Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "1.0.1"
".": "2604.0.1"
}
44 changes: 44 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Azure Local Cloud Documentation

[![Deploy](https://github.com/AzureLocal/azurelocal.github.io/actions/workflows/deploy.yml/badge.svg)](https://github.com/AzureLocal/azurelocal.github.io/actions/workflows/deploy.yml)

Community documentation for [Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/) — Microsoft's hybrid cloud infrastructure platform enabled by Azure Arc.

**Live site:** [https://azurelocal.cloud](https://azurelocal.cloud)

## What's Here

- **Implementation Guide** — End-to-end deployment runbook covering CI/CD infrastructure, Azure foundation, on-prem readiness, cluster deployment, operational foundations, and testing/validation
- **Planning** — Naming standards, discovery checklists, site assessment, hardware requirements, landing zone strategy
- **Design** — High-level and low-level design documents
- **Operations** — Day-2 operational procedures
- **Automation** — IaC patterns and pipeline guidance
- **Azure Services** — Running Azure services on Azure Local (AVD, AKS, SQL MI, App Services, ML/AI)
- **Lab Environment** — Lab setup and access

## Versioning

Documentation versions align with Azure Local build releases:

| Version | Description |
|---------|-------------|
| **2604** | Current — includes Simplified Provisioning (Preview), SAN (Disaggregated) deployment, Local Identity GA |
| **2411** | Previous release baseline |

## Local Development

```bash
npm install
npm run start # Dev server at http://localhost:3000
npm run build # Production build
```

Built with [Docusaurus](https://docusaurus.io/).

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

See [LICENSE](LICENSE).
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,20 @@ Portal deployment provides a guided wizard experience for deploying Azure Local

## Deployment Options

### S2D (Hyperconverged)

| Authentication | Description | Link |
|---------------|-------------|------|
| **Active Directory** | Enterprise deployment with domain-joined nodes | [AD - Portal Deployment](../phase-05-cluster-deployment/deployment-methods/active-directory/portal-instructions.mdx) |
| **Local Identity** | Edge/standalone deployment without AD | [Local Identity - Portal](../phase-05-cluster-deployment/deployment-methods/local-identity/portal-instructions.mdx) |

### SAN (Disaggregated)

| Authentication | Description | Link |
|---------------|-------------|------|
| **Active Directory** | SAN enterprise deployment with domain-joined nodes | [AD - Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/active-directory/portal-instructions.mdx) |
| **Local Identity** | SAN edge deployment without AD | [Local Identity - Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/local-identity/portal-instructions.mdx) |

---

## When to Use Portal Deployment
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,20 @@ ARM template deployment provides infrastructure-as-code deployment for Azure Loc

## Deployment Options

### S2D (Hyperconverged)

| Authentication | Description | Link |
|---------------|-------------|------|
| **Active Directory** | Enterprise deployment with domain-joined nodes | [AD - ARM Template](../phase-05-cluster-deployment/deployment-methods/active-directory/arm-template-instructions.mdx) |
| **Local Identity** | Edge/standalone deployment without AD | [Local Identity - ARM Template](../phase-05-cluster-deployment/deployment-methods/local-identity/arm-template-instructions.mdx) |

### SAN (Disaggregated)

| Authentication | Description | Link |
|---------------|-------------|------|
| **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) |
| **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) |

---

## When to Use ARM Template Deployment
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ status: "Active"
> **DOCUMENT CATEGORY**: Reference
> **SCOPE**: Azure Local deployment options
> **PURPOSE**: Overview and navigation for deployment methods
> **MASTER REFERENCE**: [Microsoft Learn - Deploy Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/deploy/deploy-via-portal)
> **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)

**Status**: Active

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

## Quick Reference

### S2D (Hyperconverged)

| Method | Best For | Link |
|--------|----------|------|
| **Portal (AD)** | Enterprise/Learning | [AD Portal Deployment](../phase-05-cluster-deployment/deployment-methods/active-directory/portal-instructions.mdx) |
| **ARM Template (AD)** | Production/Multi-site | [AD ARM Template](../phase-05-cluster-deployment/deployment-methods/active-directory/arm-template-instructions.mdx) |
| **Portal (Local)** | Edge/Disconnected | [Local Portal Deployment](../phase-05-cluster-deployment/deployment-methods/local-identity/portal-instructions.mdx) |
| **ARM Template (Local)** | Automated Edge | [Local ARM Template](../phase-05-cluster-deployment/deployment-methods/local-identity/arm-template-instructions.mdx) |

### SAN (Disaggregated)

| Method | Best For | Link |
|--------|----------|------|
| **Portal (AD + SAN)** | SAN Enterprise | [AD Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/active-directory/portal-instructions.mdx) |
| **ARM Template (AD + SAN)** | SAN Automated | [AD ARM Template (SAN)](../phase-05-cluster-deployment/deployment-methods/san/active-directory/arm-template-instructions.mdx) |
| **Portal (Local + SAN)** | SAN Edge | [Local Portal (SAN)](../phase-05-cluster-deployment/deployment-methods/san/local-identity/portal-instructions.mdx) |
| **ARM Template (Local + SAN)** | SAN Automated Edge | [Local ARM Template (SAN)](../phase-05-cluster-deployment/deployment-methods/san/local-identity/arm-template-instructions.mdx) |

---

## Method Comparison
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,16 @@
title: "Phase 02: OS Installation"
sidebar_label: "Phase 02: OS Installation"
sidebar_position: 2
description: "Prepare Dell hardware boot configuration, verify ISO availability, and install Azure Stack HCI OS on each cluster node before OS configuration."
description: "Install Azure Stack HCI OS on cluster nodes using ISO-based manual installation or Simplified Machine Provisioning (Preview)."
category: Runbook
scope: Azure Local cluster OS installation
purpose: Install Azure Stack HCI OS on all cluster nodes using the Dell Gold Image ISO via iDRAC virtual media and BOSS card preparation
purpose: Install Azure Stack HCI OS on all cluster nodes using ISO or Simplified Provisioning
author: Azure Local Cloud
created: 2026-01-31
updated: 2026-03-04
version: 1.1
tags: ["azure-local", "os-installation", "azure-stack-hci", "dell", "boss", "idrac"]
keywords: ["Azure Stack HCI OS", "OS installation", "Dell BOSS card", "iDRAC virtual media", "gold image ISO", "Server Core"]
updated: 2026-05-01
version: 1.2
tags: ["azure-local", "os-installation", "azure-stack-hci", "dell", "boss", "idrac", "simplified-provisioning"]
keywords: ["Azure Stack HCI OS", "OS installation", "Dell BOSS card", "iDRAC virtual media", "gold image ISO", "Server Core", "simplified provisioning", "FDO", "zero touch"]
status: Active
---

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

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

**Status**: Active

## Overview

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.
Azure Local supports two methods for installing the Azure Stack HCI OS on cluster nodes:

1. **ISO-Based Manual Installation** (GA) — Download the ISO, mount via iDRAC/BMC virtual media, and manually run Windows Setup on each node
2. **Simplified Machine Provisioning** (Preview) — Use a USB-based maintenance environment with FIDO Device Onboarding (FDO) to provision machines from Azure automatically

Choose the method that best fits your environment using the comparison below.

---

## Installation Method Comparison

| Aspect | ISO (Manual) | Simplified Provisioning (Preview) |
|--------|-------------|-----------------------------------|
| **Status** | ✅ GA — production supported | ⚠️ Preview — East US only |
| **OS Installation** | Manual via iDRAC/BMC console | Automated from Azure |
| **Physical Access** | Required for iDRAC virtual media | Required for initial USB boot |
| **Network Configuration** | Manual (SConfig or PowerShell) | Automated from Azure portal |
| **Azure Arc Registration** | Separate step ([Phase 04](../phase-04-arc-registration/index.mdx)) | Included in provisioning flow |
| **Arc Gateway Support** | ✅ Supported | ❌ Not supported (preview) |
| **Supported Hardware** | All [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) hardware | Dell AX-650/750, Lenovo MX650 V3/V4, HPE DL360 Gen11 |
| **Best For** | Production deployments, all hardware | Automated provisioning of supported SKUs |

:::tip Recommendation
Use **ISO-based installation** for production deployments until Simplified Provisioning reaches GA. Use Simplified Provisioning for evaluation and supported hardware in East US.
:::

---

## Method 1: ISO-Based Manual Installation

The traditional approach: prepare Dell BOSS cards, mount the ISO via iDRAC virtual media, and manually install the OS on each node.

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

---

## Phase 02 — Table of Contents
### ISO Tasks

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

---

## Method 2: Simplified Machine Provisioning (Preview)

An automated approach that uses a USB-based maintenance environment with FIDO Device Onboarding to provision machines directly from Azure.

:::warning Preview Feature
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.
:::

### Simplified Provisioning Tasks

| Task | Description | Duration | Link |
|------|-------------|----------|------|
| 1 | Create USB Installation Media | 15 min | [Task 1](./simplified-provisioning/task-01-create-usb-media.mdx) |
| 2 | Prepare Machines | 30 min/machine | [Task 2](./simplified-provisioning/task-02-prepare-machines.mdx) |
| 3 | Provision Machines from Azure | 15 min + wait | [Task 3](./simplified-provisioning/task-03-provision-from-azure.mdx) |
| 4 | Monitor Machine Setup | 30–60 min | [Task 4](./simplified-provisioning/task-04-monitor-progress.mdx) |
| 5 | Verify Azure Arc Connectivity | 10 min | [Task 5](./simplified-provisioning/task-05-verify-arc.mdx) |

For full details, see the [Simplified Provisioning Guide](./simplified-provisioning/index.mdx).

---

## Prerequisites

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

---

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

## Validation Checklist

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

### Simplified Provisioning Method
- [ ] USB installation media created successfully
- [ ] All machines booted from USB and maintenance environment completed
- [ ] Ownership vouchers collected for all machines
- [ ] Machines provisioned from Azure portal
- [ ] All machines show "Ready to cluster" in Azure Arc

---

## Outcome

Upon completion of this phase:
Upon completion of this phase (either method):

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

```mermaid
graph TD
A[Phase 01 Complete] --> B[Task 1: Delete/Recreate BOSS VD]
B --> C[Task 2: Mount ISO via iDRAC]
C --> D[Verify ISO Mount Status]
D --> E[Automatic Reboot to ISO]
E --> F[Task 3: Manual OS Installation]
F --> G[Complete Windows Setup]
G --> H[Task 4: Verify Installation]
H --> I{All Nodes Complete?}
I -->|No| B
I -->|Yes| J[Phase 03: OS Configuration]
A[Phase 01 Complete] --> B{Installation Method?}
B -->|ISO Manual| C[Task 1: Delete/Recreate BOSS VD]
C --> D[Task 2: Mount ISO via iDRAC]
D --> E[Task 3: Manual OS Installation]
E --> F[Task 4: Verify Installation]
F --> G{All Nodes Complete?}
G -->|No| C
G -->|Yes| H[Phase 03: OS Configuration]

B -->|Simplified Provisioning| I[Task 1: Create USB Media]
I --> J[Task 2: Prepare Machines]
J --> K[Task 3: Provision from Azure]
K --> L[Task 4: Monitor Progress]
L --> M[Task 5: Verify Arc]
M --> H
```

---
Expand Down Expand Up @@ -160,4 +223,5 @@ $config.nodes.Values | ForEach-Object {
| 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 |
| 1.1 | 2026-03-04 | Azure Local Cloud | Fix frontmatter, badges, stage references, standards alignment |
| 1.2 | 2026-05-01 | Azure Local Cloud | Add Simplified Machine Provisioning (Preview) section, update to decision page format |
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{
"label": "Simplified Provisioning (Preview)",
"position": 10,
"collapsible": true,
"collapsed": false,
"link": {
"type": "doc",
"id": "implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/index"
}
}
Loading
Loading