Skip to main content

Task 02: Arc Connectivity Validation

Implementation Part 7

DOCUMENT CATEGORY: Implementation Runbook
SCOPE: Every node of a deployed Azure Local cluster
PURPOSE: Check the Arc agent, its extensions and the Arc endpoints from the nodes themselves
MASTER REFERENCE: Azure Connected Machine agent CLI reference

Status: Active

What Azure shows about the Arc machines (status, extensions, identity) is Phase 04, Task 04, which has its own Azure CLI script. This task is the node side: what the machine itself reports and can reach. That is why it has no Azure CLI script. It changes nothing.


Values from infrastructure.yml​

The values for this task come from infrastructure.yml (schema 5). Every key, with its type, default and example, is in the variables reference.

KeyWhat the script does with it
cluster.nameThe cluster whose nodes (those that are Up) are asked
azure.locationThe region of the endpoint list. The list is the one documented list of the toolkit (Learn: Firewall requirements for Azure Local); the script has no host of its own

Execution Options​

PowerShell on a cluster machine​

On each node:

& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" show
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" extension list
Test-NetConnection -ComputerName <endpoint host> -Port 443

Validation​

  • Every node: Agent is Passed (Connected)
  • Every node: Endpoints is Passed
  • Extensions is Passed, or the warning is understood (they install some time after the registration)

Troubleshooting​

IssueCauseResolution
Endpoints fails for one hostA firewall or proxy blocks 443Open the host (Learn: Firewall requirements for Azure Local). The Arc gateway and a proxy change the path: the TCP probe only describes a direct path
Agent is DisconnectedThe agent cannot reach Azure, or the machine was deleted in Azureazcmagent show on the node shows the error
azure.location is missingThe region is not in the fileSet azure.location

PreviousUpNext
Task 01: Cluster HealthPart 7 IndexTask 03: Network Configuration

Version Control​

VersionDateAuthorChanges
1.0.02026-11-15Azure Local CloudInitial release. The script was rewritten to the toolkit rules: no host of its own, no Azure call, exit codes 0, 1 and 2