How to change the Hostname and/or IP Address of a SpectroSERVER or OneClick Web Server

Products

• CA Spectrum
• DX NetOps

Issue/Introduction

We need to change the IP Address and Hostname of our servers running Spectrum. Does Spectrum have any dependencies to the IP Address or Hostname? If so, what are the requirements for making this type of change?

Environment

Release: 20.2, 21.2, 22.2
Component: SPCCSS - SpectroSERVER Core

Resolution

This will have an impact on Spectrum. Although Spectrum is not bound to the IP Address, it does rely heavily on the Hostname and name resolution of all other Spectrum servers in the environment. This is true for a single stand-alone system, or a complex distributed deployment of SPECTRUM.

IP Address Changes:

After you have changed the IP of your SpectroSERVER or OneClick web server, make sure the SpectroSERVER(s) and the OneClick web server(s) can all ping each other by IP.

Likewise, make sure all machines that run Spectrum applications and/or integrations can ping the SpectroSERVER(s) and OneClick server(s) by IP, and vice-versa (make sure the servers can ping the machines running the apps). It might help to add the IPs and hostnames to the /etc/hosts files on all SpectroSERVERs and OneClick web servers. In Windows, the hosts file is in Windows\System32\drivers\etc. Edits to hosts files take effect immediately. Sometimes it takes DNS servers a while to catch up, and less frequently firewall ACLs need to get updated to let traffic through. In the latter case, the pings might succeed, while a firewall might block TCP. If that's the case, just have the ACLs edited to replace the old IPs with the new ones. See the Distributed SpectroSERVER Administrator Guide for details of the ports Spectrum uses.

Your managed devices will need to have the new SpectroSERVER IPs in their trap server lists, and if it's practical, you could remove the old IPs from those lists. You could accomplish this for the devices supported by the Network Configuration Manager (NCM), via an upload task. See the Network Configuration Manager User Guide for information on upload tasks.

After you change the hostname on a SpectroSERVER machine, you need to save, initialize and load the database to stamp it with the new name.

Hostname Changes:

With few exceptions, Spectrum servers communicate via SSAPI and Corba. Both of these only use hostnames (not IP addresses).

The following is a list of files, that must be updated to use the new hostname.

On a SpectroSERVER:

•  $SPECROOT/.hostrc
•  $SPECROOT/.installrc
•  $SPECROOT/UI-CONFIG.<hostname>
•  $SPECROOT/LS/.locrc
•  $SPECROOT/.LocalRegFile
•  $SPECROOT/.corbarc
•  $SPECROOT/.jcorbarc
•  $SPECROOT/SG-Support/CsResource/preferences/ssroe.prf
•  $SPECROOT/vnmsh/.vnmshrc
  
  

On a OneClick Web Server:

•  $SPECROOT/tomcat/webapps/spectrum/META-INF/context.xml
•  $SPECROOT/.hostrc
•  $SPECROOT/.installrc
•  $SPECROOT/UI-CONFIG.<hostname> 
  
  

   <versions 10.4.0 and 10.3.2 only>      Edit the $SPECROOT/tomcat/webapps/spectrum/config/console-menubar.jsp file.

     
   Webtomcat 21.2+:
   
           $SPECROOT/webtomcat/bin/webswing.properties
           $SPECROOT/webtomcat/bin/webswing-admin.properties
               webswing.server.publicUrl
               webswing.server.websocketUrl

               ** Each of the above files contains those 2 url's that have the oneclicks own name

           $SPECROOT/webtomcat/webswing/webswing.config
               adminConsoleUrl

             ** In 21.2 the "args" line should go back to the default as tomcat now passes the host name, some people
                     use to add -host oneClickHostName.xyz.net

Note: If the hostname of the Main Location Server (MLS) is changed, then all SpectroSERVERs and OneClick servers in the distributed environment must be updated.

The link below contains a script that can be used to make the needed changes to all of the above files (except .jcorbarc which will need to be done manually).  It can be run on a SpectroSERVER or a OneClick web server. If you are running the script from a Windows Server, you will need to execute the script from a 'bash -login' shell. CA does not support the script. Extract it and save it in the $SPECROOT/ directory.

Change_Spectrum_Hostname.zip

To run the script:

Stop the SpectroSERVER and processd.

1. Change the hostname on the server.
2. Reboot the Server.
3. Stop processd (go to /lib/SDPM and execute processd --stop, or you can stop the Spectrum processd service in Windows services)
4. From a bash shell, execute the Change_Spectrum_Hostname.pl script as the Spectrum initial owner from the $SPECROOT/ directory.
5. Start processd
6. Restart the SpectroSERVER and/or Tomcat on the OneClick web server.

NOTE: In some instances with Windows systems running the OneClick web server, after the changes and service restarts are completed, connection errors are observed when the OCE server attempts to connect with the SpectroSERVER(s). A full reboot of the Windows OneClick web server should be run to see if it resolves the communications problems.

Additional Information

Distributed SpectroSERVER Administrator Guide
https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/spectrum/22-2/administrating/distributed-spectroserver-administration.html

 

Network Configuration Manager Guide
https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/spectrum/22-2/managing-network/network-configuration-manager.html

OneClick WebApp is not launched since changing the OC hostname
https://knowledge.broadcom.com/external/article?articleId=236614