Migrating and Upgrading CA Spectrum

This section contains the following topics:
casp10
This section contains the following topics:
Migrate and Upgrade on Windows
You can migrate the existing 
SpectroSERVER
 database and Archive Manager database and other upgradeable components to a different directory or system, and then upgrade 
CA Spectrum
. This way, you can continue to manage your network with the existing 
CA Spectrum
 version during the installation process.
You cannot move a
CA Spectrum
installation from one system to another or from one directory to another. Instead, first copy or move the
CA Spectrum
databases and then run the installation program to reinstall
CA Spectrum
over the relocated database.
The C:\Program Files\CA directory is automatically created during a first-time installation of
CA Spectrum
.
CA Spectrum
components that are also common to other CA products are intentionally installed into this directory. This directory is automatically updated as needed during a
CA Spectrum
upgrade. Do not remove files from this directory.
Follow these steps:
  1. Delete all remote landscapes, if any exist, from the existing database.
  2. Create a user model from the OneClick Users tab. Name it the same name as the owner of the directory where you are installing the new 
    CA Spectrum
     version.
  3. Preserve the existing SpectroSERVER database (See the topic 'Preserve the existing SpectroSERVER database' on How to Perform In-Place Upgrades page).
     When backing up the 
    SpectroSERVER
     database for migration, include both the modeling catalog and the models. A catalog-only or models-only migration is not supported.
  4. Preserve the CA Spectrum Events and Statistics database (See the topic 'Preserve the CA Spectrum Events and Statistics database' on How to Perform In-Place Upgrades page).
  5. Extract the dbsavefile.SSdb file from the dbsavefile.SSdb.gz file in the SS-DB-Backup directory.
  6. Copy the saved SSdb file to the dbsavefile.SSdb file. If the SSdb file had backup compression enabled, uncompress the SSdb file by running gzip -d <
    database_file.gz
    > and then perform the copy. For example, cp db_20080105_1153.SSdb dbsavefile.SSdb.
    The dbsavefile.SSdb file must not be compressed. If dbsavefile.SSdb is compressed, the database is not migrated during installation.
  7. Create an installation directory, <
    $SPECROOT
    >, for the new version of 
    CA Spectrum
    .
    You cannot install
    CA Spectrum
    into a directory that contains a space anywhere in the path. Spaces within the directory path cause the installation to fail.
  8. Create an SS subdirectory in 
    $SPECROOT
    .
  9. Copy the custom directory from the earlier 
    CA Spectrum
     installation directory to the 
    $SPECROOT
     directory of the upgraded 
    CA Spectrum
     installation.
  10. Copy or FTP (in binary mode) the dbsavefile.SSdb file to the 
    $SPECROOT
    \SS subdirectory.
    Migrating an existing
    SpectroSERVER
    database migrates all of the existing models into the new
    SpectroSERVER
    database when you install a new version of
    CA Spectrum
    . This migration includes the models containing topology views including icon placement, groupings, and annotations.
  11. Create a DDM subdirectory in the SS subdirectory.
  12. Copy or FTP (in binary mode) dbsavefile.tgz to the new 
    $SPECROOT
    \SS\DDM directory.
    The directory structure now resembles the following structure:
    spec--spectrum_upgrade_dir_struct
  13. (Optional) To migrate the OneClick web server, copy the contents of the <
    $SPECROOT
    >\custom directories from the computer with the old OneClick web server installation. Paste these contents into the <
    $SPECROOT
    >\custom directories on the computer with the new OneClick web server installation.
Do
not
copy the <
$SPECROOT
>/custom/common/config/custom-jnlp-config.xml file to another computer when you migrate and upgrade
CA Spectrum
. This file can contain memory settings that are not compatible with the computer where you are copying the custom directories.
The mapping of custom background images (<
$SPECROOT
>\custom\images\background) to topology views is maintained in the
SpectroSERVER
database. For more information about the <
$SPECROOT
>\custom directories, see the .
CA Spectrum
 is migrated and upgraded.
Migrate and Upgrade on Linux and Solaris
You can migrate existing 
CA Spectrum
 databases and other upgradeable components to a different directory or system, and then upgrade 
CA Spectrum
. This way, you can continue to manage your network with the existing 
CA Spectrum
 version during the installation process.
Do not move a
CA Spectrum
installation from one system to another or from one directory to another. Instead, first copy or move the
CA Spectrum
database and then run the installation program to reinstall
CA Spectrum
over the relocated database.
The /opt/CA directory is automatically created during a first-time installation of
CA Spectrum
.
CA Spectrum
components that are also common to other CA products are intentionally installed into this directory. This directory is automatically updated as needed during a
CA Spectrum
upgrade. Do not remove files from this directory.
Follow these steps:
  1. Delete all remote landscapes, if any exist, from the existing database.
  2. Create a user model from the OneClick Users tab. Name it the same name as the owner of the directory where you are installing the new 
    CA Spectrum
     version.
  3. Preserve the existing SpectroSERVER database (See the topic 'Preserve the existing SpectroSERVER database' on How to Perform In-Place Upgrades page).
     When backing up the 
    SpectroSERVER
     database for migration, include both the modeling catalog and the models. A catalog-only or models-only migration is not supported.
  4. Preserve the CA Spectrum Events and Statistics database (See the topic 'Preserve the CA Spectrum Events and Statistics database' on How to Perform In-Place Upgrades page).
  5. Extract the dbsavefile.SSdb file from the dbsavefile.SSdb.gz file in the SS-DB-Backup directory.
  6. Copy the saved SSdb file to the dbsavefile.SSdb file. If SSdb had backup compression enabled, first uncompress the SSdb by running gzip -d <
    database_file.gz
    > and then perform the copy. For example, cp db_20080105_1153.SSdb dbsavefile.SSdb.
    The dbsavefile.SSdb file must not be compressed. If dbsavefile.SSdb is compressed, the database is not migrated during installation.
  7. Create an installation directory, <
    $SPECROOT
    >, for the new version of 
    CA Spectrum
    , along with subdirectories for the two database files as follows:
    mkdir -p <$SPECROOT>/SS/DDM
    Do not use /opt/SPECTRUM as the installation directory name. This location is reserved for a directory that is automatically created during installation. Also, ensure that the directory owner name is the same name as the owner of the directory where you are installing the new
    CA Spectrum
    version.
    You cannot install
    CA Spectrum
    into a directory that contains a space anywhere in the path. Spaces within the directory path cause the installation to fail.
  8. Copy or FTP (in binary mode) the dbsavefile.SSdb file to the <
    $SPECROOT
    >/SS directory.
    Migrating an existing
    SpectroSERVER
    database migrates all the existing models into the new
    SpectroSERVER
    database when you install a new version of
    CA Spectrum
    . This migration includes the models containing topology views including icon placement, groupings, and annotations.
  9. Copy or FTP (in binary mode) the dbsavefile.tgz file to the <
    $SPECROOT
    >/SS/DDM directory.
    The directory structure now resembles the following structure:
    spec--spectrum_upgrade_dir_struct
  10. (Optional) To migrate the OneClick web server, copy the contents of the <
    $SPECROOT
    >/custom directories from the computer with the old OneClick web server installation. Paste these contents into the <
    $SPECROOT
    >/custom directories on the computer with the new OneClick web server installation.
    Do
    not
    copy the <
    $SPECROOT
    >/custom/common/config/custom-jnlp-config.xml file to another computer when you migrate and upgrade
    CA Spectrum
    . This file can contain memory settings that are not compatible with the computer where you are copying the custom directories.
    The mapping of custom background images (<
    $SPECROOT
    >/custom/images/background) to topology views is maintained in the
    SpectroSERVER
    database. For more information about the <
    $SPECROOT
    >/custom directories, see the .
CA Spectrum
 is migrated and upgraded.