Upgrading a Cluster with Spatial

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 limrepo commands in the Administration Utility.
  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. Create a backup copy of repository.xml and name it repository-Copy.xml for example.
    4. Copy the contents of repository.standalone.xml to repository.xml.
    5. Start the Spectrum Technology Platform server on all nodes (for instructions, see Starting a Cluster).
    6. Import the repository content (backed up in Step 1b) into the repository using the limrepo import command with ACL for all nodes.
    7. 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. Start the upgraded Spectrum Technology Platform server on the seed node and download the Administration Utility.
    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 the Spectrum Technology Platform modify the configuration to specify the common database.
    1. Restore the backup repository-Copy.xml file to repository.xml.
    2. 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.