Skip to content

Commit f0d4c62

Browse files
fix
1 parent cec6256 commit f0d4c62

File tree

1 file changed

+59
-1
lines changed

1 file changed

+59
-1
lines changed

azure-local/deploy/deployment-azure-arc-gateway-use-without-proxy.md

Lines changed: 59 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,11 @@ Make sure the following prerequisites are met before proceeding:
2424

2525
- An Arc gateway resource created in the same subscription as used to deploy Azure Local. For more information, see [Create the Arc gateway resource in Azure](deployment-azure-arc-gateway-overview.md#create-the-arc-gateway-resource-in-azure).
2626

27-
## Run the initialization script
27+
## Step 1: Get the ArcGatewayID
28+
29+
You need the Arc gateway ID (ArcGatewayID) from Azure to run the registration script on Azure Local machines. You can find the Arc gateway ID on the Azure portal overview page of the resource.
30+
31+
## Step 2: Register new machines in Azure Arc
2832

2933
To use the Arc gateway feature for Azure Local systems without a proxy, only use the `ArcGatewayID` parameter.
3034

@@ -57,6 +61,60 @@ $id = (Get-AzContext).Account.Id
5761
Invoke-AzStackHciArcInitialization -SubscriptionID $Subscription -ResourceGroup $RG -TenantID $Tenant -Region australiaeast -Cloud "AzureCloud" -ArmAccessToken $ARMtoken -AccountID $id -ArcGatewayID $ArcgwId
5862
```
5963

64+
## Step 3: Start Azure Local cloud deployment
65+
66+
Once the Azure Local machines are registered in Azure Arc and all the extensions are installed, you can start deployment from Azure portal or using the ARM templates that are documented in these articles:
67+
68+
- [Deploy an Azure Local instance using the Azure portal](deploy-via-portal.md).
69+
70+
- [Azure Resource Manager template deployment for Azure Local, version 23H2](deployment-azure-resource-manager-template.md).
71+
72+
## Step 4: Verify that the setup succeeded
73+
74+
Once the deployment validation starts, you can connect to the first Azure Local machine from your system and open the Arc gateway log to monitor which endpoints are redirected to the Arc gateway and which ones continue using your firewall.
75+
76+
You can find the Arc gateway log at: *c:\programdata\AzureConnectedMAchineAgent\Log\arcproxy.log*.
77+
78+
:::image type="content" source="./media/deployment-connect-nodes-to-arc-gateway/arc-gateway-log.png" alt-text="Screenshot that shows the Arc gateway log using manual method." lightbox="./media/deployment-connect-nodes-to-arc-gateway/arc-gateway-log.png":::
79+
80+
To check the Arc agent configuration and verify that it is using the Arc gateway, run the following command: `c:\program files\AzureConnectedMachineAgent>.\azcmagent show`
81+
82+
The result should show the following values:
83+
84+
- **Agent version** is **1.45** or above.
85+
86+
- **Agent Status** is **Connected**.
87+
88+
- **Using HTTPS Proxy** is empty when Arc gateway isn't in use. It should show as `http://localhost:40343` when the Arc gateway is enabled.
89+
90+
- **Upstream Proxy** should be empty because you are not using any enterprise proxy.
91+
92+
- **Azure Arc Proxy** shows as **stopped** when Arc gateway isn't in use, and **running** when the Arc gateway is enabled.
93+
94+
The Arc agent without the Arc gateway:
95+
96+
:::image type="content" source="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-without-gateway.png" alt-text="Screenshot that shows the Arc agent without gateway using manual method." lightbox="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-without-gateway.png":::
97+
98+
The Arc agent using the Arc gateway:
99+
100+
:::image type="content" source="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-with-gateway.png" alt-text="Screenshot that shows the Arc agent with gateway using manual method." lightbox="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-with-gateway.png":::
101+
102+
Additionally, to verify that the setup successful, you can run the following command: `c:\program files\AzureConnectedMachineAgent>.\azcmagent check`.
103+
104+
The response should indicate that `connection.type` is set to `gateway`, and the **Reachable** column should indicate **true** for all URLs, as shown:
105+
106+
The Arc agent without the Arc gateway:
107+
108+
:::image type="content" source="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-without-gateway-2.png" alt-text="Screenshot that shows the Arc agent without gateway 2 using manual method." lightbox="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-without-gateway-2.png":::
109+
110+
The Arc agent with the Arc gateway enabled:
111+
112+
:::image type="content" source="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-with-gateway-2.png" alt-text="Screenshot that shows the Arc agent with gateway 2 using manual method." lightbox="./media/deployment-connect-nodes-to-arc-gateway/arc-agent-without-gateway-2.png":::
113+
114+
You can also audit your gateway traffic by viewing the gateway router logs.
115+
116+
To view gateway router logs on Windows, run the `azcmagent logs` command in PowerShell. In the resulting .zip file, the logs are located in the *C:\ProgramData\Microsoft\ArcGatewayRouter* folder.
117+
60118
## Next steps
61119

62120
- [Get support for deployment issues](../manage/get-support-for-deployment-issues.md)

0 commit comments

Comments
 (0)