Azure IoT App Deployment

1. Azure IoT Application Deployment Using ZedUI

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

1.1. Manual Deployment with TPM

Following are the steps to deploy the Azure IoT application through ZedControl manually. After you log in to ZedControl:
  • Step 1 > Go to Edge Nodes list
Click on 'Edge Nodes' from the left navigation to go to the already available Edge Nodes list.
AZI_4_Screen_1.png
 
  • Step 2 > Select Edge Node
Click on the edge node to deploy the Azure IoT application.
AZI_4_Screen_2.png
 
  • Step 3 > Look at basic info details
Click on the 'Basic Info' tab.
AZI_4_Screen_3.png
 
  • 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.
AZI_4_Screen_4.png
 
  • Step 5 > Observe notification
A toast message is displayed, as shown below.
Text has been copied to clipboard.
AZI_4_Screen_5.png
 
  • Step 6 > Login to Azure portal
You have to shift the screen from ZedControl 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.
AZI_4_Screen_6.png
 
  • Step 7 > Device Provisioning Service (DPS)
Search for 'dps' in the search window.
AZI_4_Screen_7.png
 
  • 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.
AZI_4_Screen_8.png
 
  • Step 10 > Create Enrollment
Click on 'Add individual Enrollment.'
AZI_4_Screen_9.png
 
Fill in all the mandatory sections displayed in the 'Add Enrollment' form.
  • Step 11 > Populate endorsement key
Paste the 'Endorsement key' copied from the ZedControl 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.
AZI_4_Screen_10.png
 
  • Step 13 > Save
AZI_4_Screen_11.png
 
  • Step 14 > Verify success
You can see an 'Enrolled Successfully' toast message appearing on the top right corner of the screen.
AZI_4_Screen_12.png
 
  • 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.
AZI_4_Screen_13.png
 
  • 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.
AZI_4_Screen_14.png
 
  • Step 17 > Switch back to ZedControl
Click on Edge App Instances from the left navigation.
AZI_4_Screen_15.png
 
  • Step 18 > Start with edge application instance creation
Click the add (Add_icon.png) 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.
AZI_4_Screen_16.png
 
  • Step 19 > Edge application and edge node details
Fill in the necessary details and click on the 'Next' button.
AZI_4_Screen_17.png
 
  • Step 20 > Edge application instance identity
Fill in the necessary details and click on the 'Next' button.
AZI_4_Screen_18.png
 
  • Step 21 > Adapters and networks
Fill in the necessary details and click on the 'Next' button.
AZI_4_Screen_19.png
 
  • 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 ZedControl does not hear from the Edge Application Instance or EVE for 3 minutes, it puts the instance in this state.
ZedControl shows this state in the following two cases:
1) when ZedControl creates metadata of the instance.
2) when EVE reports an invalid state.
Could be any reason other than the ones described in this table.
 
Was this article helpful?
0 out of 0 found this helpful

Articles in this section