WebOffice > Concepts > Cluster Server Support

If you use a clustered server for running WebOffice 10.4 SP2 (fail over respectively load balancer cluster), you can configure WebOffice 10.4 SP2 to centralize the relevant configuration files.

Note: For using WebOffice 10.4 SP2 in a cluster, every hardware id of a cluster node has to have its own license file. The additional license files have to be named license.properties2, license.properties3, ...

Additional cluster server nodes need to be licensed. For more information please contact SynerGIS (sales@mysynergis.com).

Note: When using a load balancer please assure to link the affected output directories, WebOffice 10.4 SP2 as well as ArcGIS 10.4 for Server. By using such links the required contenct will be searched in both directories. Links on Windows Server can be easily realized via Mklink.

Navigate to C:\Tomcat\webapps\<WebOffice application>\WEB-INF\web_user.xml

Open the configuration file using a XML or text editor.

WebOffice 10.4 SP2 needs a workspace directory as well as a configuration_path directory for working correctly. You can configure a centralized directory using file paths containing logical drive names (e.g. O:\WebOffice\workspace and O:\WebOffice\configuration_path) or UNC paths (e.g. \\SANNodeName\WebOffice\workspace and \\SANNodeName\WebOffice\configuration_path).

Hinweis: If the folder /configuration will be centralised via the web_user.xml, the relevant files within a roll-out process of a patch or a service pack have to be maintained manually. In generell we recommend that only the /work directory should be centralised via the web_user.xml and all other relevant directories (output folder of ArcGIS 10.4 for Server and output folder and the configuration folder of WebOffice 10.4 SP2) should be linked via a symbolic link through the Mklink command-line Tool.

Example for the creation of symbolic links with Mklink for the WebOffice 10.4 SP2 /configuration or /output folder and the output folder of the ArcGIS 10.4 for Server:

mklink /d "MyWebOfficeConf" "\\w-ws-krejci\Tomcat\webapps\WebOffice104\WEB-INF\classes\configuration\"

mklink /d "MyWebOfficeOutput" "\\w-ws-krejci\Tomcat\webapps\WebOffice104\output\"

mklink /d "MyAGSoutput" "\\w-ws-krejci\arcgisserver\directories\arcgisoutput"

If the creation of a symoblic link is successfull the following message will be displayed in the command line window:

symbolic link created for MyWebOfficeConf <<===>> \\w-ws-krejci\Tomcat\webapps\WebOffice104\WEB-INF\classes\configuration\

Note: Changes on the web_user.xml file only take effect after reloading the WebOffice 10.4 SP2 web application.

You may configure centralized workspace and configuration_path properties:

<context-param>

<param-name>configuration_path</param-name>

<param-value>/WEB-INF/classes/configuration</param-value>

</context-param>

<!-- Work folder. Changing this value is only necessary if e.g. working in cluster environments.

In the Work folder some information gets stored/retrieved:

-User profiles ('profiles' sub directory)

-States ('states' sub directory)

-Reports ('reports' sub directory)

-Print outputs ('archive' sub directory). -->

<context-param>

<param-name>workspace</param-name>

<param-value>/WEB-INF/work</param-value>

</context-param>

Note: For reloading the application of project configurations it is necessary to perform the reload operation on each of the cluster nodes explicitly because if you only do the reload operation on the logical cluster node, the performed action will cause a state change on one of the cluster nodes only (there is no automatism for propagating the application state change).