How to change the hostname of an EEM which is configured in High Availability?

Document ID : KB000014192
Last Modified Date : 11/05/2018
Show Technical Document Details
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.

Question:

How to change the hostname of an EEM which is configured in High Availability?

Environment:
This will work on both Window and Linux server with EEM 12.0 and above installed on it.
Answer:

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.
    • Modify itechpoz.dxc file in Directory/dxserver/config/knowledge to reflect new hostname
    • 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.

     
  5. 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.