Skip to main content
Version: 2604 (Preview)

Phase 03: OS Configuration

Runbook Platform

DOCUMENT CATEGORY: Runbook
SCOPE: Post-installation OS configuration
PURPOSE: Prepare nodes for Azure Arc registration
MASTER REFERENCE: Microsoft Learn - Prepare Active Directory

Status: Active Estimated Time: 45-60 minutes (all nodes) Last Updated: 2026-01-31


Overview

This stage configures the Azure Stack HCI operating system on all cluster nodes with the settings required for Azure Local deployment. All steps can be performed remotely once WinRM is enabled.

Objective: Configure the Azure Local operating system on each node with network settings, remote management, and baseline configuration required for cluster deployment.

Tasks:

  1. Enable WinRM for PowerShell remote management
  2. Enable RDP for graphical remote access
  3. Configure static IP addresses on management adapters
  4. Disable DHCP on management adapters
  5. Configure DNS server addresses
  6. Verify DNS client configuration
  7. Configure NTP time synchronization
  8. Enable ICMP firewall rules for network diagnostics
  9. Disable unused network adapters
  10. Set node hostnames
  11. Clear previous storage configuration (conditional — S2D redeployments only)
  12. Install FC HBA drivers (conditional — SAN deployments only)
  13. Configure MPIO and vendor MSDSM (conditional — SAN deployments only)
  14. Verify SAN LUN presentation (conditional — SAN deployments only)
  15. Optional: Run complete combined script (Tasks 02–10)
  16. Phase 03 Verification

Validation:

  • Remote management operational (WinRM and RDP)
  • Static network configuration applied
  • DNS resolution functional
  • Time synchronization configured
  • Nodes accessible and properly named

Outcome: All nodes configured with proper network settings, remote management enabled, and ready for Azure Arc registration (Stage 13).


Configuration Workflow

flowchart TD
A[Start: OS Installed] --> B[Enable WinRM]
B --> C[Enable RDP]
C --> D[Static IP]
D --> E[Disable DHCP]
E --> F[DNS Config]
F --> G[Verify DNS]
G --> H[NTP Config]
H --> I[Enable ICMP]
I --> J[Disable Unused NICs]
J --> K[Hostname]
K --> L[Storage Cleanup T11]
L --> M{Storage Type?}
M -->|S2D| N[Combined Script T15]
M -->|SAN| O[FC HBA Drivers T12]
O --> P[MPIO & MSDSM T13]
P --> Q[Verify LUN Presentation T14]
Q --> N
N --> R[Phase 03 Verification T16]
R --> S[Ready for Arc Registration]

Steps Overview

StepDescriptionTimeApplies To
Task 01Enable WinRM for Remote Management5 minAll
Task 02Enable RDP (Remote Desktop Protocol)5 minAll
Task 03Configure Static IP Address10 minAll
Task 04Disable DHCP on Management Adapter5 minAll
Task 05Configure DNS Servers5 minAll
Task 06Verify DNS Client Configuration5 minAll
Task 07Configure Time Synchronization (NTP)5 minAll
Task 08Enable ICMP (Ping)5 minAll
Task 09Disable Unused Network Adapters5 minAll
Task 10Configure Hostname5 minAll
Task 11Clear Previous Storage Configuration5 minS2D redeployment
Task 12Install FC HBA Drivers15 minSAN only
Task 13Configure MPIO & Vendor MSDSM15 minSAN only
Task 14Verify SAN LUN Presentation10 minSAN only
Task 15Complete Combined ScriptN/AOptional
Task 16Phase 03 Verification10 minAll

Prerequisites

RequirementDescription
OS installedStage 11 completed
iDRAC accessConsole access for initial config
IP planningStatic IPs assigned per node
DNS serversEnterprise DNS available
NTP serverTime source identified

Variables from infrastructure.yaml

The following variables are used during OS configuration:

VariableDescriptionExample
NODE_XX_IPStatic IP address for each node192.168.200.11
NODE_XX_NAMEHostname for each nodeazlocal-node01
MANAGEMENT_GATEWAYDefault gateway IP192.168.200.1
MANAGEMENT_SUBNET_PREFIXSubnet prefix length24
DNS_PRIMARY_IPPrimary DNS server IP192.168.200.2
DNS_SECONDARY_IPSecondary DNS server IP192.168.200.3
NTP_SERVERNTP server IP or hostnamepool.ntp.org

Network Configuration Reference

Example Node Configuration:

NodeManagement IPGatewayDNS1DNS2
NODE0110.x.x.1110.x.x.110.x.x.210.x.x.3
NODE0210.x.x.1210.x.x.110.x.x.210.x.x.3
NODE0310.x.x.1310.x.x.110.x.x.210.x.x.3
NODE0410.x.x.1410.x.x.110.x.x.210.x.x.3

Automation Options

Manual: Follow each step in sequence.

Automated: Use Task 15: Combined Script for full automation of Tasks 02–10.

SAN deployments: Run Tasks 12–14 after Task 11 before running the combined script.


Validation Checklist

CheckRequired
WinRM responds
RDP accessible
Static IP configured
DNS resolution works
Time synchronized
Hostname correct
FC HBA ports visible (SAN only)⚙️
MPIO configured (SAN only)⚙️
Infrastructure LUNs RAW (SAN only)⚙️

Next Stage

After completing OS configuration:

All Steps Complete?Next Action
✅ YesProceed to Phase 04: Arc Registration
❌ NoComplete remaining configuration steps

References: