DH2i DxEnterprise 19.5 Software: RHEL/CentOS Installation Quickstart Guide

Download the PDF

RHEL/CentOS Installation

This quick start guide describes how to install DxEnterprise on a Red Hat Enterprise Linux or CentOS server. Using this guide, the user will install DxEnterprise dependencies and software, then join a second server (node) into a cluster.

Configure Server and Install Dependencies

  1. Update the server using the command sudo yum update. If prompted to confirm, enter Y.
  2. Ensure that the hostname is set and unique using the hostname command.
    • To rename the server, run sudo hostnamectl set-hostname <name>. The server must be restarted for the change to take effect.
  3. Install Microsoft .NET 3.1 Runtime using installation instructions from Microsoft. There are different instructions for Red Hat and CentOS servers.
  4. OPTIONAL: Set host resolution for all servers (nodes) that will be participating in the cluster using sudo nano /etc/hosts. Write the IP address and hostname of the servers to the file and save.

Install and Configure DxEnterprise

  1. Place a copy of the DxEnterprise RPM package in a local directory on the server.
  2. Run the command sudo rpm -Uvh dxenterprise-<version>.x86_64.rpm, substituting <version> for the version already present in the file name.
  3. Activate the server using the command sudo dxcli activate-server.

    Syntax

    dxcli activate-server <key> [node]

    Parameters

    Name Description Required
    key The license key. True
    node The name of the node (comma-separated list of multiples). False

    Example

    dxcli activate-server AAAA-BBBB-CCCC-DDDD

  4. Set the cluster passkey using the command sudo dxcli cluster-set-secret.

    Syntax

    dxcli cluster-set-secret

    Parameters

    Interactive only.

    Example

    dxcli cluster-set-secret

  5. OPTIONAL: DxEnterprise can utilize NAT matchmaking to easily connect servers across the internet. Use the command sudo dxcli set-otpk to set a One-Time PassKey for the cluster. The passkey expires one hour after creation by default.

    NOTE: To use this feature, the license must have NAT enabled. To inquire about license status, visit DH2i’s Client Portal or run the command sudo dxcli get-producttype and look for NAT listed among the features.

    Syntax

    dxcli set-otpk [ttl] [otpk]

    Parameters

    Name Description Required
    ttl The time the key will expire. False
    otpk The One-Time PassKey in base64. False

    Example

    dxcli set-otpk

Setup Second Node and Join to Cluster

  1. Complete all the steps in the Configure Server and Install Dependencies section for the second node.
  2. Complete steps 1-3 in the Install and Configure DxEnterprise section for the second node.
  3. Join the second node to the cluster using sudo dxcli join-cluster and follow the prompts. When asked to use a NAT proxy, select Y if an OTPK was set or N if not. Enter the OTPK (or IP address of the first server and the cluster passkey) to join the cluster.

    Syntax

    dxcli join-cluster

    Parameters

    Interactive only.

    Example

    dxcli join-cluster

References

Download the PDF