How to install IoT Hub on Azure Stack Hub

Important

IoT Hub on Azure Stack Hub is currently in preview, and is provided free during the preview period.

This article shows you how to download and install the IoT Hub resource provider, making it available to offer to customers for subscription. The installation process of IoT Hub takes about 2 hours.

Download IoT Hub

If your Azure Stack Hub can access the Azure Marketplace, follow the steps in this section to download and install IoT Hub and its dependencies.

To download IoT Hub for a connected deployment, complete the following steps:

  1. Sign in to Azure Stack Hub administrator portal.

  2. Select Marketplace Management on the left, then select Resource providers, then click on + Add from Azure.

    Marketplace RP search

  3. Filter for "IoT Hub" if necessary, then select the IoT Hub package.

    Marketplace IoT Hub RP

  4. On the IoT Hub package page, select Download

    IoT Hub package details

  5. Wait for the package download to complete. The status will show Downloading, and can take up to 10 minutes.

    IoT Hub package downloading status

  6. Once the package is downloaded, the status will change to Not installed in the Marketplace management page.

    IoT Hub package downloaded not installed

To download IoT Hub for a disconnected or partially connected deployment, first you download the packages to your local machine. After the download completes, you then import them into your Azure Stack Hub instance.

  1. If you haven't already, follow the instructions in Download Marketplace items - Disconnected or partially connected scenarios. Here you download and run the Marketplace Syndication tool, which allows you to download the IoT Hub packages.
  2. After the syndication tool's "Azure Marketplace Items" window opens, find and select "IoT Hub" to download the required packages to your local machine.
  3. Once the download finishes, you import the packages to your Azure Stack Hub instance and publish to Marketplace.

Install IoT Hub

From the Marketplace management page, follow these steps to install the IoT Hub package:

  1. Click on the IoT Hub row, then Start Installation.

    IoT Hub RP waiting for install

  2. Click on Install Prerequisites.

    IoT Hub RP install prerequisites

  3. The status of the installation can be tracked in the notification pane. This step will take about 10 minutes.

    IoT Hub RP install prerequisites installing

  4. Wait for the installation of the prerequisites to complete. This step usually takes somewhere between 5-10 minutes depending on the environment.

    IoT Hub RP prepare secrets

  5. Click on Add Certificates under Prepare Secrets. Provide the pfx certificate created in prerequisites.

    IoT Hub RP prepare secrets - upload certificate

  6. Browse and provide the pfx that was created and the password (the input to the script)

    IoT Hub RP prepare secrets - pick certificate

    IoT Hub RP prepare secrets - provide password

  7. Click on Install under Install Resource Provider.

    IoT Hub RP prepare secrets - complete

  8. Once the installation starts, deployment status can be found in the Marketplace or in the notification pane.

    IoT Hub RP install in progress

  9. Installation can take between 90 – 120 minutes. Wait for the installation to complete.

    IoT Hub RP install complete

    Marketplace RPs - installed RPs

The IoT Hub resource provider is installed successfully! To get started, complete the following steps:

  1. If necessary, follow the instruction to create a plan, offers, and subscription.

  2. If a subscription already exists, update the associated offer/plan to include Microsoft.Devices service. Go to Plan -> Choose the plan to update -> Add Service and quota.

  3. Add Microsoft.Devices Service and click Save.

    Add IoT Hub service to plan

  4. You are all set! IoT Hubs can now be created.

Using IoT Hub

To learn how to use IoT Hub, refer to the Azure IoT Hub documentation.

Next steps

To learn more about managing IoT Hub on Azure Stack Hub, see How to manage IoT Hub on Azure Stack Hub.