Linux Installation Quick Start Guide
Introduction
This quick start guide describes how to install DxEnterprise on a Linux server. Using this guide, the user will install DxEnterprise dependencies and software, then join a second server (node) into a cluster.
Prerequisites
-
Two physical or virtual machines running any mix of:
-
Red Hat Enterprise Linux (RHEL) 7, 8 or 9
-
CentOS 7
-
Ubuntu 16.04, 18.04, 20.04 or 22.04
-
SUSE Linux Enterprise Server (SLES) 15
-
-
A valid DxEnterprise license. A fully featured Developer Edition is available free for non-production use. To purchase DxEnterprise software for production workloads, visit the DH2i Store.
-
Ensure the server hostname is set and unique.
-
Set host resolution for all servers (agents) that will be participating in the group by adding their entries to DNS or the hosts file located at
/etc/hosts
.
Installation
This section covers preparing the node and installing DxEnterprise.
Update Server and Install Dependencies
-
Update the server. If prompted to confirm, enter Y.
- Red Hat/CentOS
- Ubuntu
- SLES
sudo yum update
sudo apt update
sudo apt upgradesudo zypper refresh
sudo zypper update -
Install Microsoft .NET Runtime 6.0 using installation instructions from Microsoft:
-
Install the remaining DxEnterprise dependencies.
- Red Hat/CentOS
- Ubuntu
- SLES
sudo yum install zip gdisk
sudo apt update
sudo apt install zip gdisksudo zypper refresh
sudo zypper install zip gptfdisk
Install DxEnterprise
- Red Hat/CentOS
- Ubuntu
- SLES
-
Install the repository configuration file.
infoReplace the
<distro>
parameter in the example below withrhel7
,centos7
,rhel8
orrhel9
to install the correct package for your OS.sudo yum install https://repos.dh2i.com/<distro>/retail/repo.rpm
-
Install the product.
sudo yum install dxenterprise
-
Download the repository configuration file.
wget https://repos.dh2i.com/dists/bionic/retail/repo.deb
-
Install and remove the repository configuration file.
sudo dpkg -i repo.deb
sudo rm repo.deb -
Update the Ubuntu package list.
sudo apt-get update
-
Install the product.
sudo apt-get install dxenterprise
-
Import the public repository GPG key.
rpm --import https://repos.dh2i.com/public.gpg
-
Install the repository configuration file.
sudo zypper install https://repos.dh2i.com/sles15/retail/repo.rpm
-
Install the product.
sudo zypper install dxenterprise
Setup DxEnterprise and Create a Cluster
This section describes how to configure DxEnterprise after installation and setup a two node cluster.
Configure the First Cluster Member
-
Activate the server using the command
sudo dxcli activate-server
.Example
sudo dxcli activate-server AAAA-BBBB-CCCC-DDDD --accept-eula
-
Set the cluster passkey using the command
sudo dxcli cluster-set-secret
.Example
sudo dxcli cluster-set-secret
tipThe non-interactive version of this command is
sudo dxcli cluster-set-secret-ex
. -
Optional: DxEnterprise can utilize NAT Matchmaking Service to easily connect servers across the internet. Use the command
sudo dxcli set-otpk
to set a One-Time PassKey for the cluster. By default, the passkey expires after one hour.cautionThe DxEnterprise license must have NAT enabled to use this feature. To inquire about license status, visit DH2i’s Client Portal or run the command
dxcli get-producttype
and look for NAT listed among the features.Example
sudo dxcli set-otpk
Configure Additional Cluster Members
-
Complete all the steps in the Installation section for the second node.
-
Activate the server using the command
sudo dxcli activate-server
.Example
sudo dxcli activate-server AAAA-BBBB-CCCC-DDDD --accept-eula
-
Join the second node to the cluster using the
sudo dxcli join-cluster
command 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. Use the default NAT proxy of match.dh2i.com and enter the OTPK to join the cluster.
Example
sudo dxcli join-cluster
tipThe non-interactive version of this command is
sudo dxcli join-cluster-ex
.