How to remove a SpectroSERVER Landscape in Spectrum

Products

• Spectrum
• Network Observability

Issue/Introduction

We are decommissioning a SpectroSERVER.  How can we remove this landscape in Spectrum so that it does not show in the OneClick client anymore?

Resolution

Make sure that the all Spectrum processes are stopped on the machine you are decommissioning. On that box you can run the following as root/sudo:

systemctl stop processd

Once processd is stopped and/or the VM is disabled/deleted:

1. Remove the SpectroSERVER name from the Primary OneClick Administration page.

   a. Log into the OneClick web page as an ADMIN user
   b. Click on the Administration link
   c. Click on the Landscapes link
   d. Select the landscape to remove by checking the box to the left of the landscape in the list
   e. Click on the Remove button

If you are unable to remove it because you receive an error, continue with step 2 and once step 2 is complete, try step 1 again.

2. Remove the landscape from the landscape map

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

NOTE:  You must run these commands on the MLS. 

   b. If on Windows, start a bash shell by running "bash -login"
   c. cd to the $SPECROOT/SS directory and enter the following command where <LH> is the landscape handle to remove and precedence is the precedence of the entry.  

../SS-Tools/MapUpdate -remove <LH> -precedence <PRECEDENCE value>

The default precedence is 10 for a primary SS and 20 for a secondary fault tolerant SS.

If you are decommissioning both the primary and secondary servers in a Fault Tolerant configuration, you would run this command two times.  First you will run it for the secondary:

For example, using a landscape handle of 0x4000000 the primary SS has precedence 10 and the secondary has precedence 20.

Remove the precedence 20 entry first:

../SS-Tools/MapUpdate -remove 0x4000000 - p 20

Run MapUpdate -v to verify it has been removed.  If it is not removed, be patient.  This process can take many minutes if you have many SpectroSERVERs in the map as every single landscape needs to be updated.

Once you have confirmed the 0x4000000 with precedence 20 has been removed, run the command to remove the entry for the primary:

../SS-Tools/MapUpdate -remove 0x4000000 - p 10

Again, run MapUpdate -v to verify it has been removed.

NOTE: If you have that landscapes SpectroSERVER hostname listed in the .hostrc file of another SpectroSERVER, you should remove that entry as well as in the machines etc/hosts file.

After removing it from the landscape map, it may take up to 10 minutes to be reflected in OneClick.

Additional Information

Reference the "MapUpdate" section of the documentation for more information.