Upgrading a Cluster

Prerequisites:

Before upgrading, be sure to read the release notes for the new version. The release notes contain 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.

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.

Note that these scenarios have special procedures for upgrading a cluster:

If you have one cluster for server nodes and another cluster for configuration database nodes, see Upgrading a Cluster with a Separated Database.
If you are upgrading a cluster for the Location Intelligence Module only, see Upgrading a Cluster with the Location Intelligence Module. If you are upgrading both Spectrum and Location Intelligence Module clusters, before shutting down all nodes also see Upgrading a Cluster with the Location Intelligence Module for some required pre-upgrade steps.
If you are upgrading a cluster running the Data Hub Module, see Upgrading a Cluster with the Data Hub Module.

If these scenarios do not apply to you, follow this procedure to upgrade your cluster:

Back up the server. For instructions on creating a backup, see the Administration Guide.

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.
Stop all the nodes in the cluster. For more information, see Stopping a Cluster.
On the last node that you stopped:
1. Open the file server/app/conf/spectrum-container.properties in a text editor.
2. In the spectrum.cluster.seeds property, remove all nodes except for the current node.
  
  Note: Make a note of the nodes you remove so you can add them back later.
3. Save and close spectrum-container.properties.
4. Upgrade the node. For more information, see Upgrading a Server.
5. Open the file spectrum-container.properties in a text editor and configure the cluster properties. For more information, see Cluster Properties. Be sure to leave spectrum.cluster.seeds set to only the current node's IP address or host name.
6. Save and close spectrum-container.properties.
7. Start the server.
Upgrade each of the other nodes, one at a time, by following this procedure:

Important: Follow this procedure only when upgrading nodes other than the first node. See step 3 for the procedure to upgrade the first node.

Important: Be sure you have backed up your server before proceeding.
1. Delete this folder:
  
  SpectrumLocation\server\app\repository\store\databases
2. Upgrade the node. For more information, see Upgrading a Server.
3. Open the file spectrum-container.properties in a text editor and configure the cluster properties. For more information, see Cluster Properties. Save and close the file when you are done.
4. Delete this folder:
  
  SpectrumLocation/repository/data/databases/graph.db
  
  Note: You must delete this folder before you start the new node. If you do not, the node will fail to join the cluster.
5. Start the server.
After you have upgraded all the nodes, go back to the first node you upgraded, open spectrum-container.properties, and add the seed nodes you removed from spectrum.cluster.seeds.