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

Engineering Knowledge Manager

Installation Guide | Chapter 15: Appendices |

15.18. Appendix R: Changing the EKM Cluster Name |  | ANSYS EKM Troubleshooting Guide
Prev |  | Next

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

Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Prev | Up / Contents | Next

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