Upgrading a Server
This procedure is for upgrading a single Spectrum™ Technology Platform server.
Prerequisites:
- 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.
-
Important: We recommend that you create a backup before upgrading so that you can recover your flows, security settings, and other settings, if an error occurs during the upgrade process.
-
Note: If you have customized settings in the wrapper.conf file located in <SpectrumDirectory>/server/bin/wrapper, we recommend that you copy this file to a separate location before you upgrade the Spectrum™ Technology Platform server. After you complete the upgrade, compare the contents of wrapper.conf installed during the upgrade with the contents of the saved copy of the file. 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.
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 use remote servers, you must upgrade the remote servers and start them before upgrading the main server. If you upgrade the main server and start it before upgrading and starting the remote servers, you will need to recreate the remote server connections in Management console after upgrading.
Some modules have post-upgrade steps you need to perform.
Data Hub Module | Open this file in a text editor: and set the property dbms.allow_format_migration property to true. The purpose of this property is to protect against unintentional and irreversible store upgrades. Setting this property to "true" indicates that you understand the ramifications of proceeding with an upgrade and have taken the necessary precautions before proceeding. Restart the Spectrum™ Technology Platform server. The server will upgrade each model. Examine the server log file for errors or warning messages. Once all models have been upgraded, go back to the hub.properties file and comment out the allow_store_upgrade property. |