Skip to main content

Task 03: Network Configuration Validation

Implementation Part 7

DOCUMENT CATEGORY: Implementation Runbook
SCOPE: Every node of a deployed Azure Local cluster
PURPOSE: Check the host network from the nodes
MASTER REFERENCE: Host network requirements for Azure Local

Status: Active

Part 6 task 03 validates the network and RDMA for the acceptance test. This task is the repeatable evidence run for the handover and after changes. 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 checked, and a name the nodes must resolve
azure.locationThe region of the endpoint list (the host names the nodes must resolve, and with -TestExternalConnectivity reach on 443). The list is the one documented list of the toolkit

Execution Options​

PowerShell on a cluster machine​

On each node:

Get-NetAdapter; Get-VMSwitch; Get-VMSwitchTeam; Get-NetIntent; Get-NetAdapterRdma
Get-ClusterNetwork; Resolve-DnsName <cluster name>

Validation​

  • Exit code 0
  • Every cluster network is Up, every node reaches every other node, RDMA is enabled on the storage adapters

Troubleshooting​

IssueCauseResolution
Failed to check virtual switchesThe Hyper-V role or the switch is missingCheck the Network ATC intent deployment (Phase 06 task 09)
No RDMA-enabled adapters found (warning)RDMA is off, or the adapters do not support itGet-NetAdapterRdma; see Part 6 task 03
A name does not resolve from the nodeDNS servers of the node are wrongCheck the DNS servers of the management adapter

PreviousUpNext
Task 02: Arc ConnectivityPart 7 IndexTask 04: Storage Performance

Version Control​

VersionDateAuthorChanges
1.0.02026-11-15Azure Local CloudInitial release. The script reads cluster.name and azure.location from infrastructure.yml, takes its endpoints from the shared list and ends with exit code 1 when a check fails