15.18. Appendix R: Changing the EKM Cluster Name

Recall from Naming the Cluster and Cluster Nodes that each EKM server on the same LAN must have a unique cluster name. If you encounter a situation where you need to change the cluster name of an EKM server, follow these steps:

  1. Edit the control script: EKM_ROOT182/bin/ekm_env.(cmd|sh)

    Change the value of the EKM_CLUSTER_NAME environment variable to the new EKM cluster name:

    Windows:

    rem EKM Cluster Name
    set EKM_CLUSTER_NAME=ekmservernewname

    Linux:

    # EKM Cluster Name
    export EKM_CLUSTER_NAME=ekmservernewname
  2. (Windows only) On each cluster node, edit the Java Service Wrapper configuration:

    JBOSS_HOME/domain/configuration/wrapper.conf

    Change the value of the EKM_CLUSTER_NAME environment variable to the new EKM cluster name:

    EKM_CLUSTER_NAME=ekmservernewname
  3. On each cluster node, follow the instructions to rename the cluster node service as necessary to reflect the new cluster name, as described in Service Names.

  4. On the cluster database server, follow the instructions to rename the cluster database service as necessary to reflect the new cluster name, as described in Service Names.

  5. Rename any other EKM services as necessary to reflect the new cluster name.


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