Spectrum Server Upgrade

Important: If you are upgrading from 2020.1 S54 or above, you must apply the Upgrade_s54to20221_Windows.zip file to the server in step 9.

Before upgrading, be sure to read the release notes for the new version. The release notes contain a list of known issues, important compatibility information, supported upgrade paths, and module-specific data backup recommendations.
Apply all the latest updates available for your operating system, especially those that resolve issues with Java.
Make sure that you follow the appropriate upgrade path for the currently installed version of Spectrum that you want to upgrade.
Important: We recommend that you create a backup before upgrading so that if an error occurs during the upgrade you can recover your flows, security settings, and other settings and customizations.
To retain customized settings in the wrapper.conf file located in the SpectrumDirectory\server\bin\wrapper directory, you will need to compare the contents of wrapper.conf installed during the upgrade with the contents of the backed up copy of the file. Before upgrading make sure you have backed up all models and property files. You can then manually copy customizations that you want to retain after the upgrade into the updated version of the file. This is particularly important for changes to the initial and maximum Java heap sizes. This release requires Java 11, so corresponding updates to JVM properties should be used.

This procedure is for upgrading a single Spectrum Technology Platform server. Follow this procedure when upgrading a standard installation or when upgrading a node in a cluster. If you are upgrading a cluster, be sure to follow the cluster upgrade process. For more information, see Upgrading a Cluster.

If you upgrade the main server and start it before upgrading and starting the nodes, you will need to recreate your connections in Management console after upgrading.

Download the updated version of Spectrum Technology Platform using the download instructions contained in the release announcement email.
Unzip the downloaded installer to a temporary folder on the server you want to upgrade.
Back up the server. For instructions on creating a backup, see the Administration Guide.
Back up module-specific data for any of these modules if you have them installed.
Optional: If you have customized settings that you want to retain in wrapper.conf located in the SpectrumDirectory\server\bin\wrapper directory, copy the customized file to a separate location.
The upgrade does not retain changes to settings in this file. This is particularly important for changes to the initial and maximum Java heap sizes.
Optional: You can reduce the time it takes to upgrade your system by purging old records from the execution history. Consider purging the execution history if it contains over 100,000 entries. You can view your execution history in Enterprise Designer under View > Execution History.

If you are upgrading from version 19.1 or 20.1, use the JMX console to delete old history records. This process is faster than manually deleting records in Management Console. For more information, see Purging Execution History.
Stop the Spectrum Technology Platform server.
To stop the server, right-click the Spectrum Technology Platform icon in the Windows system tray and click Stop Spectrum.
Check that all Spectrum Java processes running have been shut down on the machine before you start the Spectrum server upgrade.

Note: If you have Global Sentry installed, stop the Global Sentry database server by opening the Windows Services Manager and stopping the Global Sentry Database Server service.
If you have applied the 2020.1 S54 patch or later, install the 2020.1 Upgrade_s54to20221_Windows.zip file to the server before you continue.
For more information, see Upgrade from 2020.1 S54 patch or later.
Run the Spectrum Technology Platform installer to upgrade your system.

Important: Clear the option to restart the server after the installation is complete.

After the upgrade is complete, edit the neo4j.template and spectrum-container.properties files if necessary to match the following settings.

SpectrumDirectory\repository\neo4j.template

dbms.active_database=graphdb
dbms.default_database=graphdb
dbms.default_listen_address=0.0.0.0
causal_clustering.discovery_advertised_address=${spectrum.agent.address}
causal_clustering.enable_pre_voting=false
dbms.routing.enabled=true
dbms.routing.listen_address=0.0.0.0
dbms.routing.advertised_address=${spectrum.agent.address}

SpectrumDirectory\server\conf\spectrum-container.properties
```
spectrum.repository.cluster.mode=CAUSAL
```
Note: The spectrum.repository.cluster.mode setting shown here is for a standard (non-cluster) server or separated database node.

Check that all Spectrum Java processes have been shut down.
Start the Spectrum Technology Platform server.
Apply all the updates for the platform and any modules you have installed.
For a listing of updates, see Spectrum Technology Platform Updates.

Note: Any job or subflow stored in the system during a server upgrade is marked as exposed to provide the same behavior for those jobs and subflows as before the upgrade. Any job or subflow that is exported prior to the upgrade will not be exposed. Therefore, when importing these jobs or subflows back into the system, you must manually expose the imported job or subflow.

The following module has post-upgrade steps you need to perform.


Spatial	During an upgrade, the pool size is reset to 4 if set to a lower value. A pool size setting of 4 or more is unaffected. To change the Remote Component Pool Size value after upgrading, open the Management Console and select Resources > Spatial. Change the pool size value and click Save. For details, see Modifying the Pool Size in the Spectrum Spatial Guide.
Context Graph	Context Graph models are stored on an external Neo4j Graph Database Server. For instructions about how to upgrade Context Graph, see Upgrade Data Hub or Context Graph.