15.19. Appendix S: Changing an EKM Cluster Node IP Address

When an EKM cluster node is installed using ANSYS EKM Server product installation, the EKM cluster node is configured to use one of the non-loopback IP addresses on the server host. If the IP address of the server host changes, or the server host has multiple IP addresses and you wish to configure the EKM cluster node to use a different one than was configured during product installation, you may change the IP address of the cluster node by following these steps:

  1. Stop the EKM cluster node.

  2. Edit the control script: EKM_NODE_ROOT182/bin/ekm_env.(cmd|sh)

    Change the values of the JBOSS_PUBLIC_IP, JBOSS_PRIVATE_IP and JBOSS_MANAGEMENT_IP environment variables to the new IP address, as show in bold:

    Windows:

    rem JBoss Public IP
    set JBOSS_PUBLIC_IP=192.168.1.5
    
    rem JBoss Private IP
    set JBOSS_PRIVATE_IP=192.168.1.5
    
    rem JBoss Management IP
    set JBOSS_MANAGEMENT_IP=192.168.1.5

    Linux:

    # JBoss Public IP
    export JBOSS_PUBLIC_IP=192.168.1.5
    
    # JBoss Private IP
    export JBOSS_PRIVATE_IP=192.168.1.5
    
    # JBoss Management IP
    export JBOSS_MANAGEMENT_IP=192.168.1.5
  3. (Windows only) Edit the Java Service Wrapper configuration:

    JBOSS_HOME/domain/configuration/wrapper.conf

    1. Change the values of the JBOSS_PUBLIC_IP, JBOSS_PRIVATE_IP and JBOSS_MANAGEMENT_IP environment variables to the new IP address, as shown in bold:

      JBOSS_PUBLIC_IP=192.168.1.5
      JBOSS_PRIVATE_IP=192.168.1.5
      JBOSS_MANAGEMENT_IP=192.168.1.5
    2. Unregister the EKM cluster node service using the service un-registration script:

      EKM_NODE_ROOT182/bin/unregister_ekm_service.cmd

    3. Register the EKM cluster node service using the service registration script:

      EKM_NODE_ROOT182/bin/register_ekm_service.cmd

  4. Start the EKM cluster node.

  5. If the EKM cluster node whose IP address you changed is the primary node, you must complete the following steps on each non-primary node:

    1. Stop the EKM cluster node.

    2. Edit the JBoss host-controller configuration (see JBoss Domain Mode and Configuration).

    3. Under the domain-controller element, edit the remote element and set the value of the host attribute to the new IP address of the primary node:

      <domain-controller>
          <remote host="192.168.1.5" port="${jboss.domain.master.port:9999}"
               security-realm="ManagementRealm" />
      </domain-controller>
    4. Start the EKM cluster node.


Release 18.2 - © ANSYS, Inc. All rights reserved.