Phase 02: OS Installation
DOCUMENT CATEGORY: Runbook SCOPE: Azure Local cluster OS installation PURPOSE: Choose the OS installation path and follow its tasks MASTER REFERENCE: Microsoft Learn — Deploy Azure Local
Status: Active
Overview
Phase 02 has two paths. Both end with the Azure Stack HCI OS on every node, but they hand over in different states, so the phases after them differ too.
| Path | What it is | Next |
|---|---|---|
| Manual OS Installation (ISO) | You install from the ISO or your OEM's image on each node through the BMC console. GA. | All of Phase 03, then Phase 04 |
| Simplified Machine Provisioning | Azure installs the OS, sets the host name and registers the machine with Arc. Preview. By hand in the portal, or fully automated with azurelocal-ztp. | Phase 03 OS configuration (the automated run, or simplified provisioning Task 06 by hand). Phase 04 is skipped |
Choose your route has the flow chart for the whole of Part 4 and a decision matrix of every OS step on each path.
Simplified provisioning can run with no one in the rack. The azurelocal-ztp automation boots each machine from a virtual USB over the BMC, collects the ownership vouchers, claims the machines in Azure, waits for the OS install, verifies each management address and puts back any BIOS value it changed for the install, then ends at the Handoff. One command from a Windows management host, or one pipeline. OS configuration follows.
- Documentation: azurelocal.cloud/azurelocal-ztp
- Source: github.com/AzureLocal/azurelocal-ztp
- On this site: Automated route
Proven on Dell AX-760 with iDRAC 7.30. Not Microsoft-supported.
Path comparison
| Aspect | Manual (ISO) | Simplified provisioning (preview) |
|---|---|---|
| Status | ✅ GA, production supported | ⚠️ Preview, East US only |
| OS installation | By hand through the iDRAC or BMC console | By Azure |
| Physical access | iDRAC virtual media | A USB stick per machine, or none with azurelocal-ztp |
| Host name | You set it in Phase 03 | Set by provisioning |
| OEM drivers and SBE | In the OEM image, or you install them | You install them (Task 06), or the Phase 03 automated run does |
| Network configuration | Phase 03 | DHCP from provisioning (a reservation per management MAC, Mode A, is recommended); static IP, one gateway, DNS and time in Task 06 or Phase 03 |
| Azure Arc registration | Phase 04 | Done by provisioning |
| Arc machine name | The host name | <device-id>-1, see the known issue |
| Arc gateway | ✅ Supported | ❌ Not supported in the preview |
| Validated hardware | All Azure Local catalog hardware | Dell AX-650/750, Lenovo MX650 V3/V4, HPE DL360 Gen11 |
Use the manual (ISO) path for production deployments until simplified provisioning reaches GA. Use simplified provisioning for evaluation, and on its validated hardware in East US.
Path 1: Manual OS Installation (ISO)
| Task | Description | Duration |
|---|---|---|
| 1 | Delete and Recreate Virtual Disk on Dell BOSS Card | 15 min |
| 2 | Mount and Verify Dell Gold Image ISO | 15 min |
| 3 | Manual OS Installation | 30–45 min |
| 4 | Verify OS Deployment | 15 min |
Start at the Manual OS Installation overview.
Path 2: Simplified Machine Provisioning (Preview)
By hand, in the portal
| Task | Description | Duration |
|---|---|---|
| 1 | Create USB Installation Media | 15 min |
| 2 | Prepare Machines | 30 min per machine |
| 3 | Provision Machines from Azure | 15 min + wait |
| 4 | Monitor Machine Setup | 30–60 min |
| 5 | Verify Azure Arc Connectivity | 10 min |
| 6 | Prepare Machines for Validate | 30 min |
Automated, with azurelocal-ztp
| Page | Description |
|---|---|
| Automation Overview | Design, flow chart, stages and gates |
| Prerequisites | Azure, BMC, network and management host |
| Operator Inputs | The environment file, and where the SBE belongs |
| Run from a Management Host | Plan, run and resume on Windows |
| Monitor with Sonar | Follow the run live |
| Run from a Pipeline | Self-hosted runner, approval before Boot |
| Output and Handoff | The Handoff, and what OS configuration and cluster deployment take from it |
Both: Troubleshooting and Known Issues.
Workflow
graph TD
A[Phase 01 complete] --> B{Installation path?}
B -->|Manual, ISO| C[Manual Tasks 1 to 4]
C --> D[Phase 03: all OS configuration tasks]
D --> E[Phase 04: Arc registration]
B -->|Simplified, portal| F[Simplified Tasks 1 to 5]
F --> G[Simplified Task 6: prepare for Validate, or Phase 03]
B -->|Simplified, azurelocal-ztp| H[One run: provisioning to the Handoff]
H --> J[Phase 03: automated OS configuration]
E --> I[Phase 05: Cluster deployment]
G --> I
J --> I
Outcome
- Manual path: the OS is on every node. There is no unattended ISO install, so a person does this on each node. Continue with Phase 03, preferably the automated run.
- Simplified path: every machine is Ready to cluster in Azure. With azurelocal-ztp that is the Handoff; run Phase 03 OS configuration next for the OEM drivers, SBE, one static management address, DNS and time (or Task 06 by hand on the portal route). Phase 04 is skipped; continue with Phase 05.
Check Microsoft Learn's OS installation steps and your OEM's deployment guide for your build and hardware.
- Azure Local 2610 runs OS build 26100.33650; use 2610 media and a driver compatible with that build.
- Do not install Windows Updates with SConfig or Azure Update Manager. Updates install during the deployment, and installing them first causes a deployment failure.
- Do not use an underscore in the computer name, and do not rely on inbox NIC drivers.
Leave the machines in a workgroup (the default; the deployment joins them to the domain), or, with Azure Local 2604 or later, join them to the domain first by following Optional: domain join before deployment. Local identity deployments do not use Active Directory, so leave those machines in a workgroup.
Navigation
| ← Phase 01: Hardware Provisioning | ↑ Cluster Deployment | Phase 03: OS Configuration → |
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0 | 2026-01-31 | Azure Local Cloud | Initial document |
| 1.1 | 2026-03-04 | Azure Local Cloud | Fix frontmatter, badges, stage references, standards alignment |
| 2.0 | 2026-11-06 | Azure Local Cloud | Split into two paths: Manual OS Installation and Simplified Machine Provisioning; azurelocal-ztp call-out; simplified Task 06 |
| 2.1 | 2026-11-08 | Azure Local Cloud | Aligned to Learn 2610: OS build 26100.33650, do-not list, optional domain join before deployment |