Skip to main content
Version: 2604 (Preview)

Active Directory — ARM Template Deployment (SAN)

Runbook Azure Storage

DOCUMENT CATEGORY: Runbook SCOPE: ARM template SAN cluster deployment with Active Directory PURPOSE: Deploy Azure Local with external SAN storage and AD authentication via ARM MASTER REFERENCE: Microsoft Learn — Deploy via ARM (Disaggregated)

Status: Active


Overview

This runbook deploys a disaggregated Azure Local cluster using ARM templates with:

  • Storage: External SAN (Fiber Channel)
  • Identity: Active Directory

ARM template deployment provides repeatability, version control, and CI/CD integration. The disaggregated ARM template includes SAN-specific parameters not present in the S2D template.


Prerequisites

Complete all items from the SAN Prerequisites and the AD Prerequisites sections.


Key Parameter Differences (SAN vs S2D)

The disaggregated ARM template includes parameters specific to SAN deployments:

ParameterDescription
intentListList of deployment intents — no storage intent (only management + compute)
sanNetworkListList of SAN networks for the FC fabric
storageConnectivitySwitchlessSet to false — SAN always uses switched connectivity
sbeVersionSolution Builder Extension version for your hardware
sbeFamilySBE package family
sbePublisherSBE publisher/vendor

Step-by-Step

Step 1: Obtain the ARM Template

Download the disaggregated ARM template from:

Step 2: Create the Parameters File

Create a parameters file with SAN-specific values:

{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": { "value": "<cluster-name>" },
"location": { "value": "<azure-region>" },
"domainFqdn": { "value": "<domain.fqdn>" },
"adouPath": { "value": "OU=<ou>,DC=<domain>,DC=<tld>" },
"storageConfiguration": { "value": "SAN" },
"networkingPattern": { "value": "managementAndCompute" }
}
}
Storage Configuration

Set storageConfiguration to "SAN" to deploy with external SAN storage. This is the key differentiator from S2D deployments.

Step 3: Deploy via Azure CLI

az deployment group create \
--resource-group <resource-group> \
--template-file azuredeploy.json \
--parameters @azuredeploy.parameters.san.ad.json

Step 4: Monitor Deployment

az deployment group show \
--resource-group <resource-group> \
--name <deployment-name> \
--query "properties.provisioningState" -o tsv

Post-Deployment

After cluster deployment completes:

  1. Connect workload LUNs — see Connect External Storage
  2. Proceed to Phase 06: Post-Deployment

Troubleshooting

IssueResolution
Template validation failsVerify all SAN-specific parameters are included. Check storageConfiguration is set to "SAN".
Deployment fails on storageEnsure LUNs are visible and in RAW state on all nodes. Verify MPIO is enabled.
SBE parameters invalidContact your hardware vendor for correct SBE version, family, and publisher values.

AD — Portal (SAN)↑ SAN DeploymentLocal Identity — Portal (SAN) →

VersionDateAuthorChanges
1.02026-05-01Azure Local CloudInitial release