Skip to main content
Version: v22.0

Azure Virtual Machine Extensions Quick Start Guide

Introduction

This quick start guide describes how to install the DxEnterprise extension using the Azure Portal UI and Cloud Shell. Using this guide, the user will add the extension to a new or existing VM deployment using the Azure Portal UI or Cloud Shell. This guide also provides links to other resources for configuring DxEnterprise and creating a cluster.

Prerequisites

  • 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.

Create the VM

Extensions can be added to Azure VMs using the Cloud Portal or Cloud Shell. Three examples are provided below for adding extensions to Azure VMs.

Option 1: Add the Extension to a New VM Using the Azure Portal

  1. Login to the Azure Management Portal.

  2. Search for VM using the search bar at the top of the window and select Virtual Machines.

  3. Select Create > Virtual Machine.

  4. Assign the VM to a resource group and give it a name.

  5. Select a VM base image from the following operating systems:

    • Ubuntu 16.04, 18.04, 20.04 or 22.04.

    • Red Hat Enterprise Linux 7 or 8.

    • Windows 2012, 2012R2, 2016, 2019 or 2022.

  6. Set an SSH keypair or username and password, as needed.

  7. Select Advanced > Select an Extension to Install and choose a DxEnterprise offering from the list of extensions.

  8. Select Review + Create in the bottom-left corner, then select Create.

  9. Proceed to the section titled Configure DxEnterprise and Create a Cluster.

Option 2: Add the Extension to an Existing VM Using the Azure Portal

  1. Login to the Azure Management Portal.

  2. Search or find the VM using the search bar or navigation pane.

  3. Select Extensions under Settings in the left menu.

  4. Select Add.

  5. Choose DxEnterprise from the list of extensions.

  6. Select Create, then Add.

Option 3: Add the Extension to an Existing VM Using the Cloud Shell

The extensions DH2i offers on Azure use the naming convention <product>For<OS>. DxEnterprise is offered on Windows and Linux and use the following extension names:

  • DxEnterpriseForWindows

  • DxEnterpriseForLinux

Choose the extension name that matches the operating system of the VM. To add the extension to the VM, do the following:

  1. Login to the Azure Management Portal.

  2. Select the Cloud Shell icon near the search bar at the top of the window.

  3. Run the following command, substituting the resource group name, VM name, and extension name:

    az vm extension set –resource-group <vm_resource_group> --vm-name <vm_name> --name <extension_name> --publisher Dh2ico

Choose the extension name that matches the operating system of the VM. To add the extension to the VM, do the following:

  1. Login to the Azure Management Portal.

  2. Select Cloud Shell near the search bar at the top of the window.

  3. Run the following command, substituting the resource group name, VM name, and extension name:

    az vm extension set –resource-group <vm_resource_group> --vm-name <vm_name> --name <extension_name> --publisher Dh2ico

Configure DxEnterprise and Create a Cluster

After the DxEnterprise extension is added to the VM, DxEnterprise will need to be configured using the command line (Linux) or UI (Windows). Links are given in the sections below for the appropriate steps.

info

A valid DxEnterprise license is required to continue. See the prerequisites section for more information.

Configure DxEnterprise on the First Node

  1. SSH or RDP to the VM.

  2. Complete the steps in the section titled Configure DxEnterprise... in the Linux and/or Windows installation quick start guide(s).

Setup the Second Node and Join it into the Cluster

  1. Add the DxEnterprise extension to the VM using the instructions from either the “Add the Extension to a New Virtual Machine” or “Add the Extension to an Existing VM Using Cloud Shell” section in this guide above.

  2. SSH or RDP to the VM.

  3. Configure the second node and join it to the existing cluster.

    Complete step one of Configure DxEnterprise and Create a Cluster and step three of Setup Second Node and Join into Cluster from the Linux Installation Quick Start Guide.

Next Steps

Additional Information