Skip to main content
Version: v23.0

AWS Amazon Machine Images for Linux Quick Start Guide

Introduction​

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 for joining two nodes into a cluster.

Configure DxEnterprise on the First Node​

  1. Use an SSH client to connect to the first server.

  2. Set the hostname for the instance by running the command hostnamectl set-hostname <new_hostname>.

  3. Run the setup.sh script to start DxEnterprise services and activate the server.

    bash /opt/dh2i/bin/setup.sh

  4. Use the command dxcli set-otpk to set a One-Time PassKey for the cluster. The passkey expires one hour after creation by default.

    Example

    dxcli set-otpk

  5. Optional: Set the cluster passkey using the command dxcli cluster-set-secret.

    info

    Setting a cluster passkey is not required when doing NAT joins. However, a cluster passkey is still required for remote cluster management.

    Example

    dxcli cluster-set-secret
    tip

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

Setup Second Node and Join to Cluster​

  1. Use an SSH client to connect to the second server.

  2. Complete step two of the previous section for the second node.

  3. Join the second node to the cluster using dxcli join-cluster and follow the prompts. Select Y when prompted to join via NAT proxy. Enter the OTPK to join the cluster.

    Example

    dxcli join-cluster
    info

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

Next Steps​

Additional Information​