Skip to main content

Task 04: Verify Arc Registration and Connectivity

DOCUMENT CATEGORY: Runbook SCOPE: Verify that Azure Arc registration is successful and connectivity is establis... PURPOSE: Verify that Azure Arc registration is successful and connectivity is established for all cluster nodes MASTER REFERENCE: Register Azure Local with Azure Arc

Status: Active

Runbook Phase 04 — Arc Registration Azure Local

Status: Production-ready


Overview​

After Arc registration and bootstrap complete, verify that all cluster nodes are properly registered, connected, and ready for Azure Local cluster deployment.

Prerequisites​

RequirementDetails
Arc registrationCompleted via Task 02
Bootstrap statusSucceeded on all nodes (Task 03)
Azure modulesAz.Accounts, Az.ConnectedMachine
Node accessWinRM to all cluster nodes

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.


Verification​

Run on each cluster node to verify the local Arc agent:

# Check Arc agent service
Get-Service himds | Format-Table Name, Status, StartType

# Show Arc agent registration details
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" show

# Test endpoint connectivity through Arc Gateway
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" check

Expected Results​

CheckExpected
himds serviceRunning on every node
azcmagent show → Agent StatusConnected
azcmagent checkAll endpoints reachable
Get-AzConnectedMachine → StatusConnected for every node
Arc GatewayResource ID populated (if using gateway)


Alternatives​

The procedures in this task use the methods shown in the tabs above. The toolkit is PowerShell 7 only and has no Bash scripts. A few tasks that act on Azure also have an Azure CLI script written in PowerShell. The script status page of the toolkit lists which task has which script.

PreviousUpNext
← Task 03: Monitor Bootstrap ProcessPhase 04: Arc Registration---

Troubleshooting​

SymptomResolution
himds service stoppedStart-Service himds — if it fails, check C:\ProgramData\AzureConnectedMachineAgent\Log\himds.log
azcmagent show → DisconnectedRun azcmagent connect again or check network/proxy
azcmagent check fails endpointsVerify firewall rules allow *.guestconfiguration.azure.com, *.his.arc.azure.com
Node missing from Get-AzConnectedMachineRe-run Task 02 registration for that node
Extensions not provisionedExtensions are deployed during cluster deployment — not required at this stage

Azure Portal Verification​

For manual confirmation:

  1. Navigate to Azure Arc → Machines in the Azure Portal
  2. Filter by resource group from infrastructure.yml
  3. Confirm all nodes show Connected status
  4. Click each node → Properties → verify subscription, resource group, and region
  5. If using Arc Gateway: Networking → Gateway configuration → verify gateway resource ID

Navigation: ← Task 03: Monitor Bootstrap | ↑ Phase 04 Index | → Phase 05: Cluster Deployment


Version Control​

VersionDateAuthorChanges
1.0.02025-03-25Azure Local CloudInitial release