Prerequisites:
- Before upgrading, be sure to read the release notes for the new version. The
release notes contain important compatibility information, supported upgrade
paths, and module-specific data backup recommendations.
- Apply all the latest updates available for your operating system, especially
those that resolve issues with Java.
This procedure describes how to upgrade Spectrum™ Technology Platform when you have
separated the configuration database from the server. To upgrade an environment that
has a separated configuration database, you first upgrade the configuration database
cluster, then the server cluster.
-
Back up the server. For instructions on creating a backup, see the
Administration Guide.
Important: We recommend that you create a backup before upgrading so
that you can recover your flows, security settings, and other settings, if
an error occurs during the upgrade process.
-
Back up module-specific data for any of these modules if you have them
installed.
Module |
Items to Back Up |
Advanced Matching Module, Data Normalization Module, and
Universal Name Module |
Back up the contents of these subfolders located in
SpectrumLocation/server/modules:
- cdqdb
- lucene
- matcher
- parser
- searchindex
- tables
|
Data Hub Module |
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
|
Location Intelligence Module |
Back up your named resources, data, and configuration
files. |
-
Stop all the nodes in the server cluster then stop all the nodes in the
configuration database cluster. Make a note of the last node that you stop in
the configuration database cluster. You must start this node first after
upgrading. For instructions on stopping a cluster, see Stopping a Cluster.
-
On the last
node that you shut down in the configuration database cluster, execute
installdb.exe. The installer upgrades the
configuration database.
Warning: The first node that you upgrade must be
the last node that was stopped. This is because on some operating systems
the configuration database will start automatically at the end of the
upgrade process. If the first node that starts is not the last node that was
stopped, data such as job history and configuration settings may be lost. If
you do not know which node was stopped last, look in each node's wrapper log
for the time stamp of the shutdown message. You can find the wrapper log in:
Spectrum
Location\Database\repository\logs\wrapper.log.
Important: When prompted with the option to
start Spectrum™ Technology Platform after the installation, you must
disable this option so that the database does not start automatically when
the installation completes.
-
After the upgrade is complete, the configuration database starts up
automatically. Verify that the configuration database is fully started before
continuing by opening the log file
SpectrumInstallationLocation\Database\repository\logs\wrapper.log
and looking for the message Started.
Important: Do not attempt to stop the server until after it has
fully started for the first time. Stopping the server before it performs an
initial startup can cause your installation to become unusable.
-
Stop the configuration database. To stop the configuration database,
right-click the Spectrum™ Technology Platform icon in the Windows system tray
and select Stop Spectrum™. Alternatively, you can use the Windows
Services control panel to stop the configuration database by stopping the
Spectrum Database service.
-
Configure clustering for the database cluster.
-
Edit the file
Database/repository/spectrum-container.properties
as described in Cluster Properties for a Configuration Database Cluster.
-
Save and close the spectrum-container.properties
file.
-
Start the last node that was stopped in the configuration
database cluster. To start
the configuration database, right-click the Spectrum™ Technology Platform icon in the Windows system tray and select
Start Spectrum™. Alternatively, you can use the
Windows Services control panel to start the configuration database by
starting the Spectrum Database
service.
-
After the upgraded configuration database is fully
started, repeat the previous steps to upgrade each of the remaining
servers in the configuration database cluster and start each of
them.
-
Upgrade each node in the server cluster. For more information, see Upgrading a Cluster.
Important: When installing each
server select the Server only option in the
installer and provide the host and port of one or more of the
configuration database servers. You can find the port in the file
InstallationLocation\Database\repository\spectrum-container.properties.
The port is specified in the
spectrum.repository.server.connector.bolt.port
property.
Note: Any job or subflow stored in the system during a server upgrade is marked as
exposed to provide the same behavior for those jobs and subflows as before the
upgrade. Any job or subflow that is exported prior to the upgrade will not be
exposed. Therefore, when importing these jobs or subflows back into the system, you
must manually expose the imported job or subflow.
Some modules have post-upgrade steps you need to perform.
Data Hub Module |
Open this file in a text editor:
server/modules/hub/neo4j.properties and set the
property dbms.allow_format_migration property
to true. The purpose of this property is to protect
against unintentional and irreversible store upgrades. Setting this
property to "true" indicates that you understand the ramifications
of proceeding with an upgrade and have taken the necessary
precautions before proceeding. Restart the Spectrum™ Technology Platform server. The server will upgrade each model.
Examine the file
server/app/repository/logs/wrapper.log for
errors or warning messages. Once all models have been upgraded, go
back to the hub.properties file and comment out
the allow_store_upgrade property.
|