How to remove a landscape after it has been removed from the Spectrum environment.

Document ID : KB000057295
Last Modified Date : 14/02/2018
Show Technical Document Details

SUMMARY:

In a Distributed SpectroSERVER environment, after removing a landscape from the environment, OneClick may still show the removed landscape in red as "Unknown".

We have setup a staging environment to replicate the Production environment, and loaded the SSDB from Production to test (new environment). Our production environment has 3 landscapes, whereas, the test has only 2 . Since I loaded the DB from Prod, the 3rd landscape shows up as 'unknown'. I am not able to delete this landscape from Administration tab in One click, as it was not manually added. Please let me know how to delete this landscape from the new environment. 

INSTRUCTIONS:

OneClick gets the list of landscapes from the landscape map of the SpecroSERVER configured as the Main Location Server Name in the OneClick Administration -> Spectrum Configuration web page. The removed landscape is still listed as a landscape in the landscape map and Location Server cache on this SpectroSERVER. To perminantly remove this landscape from the landscape map and Location Server cache:

 

1. Log into the SpectroSERVER system that is configured as the Main Location Server Name in the OneClick Administration -> Spectrum Configuration web page and open a bash shell

2. cd to the $SPECROOT/SS-Tools directory

3. Enter the following command to view the landscape map:

./MapUpdate -v

4. Find the landscape to be removed and note the landscape handle

5. Enter the following command to remove the landscape from the landscape map where <LH> is the the landscape handle of the landscape to be removed

./MapUpdate -r <LH>

6. Enter the following command to view the Location Server cache:

./HostUpdate -v

7. Find the landscape to be removed and note the landscape handle

8. Enter the following command to remove the landscape from the Location Server cache where <LH> is the the landscape handle of the landscape to be removed

./HostUpdate -r <LH>

9. Restart tomcat on the OneClick server to read in the updated landscape map and Location Server cache

 

ADDITIONAL INFORMATION:

For more information on the MapUpdate and HostUpdate commands, please reference the "CA Spectrum Database Tools" section in the "Database Management Guide" for Spectrum 9.4 and below and the "CA Spectrum Database Tools" section in the Spectrum 10.0 document.