How to install IoT Hub on Azure Stack Hub
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:
Sign in to Azure Stack Hub administrator portal.
Select Marketplace Management on the left, then select Resource providers, then click on + Add from Azure.
Filter for "IoT Hub" if necessary, then select the IoT Hub package.
On the IoT Hub package page, select Download
Wait for the package download to complete. The status will show Downloading, and can take up to 10 minutes.
Once the package is downloaded, the status will change to Not installed in the Marketplace management page.
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.
- 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.
- After the syndication tool's "Azure Marketplace Items" window opens, find and select "IoT Hub" to download the required packages to your local machine.
- 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:
Click on the IoT Hub row, then Start Installation.
Click on Install Prerequisites.
The status of the installation can be tracked in the notification pane. This step will take about 10 minutes.
Wait for the installation of the prerequisites to complete. This step usually takes somewhere between 5-10 minutes depending on the environment.
Click on Add Certificates under Prepare Secrets. Provide the pfx certificate created in prerequisites.
Browse and provide the pfx that was created and the password (the input to the script)
Click on Install under Install Resource Provider.
Once the installation starts, deployment status can be found in the Marketplace or in the notification pane.
Installation can take between 90 – 120 minutes. Wait for the installation to complete.
The IoT Hub resource provider is installed successfully! To get started, complete the following steps:
If necessary, follow the instruction to create a plan, offers, and subscription.
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.
Add Microsoft.Devices Service and click Save.
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.
To learn more about managing IoT Hub on Azure Stack Hub, see How to manage IoT Hub on Azure Stack Hub.