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: azure-local/deploy/deployment-arc-register-configurator-app.md
+22-20Lines changed: 22 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Configurator application for Azure Local (preview)
3
-
description: Learn how to use the Configurator application to o bootstrap and Arc register the Azure Local machines. (Preview)
3
+
description: Learn how to use the Configurator application to bootstrap and Arc register the Azure Local machines. (Preview)
4
4
author: alkohli
5
5
ms.author: alkohli
6
6
ms.topic: how-to
@@ -15,7 +15,7 @@ ms.service: azure-local
15
15
16
16
This article describes how to use the Configurator app to bootstrap and register the machines you plan to include in your Azure Local instance.
17
17
18
-
You can use the Configurator app or Azure CLI to register your machines. Use the Configurator app if you intend to deploy some sites with a few machines per site.
18
+
You can use the Configurator app or [Azure CLI](./deployment-arc-register-server-permissions.md) to register your machines. If you plan to deploy a few machines per site, use the Configurator app.
@@ -92,23 +92,23 @@ Before you begin, make sure that you complete the following prerequisites:
92
92
93
93
Follow these steps to configure network settings and connect the machines to Azure. Start this action a few minutes after you turn on the machine.
94
94
95
-
1. Open the Configurator app. Sign into the machine using the machine serial number.
95
+
1. Open the Configurator app. Enter the machine serial number and select **Next**.
96
96
97
97
:::image type="content" source="media/deployment-arc-register-configurator-app/access-the-device-1.png" alt-text="Screenshot of the machine serial number dialog in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/access-the-device-1.png":::
98
98
99
99
1. Sign in to the machine with local administrator credentials.
100
100
101
101
:::image type="content" source="media/deployment-arc-register-configurator-app/access-the-device-2.png" alt-text="Screenshot of the password in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/access-the-device-2.png":::
102
102
103
-
1. On the Azure Arc agent setup page, select **Start**.
103
+
1. On the **Azure Arc agent setup** page, select **Start**.
104
104
105
105
:::image type="content" source="media/deployment-arc-register-configurator-app/start-setup-1.png" alt-text="Screenshot of the Azure Arc agent setup page with Start selected in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/start-setup-1.png":::
106
106
107
-
1. On the **Prerequisites** tab, verify that the minimum requirements are met.
107
+
1. On the **Prerequisites** tab, verify that the minimum requirements are met and then select **Next**.
108
108
109
109
:::image type="content" source="media/deployment-arc-register-configurator-app/prerequisites-1.png" alt-text="Screenshot of the Prerequisites tab in the Configurator app for Azure Local when all the prerequisites are met." lightbox="media/deployment-arc-register-configurator-app/prerequisites-1.png":::
110
110
111
-
If a requirement isn't met, the app displays a warning icon. Resolve the issue before you proceed.
111
+
If a requirement isn't met, the app displays a warning icon. Resolve the issue before you proceed. For more information, see [Troubleshooting](#troubleshooting).
112
112
113
113
:::image type="content" source="media/deployment-arc-register-configurator-app/prerequisites-2.png" alt-text="Screenshot of the Prerequisites tab in the Configurator app for Azure Local when one of the prerequisites isn't met." lightbox="media/deployment-arc-register-configurator-app/prerequisites-2.png":::
114
114
@@ -129,7 +129,7 @@ Follow these steps to configure network settings and connect the machines to Azu
129
129
130
130
:::image type="content" source="media/deployment-arc-register-configurator-app/basics-tab-additional-details-1.png" alt-text="Screenshot of the Basics tab with additional details configured in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/basics-tab-additional-details-1.png":::
131
131
132
-
1. Enable **Remote desktop** protocol.
132
+
1. Select **Off** to enable **Remote desktop** protocol.
133
133
134
134
1. Select **Public endpoint** or **Proxy server** as the connectivity method. If selecting a proxy server, provide the proxy URL and the bypass list.
135
135
@@ -141,10 +141,12 @@ Follow these steps to configure network settings and connect the machines to Azu
141
141
142
142
1. Select **Next** on the **Basics** tab.
143
143
144
-
1. On the **Arc agent setup** tab, under **Arc agent details**, specify the following inputs:
144
+
1. On the **Arc agent setup** tab, provide the following inputs:
145
145
146
146
:::image type="content" source="media/deployment-arc-register-configurator-app/arc-agent-setup-tab-1.png" alt-text="Screenshot of the Arc agent setup tab in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/arc-agent-setup-tab-1.png":::
147
147
148
+
1. The **Cloud type** is populated automatically as `Azure`.
149
+
148
150
1. Enter a **Subscription ID** to register the machine.
149
151
150
152
1. Provide a **Resource group** name. This resource group contains the machine and system resources that you create.
@@ -154,21 +156,21 @@ Follow these steps to configure network settings and connect the machines to Azu
154
156
> [!IMPORTANT]
155
157
> Specify the region with spaces removed. For example, specify the East US region as `EastUS`.
156
158
157
-
1. The **Cloud type** is populated automatically as `Azure`.
158
-
159
159
1. Provide a **Tenant ID**. The tenant ID is the directory ID of your Microsoft Entra tenant. To get the tenant ID, see [Find your Microsoft Entra tenant](/azure/azure-portal/get-subscription-tenant-id).
160
160
161
161
1. If you set up an Azure Arc gateway, specify the Arc gateway ID. This is the resource ID of the Arc gateway that you set up. For more information, see [About Azure Arc gateways](./deployment-azure-arc-gateway-overview.md).
162
162
163
-
> [!IMPORTANT]
164
-
> Make sure to verify all the inputs before you proceed. Any incorrect inputs here might result in a setup failure.
163
+
> [!IMPORTANT]
164
+
> Make sure to verify all the inputs before you proceed. Any incorrect inputs here might result in a setup failure.
165
165
166
-
1. On the **Arc agent setup** tab, select **Next**.
166
+
1. Select **Next**.
167
167
168
168
1. On the **Review and apply** tab, verify machine details. To modify any settings, go back. If satisfied with the current settings, select **Finish**. If you changed the hostname, your machines boot up automatically at this point and you must sign in again.
169
169
170
170
:::image type="content" source="media/deployment-arc-register-configurator-app/review-apply-tab-1.png" alt-text="Screenshot of the Review and apply tab in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/review-apply-tab-1.png":::
171
171
172
+
### Step 2: Complete registration of machines to Azure
173
+
172
174
1. Wait for the configuration to complete. First, machine details are uploaded followed by registration of the machines to Azure.
173
175
174
176
1. During the Arc registration process, you must authenticate with your Azure account. The app displays a code that you must enter in the URL, displayed in the app, in order to authenticate. Follow the instructions to complete the authentication process.
@@ -179,7 +181,7 @@ Follow these steps to configure network settings and connect the machines to Azu
179
181
180
182
1. Repeat all steps on the other machines until the Arc configuration succeeds. Select the **Open in Azure portal** link.
181
183
182
-
## Step 2: Verify machines are connected to Arc
184
+
## Step 3: Verify machines are connected to Arc
183
185
184
186
1. In the Azure portal, go to the resource group for bootstrapping.
185
187
@@ -189,9 +191,9 @@ Follow these steps to configure network settings and connect the machines to Azu
189
191
190
192
You might need to collect logs or diagnose problems if you encounter any issues while using the app to configure machines. You can use the following methods to troubleshoot:
191
193
192
-
1. Get logs from a machine.
193
-
1. Run diagnostic tests.
194
-
1. Collect a Support package.
194
+
- Get logs from a machine.
195
+
- Run diagnostic tests.
196
+
- Collect a Support package.
195
197
196
198
### Get logs if the app is inaccessible
197
199
@@ -205,7 +207,7 @@ To diagnose and troubleshoot any machine issues related to hardware, time server
205
207
206
208
1. Select the help icon in the top-right corner of the app to open the **Support + troubleshooting** pane.
207
209
208
-
1. Select **Run diagnostic tests**. The diagnostic tests check the health of the machine hardware, time server, and the network connectivity. The tests also check the status of the Azure Arc agent.
210
+
1. Select **Run tests**. The diagnostic tests check the health of the machine hardware, time server, and the network connectivity. The tests also check the status of the Azure Arc agent.
209
211
210
212
:::image type="content" source="media/deployment-arc-register-configurator-app/run-diagnostics-tests-1.png" alt-text="Screenshot that shows the Support and troubleshooting pane with Run diagnostic tests selected."lightbox="media/deployment-arc-register-configurator-app/run-diagnostics-tests-1.png":::
211
213
@@ -221,11 +223,11 @@ Here's a table that describes the diagnostic tests:
221
223
| Web proxy (if configured) | This test validates the web proxy configuration of the machine. |
222
224
| Time sync | This test validates the machine time settings and checks that the time server configured on the machine is valid and accessible. |
223
225
| Azure Arc agent | This test validates the Azure Arc agent is installed and running on the machine. |
224
-
| Environment checker | The Environment Checker tool runs a series of tests to evaluate the deployment readiness of your environment for Azure Local deployment including those for connectivity, hardware, Active Directory, network, and Arc integration. For more information, see [Evaluate the deployment readiness of your environment for Azure Local](../manage/use-environment-checker.md#about-the-environment-checker-tool) |
226
+
| Environment checker | The Environment Checker tool runs a series of tests to evaluate the deployment readiness of your environment for Azure Local deployment including those for connectivity, hardware, Active Directory, network, and Arc integration. For more information, see [Evaluate the deployment readiness of your environment for Azure Local](../manage/use-environment-checker.md#about-the-environment-checker-tool). |
225
227
226
228
### Collect a Support package from the app
227
229
228
-
A log package is composed of all the relevant logs that can help Microsoft Support troubleshoot any machine issues. You can generate a log package via the app. Follow these steps to collect a Support package from the app:
230
+
A Support package is composed of all the relevant logs that can help Microsoft Support troubleshoot any machine issues. You can generate a Support package via the app. Follow these steps to collect a Support package:
229
231
230
232
1. Select the help icon in the top-right corner of the app to open the **Support + troubleshooting** pane. Select **Create** to begin support package collection. The package collection could take several minutes.
0 commit comments