Proxy Installation

Installation

All the proxy features are contained into the proxy.war file, an application you will have to deploy on your servlet container. The proxy's configuration is done with a Joomla-based component.

1) Put the proxy.war file in your application server's webapps folder.

2) Open the proxy/WEB-INF/spring/hibernate-config.xml and modify the parameters to match to your configuration.

Database connexion :

    <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName" value="com.mysql.jdbc.Driver" />
        <property name="url" value="jdbc:mysql://127.0.0.1:3306/DBNAME?zeroDateTimeBehavior=convertToNull" />
        <property name="username" value="USERNAME" />
        <property name="password" value="PASSWORD" />
    </bean>

Some configurations need to specify "localhost" instead of "127.0.0.1"

Joomla Database prefix :

    <bean id="namingStrategy" class="org.easysdi.proxy.namingStrategy.CustomNamingStrategy">
        <property name="prefix">
            <value>jos_</value>
        </property>
    </bean>

3) Open WEB-INF/classes/ehcache.xml. Set the diskStore path to an empty writable folder on your system. The proxy caches its configuration and other server capabilities.

4) Restart your application server.

5) Test your installation

In a web browser, test the url:

http://your_server:8080/proxy/

You should have the following response

<ExceptionReport xmlns="http://www.opengis.net/ows/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/ows/2.0 owsExceptionReport.xsd" version="1.0.0">
<Exception exceptionCode="MissingParameterValue" locator="request">
<ExceptionText>
Could not determine proxy request from http request. Parameter REQUEST is missing.
</ExceptionText>
</Exception>
</ExceptionReport>

To invalidate manually the proxy :

http://your_server:8080/proxy/cache?complete=TRUE

Installation issues

Tomcat security

You might encounter deploying issue if the variable "TOMCATX_SECURITY" is set to "ON" in the 'etc/init.d/tomcatX.X' file. Where X is your version of Tomcat.
Please turn it to "OFF" and read further doc on Tomcat project's homepage.