Using Multiple WebOffice Applications of Different Versions

This chapter covers the setup of two WebOffice application versions with different versions within one Apache Tomcat application server. This chapter describes all necessary steps for setting up another WebOffice application with different patch levels. In addition, the steps for adapting possible other WebOffice components are also described.

 

icon_comment

In this application scenario the previous WebOffice application may no longer be fully compatible with the Server Object Extension. This can lead to problems if functions that are executed via Server Object Extension no longer function properly (see also chapter Server Object Extension (SOE) - Functionalities). This scenario is intended for application versions with different patch versions that have the same version basis.

icon_cross-reference

If you have any questions regarding the setup and use of different WebOffice application levels, you can contact the WebOffice Support Team.

Stop Apache Tomcat Service

To add another application the Apache Tomcat application server must be stopped under the Windows Services. This step is also possible with Configure Tomcat if it is installed.

Stop Apache Tomcat Service

Stop Apache Tomcat Service

Add another application in Apache Tomcat

The first step in providing another WebOffice application with different versions is to add a new application in Apache Tomcat. The new application must be created on the basis of a complete WebOffice installation.

Directory of Apache Tomcat applications (subfolder "webapps")

Directory of Apache Tomcat applications (subfolder "webapps")

 

Adding a new WebOffice application to the Apache Tomcat application server

Adding a new WebOffice application to the Apache Tomcat application server

 

icon_comment

No WebOffice patch may be used to create a new application. The installation of the whole WebOffice application has to be used. For more information on installation, see chapter Install WebOffice Application. For the installation of further WebOffice patches, please refer to the chapter Upgrade WebOffice.

icon_comment

If a new license is required due to version changes, the new license file must be inserted into the corresponding directory (e.g. C:\Tomcat\webapps\WebOffice\WEB-INF\classes\configuration\license) or imported via the WebOffice Administration Page (SynAdmin). For more information on installing a license, please refer to the chapter Install the License.

icon_cross-reference

If you want to upgrade an existing version, please proceed as described in the chapter Upgrade and its sub chapters.

Create your own WebOfficeSystem folder for the added application

Next, an additional WebOfficeSystem directory must be created under the ArcGIS Server installation directory (e.g. C:\arcgisserver\directories\WebOfficeSystem2). In addition, the WebOffice system files for the application version used must be copied to the folder. This WebOffice system folder contains the corresponding Java libraries for the WebOffice version used.

icon_cross-reference

For more information on this topic see chapter Deploy WebOffice Files on ArcGIS Server.

 

Add another WebOffice system folder to the ArcGIS Server directory

Add another WebOffice system folder to the ArcGIS Server directory

 

Adding the WebOffice system files

Adding the WebOffice system files

 

icon_comment

Please make sure that the included files match the status of your WebOffice application (e.g. 104.0.0.201604141935 of the folder in the Screenshot indicates a WebOffice 10.4 application).

Deploy an updated Server Object Extension

With different WebOffice application versions the Server Object Extension must always be updated with the more current version directly on the ArcGIS Server Manager. The necessary steps for updating the Server Object Extension can be found in the readme of a patch or in the following chapter Install ArcGIS Server Object Extension for WebOffice under Editing the Extension.

Updating the Server Object Extension via ArcGIS Server Manager

Updating the Server Object Extension via ArcGIS Server Manager

Creation and publishing of another SynOutputService

In addition to updating the Server Object Extension a new SynOutputService must be created for the newly created WebOffice application. This SynOutputService contains the full compatibility to the application and allows the use of existing or new functions in the range of WebOffice extensions.

 

In the first step the data in the Service Documents directory (.\arcgisserver\directories\ServiceDocuments) is copied from the content of the WebOffice DVD (WebOffice10.9-DVD\Software\WebOffice directories ServiceDocuments) accordingly and renamed (e.g. directory SynOutputService104 or SynOutputService104.mxd).

 

Duplicate of SynOutputService.mxd for new application

Duplicate of SynOutputService.mxd for new application

 

Create a new workspace

Create a new workspace

 

In the next step the described installation steps are carried out on the basis of the new files (e.g. directory SynOutputService104 or SynOutputService104.mxd) for publishing the further SynOutputService according to the chapter Publish the SynOutputService.

 

Creation of another SynOutputService in ArcGIS Server Manager

Creation of another SynOutputService in ArcGIS Server Manager

 

Additionally the path on the General tab in the properties of the Server Object Extension in the ArcGIS Server Manager must be adjusted according to the newly created WebOfficeSystem folder (e.g. C:\arcgisserver\directories\WebOfficeSystem104\syn_soe_ao_gateway.json).

 

Adaption of handler configuration in ArcGIS Server Manager

Adaption of handler configuration in ArcGIS Server Manager

Update WebOffice author

It is recommended that the WebOffice author be updated to the latest version for different WebOffice application versions. Updating the WebOffice author is described in the following chapter Upgrade WebOffice author. In general only WebOffice author can be installed on a machine. If two applications with different versions (e.g. version 10.5 or 10.6) are in use simultaneously, changes may occur in WebOffice usermanagement due to the incompatibility of the respective WebOffice author version. To work around this, install a compatible version for WebOffice usermanagement on another machine and connect to the corresponding WebOffice application via a UNC path in the Settings.

icon_comment

In general newer WebOffice author versions are compatible for editing older WebOffice projects.

Update WebOffice Extension

To ensure general compatibility, you should always install the latest WebOffice extension. If no more recent ones are available, this step can be skipped. For more information on updating the WebOffice Extension see Upgrade WebOffice extensions.

Installation of another or updated WebOffice User Management

This step can be skipped if no WebOffice usermanagement is in use. If there are different versions of User Management between the WebOffice application versions, an additional User Management application must be installed. Several WebOffice User Managements can be installed in parallel. If there are no different versions of the user administration the currently installed user administration can be used.

 

Create a new <%Usermangement%> application

Create a new <%Usermangement%> application

 

In general a new application is created in the IIS folder (e.g. C:\inetpub\wwwroot) under a different name (e.g. UserManagementAdminWeb104). In addition, a virtual directory is added to the IIS, which points to the path of the newly created user administration application. This is then converted into an application.

 

icon_cross-reference

For more details on installing WebOffice usermanagement see chapter WebOffice UserManagement (Application Server).

icon_comment

It is recommended to set up a separate application pool for each user management application, as some versions have different application pool requirements.

An existing database is always valid only with the schema of the linked user administration. It is possible to upgrade the user administration database schema to the latest version. If different User Management applications are running in parallel, it is recommended to create a new database for the newly created User Management application and to export the existing UM database and import it into the new one. After that, the schema can be upgraded to the latest version using the User Management Upgrade Wizard (see chapter Creating a User Management Database).

 

The installed WebOffice author is only compatible with the compatible User Management. If an incompatible version of WebOffice author is specified for the User Management database specified in the profile, the following message appears:

 

Notification of incompatibility of WebOffice Author and user management

Notification of incompatibility of WebOffice Author and user management

 

icon_comment

The WebOffice author can only be installed once on the system. The administration of another weboffice version has to be done via another computer with WebOffice author installed.

Create a new WebOffice FTS-Index

If a full text search is already defined in the copied application configuration, the following steps must be carried out accordingly. To use the full text search of the new WebOffice application, another WebOffice FTS-Index must be set up. The necessary setup steps can be found in chapter Set up several Cores in WebOffice FTS-Index.

icon_warning

ACHTUNG!

The scenario of using a WebOffice FTS-Index for multiple WebOffice applications is NOT RECOMMENDED by VertiGIS! ONE WebOffice FTS-Index should only be used by ONE WebOffice application.

(Optional) Adjusting the settings of the Apache Tomcat Connector

For more information on adjusting the settings of the Apache Tomcat Connector see Create a new WebOffice application.

Adjusting the Internet Information Server (IIS)

For more information on creating a new output directory in IIS refer to the chapter Create a new WebOffice application.

Adjusting the basic settings or profiles in WebOffice author

For more information on adjusting the settings in WebOffice author refer to the chapter Create a new WebOffice application.

Adjusting application configuration in WebOffice author

For more information on adapting or configuring the new output directory in the WebOffice application configuration refer to the chapter Create a new WebOffice application.