You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-edge/how-to-install-iot-edge-ubuntuvm.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ The Azure IoT Edge runtime is what turns a device into an IoT Edge device. The r
17
17
18
18
To learn more about how the IoT Edge runtime works and what components are included, see [Understand the Azure IoT Edge runtime and its architecture](iot-edge-runtime.md).
19
19
20
-
This article lists the steps to deploy an Ubuntu 18.04 LTS virtual machine with the Azure IoT Edge runtime installed and configured using a pre-supplied device connection string. This is accomplished using a [cloud-init](../virtual-machines/linux/using-cloud-init.md
20
+
This article lists the steps to deploy an Ubuntu 18.04 LTS virtual machine with the Azure IoT Edge runtime installed and configured using a pre-supplied device connection string. The deployment is accomplished using a [cloud-init](../virtual-machines/linux/using-cloud-init.md
21
21
) based [ARM template](../azure-resource-manager/templates/overview.md) maintained in the [iotedge-vm-deploy](https://github.com/Azure/iotedge-vm-deploy) project repository.
22
22
23
23
On first boot, the Ubuntu 18.04 LTS virtual machine [installs the latest version of the Azure IoT Edge runtime via cloud-init](https://github.com/Azure/iotedge-vm-deploy/blob/master/cloud-init.txt). It also sets a supplied connection string before the runtime starts, allowing you to easily configure and connect the IoT Edge device without the need to start an SSH or remote desktop session.
@@ -42,23 +42,23 @@ The [Deploy to Azure Button](../azure-resource-manager/templates/deploy-to-azure
42
42
43
43
**DNS Label Prefix**: A required value of your choosing that is used to prefix the hostname of the virtual machine.
44
44
45
-
**Admin Username**: A username which will be provided root privileges on deployment.
45
+
**Admin Username**: A username, which will be provided root privileges on deployment.
46
46
47
47
**Device Connection String**: A [Device Connection string](how-to-register-device.md) for a device that was created within your intended [IoT Hub](../iot-hub/about-iot-hub.md).
48
48
49
49
**VM Size**: The [size](../cloud-services/cloud-services-sizes-specs.md) of the virtual machine to be deployed
50
50
51
51
**Ubuntu OS Version**: The version of the Ubuntu OS to be installed on the base virtual machine.
52
52
53
-
**Location**: The [geographic region](https://azure.microsoft.com/global-infrastructure/locations/) to deploy the virtual machine into, this defaults to the location of the selected Resource Group.
53
+
**Location**: The [geographic region](https://azure.microsoft.com/global-infrastructure/locations/) to deploy the virtual machine into, this value defaults to the location of the selected Resource Group.
54
54
55
55
**Authentication Type**: Choose **sshPublicKey** or **password** depending on your preference.
56
56
57
57
**Admin Password or Key**: The value of the SSH Public Key or the value of the password depending on the choice of Authentication Type.
58
58
59
59
When all fields have been filled in, select the checkbox at the bottom of the page to accept the terms and select **Purchase** to begin the deployment.
60
60
61
-
1. Verify that the deployment has completed successfully. A virtual machine resource should have been deployed into the selected resource group. Take note of the machine name which should be in the format `vm-0000000000000` and it's associated **DNS Name** which should be in the format `<dnsLabelPrefix>`.`<location>`.cloudapp.azure.com.
61
+
1. Verify that the deployment has completed successfully. A virtual machine resource should have been deployed into the selected resource group. Take note of the machine name, this should be in the format `vm-0000000000000`. Also, take of the associated **DNS Name**, which should be in the format `<dnsLabelPrefix>`.`<location>`.cloudapp.azure.com.
62
62
63
63
The **DNS Name** can be obtained from the **Overview** section of the newly deployed virtual machine within the Azure Portal.
64
64
@@ -90,7 +90,7 @@ The [Deploy to Azure Button](../azure-resource-manager/templates/deploy-to-azure
90
90
91
91
1. Copy the SubscriptionID field for the subscription you'd like to use.
92
92
93
-
1. Set your working subscription with the ID that you just copied:
93
+
1. Set your working subscription with the ID that you copied:
94
94
95
95
```azurecli-interactive
96
96
az account set -s <SubscriptionId>
@@ -104,7 +104,7 @@ The [Deploy to Azure Button](../azure-resource-manager/templates/deploy-to-azure
104
104
105
105
1. Create a new virtual machine:
106
106
107
-
If you would like to use an **authenticationType** of `password` see the example below:
107
+
To use an **authenticationType** of `password`, see the example below:
108
108
109
109
```azurecli-interactive
110
110
az group deployment create \
@@ -118,7 +118,7 @@ The [Deploy to Azure Button](../azure-resource-manager/templates/deploy-to-azure
If you prefer to authenticate with an SSH key you may do so by specifying an **authenticationType** of `sshPublicKey`, then provide the value of the SSH key in the **adminPasswordOrKey** parameter. An example is shown below.
121
+
To authenticate with an SSH key, you may do so by specifying an **authenticationType** of `sshPublicKey`, then provide the value of the SSH key in the **adminPasswordOrKey** parameter. An example is shown below.
122
122
123
123
```azurecli-interactive
124
124
#Generate the SSH Key
@@ -137,7 +137,7 @@ The [Deploy to Azure Button](../azure-resource-manager/templates/deploy-to-azure
137
137
138
138
```
139
139
140
-
1. Verify that the deployment has completed successfully. A virtual machine resource should have been deployed into the selected resource group. Take note of the machine name which should be in the format `vm-0000000000000` and it's associated **DNS Name** which should be in the format `<dnsLabelPrefix>`.`<location>`.cloudapp.azure.com.
140
+
1. Verify that the deployment has completed successfully. A virtual machine resource should have been deployed into the selected resource group. Take note of the machine name, this should be in the format `vm-0000000000000`. Also, take of the associated **DNS Name**, which should be in the format `<dnsLabelPrefix>`.`<location>`.cloudapp.azure.com.
141
141
142
142
The **DNS Name** can be obtained from the **Overview** section of the newly deployed virtual machine within the Azure Portal.
0 commit comments