Task 01: Validate SDN Prerequisites
DOCUMENT CATEGORY: Runbook
SCOPE: SDN prerequisite validation
PURPOSE: Verify cluster meets SDN requirements
MASTER REFERENCE: Microsoft Learn - SDN Overview
Status: Active
Overview
Before enabling SDN on Azure Local, you must verify that your cluster meets all prerequisites including version requirements, network intent configuration, and workload compatibility.
Prerequisites Checklist
Version Requirements
| Requirement | Minimum Version |
|---|---|
| Azure Local | 2601 |
| OS Build | 26100.xxxx |
| Arc Agent | Latest |
Network Intent Compatibility
SDN enabled by Arc only supports specific Network ATC configurations. Verify your intent matches one of these patterns:
| Pattern | Description | Storage Connectivity |
|---|---|---|
| Group All Traffic | Single intent for all traffic | Switched only |
| Management + Compute with Separate Storage | 2 intents | Switched or Switchless (≤4 nodes) |
| Fully Disaggregated | Up to 3 separate intents | Switched or Switchless (≤4 nodes) |
Workload Compatibility
| Workload | SDN Compatible |
|---|---|
| Azure Local VMs (deployed from Azure) | ✅ Yes |
| Hyper-V VMs (deployed locally) | ❌ No - Use on-premises SDN |
| AKS on Azure Local | ❌ No |
| Multi-cast applications | ❌ No |
Execution Options
- Azure Portal
- Orchestrated Script
Steps
- Navigate to Azure Portal → Azure Arc → Azure Local
- Select your cluster resource
- Go to Overview and verify:
- Version: 2601 or later
- Connection Status: Connected
Network ATC intent configuration and OS build version are not visible in the Azure Portal. You must use PowerShell (Direct Script or Orchestrated Script) to validate these prerequisites. The portal can only confirm cluster version and Arc connectivity.
Verification (Portal Only)
Document the following from the portal:
- Cluster version is 2601+
- Arc connection is active
For full validation, use the Direct Script or Orchestrated Script tab to also verify:
- OS build (26100.xxxx+)
- Network intent compatibility
- AKS workload check
PowerShell
No script in this task folder.
Invoke-SdnPrerequisites-Orchestrated.ps1is a placeholder: it printsNOT IMPLEMENTED, changes nothing and exits with code 3. The earlierTest-SdnPrerequisites.ps1is removed.Enable-ArcSdn.ps1checks the prerequisites Microsoft Learn lists and plans under-WhatIf.
Script
| Script | What it does |
|---|---|
scripts/deploy/04-cluster-deployment/phase-06-post-deployment/task-01-deploy-sdn/powershell/Enable-ArcSdn.ps1 | Turns on SDN enabled by Azure Arc when sdn.enabled of infrastructure.yml is true. Under -WhatIf it checks the OS build, the DNS record and the intent layout, and changes nothing. See Deploy SDN. |
Run
./Enable-ArcSdn.ps1 -InfrastructureFile ./infrastructure.yml -WhatIf
Validation Checklist
Complete this checklist before proceeding to SDN enablement:
| Requirement | Status | Notes |
|---|---|---|
| Azure Local version 2601+ | ☐ | |
| OS build 26100.xxxx+ | ☐ | |
| Arc connection active | ☐ | |
| Network intent compatible | ☐ | Document pattern used |
| No AKS workloads | ☐ | |
| No existing on-premises SDN | ☐ |
Troubleshooting
| Issue | Resolution |
|---|---|
| Version too old | Upgrade Azure Local to 2601+ |
| Arc not connected | Run Sync-AzureStackHCI and verify connectivity |
| Incompatible network intent | Reconfigure Network ATC before enabling SDN |
| AKS workloads present | Cannot enable SDN - AKS not supported |
| Existing SDN via WAC/SDN Express | Cannot migrate - choose one method |
Next Steps
If all prerequisites are met, proceed to Post-Deployment: Deploy SDN.
Scripts for this task are located in the azurelocal-toolkit repository under scripts/deploy/ in the appropriate task folder.
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.
Navigation
| Previous | Up | Next |
|---|---|---|
| ← Phase 01: SDN Operations | Phase 01: SDN Operations | Task 02: Configure NSGs → |
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2026-03-24 | AzureLocal | Initial release |
| 1.1.0 | 2026-04-01 | AzureLocal | Align naming conventions, remove consulting language |
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.
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2025-03-25 | AzureLocal | Initial release |
| 1.1.0 | 2026-04-01 | AzureLocal | Align naming conventions, remove consulting language |