DH2i DxEnterprise 21.0 Software: Azure Marketplace Image for Linux Quick Start Guide
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
- Use an SSH client to connect to the first server.
- Run the setup.sh script to start DxEnterprise services.
Syntax
sudo bash /opt/dh2i/bin/setup.sh
- (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
- 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
- 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
- Use an SSH client to connect to the second server.
- Complete step two (and step three for BYOL images) of the Configure DxEnterprise section for the second node.
- 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
- To further configure the cluster, reference some of the following docs: