How to change the landscape handle of an unpopulated database in Spectrum?

Products

• CA Spectrum

Issue/Introduction

How to change the landscape handle of an unpopulated database in Spectrum?

Environment

Release: All supported Spectrum versions

Component: SPCCSS - SpectroSERVER Core

Resolution

There can be a requirement where you may need to change the landscape handle value of an unpopulated Spectrum database. This document explains how to change the landscape handle of an unpopulated Spectrum database. Please follow the below steps:

1. Log into the SpectroSERVER system as the user that owns the Spectrum installation

2. If on Windows, start a bash shell by running "bash -login"

3. cd to the $SPECROOT/SS directory and enter the following command to change the landscape handle of the SpectroSERVER database where <LH> is the landscape handle:

../SS-Tools/lh_set <LH>

NOTE: There is no method for changing the landscape handle of a populated SpectroSERVER database.

4. cd to the $SPECROOT/SS/DDM directory and enter the following command to change the landscape handle of the Archive Manager (DDM) database where <LH> is the landscape handle:

./ddm_load -i <LH>

NOTE: Running the "ddm_load -i" command will reinitialize the DDM database from scratch  (ie remove all information in the database) and re-stamp the database with the new landscape handle. There is no method for changing the landscape handle of a populated DDM database. 

Additional Information

An unpopulated database is a database that has NO Spectrum models and only consists of the catalog. Examples of an unpopulated database are:

The database after a fresh new installation of Spectrum where the SpectroSERVER has NOT been started yet.

The database after loading and re-initializing the catalog ONLY from a database save. For example, running the following command from the $SPECROOT/SS directory:

../SS-Tools/SSdbload -ic databasesave.SSdb


Please reference the "SSdbload" section of the documentation for more information

Please reference the "Change a Landscape Handle" section of the documentation for more information.