Skip to content

Commit 406154f

Browse files
feat(docs): add Azure Local 2604 features — Simplified Provisioning, SAN deployment, Local Identity GA
- Add Simplified Machine Provisioning (Preview) section under Phase 02 OS Installation - 5 task files covering USB media creation, machine prep, Azure provisioning, monitoring, and Arc verification - Index page with ISO vs Simplified comparison table - Integration with azurelocal-ztp community automation project - Add SAN (Disaggregated) deployment path under Phase 05 Cluster Deployment - 4 new runbooks: AD/Local Identity × Portal/ARM Template for SAN storage - SAN index with FC patterns, prerequisites, and S2D vs SAN comparison - Updated decision trees and deployment matrices across all index pages - Update Local Identity from Preview to GA - Remove preview warnings and badges - Position as fully supported deployment method alongside Active Directory - Pin Microsoft Learn links to ?view=azloc-2604 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 1f778d1 commit 406154f

22 files changed

Lines changed: 1796 additions & 54 deletions

docs/implementation/04-cluster-deployment/deployment-methods/01-portal-deployment.mdx

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,20 @@ Portal deployment provides a guided wizard experience for deploying Azure Local
3232

3333
## Deployment Options
3434

35+
### S2D (Hyperconverged)
36+
3537
| Authentication | Description | Link |
3638
|---------------|-------------|------|
3739
| **Active Directory** | Enterprise deployment with domain-joined nodes | [AD - Portal Deployment](../phase-05-cluster-deployment/deployment-methods/active-directory/portal-instructions.mdx) |
3840
| **Local Identity** | Edge/standalone deployment without AD | [Local Identity - Portal](../phase-05-cluster-deployment/deployment-methods/local-identity/portal-instructions.mdx) |
3941

42+
### SAN (Disaggregated)
43+
44+
| Authentication | Description | Link |
45+
|---------------|-------------|------|
46+
| **Active Directory** | SAN enterprise deployment with domain-joined nodes | [AD - Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/active-directory/portal-instructions.mdx) |
47+
| **Local Identity** | SAN edge deployment without AD | [Local Identity - Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/local-identity/portal-instructions.mdx) |
48+
4049
---
4150

4251
## When to Use Portal Deployment

docs/implementation/04-cluster-deployment/deployment-methods/02-arm-template-deployment.mdx

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,20 @@ ARM template deployment provides infrastructure-as-code deployment for Azure Loc
3232

3333
## Deployment Options
3434

35+
### S2D (Hyperconverged)
36+
3537
| Authentication | Description | Link |
3638
|---------------|-------------|------|
3739
| **Active Directory** | Enterprise deployment with domain-joined nodes | [AD - ARM Template](../phase-05-cluster-deployment/deployment-methods/active-directory/arm-template-instructions.mdx) |
3840
| **Local Identity** | Edge/standalone deployment without AD | [Local Identity - ARM Template](../phase-05-cluster-deployment/deployment-methods/local-identity/arm-template-instructions.mdx) |
3941

42+
### SAN (Disaggregated)
43+
44+
| Authentication | Description | Link |
45+
|---------------|-------------|------|
46+
| **Active Directory** | SAN enterprise deployment with domain-joined nodes | [AD - ARM Template (SAN)](../phase-05-cluster-deployment/deployment-methods/san/active-directory/arm-template-instructions.mdx) |
47+
| **Local Identity** | SAN edge deployment without AD | [Local Identity - ARM Template (SAN)](../phase-05-cluster-deployment/deployment-methods/san/local-identity/arm-template-instructions.mdx) |
48+
4049
---
4150

4251
## When to Use ARM Template Deployment

docs/implementation/04-cluster-deployment/deployment-methods/index.mdx

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ status: "Active"
2020
> **DOCUMENT CATEGORY**: Reference
2121
> **SCOPE**: Azure Local deployment options
2222
> **PURPOSE**: Overview and navigation for deployment methods
23-
> **MASTER REFERENCE**: [Microsoft Learn - Deploy Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/deploy/deploy-via-portal)
23+
> **MASTER REFERENCE**: [Microsoft Learn Deploy Azure Local via Portal](https://learn.microsoft.com/en-us/azure/azure-local/deploy/deploy-via-portal?view=azloc-2604)
2424
2525
**Status**: Active
2626

@@ -32,13 +32,24 @@ Azure Local clusters can be deployed using different methods. This section provi
3232

3333
## Quick Reference
3434

35+
### S2D (Hyperconverged)
36+
3537
| Method | Best For | Link |
3638
|--------|----------|------|
3739
| **Portal (AD)** | Enterprise/Learning | [AD Portal Deployment](../phase-05-cluster-deployment/deployment-methods/active-directory/portal-instructions.mdx) |
3840
| **ARM Template (AD)** | Production/Multi-site | [AD ARM Template](../phase-05-cluster-deployment/deployment-methods/active-directory/arm-template-instructions.mdx) |
3941
| **Portal (Local)** | Edge/Disconnected | [Local Portal Deployment](../phase-05-cluster-deployment/deployment-methods/local-identity/portal-instructions.mdx) |
4042
| **ARM Template (Local)** | Automated Edge | [Local ARM Template](../phase-05-cluster-deployment/deployment-methods/local-identity/arm-template-instructions.mdx) |
4143

44+
### SAN (Disaggregated)
45+
46+
| Method | Best For | Link |
47+
|--------|----------|------|
48+
| **Portal (AD + SAN)** | SAN Enterprise | [AD Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/active-directory/portal-instructions.mdx) |
49+
| **ARM Template (AD + SAN)** | SAN Automated | [AD ARM Template (SAN)](../phase-05-cluster-deployment/deployment-methods/san/active-directory/arm-template-instructions.mdx) |
50+
| **Portal (Local + SAN)** | SAN Edge | [Local Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/local-identity/portal-instructions.mdx) |
51+
| **ARM Template (Local + SAN)** | SAN Automated Edge | [Local ARM Template (SAN)](../phase-05-cluster-deployment/deployment-methods/san/local-identity/arm-template-instructions.mdx) |
52+
4253
---
4354

4455
## Method Comparison

docs/implementation/04-cluster-deployment/phase-02-os-installation/index.mdx

Lines changed: 93 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@
22
title: "Phase 02: OS Installation"
33
sidebar_label: "Phase 02: OS Installation"
44
sidebar_position: 2
5-
description: "Prepare Dell hardware boot configuration, verify ISO availability, and install Azure Stack HCI OS on each cluster node before OS configuration."
5+
description: "Install Azure Stack HCI OS on cluster nodes using ISO-based manual installation or Simplified Machine Provisioning (Preview)."
66
category: Runbook
77
scope: Azure Local cluster OS installation
8-
purpose: Install Azure Stack HCI OS on all cluster nodes using the Dell Gold Image ISO via iDRAC virtual media and BOSS card preparation
8+
purpose: Install Azure Stack HCI OS on all cluster nodes using ISO or Simplified Provisioning
99
author: Azure Local Cloud
1010
created: 2026-01-31
11-
updated: 2026-03-04
12-
version: 1.1
13-
tags: ["azure-local", "os-installation", "azure-stack-hci", "dell", "boss", "idrac"]
14-
keywords: ["Azure Stack HCI OS", "OS installation", "Dell BOSS card", "iDRAC virtual media", "gold image ISO", "Server Core"]
11+
updated: 2026-05-01
12+
version: 1.2
13+
tags: ["azure-local", "os-installation", "azure-stack-hci", "dell", "boss", "idrac", "simplified-provisioning"]
14+
keywords: ["Azure Stack HCI OS", "OS installation", "Dell BOSS card", "iDRAC virtual media", "gold image ISO", "Server Core", "simplified provisioning", "FDO", "zero touch"]
1515
status: Active
1616
---
1717

@@ -26,14 +26,44 @@ import TabItem from '@theme/TabItem';
2626

2727
> **DOCUMENT CATEGORY**: Runbook
2828
> **SCOPE**: Azure Local cluster OS installation
29-
> **PURPOSE**: Install Azure Stack HCI OS on all cluster nodes using the Dell Gold Image ISO via iDRAC virtual media and BOSS card preparation
30-
> **MASTER REFERENCE**: [Microsoft Learn - Deploy Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/deploy/deployment-introduction)
29+
> **PURPOSE**: Install Azure Stack HCI OS on all cluster nodes
30+
> **MASTER REFERENCE**: [Microsoft Learn - Deploy Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/deploy/deployment-introduction?view=azloc-2604)
3131
3232
**Status**: Active
3333

3434
## Overview
3535

36-
Install Azure Stack HCI OS on all cluster nodes. This phase covers ISO mounting via iDRAC virtual media, BOSS card virtual disk preparation, manual OS installation through iDRAC Virtual Console, and post-install verification.
36+
Azure Local supports two methods for installing the Azure Stack HCI OS on cluster nodes:
37+
38+
1. **ISO-Based Manual Installation** (GA) — Download the ISO, mount via iDRAC/BMC virtual media, and manually run Windows Setup on each node
39+
2. **Simplified Machine Provisioning** (Preview) — Use a USB-based maintenance environment with FIDO Device Onboarding (FDO) to provision machines from Azure automatically
40+
41+
Choose the method that best fits your environment using the comparison below.
42+
43+
---
44+
45+
## Installation Method Comparison
46+
47+
| Aspect | ISO (Manual) | Simplified Provisioning (Preview) |
48+
|--------|-------------|-----------------------------------|
49+
| **Status** | ✅ GA — production supported | ⚠️ Preview — East US only |
50+
| **OS Installation** | Manual via iDRAC/BMC console | Automated from Azure |
51+
| **Physical Access** | Required for iDRAC virtual media | Required for initial USB boot |
52+
| **Network Configuration** | Manual (SConfig or PowerShell) | Automated from Azure portal |
53+
| **Azure Arc Registration** | Separate step ([Phase 04](../phase-04-arc-registration/index.mdx)) | Included in provisioning flow |
54+
| **Arc Gateway Support** | ✅ Supported | ❌ Not supported (preview) |
55+
| **Supported Hardware** | All [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) hardware | Dell AX-650/750, Lenovo MX650 V3/V4, HPE DL360 Gen11 |
56+
| **Best For** | Production deployments, all hardware | Automated provisioning of supported SKUs |
57+
58+
:::tip Recommendation
59+
Use **ISO-based installation** for production deployments until Simplified Provisioning reaches GA. Use Simplified Provisioning for evaluation and supported hardware in East US.
60+
:::
61+
62+
---
63+
64+
## Method 1: ISO-Based Manual Installation
65+
66+
The traditional approach: prepare Dell BOSS cards, mount the ISO via iDRAC virtual media, and manually install the OS on each node.
3767

3868
:::warning Important Notes
3969
- **BOSS deletion triggers reboot** — Deleting and recreating BOSS virtual disks creates a configuration job that requires a reboot to apply
@@ -42,9 +72,7 @@ Install Azure Stack HCI OS on all cluster nodes. This phase covers ISO mounting
4272
- **Do NOT domain join nodes** — Nodes must remain in workgroup until after Azure Local cluster deployment
4373
:::
4474

45-
---
46-
47-
## Phase 02 — Table of Contents
75+
### ISO Tasks
4876

4977
| Task | Description | Duration | Link |
5078
|------|-------------|----------|------|
@@ -55,14 +83,38 @@ Install Azure Stack HCI OS on all cluster nodes. This phase covers ISO mounting
5583

5684
---
5785

86+
## Method 2: Simplified Machine Provisioning (Preview)
87+
88+
An automated approach that uses a USB-based maintenance environment with FIDO Device Onboarding to provision machines directly from Azure.
89+
90+
:::warning Preview Feature
91+
Simplified machine provisioning is **in preview**. Only East US region is supported. Arc Gateway is not supported. Review the [Microsoft preview terms](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) before use.
92+
:::
93+
94+
### Simplified Provisioning Tasks
95+
96+
| Task | Description | Duration | Link |
97+
|------|-------------|----------|------|
98+
| 1 | Create USB Installation Media | 15 min | [Task 1](./simplified-provisioning/task-01-create-usb-media.mdx) |
99+
| 2 | Prepare Machines | 30 min/machine | [Task 2](./simplified-provisioning/task-02-prepare-machines.mdx) |
100+
| 3 | Provision Machines from Azure | 15 min + wait | [Task 3](./simplified-provisioning/task-03-provision-from-azure.mdx) |
101+
| 4 | Monitor Machine Setup | 30–60 min | [Task 4](./simplified-provisioning/task-04-monitor-progress.mdx) |
102+
| 5 | Verify Azure Arc Connectivity | 10 min | [Task 5](./simplified-provisioning/task-05-verify-arc.mdx) |
103+
104+
For full details, see the [Simplified Provisioning Guide](./simplified-provisioning/index.mdx).
105+
106+
---
107+
58108
## Prerequisites
59109

60110
| Requirement | Description | Source |
61111
|-------------|-------------|--------|
62112
| Phase 01 Complete | BIOS and iDRAC settings validated and compliant (Tasks 04/05) | [Phase 01](../phase-01-hardware-provisioning/index.mdx) |
63-
| Dell BOSS Cards | Boot Optimized Storage Solution cards installed in all nodes | Hardware |
64-
| iDRAC Access | Virtual Console and Virtual Media control available | `variables.yml: nodes.<name>.idrac_ip` |
65-
| Gold Image ISO | Dell Azure Local Gold Image ISO available on network share or USB | Azure Local Cloud build team |
113+
| Dell BOSS Cards | Boot Optimized Storage Solution cards installed in all nodes (ISO method) | Hardware |
114+
| iDRAC Access | Virtual Console and Virtual Media control available (ISO method) | `variables.yml: nodes.<name>.idrac_ip` |
115+
| Gold Image ISO | Dell Azure Local Gold Image ISO available (ISO method) | Build team |
116+
| USB Flash Drive | At least 8 GB (Simplified Provisioning method) | Operator |
117+
| Windows 11 PC | For USB prep tool and Configurator app (Simplified Provisioning method) | Operator |
66118

67119
---
68120

@@ -88,6 +140,7 @@ Azure Local Cloud maintains a Dell Gold Image with pre-configured drivers optimi
88140

89141
## Validation Checklist
90142

143+
### ISO Method
91144
- [ ] BOSS virtual disks deleted and recreated on all nodes
92145
- [ ] Dell Gold Image ISO mounted and verified on all nodes (`Inserted: true`)
93146
- [ ] Nodes rebooted and booted from ISO after BOSS recreation
@@ -97,15 +150,20 @@ Azure Local Cloud maintains a Dell Gold Image with pre-configured drivers optimi
97150
- [ ] All nodes boot to Server Core command prompt
98151
- [ ] OS verified per Task 4 checklist
99152

153+
### Simplified Provisioning Method
154+
- [ ] USB installation media created successfully
155+
- [ ] All machines booted from USB and maintenance environment completed
156+
- [ ] Ownership vouchers collected for all machines
157+
- [ ] Machines provisioned from Azure portal
158+
- [ ] All machines show "Ready to cluster" in Azure Arc
159+
100160
---
101161

102162
## Outcome
103163

104-
Upon completion of this phase:
164+
Upon completion of this phase (either method):
105165

106-
- Dell BOSS virtual disks recreated on all nodes per Dell validated practices
107166
- Azure Stack HCI OS installed on all cluster nodes
108-
- OS installed to Dell BOSS card M.2 RAID-1 volumes
109167
- Administrator passwords documented securely in Azure Key Vault
110168
- All nodes boot to Server Core command prompt
111169
- Nodes ready for Phase 03: OS Configuration
@@ -116,16 +174,21 @@ Upon completion of this phase:
116174

117175
```mermaid
118176
graph TD
119-
A[Phase 01 Complete] --> B[Task 1: Delete/Recreate BOSS VD]
120-
B --> C[Task 2: Mount ISO via iDRAC]
121-
C --> D[Verify ISO Mount Status]
122-
D --> E[Automatic Reboot to ISO]
123-
E --> F[Task 3: Manual OS Installation]
124-
F --> G[Complete Windows Setup]
125-
G --> H[Task 4: Verify Installation]
126-
H --> I{All Nodes Complete?}
127-
I -->|No| B
128-
I -->|Yes| J[Phase 03: OS Configuration]
177+
A[Phase 01 Complete] --> B{Installation Method?}
178+
B -->|ISO Manual| C[Task 1: Delete/Recreate BOSS VD]
179+
C --> D[Task 2: Mount ISO via iDRAC]
180+
D --> E[Task 3: Manual OS Installation]
181+
E --> F[Task 4: Verify Installation]
182+
F --> G{All Nodes Complete?}
183+
G -->|No| C
184+
G -->|Yes| H[Phase 03: OS Configuration]
185+
186+
B -->|Simplified Provisioning| I[Task 1: Create USB Media]
187+
I --> J[Task 2: Prepare Machines]
188+
J --> K[Task 3: Provision from Azure]
189+
K --> L[Task 4: Monitor Progress]
190+
L --> M[Task 5: Verify Arc]
191+
M --> H
129192
```
130193

131194
---
@@ -160,4 +223,5 @@ $config.nodes.Values | ForEach-Object {
160223
| Version | Date | Author | Changes |
161224
|---------|------|--------|---------|
162225
| 1.0 | 2026-01-31 | Azure Local Cloud | Initial document |
163-
| 1.1 | 2026-03-04 | Azure Local Cloud | Fix frontmatter, badges, stage references, standards alignment |
226+
| 1.1 | 2026-03-04 | Azure Local Cloud | Fix frontmatter, badges, stage references, standards alignment |
227+
| 1.2 | 2026-05-01 | Azure Local Cloud | Add Simplified Machine Provisioning (Preview) section, update to decision page format |
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
{
2+
"label": "Simplified Provisioning (Preview)",
3+
"position": 10,
4+
"collapsible": true,
5+
"collapsed": false,
6+
"link": {
7+
"type": "doc",
8+
"id": "implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/index"
9+
}
10+
}

0 commit comments

Comments
 (0)