Upgrading a Cluster with the Data Hub Module

Prerequisites:

In a cluster that runs the Data Hub Module, each node hosts the Spectrum™ Technology Platform server as well as Data Hub Module models. When upgrading, you need to upgrade your models in addition to upgrading the Spectrum™ Technology Platform server.

The upgrade process consists of these steps:

  1. Back up your models and properties files.
  2. On the master server, upgrade Spectrum™ Technology Platform then upgrade your models.
  3. On each non-master server, upgrade Spectrum™ Technology Platform then copy the upgraded models from the master server to the non-master server.

To upgrade a cluster that runs the Data Hub Module, follow this procedure:

  1. If you do not already have a backup copy of your models, create a backup manually. To create a backup manually, open the Relationship Analysis Client and click Manage. Select the model you want to back up then click Backup.
    In addition to backing up your models, back up these two property files:
    • server\modules\hub\hub.properties
    • server\modules\db\neo4j.properties
  2. Identify which node is the serving as the master server for the Data Hub Module.
    1. Open a web browser and go to:

      http://LoadBalancer:8080/jmx-console/HttpAdaptor/list

    2. Scroll down to the neo4j.org domain.

      You will see a set of objects for each model. The Role attribute in the HighAvailability object indicates whether a server is the master for a model.

    3. If you have more than one model and each model has a different master, you need to make one server the master of all the models. To do this, restart the cluster then open the Relationship Analysis Client using the hostname or IP address of one of the nodes rather than the load balancer. In the Relationship Analysis Client, open each model by running a query on each model. This will make the server you are connected to the master for each model.
  3. Stop each non-master node in the cluster, then stop the master server last. Stop nodes one at a time rather than all at once.
    Important: Make sure that Spectrum™ Technology Platform stops without errors. If a server does not stop properly, Data Hub Module models on the server will not open successfully after upgrading. To ensure that Spectrum™ Technology Platform stopped cleanly, examine the SpectrumDirectory\server\app\repository\logs\wrapper.log file for errors during shutdown.
  4. Upgrade the master server.
    1. If you are upgrading from Spectrum™ Technology Platform 10.0 or later, each model directory must contain a version.data file. Review all the model.ModelName subdirectories located under SpectrumDirectory/server/modules/hub/db to confirm that they contain a version.data file. If any model directory is missing this file, copy the corresponding version.data file from one of the non-master nodes.
    2. Run the Spectrum™ Technology Platform installer to upgrade the master server to the new version of Spectrum™ Technology Platform.
    3. After the upgrade process finishes, the Spectrum™ Technology Platform server starts automatically. Wait for the server to finish starting completely, then stop the server.
    4. Open the file SpectrumFolder\server\modules\hub\hub.properties in an editor and confirm that the property hub.neo4j.database.type is set to embedded:
      hub.neo4j.database.type=embedded
    5. Open the file SpectrumFolder\server\modules\hub\db\neo4j.properties in an editor and set the allow_store_upgrade property to true:
      allow_store_upgrade=true
    6. Start the Spectrum™ Technology Platform server.
    7. Open each model in the Relationship Analysis Client and run a query. Any query is sufficient.
    8. Stop the Spectrum™ Technology Platform server.
    9. Open the file SpectrumFolder\server\modules\hub\hub.properties in an editor and set the property hub.neo4j.database.type to ha:
      hub.neo4j.database.type=ha
    10. Compare any properties files that you backed up to the installed files and make any necessary changes. Do not overwrite new files with old files because new files may contain properties that old files do not.
  5. Upgrade the non-master servers.
    1. Delete the models in the SpectrumDirectory\server\modules\hub\db directory.
      Warning: Do not delete the models from the master server.
    2. On one of the non-master servers, run the Spectrum™ Technology Platform installer to upgrade it to the new version of Spectrum™ Technology Platform.
    3. After the upgrade process finishes, the Spectrum™ Technology Platform server starts automatically. Wait for the server to finish starting completely, then stop the server.
    4. Open the file SpectrumFolder\server\modules\hub\hub.properties in an editor and set the property hub.neo4j.database.type to ha:
      hub.neo4j.database.type=ha
    5. Compare any properties files that you backed up to the installed files and make any necessary changes. Do not overwrite new files with old files because new files may contain properties that old files do not.
    6. Copy the SpectrumFolder\server\modules\hub\db\model.* directories from the master server to the non-master server.
    7. Repeat these steps for each non-master server in the cluster.
  6. Start the cluster.
    1. Start the master server, followed by non-master servers.
    2. Ensure that each server in the cluster is functioning. Check SpectrumFolder\server\app\repository\wrapper.log for any errors.
    3. While directly connected to the master server (bypassing the load balancer), open each model, one at a time, and inspect the wrapper.log file for errors.