Tutorial: Prepare to deploy Azure Stack Edge Pro with GPU

This tutorial is the first in the series of deployment tutorials that are required to completely deploy Azure Stack Edge Pro with GPU. This tutorial describes how to prepare the Azure portal to deploy an Azure Stack Edge resource.

You need administrator privileges to complete the setup and configuration process. The portal preparation takes less than 10 minutes.

In this tutorial, you learn how to:

  • Create a new resource
  • Get the activation key

Get started

For Azure Stack Edge Pro deployment, you need to first prepare your environment. Once the environment is ready, follow the required steps and if needed, optional steps and procedures to fully deploy the device. The step-by-step deployment instructions indicate when you should perform each of these required and optional steps.

Step Description
Preparation These steps must be completed in preparation for the upcoming deployment.
Deployment configuration checklist Use this checklist to gather and record information before and during the deployment.
Deployment prerequisites These prerequisites validate that the environment is ready for deployment.
Deployment tutorials These tutorials are required to deploy your Azure Stack Edge Pro device in production.
1. Prepare the Azure portal for Azure Stack Edge Pro Create and configure your Azure Stack Edge resource before you install an Azure Stack Box Edge physical device.
2. Install Azure Stack Edge Pro Unpack, rack, and cable the Azure Stack Edge Pro physical device.
3. Connect to Azure Stack Edge Pro Once the device is installed, connect to device local web UI.
4. Configure network settings for Azure Stack Edge Pro Configure network including the compute network and web proxy settings for your device.
5. Configure device settings for Azure Stack Edge Pro Assign a device name and DNS domain, configure update server and device time.
6. Configure security settings for Azure Stack Edge Pro Configure certificates for your device. Use device-generated certificates or bring your own certificates.
7. Activate Azure Stack Edge Pro Use the activation key from service to activate the device. The device is ready to set up SMB or NFS shares or connect via REST.
8. Configure compute Configure the compute role on your device. A Kubernetes cluster is also created.
9A. Transfer data with Edge shares Add shares and connect to shares via SMB or NFS.
9B. Transfer data with Edge storage accounts Add storage accounts and connect to blob storage via REST APIs.

You can now begin to gather information regarding the software configuration for your Azure Stack Edge Pro device.

Deployment configuration checklist

Before you deploy your device, you need to collect information to configure the software on your Azure Stack Edge Pro device. Preparing some of this information ahead of time helps streamline the process of deploying the device in your environment. Use the Azure Stack Edge Pro deployment configuration checklist to note down the configuration details as you deploy your device.


Following are the configuration prerequisites for your Azure Stack Edge resource, your Azure Stack Edge Pro device, and the datacenter network.

For the Azure Stack Edge resource

Before you begin, make sure that:

  • Your Microsoft Azure subscription is enabled for an Azure Stack Edge resource. Make sure that you used a supported subscription such as Microsoft Enterprise Agreement (EA), Cloud Solution Provider (CSP), or Microsoft Azure Sponsorship. Pay-as-you-go subscriptions aren't supported. To identify the type of Azure subscription you have, see What is an Azure offer?.

  • You have owner or contributor access at resource group level for the Azure Stack Edge Pro/Data Box Gateway, IoT Hub, and Azure Storage resources.

    • To create any Azure Stack Edge / Data Box Gateway resource, you should have permissions as a contributor (or higher) scoped at resource group level.
    • You also need to make sure that the Microsoft.DataBoxEdge and MicrosoftKeyVault resource providers are registered. To create any IoT Hub resource, Microsoft.Devices provider should be registered.
      • To register a resource provider, in the Azure portal, go to Home > Subscriptions > Your-subscription > Resource providers.
      • Search for the specific resource provider, for example, Microsoft.DataBoxEdge, and register the resource provider.
    • To create a Storage account resource, again you need contributor or higher access scoped at the resource group level. Azure Storage is by default a registered resource provider.
  • You have admin or user access to Azure¬†Active Directory Graph API for generating activation key or credential operations such as share creation that uses a storage account. For more information, see Azure Active Directory Graph API.

For the Azure Stack Edge Pro device

Before you deploy a physical device, make sure that:

  • You've reviewed the safety information that was included in the shipment package.
  • You have a 1U slot available in a standard 19" rack in your datacenter for rack mounting the device.
  • You have access to a flat, stable, and level work surface where the device can rest safely.
  • The site where you intend to set up the device has standard AC power from an independent source or a rack power distribution unit (PDU) with an uninterruptible power supply (UPS).
  • You have access to a physical device.

For the datacenter network

Before you begin, make sure that:

  • The network in your datacenter is configured per the networking requirements for your Azure Stack Edge Pro device. For more information, see Azure Stack Edge Pro System Requirements.

  • For normal operating conditions of your Azure Stack Edge Pro, you have:

    • A minimum of 10-Mbps download bandwidth to ensure the device stays updated.
    • A minimum of 20-Mbps dedicated upload and download bandwidth to transfer files.

Create a new resource

If you have an existing Azure Stack Edge resource to manage your physical device, skip this step and go to Get the activation key.

To create an Azure Stack Edge resource, take the following steps in the Azure portal.

  1. Use your Microsoft Azure credentials to sign in to the Azure portal at this URL: https://portal.azure.com.

  2. In the left-pane, select + Create a resource. Search for and select Azure Stack Edge / Data Box Gateway. Select Create.

  3. Pick the subscription that you want to use for the Azure Stack Edge Pro device. Select the country to where you want to ship this physical device. Select Show devices.

    Create a resource 1

  4. Select device type. Under Azure Stack Edge Pro, choose Azure Stack Edge Pro with GPU and then choose Select. If you see any issues or are unable to select the device type, go to Troubleshoot order issues.

    Create a resource 3

  5. Based on your business need, you can select Azure Stack Edge Pro with 1 or 2 Graphical Processing Units (GPUs) from Nvidia.

    Create a resource 4

  6. On the Basics tab, enter or select the following Project details.

    Setting Value
    Subscription The subscription is automatically populated based on the earlier selection. Subscription is linked to your billing account.
    Resource group Select an existing group or create a new group.
    Learn more about Azure Resource Groups.
  7. Enter or select the following Instance details.

    Setting Value
    Name A friendly name to identify the resource.
    The name has from 2 to 50 characters containing letters, numbers, and hyphens.
    Name starts and ends with a letter or a number.
    Region For a list of all the regions where the Azure Stack Edge resource is available, see Azure products available by region. If using Azure Government, all the government regions are available as shown in the Azure regions.
    Choose a location closest to the geographical region where you want to deploy your device.

    Create a resource 5

  8. Select Next: Shipping address.

    • If you already have a device, select the combo box for I already have a device.

      Create a resource 6

    • If this is the new device that you're ordering, enter the contact name, company, address to ship the device, and contact information.

      Create a resource 7

  9. Select Next: Tags. Optionally provide tags to categorize resources and consolidate billing. Select Next: Review + create.

  10. On the Review + create tab, review the Pricing details, Terms of use, and the details for your resource. Select the combo box for I have reviewed the privacy terms.

    Create a resource 8

    You are also notified that during the resource creation, a Managed Service Identity (MSI) is enabled that lets you authenticate to cloud services. This identity exists for as long as the resource exists.

  11. Select Create.

    The resource creation takes a few minutes. An MSI is also created that lets the Azure Stack Edge device communicate with the resource provider in Azure.

    After the resource is successfully created and deployed, you're notified. Select Go to resource.

    Go to the Azure Stack Edge Pro resource

After the order is placed, Microsoft reviews the order and contacts you (via email) with shipping details.


If you want to create multiple orders at one time or clone an existing order, you can use the scripts in Azure Samples. For more information, see the README file.

If you run into any issues during the order process, see Troubleshoot order issues.

Get the activation key

After the Azure Stack Edge resource is up and running, you'll need to get the activation key. This key is used to activate and connect your Azure Stack Edge Pro device with the resource. You can get this key now while you are in the Azure portal.

  1. Select the resource you created, and select Overview.

  2. In the right pane, enter a name for the Azure Key Vault or accept the default name. The key vault name can be between 3 and 24 characters.

    A key vault is created for each Azure Stack Edge resource that is activated with your device. The key vault lets you store and access secrets, for example, the Channel Integrity Key (CIK) for the service is stored in the key vault.

    Once you've specified a key vault name, select Generate key to create an activation key.

    Get activation key

    Wait a few minutes while the key vault and activation key are created. Select the copy icon to copy the key and save it for later use.


  • The activation key expires three days after it is generated.
  • If the key has expired, generate a new key. The older key is not valid.

Next steps

In this tutorial, you learned about Azure Stack Edge Pro topics such as:

  • Create a new resource
  • Get the activation key

Advance to the next tutorial to learn how to install Azure Stack Edge Pro.