Upgrading a Cluster with the Location Intelligence Module

When a common repository database is used for clustering, these additional steps required before and after the Spectrum™ Technology Platform upgrade process. Before the upgrade, you must move to a local Derby 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, do not use Windows WebDAV; instead, use a third-party WebDAV tool such as WinSCP.
  1. Before upgrading Spectrum™ Technology Platform, back up the repository by following these steps.
    1. Select a node from the cluster.
    2. Back up the repository content using a non-Windows WebDAV client.
    3. Back up repository.xml (under Spectrum\server\modules\spatial\jackrabbit).
    4. Back up the JDBC driver jar file used by the database for the repository (for example, postgresql-9.1-901.jdbc4.jar under Spectrum\server\app\lib).
    5. Back up repository.xml from Spectrum\server\app\tmp\RepositoryService.war-xxxxxxxx-contents\ webapp\WEB-INF\classes\org\apache\jackrabbit\core. If you cannot find this file, you can extract it from RepositoryService.war under Spectrum\server\app\deploy.
  2. Switch the common repository database to a local Derby database (temporarily, just for upgrade purposes). Apply the following steps to all nodes in the cluster.
    1. Stop the Spectrum™ Technology Platform server.
    2. Rename the jackrabbit folder to "jackrabbit_cluster" (from Spectrum\server\modules\spatial\jackrabbit to Spectrum\server\modules\spatial\jackrabbit_cluster).
    3. Create another jackrabbit folder in the same location.
    4. Copy repository.xml (backed up in Step 1e) to the jackrabbit folder.
    5. Start the Spectrum™ Technology Platform server.
    6. Copy all the repository files and folders (backed up in Step 1b) into the repository using a non-Windows WebDAV client.
    7. Stop the Spectrum™ Technology Platform server.
  3. Follow normal procedures to upgrade Spectrum™ Technology Platform to the new version.
  4. After the Spectrum™ Technology Platform upgrade is complete, switch back to the common repository database for all nodes in the cluster by following these steps.
    1. First node only: Start the Spectrum™ Technology Platform server (if required) and back up the content from the repository using a non-Windows WebDAV client.
    2. Stop the Spectrum™ Technology Platform server.
    3. Rename the jackrabbit folder to "jackrabbit_local" (from Spectrum\server\modules\spatial\jackrabbit to Spectrum\server\modules\spatial\jackrabbit_local).
    4. Create another folder named "jackrabbit" in the same location.
    5. Copy repository.xml (backed up in Step 1c) to the jackrabbit folder.
    6. Copy the JDBC driver jar (backed up in Step 1d) to Spectrum\server\app\lib.
    7. Start the Spectrum™ Technology Platform server.
    8. First node only: Copy the content that you backed up in Step 4a into the repository using a non-Windows WebDAV client.
    9. Repeat Steps 4b-4g for each additional node.
    10. For each additional node, after copying repository.xml (backed up in Step 1c) to the jackrabbit folder, verify that it has a distinct Cluster ID.