This chapter covers the setup of two WebOffice application versions with different versions. 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.
Note: 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.
Note: 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 must be stopped under the Windows Services. This step is also possible with Configure Tomcat if it is installed.
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')
Adding a new WebOffice application to the Apache Tomcat application server
Note: No ordinary WebOffice patch may be used to create a new application; instead the installation of the entire WebOffice application must 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.
Note: 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.
Note: If you want to upgrade an existing version, please proceed as described in the chapter Upgrade and its sub chapter.
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.
Note: For more information on this topic see chapter Deploy WebOffice Files on ArcGIS Server.
Add another WebOffice system folder to the ArcGIS Server directory
Adding the WebOffice system files
Note: Please make sure that the included files match the status of your WebOffice application (e.g. 126.96.36.199604141935 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
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
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
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
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.
Note: 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 usermanagement
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 administrations 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
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.
Note: For more details on installing WebOffice usermanagement see chapter WebOffice usermanagement (Application Server).
Note: We recommend that you set up a separate application pool for each user management application, since some versions have different application pools.
Note: An existing database is only valid 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. The schema can then be upgraded to the latest version using the User Management Upgrade Assistant (see chapter Create a Usermanagement Database).
The installed WebOffice author is only compatible with the compatible WebOffice usermanagement. 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
Note: 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.
Note: 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.