Skip to main content
Version: Archive

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 or 8
    • CentOS 7
    • Ubuntu 16.04, 18.04, or 20.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.

Installation

This section guides you through preparing the VM for a DxEnterprise installation.

Update Server and Install Dependencies

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

    yum update
  2. Ensure that the hostname is set and unique using the hostname command. If the server needs to renamed, run the hostnamectl command to rename the server. The server must be restarted for the change to take effect.

    hostnamectl set-hostname <name>
  3. Install Microsoft .NET 3.1 Runtime using installation instructions from Microsoft:

  4. Install the remaining DxEnterprise dependencies.

    yum install zip udisks2

Install DxEnterprise

  1. Download the DxEnterprise repository configuration file.

    info

    Replace the <distro> parameter in the example below with rhel7, centos7, or rhel8 to download the correct .conf file.

    wget -O /etc/yum.repos.d/dh2i.repo https://repos.dh2i.com/<distro>/retail/repo.conf
  2. Install the product.

    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 DxEnterprise

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

    Example

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

    Example

    dxcli cluster-set-secret
    tip

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

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

    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

    dxcli set-otpk

Setup Second Node and Join into Cluster

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

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

    Example

    dxcli activate-server AAAA-BBBB-CCCC-DDDD
  3. Join the second node to the cluster using the 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

    dxcli join-cluster
    tip

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

Additional Information