This chapter describes a step-by-step guide and recommendations from VertiGIS for upgrading to the latest version of WebOffice. The new release package is available in the Download Center.

 

When upgrading your WebOffice application from 10.7 to 10.7 SP1  (Service Pack 1) consider the following requirements:

 

•Backup the content of the WebOffice usermanagement database

Backup the WebOffice usermanagement database by exporting an xml dump file.

 

•Uninstallation of WebOffice author standalone

Uninstall WebOffice author standalone via Control Panel\Programs\Programs and Features.

 

•Uninstallation of WebOffice author (as ArcMap extension)

Follow the steps in Upgrade WebOffice author.

Important Note:

With version WebOffice 10.7, WebOffice author (ArcMap) will be officially deprecated; i.e. will be delivered with WebOffice 10.7 for the last time. New features of WebOffice from version 10.7 will mostly only be implemented in WebOffice author standalone. WebOffice author (ArcMap) is no longer delivered with WebOffice 10.7 SP1.

Note: During this uninstallation all ArcGIS Desktop applications must be closed!

 

•Uninstallation of WebOffice extensions

Follow the steps in Upgrade WebOffice extensions.

Note: During this uninstallation all ArcGIS Desktop applications must be closed!

 

•Unistallation of WebOffice FTS-Index

WebOffice 10.7 SP1 uses the version 8.2.0 of WebOffice FTS-Index for the Full-Text Search.

Note: All FTS-subindices calculated so far will be removed and must be recalculated after installation of the new version of WebOffice FTS-Index in the WebOffice Administrationpage (Full-Text Search tab).

 

•Optional: Upgrade to ArcGIS 10.7.1 or installation of the latest Esri patches for ArcGIS Desktop, ArcGIS Server and ArcGIS Engine

Follow the steps from Upgrade ArcGIS.

 

WebOffice 10.7 SP1 supports the following versions of Esri ArcGIS:

Supported ArcGIS versions for WebOffice 10.7 SP1

 

Note: VertiGIS recommends always installing the latest available patches for each installed version of ArcGIS.

 

If ArcGIS is also updated from version lower than 10.6 to version 10.6 or higher during the WebOffice upgrade, then existing user-defined Esri print templates must be changed from ArcMap-based to ArcGIS Pro-based print templates (.pagx), i.e. open the MXD in ArcGIS Pro, and right-click Save as layout file.  For a detailed instructions, see chapter Migration of Layout Templates to ArcGIS Pro.

Note: For details on using Esri Print in WebOffice, see the Esri Print chapter.

 

•Installation of WebOffice author standalone

Follow the steps in WebOffice author standalone setup.

 

•Optional: Installation of WebOffice author (as ArcMap extension)

Follow the steps in Upgrade WebOffice author.

Important Note:

With version WebOffice 10.7, WebOffice author (ArcMap) will be officially deprecated; i.e. will be delivered with WebOffice 10.7 for the last time. New features of WebOffice from version 10.7 will mostly only be implemented in WebOffice author standalone. WebOffice author (ArcMap) is no longer delivered with WebOffice 10.7 SP1.

Note: Since WebOffice author standalone is feature complete, an installation of WebOffice author as ArcMap extension is only optional and no longer necessary.

 

•Installation of WebOffice extensions (Plot, ePaper, Extract Server)

Follow the steps in Upgrade WebOffice extensions.

 

•Optional: Installation of  VertiGIS Utilities (Printing Tools)

Follow the steps in chapter Optional: SynerGIS Utilities (Printing Tools).

Note: Since WebOffice 10.7 there is a BETA version of Geoprocessing (Python) based printing with the name VertiGIS Utilities in addition to the already known  WebOffice extensions.

 

 

•Installation of WebOffice usermanagement Admin Web

Follow the steps in Upgrade UserManagement Admin Web.

Note: Step 1 (Backup the content of the WebOffice usermanagement database) can be ignored if already done.

Note: Afterwards, an update of the user management database is necessary in order to upgrade the data model to the current version. To do this, open the UserManagement Admin Web page and log in with your user; you will then be prompted to update the data model if it is no longer up-to-date.

 

•Update the servlet engine

Update Java and Apache Tomcat to current versions is obligatory, update of Apache Tomcat Connector is optional.

Notes:

▪VertiGIS recommends the use of Java OpenJDK 11 since WebOffice 10.6 R2 SP1. For further information on the version used and installation see chapter Java.

▪If you want to update Apache Tomcat, a backup of the entire Tomcat folder is highly recommended!

▪WebOffice 10.7 SP1 is certified for Java OpenJDK 11.0.6, Apache Tomcat 9.0.31 and Apache Tomcat Connector 1.2.48 versions.

▪After an update to the current version of Apache Tomcat and when using Apache Tomcat Connector a read access for local user IIS_IUSRS must be set to folder \Tomcat\conf.

▪If you have imported one or more security certificates in the Java Truststore, you must import the security certificates into the Java Trust Store of the new Java directory after updating. This can be done using the Import SSL Certificates in SynAdmin function.

 

•Installation of WebOffice FTS-Index (full text search)

WebOffice 10.7 SP1 uses the version 8.2.0 of WebOffice FTS-Index for the Full-Text Search.

Follow the steps in chapter Installation of WebOffice FTS-Index or SolrCloud installation.

Note: If WebOffice FTS-Index (standalone) was already installed and Java was updated to a current version, the system variable JAVA_HOME must be adapted accordingly before installing WebOffice FTS-Index (the path to the installation directory of Java must be changed to the path of the current version). See the section Setting JAVA_HOME as a System Variable in the chapter Installation of WebOffice FTS-Index.

Note: After successful installation, all FTS subindices of the search layers in the WebOffice Administration Page (Full-Text Search Tab tab) must be recalculated.

 

•Update of the Server Object Extension and the  WebOffice system folder

Update the ArcGIS for Server Object Extension (SOE) for WebOffice as described:

  1) In ArcGIS Server Manager under Site/Extensions choose SynerGIS Server Object Extension to edit and select the new SOE file (syn_soe_ao_gateway.soe file) from WebOffice10.7-DVD\Software\ArcGIS for Server Object Extension to upload.

Note: Don't use uninstall and install the extension, because else you have to set the properties for SynerGIS Server Object Extension again!

 

 

Note: After replacing the SOE file, SynOutputService and any other services with activated Server Object Extension are stopped. These services must remain stopped, otherwise the next step can not be performed.

 

  2) Replace the SynerGIS files in C:\arcgisserver\directories\WebOfficeSystem with the files from WebOffice10.7-DVD\Software\WebOffice directories\WebOfficeSystem.

 

 

  3) Start the map service SynOutputService (or all services, where SynerGIS Server Object Extension is activated).

 

 

•Update of WebOffice application

Update the WebOffice application as follows:

1.Backup your WebOffice appliction ( C:\Tomcat\webapps\<WebOffice Application>) and copy it to a secure location

2.Stop Apache Tomcat (via Start/Programs/Administrative Tools/Services)

3.Delete the Apache Tomcat working directory (C:\Tomcat\work\Catalina\localhost\<WebOffice Application>)

4.Copy the current patch (WO107_patch_yyyymmdd.exe) into the WebOffice application directory (C:\Tomcat\webapps\<WebOffice Anwendung>)

5.Execute the current patch as administrator (replace all existing files if necessary)

6.Delete the current patch (WO107_patch_yyyymmdd.exe)

7.Start Apache Tomcat (über Start/Programs/Administrative/Services)

 

Note: For more details see the chapter Kapitel Upgrade WebOffice.

 

Finally all project configurations should be validated in WebOffice author standalone using the functionality Verify All Projects. If one or more projects are invalid the project configuration can be repaired using the Repair projects button.

 

 

 

Notes:

•In case of problems clear Browser- and Proxy-Cache. Please find more details about clearing the browser cache in Delete Browser Cache.

•When using the JavaScript clients WebOffice core client and WebOffice flex Client, using a reverse proxy can cause problems in the map display if a forward slash / is set at the end of the ProxyPass and ProxyPassReverse lines in the code. In this case please remove the slash at the end of the lines. For more details see chapter Apache Reverse Proxy.

•If you have problems during or after the WebOffice update, please contact the WebOffice Support Team.

•If GeoOffice is installed next to WebOffice, you must make sure that outdated GeoOffice modules are updated or, if no longer needed, uninstalled. Otherwise you may experience problems when using WebOffice.