DH2i DxEnterprise 21.0 Software: Azure Marketplace Image for Linux Quick Start Guide

Download the PDF

Azure Marketplace Images for Linux

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

Prerequisites

  • An Azure Virtual Machine (VM) with DxEnterprise pre-installed. To create a DxEnterprise VM using a Marketplace Image, visit the Azure Marketplace and search for “DxEnterprise.”
  • 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. Run the setup.sh script to start DxEnterprise services.

    Syntax

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

  3. (BYOL images only) Activate the server using the command sudo dxcli activate-server.

    Syntax

    dxcli activate-server <key> [node]

    Parameters

    Name Description Required
    key The license key. True
    node The name of the node (comma-separated list of multiples). False

    Example

    dxcli activate-server AAAA-BBBB-CCCC-DDDD

  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.

    NOTE: To use this feature, the license must have NAT enabled; pay-as-you-go Marketplace images come with NAT. For BYOL users wanting to inquire about license status, visit DH2i’s Client Portal or run the command sudo dxcli get-producttype and look for NAT listed among the features.

    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 step two (and step three for BYOL images) 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. To further configure the cluster, reference some of the following docs:

References

Download the PDF