Skip to main content
Version: v22.0

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:

    • RHEL 7, 8 or 9
    • CentOS 7
    • Ubuntu 16.04, 18.04, 20.04 or 22.04
  • 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 perparing the node and installing DxEnterprise.

Update Server and Install Dependencies

  1. Update the server. If prompted to confirm, enter Y.

    sudo yum update
  2. Install Microsoft .NET Runtime 6.0 using installation instructions from Microsoft:

  3. Install the remaining DxEnterprise dependencies.

    sudo yum install zip gdisk

Install DxEnterprise

  1. Install the repository configuration file.

    info

    Replace the <distro> parameter in the example below with rhel7, centos7, rhel8 or rhel9 to install the correct package for your OS.

    sudo yum install https://repos.dh2i.com/<distro>/retail/repo.rpm
  2. Install the product.

    sudo yum 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

  1. Activate the server using the command sudo dxcli activate-server.

    Example

    sudo dxcli activate-server AAAA-BBBB-CCCC-DDDD --accept-eula
  2. Set the cluster passkey using the command sudo dxcli cluster-set-secret.

    Example

    sudo dxcli cluster-set-secret
    tip

    The non-interactive version of this command is sudo dxcli cluster-set-secret-ex.

  3. 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.

    caution

    The 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

  1. Complete all the steps in the Installation section for the second node.

  2. Activate the server using the command sudo dxcli activate-server.

    Example

    sudo dxcli activate-server AAAA-BBBB-CCCC-DDDD --accept-eula
  3. 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
    tip

    The non-interactive version of this command is sudo dxcli join-cluster-ex.

Additional Information