Navigation:  How to... > How to implement Reverse Proxy Architecture > Using Apache Reverse Proxy > Configuration of Apache Reverse Proxy

To work with Apache Reverse Proxy the configuration file httpd.conf located in <Apache installation folder>\conf has to be customized. It is necessary that Apache Reverse Proxy transmits a certain header (syn_urlmap) so WebOffice 10R3 can remap the URL.

 

The first step is to load the module mod_headers :

 

The second step is to configure the application- and redirect-paths.

 

Beside the application path it is necessary to provide every path that is accessed by WebOffice 10R3 or ArcGIS Server, e.g. ArcGIS output location.

 

<Location /WebOffice>

 ProxyPass http://<SERVERNAME_intern>:8080/WebOffice/

 ProxyPassReverse http://<SERVERNAME_intern>:8080/WebOffice/

 RequestHeader set syn_urlmap http://<SERVERNAME_intern>:8080/WebOffice;http(s)://<SERVERNAME_extern>/WebOffice| 

 http://<SERVERNAME_intern>/arcgisoutput;http(s)://<SERVERNAME_extern>/arcgisoutput| 

 http://<SERVERNAME_intern>/arcgiscache;http(s)://<SERVERNAME_extern>/arcgiscache|

 /WebOffice_intern;/WebOffice_extern 

</Location>

 

<Location /arcgisoutput>

 ProxyPass http://<SERVERNAME_intern>/arcgisoutput/

 ProxyPassReverse http://<SERVERNAME_intern>/arcgisoutput/ 

</Location>

 

<Location /arcgiscache>

 ProxyPass http://<SERVERNAME_intern>/arcgiscache/

 ProxyPassReverse http://<SERVERNAME_intern>/arcgiscache/ 

</Location>

 

Note: When mapping the paths use both, absolute and relative paths. Be sure that the mapping of the relative paths is at the end of syn_urlmap.

Note: Using various GIS Servers distinct folder names for arcgiscache and arcgisoutput locations have to be provided. E.g. arcgiscache1 on one GIS Server, arcgiscache2 on another.

Note: WebOffice extract server is configured for a virtual directory in IIS, which runs by default on port 80. Therefore you should not specify the port :8080 in the URL.

 

It is always useful to restrict the access to certain pages, e.g. synadmin page. Use:

ProxyPass /WebOffice/synadmin !

 

This way you can also restrict access to the pages thematictest.jsp, testextcall.htm and testextapplication.jsp. Do not restrict externalcall.jsp!

 

Note: If using 'RequestHeader set syn_urlmap http://<SERVERNAME_intern>:8080/WebOffice;' you have to increase the GZIP filter limit. The default value defined in <WebOffice application>\Web-INF\web.xml is 5001 Bytes. Our recommendation is to increase this value to 10001 Bytes by configuring it in <WebOffice application>\Web-INF\web_user.xml.

 

Default in web.xml:

 

<filter>
<filter-name>GZIPFilter</filter-name>
<filter-class>com.mysynergis.core.controller.filter.GZIPFilter</filter-class>
<init-param>
<param-name>compressionThreshold</param-name>
<param-value>5001</param-value>
<description>perform compression if the response size (in bytes) is larger than the value specified</description>
</init-param>
</filter>

 

Insert in web_user.xml:

 

<filter>
<filter-name>GZIPFilter</filter-name>
<filter-class>com.mysynergis.core.controller.filter.GZIPFilter</filter-class>
<init-param>
<param-name>compressionThreshold</param-name>
<param-value>10001</param-value>
<description>perform compression if the response size (in bytes) is larger than the value specified</description>
</init-param>
</filter>

 

Note: Pay attention to explicitly supported scenarios for https.