Upgrading a Cluster with the Location Intelligence Module

When a common repository database is used for clustering, these additional steps are required before and after the Spectrum™ Technology Platform upgrade process. This upgrade process must be followed even if you have a single node with a common repository database.

Before the upgrade, you must move to a local database setup; after the upgrade, you then change back to the cluster setup by pointing repository.xml to the external database.
Note: To preserve access control settings, use the Administration Utility instead of WebDAV. See the Administration section of the Spectrum Spatial Guide for instructions on using the Administration Utility. The limrepo commands in the Administration Utility were available beginning in version 11.0; if you are upgrading from a version prior to 11.0, you must use WebDAV.
  1. Before upgrading Spectrum™ Technology Platform, back up the repository by following these steps.
    1. Select a node from the cluster. This will be the seed node (see Installing a Cluster).
    2. Back up the repository content using the Administration Utility's limrepo export command with ACL, pointing to the seed node.
    3. Back up the Spectrum\server\modules\spatial\jackrabbit folder to a location outside the installation folder.
  2. Switch the common repository database to a local database (temporarily, just for upgrade purposes). Apply these steps to all nodes in the cluster.
    1. Stop the Spectrum™ Technology Platform server on all nodes (for instructions, see Stopping a Cluster).
    2. Delete the repository, version, workspaces folders and the lock.properties file (if available) from the jackrabbit folder (Spectrum\server\modules\spatial\jackrabbit).
    3. Copy the contents of repository.standalone.xml to repository.xml.
    4. Start the Spectrum™ Technology Platform server on all nodes (for instructions, see Starting a Cluster).
    5. Import the repository content (backed up in Step 1b) into the repository using the limrepo import command with ACL for all nodes.
    6. Stop the Spectrum™ Technology Platform server.
  3. Follow normal procedures in Upgrading a Cluster to upgrade Spectrum™ Technology Platform to the new version on all nodes.
  4. For the seed node only, after the Spectrum™ Technology Platform upgrade is complete, back up the upgraded content by following these steps.
    1. On the seed node, download the Administration Utility from the upgraded Spectrum™ Technology Platform server.
    2. Back up the content from the repository using the limrepo export command with ACL by pointing to the seed node.
    3. Stop the Spectrum™ Technology Platform server on all nodes (for instructions, see Stopping a Cluster).
    4. On all nodes, back up the upgraded Spectrum\server\modules\spatial\jackrabbit folder to a location outside the installation folder.
  5. On all nodes of Spectrum™ Technology Platform modify the configuration to specify the common database.
    1. Copy the contents of repository.<databaseType>.xml to repository.xml located under the server/modules/spatial/jackrabbit folder where <databaseType> is the appropriate type for your database (postgres, oracle, or mssql).
    2. In repository.xml:
      • Modify the DataSource section with the server host name, port, database, user, and password.
      • Modify the Cluster section to assign a distinct cluster ID, like Node1. Ensure unique IDs are assigned to every subsequent node in the cluster (for example, Node2, Node3).
      • Save the changes to repository.xml.
    3. Remove these folders from the /server/modules/spatial/jackrabbit folder: repository, version, workspaces.
  6. If your database has previously contained any repository content, you must remove these tables to create a clean repository:
    • default_binval
    • default_bundle
    • default_names
    • default_refs
    • rep_fsentry
    • rep_global_revision
    • rep_journal
    • rep_local_revisions
    • security_binval
    • security_bundle
    • security_names
    • security_refs
    • version_binval
    • version_bundle
    • version_names
    • version_refs
    If using Oracle, then also delete version_seq_names_id, security_seq_names_id, and default_seq_names_id.
  7. On the seed node only, import the backed up repository content.
    1. Start the Spectrum™ Technology Platform server (for instructions, see Starting a Cluster).
    2. Import the contents using the limrepo import command, pointing to the seed node.
  8. Start the remaining nodes in the cluster (for instructions, see Starting a Cluster).