Skip to main content

Phase 02: OS Installation

Runbook Azure Dell

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.

PathWhat it isNext
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 ProvisioningAzure 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.

Zero-touch provisioning: azurelocal-ztp

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.

Proven on Dell AX-760 with iDRAC 7.30. Not Microsoft-supported.


Path comparison​

AspectManual (ISO)Simplified provisioning (preview)
Status✅ GA, production supported⚠️ Preview, East US only
OS installationBy hand through the iDRAC or BMC consoleBy Azure
Physical accessiDRAC virtual mediaA USB stick per machine, or none with azurelocal-ztp
Host nameYou set it in Phase 03Set by provisioning
OEM drivers and SBEIn the OEM image, or you install themYou install them (Task 06), or the Phase 03 automated run does
Network configurationPhase 03DHCP 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 registrationPhase 04Done by provisioning
Arc machine nameThe host name<device-id>-1, see the known issue
Arc gateway✅ Supported❌ Not supported in the preview
Validated hardwareAll Azure Local catalog hardwareDell AX-650/750, Lenovo MX650 V3/V4, HPE DL360 Gen11
Recommendation

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)​

TaskDescriptionDuration
1Delete and Recreate Virtual Disk on Dell BOSS Card15 min
2Mount and Verify Dell Gold Image ISO15 min
3Manual OS Installation30–45 min
4Verify OS Deployment15 min

Start at the Manual OS Installation overview.


Path 2: Simplified Machine Provisioning (Preview)​

By hand, in the portal​

TaskDescriptionDuration
1Create USB Installation Media15 min
2Prepare Machines30 min per machine
3Provision Machines from Azure15 min + wait
4Monitor Machine Setup30–60 min
5Verify Azure Arc Connectivity10 min
6Prepare Machines for Validate30 min

Automated, with azurelocal-ztp​

PageDescription
Automation OverviewDesign, flow chart, stages and gates
PrerequisitesAzure, BMC, network and management host
Operator InputsThe environment file, and where the SBE belongs
Run from a Management HostPlan, run and resume on Windows
Monitor with SonarFollow the run live
Run from a PipelineSelf-hosted runner, approval before Boot
Output and HandoffThe 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.
Before Validate, on either path

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.
Domain membership before deployment

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.


← Phase 01: Hardware Provisioning↑ Cluster DeploymentPhase 03: OS Configuration →

Version Control​

VersionDateAuthorChanges
1.02026-01-31Azure Local CloudInitial document
1.12026-03-04Azure Local CloudFix frontmatter, badges, stage references, standards alignment
2.02026-11-06Azure Local CloudSplit into two paths: Manual OS Installation and Simplified Machine Provisioning; azurelocal-ztp call-out; simplified Task 06
2.12026-11-08Azure Local CloudAligned to Learn 2610: OS build 26100.33650, do-not list, optional domain join before deployment