- 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.
-
Important: If you upgraded to Spectrum Technology Platform 2022.1 from an earlier version of Spectrum, you must reindex the Spectrum 2022.1 search indexes before you upgrade to Spectrum Technology Platform 2023.1. For instructions how to do this, see Reindex 2022.1 Search Indexes before upgrading to 2023.1 under Upgrading you Installation.
- Make sure that you follow the appropriate upgrade path for the currently installed version of Spectrum that you want to upgrade.
- Apply all the latest updates available for your operating system, especially those that resolve issues with Java.
- 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 cluster where the Spectrum Technology Platform server and configuration database are installed on each node of the cluster. To upgrade a cluster, you upgrade one node at a time. The first node you upgrade is handled slightly differently than the other nodes because you must point the node to itself as a seed node since no other nodes will be running in the cluster when it starts up.
The following scenarios have special procedures for upgrading a cluster.
For this scenario | Use this information |
---|---|
Separate clusters for server nodes and configuration database nodes | Upgrading a Cluster with a Separated Database. |
Upgrading a cluster for Spatial only | Upgrading a Cluster with Spatial |
Upgrading both Spectrum and Spatial clusters | Upgrading a Cluster with Spatial |
Upgrading a cluster running Context Graph | Before shutting down all nodes in the cluster, see Upgrading a Cluster with Context Graph. |
If none of the scenarios apply to your installation of Spectrum, complete the following steps to upgrade your cluster.