Steps to change EEM host name (Version 12.0)

Products

• CA Directory
• CA Service Management - Service Desk Manager
• CA Process Automation Base

Issue/Introduction

This documents describes the steps to be performed to change the EEM hostname which is configured in High Availability mode and has applications registered on it.

Environment

EEM 12.x

Resolution

The following steps need to be performed to if you want to change the hostname of EEM server which is configured for High Availability and has application instances registered on it.

1. Take a back up of application instances: If the hostname steps are successful , all registered applications will continue to work and a restore of application instance is not required. The backup is an optional step.
   
   
   • Login to EEM server using the application instance.
   • Click on Configure->EEM Server ->Export Application
   • Select the options you wish to export and click Export.
   • Save the file
   
   
   
2. Remove the registered server from failover:
   
   
   • Open the command prompt from the primary server, and navigate to the EiamInstallation\bin location.
   • Execute the following command:
     java -jar eiam-clustersetup.jar
   • Execute the following command:
     remove
   • message "Type the Failover Hostname" appears.
     The available secondary servers are displayed. Each secondary server is numbered, starting from [0]. A message "select hostname" appears.
   • Type the number corresponding to the secondary server you want to delete, and press Enter.
     A confirmation message "Are you sure you want to continue? [Y/N]" appears.
   • Type Y and press Enter.
   
   
   
3. Change the hostname
   
   
   • Run the command net stop igateway
   • Run the command net stop dxserver ALL
   • Modify server.xml in EmbeddedEntitlementsManager/config/server to reflect the new hostname. It can be done by doing an Edit/replace of old hostname with the new hostname.
   • It is preferred to run the Directory commands using Unix account dsa  (example:  su - dsa) 
   • Modify itechpoz.dxc file in Directory/dxserver/config/knowledge to reflect new hostname
   • type command:   dxsyntax   to verify syntax   and delete dxserver/config/knowledge/<secondary-eem-hostname>.dxc  files
   • update itechpoz.dxg  file in /dxserver/config/knowledge folder  to remove entry to  dxserver/config/knowledge/<secondary-eem-hostname>.dxc  files.  save
   • Modify iPoz.conf file in iTechnology folder to reflect new hostname
   • Run the command net start dxserver
   • Run the command net start igateway
   
   
   
4. Add Failover
   
   
   • On the primary server, open the command prompt
   • Navigate to the EiamInstallation\bin location.
   • Execute the following command:
     java -jar eiam-clustersetup.jar
   • Execute the following command:
     resetprimary
     Note: You must reset a primary server only once in a failover setup.
     The primary server is reset and is configured.
   • Execute the following command:
     add
     The message "Enter fully qualified hostname (example.ca.com)" appears.
   • Type the hostname of the secondary server, and press Enter.
     The message "Enter DSA Port [default=509]" appears.
   • Do one of the following steps:
     
     
     1. If you want to accept the default port, press Enter.
     2. If you want to enter a different DSA port, type the port number and press Enter.
     
     A confirmation message "Are you sure you want to continue? [Y/N]" appears.
   • Type Y and press Enter.
     The failover tool starts validating the entered details. After validation, the secondary server is added to the primary server.

 

• Synchronize with Primary server 

• • Open the command prompt from a secondary server, and navigate to the EiamInstallation\bin location.
  • Execute the following command:
    java -jar eiam-clustersetup.jar -p <hostname_of_primaryserver>
  • Execute the following command:
    sync
  • The available secondary servers are displayed. Each secondary server is numbered, starting from [0]. A message "select hostname" appears.
  • Type the number corresponding to the current hostname, and press Enter.
    The failover tool starts synchronization. A confirmation message "Are you sure you want to continue? [Y/N]" appears.
  • Type Y and press Enter.
    The failover tool starts validating the synchronization process. After validation, the secondary server is synchronized with the primary server.