5.1.1. Installation Requirements

An EKM server requires one or more EKM cluster nodes, and a cluster database server. During installation you will set up a cluster database server and one or more cluster nodes.

Cluster nodes are set up one at a time using the ANSYS EKM Server product installation. Cluster nodes must meet the following requirements:

When installing more than one cluster node on the same server host, the following additional requirements apply:

To set up a cluster node, follow the instructions in Running ANSYS EKM Server Product Installation, observing the following special instructions:

When setting up a cluster node, the Database Server Type step applies to the cluster database server:

Although the product installation will prompt you to enter these settings, these guidelines will help you understand them ahead of time:

  1. The cluster name identifies the cluster that the cluster node will be a member of.

  2. The cluster node name identifies the name of the cluster node within the cluster. Specify a unique cluster node name (also referred to as “cluster node ID”) for each cluster node.

  3. One cluster node must be designated as the primary node. This will usually be the first cluster node you install.

  4. When installing a non-primary node, provide the IP address of the primary cluster node.

  5. If multiple cluster nodes are installed on the same server host, specify a unique JBoss port offset for each cluster node.

  6. The base directory for the EKM server must be a located on a file share on the cluster file server—this directory will be accessed by all cluster nodes.

  7. The base directory for the EKM cluster node must be unique for each cluster node. This directory can be located on local storage on the server host, or on a file share on the cluster file server.

  8. The shared path for the EKM data directory must be located on a file share on the cluster file server—this directory will be accessed by all cluster nodes.

  9. The EKM job data directory must be located on a file share on the cluster file server—this directory will be accessed by all cluster nodes.

  10. When configuring the EKM database server, specify the connection information needed to connect to the cluster database server.


Important:  When configuring the EKM database server, provide one of the following valid values for the hostname:

  • The Fully-Qualified Domain Name (FQDN) of the cluster database server, such as ekmClusterDb.yourdomain.com

  • The network-accessible IP address of the cluster database server, such as 192.168.1.2

An invalid value will result in an inoperable cluster. Examples of invalid values include:

  • localhost

  • Any IP address that is not network accessible, such as 127.0.0.1

  • Any hostname that is not fully-qualified, such as ekmClusterDb

Each cluster node MUST be provided with identical EKM database server configuration. These requirements apply to all cluster nodes, including those installed on the same host as the cluster database server.



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