Skip to main content

193 docs tagged with "azure-local"

View all tags

ARM Template Deployment

ARM template-based Azure Local cluster deployment options for Active Directory and Local Identity environments.

ARM Validate and Deploy automation

One command, from a jump server or a pipeline, that checks readiness, validates, waits for approval, deploys the Azure Local instance with Microsoft's ARM template and explains failures; where the pre-cluster verification gate sits before it.

Authentication Methods

Authentication options for Azure Local deployment — Azure PowerShell and Azure CLI session setup.

Automated OS Configuration (One Run)

Configure every node's OS in one run with the azurelocal-toolkit: standalone or from a GitHub or GitLab pipeline, with method detection, plan, approval, apply and verify, the master-file keys it reads, clear_storage, exit codes and troubleshooting.

Automation Prerequisites

What you need before running the azurelocal-ztp automation: Azure subscription settings and roles, hardware and BMC, network paths, and the Windows management host.

Azure Local Implementation Guide

Complete guide for deploying Azure Local infrastructure — from Azure foundation through cluster deployment, validation, and handover.

Choose Your Route: ISO or Simplified Provisioning

Two routes lead to the same Azure Local cluster deployment. A flow chart and a decision matrix show which OS installation, OS configuration and Arc registration steps each route needs before Validate.

Cluster Deployment

Runbook for deploying Azure Local clusters, covering OS installation, Arc registration, cluster creation, and post-deployment configuration.

Deployment Methods

Overview of Azure Local cluster deployment methods including Portal and ARM Template options for Active Directory and Local Identity environments.

Full CAF/WAF Deployment Overview

Overview of the full CAF/WAF landing zone deployment — enterprise-scale management group hierarchy, dedicated subscriptions, and multi-resource-group organization following Azure Landing Zone architecture.

How the OS Configuration Run Works

Every step of the automated OS configuration run in the order it executes: what is read first, what counts as a change, the idempotent re-run, the restart points, the three management address modes, the SAN-only steps, the SBE route, the retry on state Unknown, per-node continue on failure and the plan, approval, apply and verify stages.

How to Use This Guide

Explain how to navigate the automation guide and combine it with the implementation guide.

Key Inputs and Variables

How Azure Local deployments are configured: one infrastructure.yml (schema 5), defined by the master registry, validated by a schema.

Management Servers

Management server definitions — domain controllers, jumpbox, WAC, and syslog server. Deployment-agnostic variable capture.

Manual OS Installation (ISO)

Install the Azure Stack HCI OS from the ISO or your OEM's image on each node through the BMC console: prepare the boot disk, mount the image, install, and verify.

Monitor the Run with Sonar

Follow a zero-touch provisioning run live and read-only with azurelocal-sonar, from the virtual USB boot to ready for Validate, and on through cluster Validate and Deploy.

Output and Handoff to Cluster Deployment

What the azurelocal-ztp automation produces at the Handoff, and what to give OS configuration and cluster deployment, including each machine's arcMachineResourceId and the management address result.

Phase 01: Landing Zones

Phase 01: Landing Zones — choose your deployment model and deploy management groups, subscriptions, and resource groups following Azure CAF/WAF and Azure Landing Zone architecture.

Phase 02: OS Installation

Install the Azure Stack HCI OS on cluster nodes by one of two paths: manual installation from an ISO or OEM image, or simplified machine provisioning (preview), by hand or automated with azurelocal-ztp.

Portal Deployment

Portal-based Azure Local cluster deployment options for Active Directory and Local Identity environments.

Purpose and Scope

Define the scope, deployment paths, and reader expectations for the automation guide.

Purpose and Scope

Comprehensive guidance for deploying Azure Local infrastructure with multiple implementation approaches.

Run Day 2 Operations in a Pipeline

Run the day 2 scripts of Part 8 by hand, or in the day 2 pipelines on GitHub Actions, GitLab CI or Azure DevOps: a scheduled check for updates, the update, node maintenance and cluster operations, each change behind one approval

Run from a Pipeline

Run the azurelocal-ztp zero-touch automation from a pipeline on a self-hosted Windows runner: why self-hosted, identity and roles, Key Vault secrets, a manual approval before the Boot stage, and resume with -From.

Run the Validation in a Pipeline

Run the four validation checks of Part 7 by hand, or in the validation pipeline on GitHub Actions, GitLab CI or Azure DevOps, with the storage load test behind an approval

SAN (Disaggregated) Deployment

Deploy Azure Local using Storage Area Network (SAN) external storage — disaggregated architecture with independent scaling of compute and storage.

Simplified Machine Provisioning (Preview)

Install the OS and register Azure Local machines using simplified machine provisioning — an alternative to manual ISO installation that automates OS deployment from Azure.

Storage Architecture Planning

Storage architecture decision guide for Azure Local deployments: Storage Spaces Direct, hybrid (Storage Spaces Direct plus SAN) and disaggregated SAN over Fibre Channel or iSCSI

Task 01: Check for Updates

Check what updates the cluster has discovered and what Azure shows for it, after the deployment and on a schedule. Read only

Task 01: Cluster Health Validation

Validate the cluster service, the nodes, Storage Spaces Direct, the cluster networks, the quorum and the Arc agent from the cluster, read only

Task 01: Deploy SDN

Enable Software Defined Networking (SDN) on Azure Local via Arc integration — Network Controller as Failover Cluster service, enabling logical network NSG management

Task 01: Enable Defender for Cloud

Turn on the free level of Microsoft Defender for Cloud that Azure Local needs: Foundational CSPM and the Microsoft cloud security benchmark

Task 02: Cluster Quorum Configuration

Configure cluster quorum — validate and provision the cloud witness storage account, then set quorum via Cloud Witness, File Share Witness, or Disk Witness

Task 02: Create Subscription

Create a single subscription for the single subscription deployment and associate it with the landing zone management group.

Task 02: Enable RDP

Enable Remote Desktop Protocol on all Azure Local nodes for graphical remote access during configuration and troubleshooting.

Task 02: Prepare Machines

Boot servers from the USB maintenance environment to generate FIDO Device Onboarding ownership vouchers

Task 02: Start the Solution Update

Start the Azure Local solution update after the deployment or for the monthly update, with the safety checks of Microsoft Learn, and return without waiting

Task 02: VPN Gateway

Deploy the Azure VPN Gateway for site-to-site connectivity between Azure and on-premises infrastructure.

Task 03: Configure Static IP Address

Configure static IP addresses on the management network adapter for each Azure Local cluster node using explicit values from infrastructure.yml.

Task 03: Manual OS Installation

Manually install Azure Stack HCI OS on each cluster node using iDRAC Virtual Console. The ISO was mounted in Task 02 — nodes boot directly into Windows Setup after the BOSS recreation reboot.

Task 03: Node Maintenance

Take one Azure Local node through maintenance: check it is safe, drain it, reboot it, resume it and wait for the storage repair jobs before the next node

Task 04: Cluster Operations

Day to day operations on an Azure Local cluster: health check, maintenance mode of a node, live migration, volume ownership, capacity and alerts

Task 04: Disable DHCP on All Adapters

Disable DHCP on all network adapters except virtual and management adapters to lock in static IP configuration across all Azure Local cluster nodes.

Task 04: Verify OS Deployment

Verify that Azure Stack HCI OS has been successfully installed on all cluster nodes before proceeding to Phase 03: OS Configuration.

Task 05: Azure Bastion

Deploy Azure Bastion for secure browser-based RDP/SSH access to management VMs without public IP exposure.

Task 05: BIOS and iDRAC Settings Remediation

Remediate non-compliant BIOS and iDRAC settings identified in Task 04 using Dell Redfish API. Handles reboots, re-collects configuration, and re-runs Task 04 validation to confirm 100% compliance.

Task 05: Configure DNS Servers

Configure primary and secondary DNS server addresses on the management NIC of each Azure Local cluster node using explicit values from infrastructure.yml.

Task 05: Deploy Windows Admin Center

Deploy and configure Windows Admin Center (WAC) on a dedicated management server for Azure Local cluster management, monitoring, and Azure integration.

Task 05: Environment Checker Readiness

Run the standalone Azure Local Environment Checker (connectivity, hardware, software, Active Directory, network and Arc integration validators) before deployment, and uninstall it from the machines before deployment starts.

Task 05: Storage Configuration

Create the Storage Spaces Direct volumes and the Azure storage paths of the Azure Local instance from the master infrastructure.yml

Task 06: Customer Transfer

Give the customer administrator access to the Azure Local resources in Azure and write the transfer record

Task 06: Prepare Machines for Validate

After simplified machine provisioning, install the OEM drivers and SBE, set one static management address with one default gateway, DNS and time, and check every machine before cluster Validate.

Task 07: NAT Gateway

Deploy a NAT Gateway for outbound internet connectivity from the management subnet.

Task 08: Arc Gateway

Deploy an Azure Arc Gateway to enable Arc-enabled server connectivity through a centralized gateway endpoint.

Task 08: Enable ICMP (Ping)

Enable ICMPv4 and ICMPv6 inbound firewall rules on each Azure Local node to allow ping for network diagnostics and connectivity validation.

Task 10: Key Vault

Deploy the management Key Vault for storing deployment secrets, certificates, and credentials.

Task 11: SBE Update Import

Import the OEM Solution Builder Extension files into the cluster's update service when an update reports AdditionalContentRequired

Task 12: Install FC HBA Drivers (Conditional)

Install Fibre Channel HBA drivers (or the dedicated iSCSI adapter drivers) on Azure Local nodes for SAN disaggregated deployments, and get the zoning timing right for disaggregated versus hybrid

Troubleshooting and Known Issues

Known issues found on live runs of the azurelocal-ztp zero-touch automation, with the recovery steps Microsoft Learn documents for simplified machine provisioning.

Variable Management Standard

How variables are managed in the Azure Local toolkit: one registry, one infrastructure file, one template per tool.

Which Provisioning Method, Then OS Configuration

A decision flow from the way the OS was installed (azurelocal-ztp simplified provisioning, or a manual ISO install) to OS configuration, method detection, the two paths, the converge check, ARM Validate and ARM Deploy, and how to tell which method you used.

Zero-Touch Provisioning Automation (Preview)

How the azurelocal-ztp scripts take Azure Local machines from bare metal to Provisioned and Arc-connected, ending at the Handoff, with no one in the rack: stages, gates, management address modes, what runs where, parallel nodes, and resume. OS configuration follows.