DH2i DxEnterprise 21.0 Software: AWS AMI for Linux Quick Start Guide

Download the PDF

AWS AMIs

This quick start guide describes how to configure DH2i’s pay-as-you-go DxEnterprise Linux images available on AWS. Using this guide, the user will configure DxEnterprise on two servers (nodes) and join the second node into a cluster.

Prerequisites

  • An AWS Virtual Machine (VM) with DxEnterprise pre-installed. To create a DxEnterprise VM using a Marketplace Image, search for “DxEnterprise” in the Marketplace using the AWS search bar.
  • A second DxEnterprise VM is required for joining two nodes into a cluster.

Configure DxEnterprise

  1. Use an SSH client to connect to the first server.
  2. Set the hostname for the instance by running sudo hostnamectl set-hostname <new_hostname>.
  3. Run the setup.sh script to configure DxEnterprise and activate the server.

    Syntax

    sudo bash /opt/dh2i/bin/setup.sh

  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.

    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. Use an SSH client to connect to the second server.
  2. Complete steps 2-3 of the Configure DxEnterprise section for the second node.
  3. 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

  4. Read the following docs for more information about configuring the cluster:

References

Download the PDF