DH2i DxEnterprise 20.0 Software: RHEL/CentOS Installation Quick Start Guide
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.
Prerequisites
The following requirements must be met before continuing with this guide:
- A physical or virtual machine running RHEL/CentOS 7 or 8. A second machine is required for joining two nodes into a cluster.
Configure Server and Install Dependencies
- Update the server using the command sudo yum update. If prompted to confirm, enter Y.
- 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.
- Install Microsoft .NET 3.1 Runtime using installation instructions from Microsoft. There are different instructions for Red Hat and CentOS servers.
- Install remaining DxEnterprise dependencies by running sudo yum install zip udisks2.
- 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 DxEnterprise
- Download the DxEnterprise repository configuration file by running the command sudo wget -O /etc/yum.repos.d/dh2i.repo https://repos.dh2i.com/<distro>/retail/repo.conf.
NOTE: Replace the <distro> parameter with rhel7, centos7, or rhel8 to download the correct .conf file. For CentOS 8, use rhel8.
- Run the command sudo yum install -y dxenterprise.
Configure DxEnterprise
- 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
- 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
- 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
- Complete all the steps in the Configure Server and Install Dependencies section for the second node.
- Complete the Install DxEnterprise section and step one of the Configure DxEnterprise section for the second node.
- Join the second node to the cluster using sudo dxcli join-cluster and follow the prompts.
- If an OTPK was not set for the cluster, select N when prompted to join via NAT proxy. Enter the IP address and cluster passkey of the first server to join the cluster.
- If an OTPK was set for the cluster, select Y when prompted to join via NAT proxy. Enter the OTPK to join the cluster.
Syntax
dxcli join-cluster
Parameters
Interactive only.
Example
dxcli join-cluster