| title | description | services | keywords | author | manager | ms.author | ms.reviewer | ms.date | ms.topic | ms.service |
|---|---|---|---|---|---|---|---|---|---|---|
Simulate Azure IoT Edge on Linux | Microsoft Docs |
Install the Azure IoT Edge runtime on a simulated device in Linux, and deploy your first module |
iot-edge |
kgremban |
timlt |
kgremban |
elioda |
10/16/2017 |
article |
iot-edge |
Azure IoT Edge enables you to perform analytics and data processing on your devices, instead of having to push all the data to the cloud. The IoT Edge tutorials demonstrate how to deploy different types of modules, built from Azure services or custom code, but first you need a device to test.
This tutorial walks you through creating a simulated IoT Edge device, then deploying a module that generates sensor data. You learn how to:
The simulated device that you create in this tutorial is a monitor that generates temperature, humidity, and pressure data. The other Azure IoT Edge tutorials build upon the work you do here by deploying modules that analyze the data for business insights.
This tutorial assumes that you're using a computer or virtual machine running Linux to simulate an Internet of Things device. The following services are required to successfully deploy an IoT Edge device:
- Install Docker for Linux and make sure it's running.
- Most Linux distributions, including Ubuntu, already have Python 2.7 installed. Use the following command to make sure that pip is installed:
sudo apt-get install python-pip.
Start the tutorial by creating your IoT Hub.
[!INCLUDE iot-hub-create-hub]
Register an IoT Edge device with your newly created IoT Hub.
[!INCLUDE iot-edge-register-device]
Install and start the Azure IoT Edge runtime on your device.
The IoT Edge runtime is deployed on all IoT Edge devices. It comprises two modules. The IoT Edge agent facilitates deployment and monitoring of modules on the IoT Edge device. The IoT Edge hub manages communications between modules on the IoT Edge device, and between the device and IoT Hub. When you configure the runtime on your new device, only the IoT Edge agent will start at first. The IoT Edge hub comes later when you deploy a module.
On the machine where you'll run the IoT Edge device, download the IoT Edge control script:
sudo pip install -U azure-iot-edge-runtime-ctlConfigure the runtime with your IoT Edge device connection string from the previous section:
sudo iotedgectl setup --connection-string "{device connection string}" --auto-cert-gen-force-no-passwordsStart the runtime:
sudo iotedgectl startCheck Docker to see that the IoT Edge agent is running as a module:
sudo docker ps
Manage your Azure IoT Edge device from the cloud to deploy a module which will send telemetry data to IoT Hub.
[!INCLUDE iot-edge-deploy-module]
In this tutorial, you created a new IoT Edge device and installed the IoT Edge runtime on it. Then, you used the Azure portal to push an IoT Edge module to run on the device without having to make changes to the device itself. In this case, the module that you pushed creates environmental data that you can use for the tutorials.
Open the command prompt on the computer running your simulated device again. Confirm that the module deployed from the cloud is running on your IoT Edge device:
sudo docker ps
View the messages being sent from the tempSensor module to the cloud:
sudo docker logs -f tempSensor
You can also view the telemetry the device is sending by using the IoT Hub explorer tool.
In this tutorial, you created a new IoT Edge device and used the Azure IoT Edge cloud interface to deploy code onto the device. Now, you have a simulated device generating raw data about its environment.
This tutorial is the prerequisite for all of the other IoT Edge tutorials. You can continue on to any of the other tutorials to learn how Azure IoT Edge can help you turn this data into business insights at the edge.
[!div class="nextstepaction"] Develop and deploy C# code as a module