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 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.
-
Before upgrading Spectrum™ Technology Platform, back up the repository by
following these steps.
- Select a node from the cluster. This will be the seed node (see Installing a Cluster).
- Back up the repository content using the Administration Utility's limrepo export command with ACL, pointing to the seed node.
- Back up the Spectrum\server\modules\spatial\jackrabbit folder to a location outside the installation folder.
-
Switch the common repository database to a local database (temporarily, just
for upgrade purposes). Apply these steps to all nodes in the cluster.
- Stop the Spectrum™ Technology Platform server.
- Delete the jackrabbit folder (Spectrum\server\modules\spatial\jackrabbit) and create an empty "jackrabbit" folder in the same location.
- Copy repository.xml into the jackrabbit folder 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.
- Start the Spectrum™ Technology Platform server.
- Import the repository content (backed up in Step 1b) into the repository using WebDAV (the limrepo import command will not work with an empty folder).
- Stop the Spectrum™ Technology Platform server.
- Follow normal procedures to upgrade Spectrum™ Technology Platform to the new version on all nodes.
-
For the seed node only, after the Spectrum™ Technology Platform upgrade is
complete, back up the upgraded content by following these steps.
- Start the Spectrum™ Technology Platform server
- Download the Administration Utility from the upgraded Spectrum™ Technology Platform server.
- Back up the content from the repository using the limrepo export command with ACL.
- Stop the Spectrum™ Technology Platform server.
- Back up the upgraded Spectrum\server\modules\spatial\jackrabbit folder to a location outside the installation folder.
- Configure the platform cluster as described in Installing a Cluster.
-
On all nodes of Spectrum™ Technology Platform modify the configuration to
specify the common database.
-
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). -
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.
- Remove these folders from the /server/modules/spatial/jackrabbit folder: repository, version, workspaces.
-
Copy the contents of
repository.<databaseType>.xml to
repository.xml located under the
server/modules/spatial/jackrabbit folder where
-
If your database has previously contained any repository content, you must
remove tables from it so that a clean repository can be created. These tables
need to be removed:
If using Oracle, then also delete
default_binval security_binval default_bundle security_bundle default_names security_names default_refs security_refs rep_fsentry version_binval rep_global_revision version_bundle rep_journal version_names rep_local_revisions version_refs version_seq_names_id, security_seq_names_id
, anddefault_seq_names_id
. -
On the seed node only, import the backed up repository content.
- Start the Spectrum™ Technology Platform server (for instructions, see Starting a Cluster).
- Import the contents using the limrepo import command, pointing to the seed node.
- Start the remaining nodes in the cluster (for instructions, see Starting a Cluster).