Azure IoT Application Deployment Using the ZEDEDA GUI
The Azure IoT application can be deployed in the following two ways:
- Automatic–The end-to-end integration with Azure without interacting with the Azure portal.
- Manual–This integration involves toggling between the ZEDEDA Cloud and Azure portals. The two variations for manual mode are:
- with Trust Platform Module (TPM)
- without TPM
Note: Automatic deployment is the recommended mode.
Note: This document mainly focuses on the TPM-based Azure IoT application manual deployment.
Manual Deployment with TPM
Following are the steps to deploy the Azure IoT application through ZEDEDA Cloud manually. After you log in to ZEDEDA Cloud:
- Step 1 > Go to Edge Nodes list
Click on 'Edge Nodes' from the left navigation to go to the already available Edge Nodes list.
- Step 2 > Select Edge Node
Click on the edge node to deploy the Azure IoT application.
- Step 3 > Look at basic info details
Click on the 'Basic Info' tab.
- Step 4 > Look at the security section.
Scroll down to the security section to find the 'Endorsement Key' field. Click on 'Copy' to copy the endorsement key.
- Step 6 > Login to the Azure portal
You have to shift the screen from ZEDEDA Cloud to the Azure portal. Enter the Azure login credentials. To get more details on obtaining the Azure credentials and some of the other Azure IoT-related details, click here.
- Step 7 > Device Provisioning Service (DPS)
Search for 'dps' in the search window.
- Step 8 > Manage Enrollment
- Step 9 > Individual Enrollments
Click on manage Enrollment on the left navigation and then on individual Enrollment to create a new Enrollment.
- Step 10 > Create Enrollment
Click on 'Add individual Enrollment.'
Fill in all the mandatory sections displayed in the 'Add Enrollment' form.
- Step 11 > Populate endorsement key
Paste the 'Endorsement key' copied from the ZEDEDA Cloud screen under the 'Security' section of the 'Basic info' tab.
- Step 12 > Fill up the necessary attributes.
Type the 'Registration ID' in the appropriate field.
- Step 13 > Save
- Step 14 > Verify success
You can see an 'Enrolled Successfully' toast message appearing on the top right corner of the screen.
- Step 15 > View in the Enrollment list
The same Enrollment can also be seen in the list with registration ID. Click on the created Enrollment.
- Step 16 > Copy the required information.
The DPS overview section has the essential details. Copy the 'ID Scope' value. Also, keep the registration ID and symmetric key info handy.
- Step 17 > Switch back to ZEDEDA Cloud
Click on Edge App Instances from the left navigation.
- Step 18 > Start with edge application instance creation
Click the add () icon at the top right corner to trigger the new 'Add Edge App Instance' wizard.
Note: The deployment details for the Azure IoT application are the main focus here. Hence the wizard steps, other than step 4 (Custom Configuration), are not enumerated in this document. For more detailed steps of the wizard, click here.
- Step 19 > Edge application and edge node details
Fill in the necessary details and click on the 'Next' button.
- Step 20 > Edge application instance identity
Fill in the necessary details and click on the 'Next' button.
- Step 21 > Adapters and networks
Fill in the necessary details and click on the 'Next' button.
- Step 22 > Custom configuration
Paste the 'ID Scope' value (copied from the Azure screen in step 17) in the 'scope_id' field, along with 'registration_id' and 'symmentric_key.' Click on the 'Next' button.
-
Step 23 > Deploy
Review all the options you have selected and click the 'Deploy' button.
-
Step 24 > Notification message
The Edge Application is deployed on the selected Edge Node when you click on the' Deploy' button. A notification showing the status of deployment appears in a Toast message, as follows:
Edge App Instance: test has been added.
-
Step 25 > Verify edge application instance list
The newly added Edge App Instance appears in the list view. The Edge App Instances are sorted by their names. The colored dot indicates the Run State to the Edge Application Instance name's left. The colored dots with the state is as represented in the table:
Legends | Description |
The Edge Application Instance is working fine. | |
The Edge Application Instance is stopped. | |
EVE has received the configuration details of the Edge Application Instance, and the process of installing is in progress. | |
If the ZEDEDA Cloud does not hear from the Edge Application Instance or EVE for 3 minutes, it puts the instance in this state. | |
ZEDEDA Cloud shows this state in the following two cases:
1) when ZEDEDA Cloud creates metadata of the instance.
2) when EVE reports an invalid state.
|
|
Could be any reason other than the ones described in this table. |