5.1.1. Installation Requirements

Engineering Knowledge Manager

Installation Guide | Chapter 5: Installing an EKM Server | 5.1. Installing a New EKM Server |

5.1. Installing a New EKM Server |  | 5.1.2. Running ANSYS EKM Server Product Installation
Prev |  | Next

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

- It is required that all cluster nodes be set up on the same operating system architecture (Windows or Linux).

- It is required that one (and only one) cluster node in the cluster be designated as the EKM cluster primary node.

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

- It is required that each cluster node on the same server host use a different JBoss port offset.

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:

- Set up the default database server: MySQL: Choose this to set up the default MySQL database server as the cluster database server.

- Use an existing database server: Choose this to specify the connection information for an existing 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.

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.