Skip to content

Update deployment-virtual.md - adjust system requirements #3830

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 10 commits into
base: main
Choose a base branch
from
Open

Update deployment-virtual.md - adjust system requirements #3830

Changes from 3 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
782f4e8
Update deployment-virtual.md
Karl-WE Sep 2, 2025
3040502
Update deployment-virtual.md
Karl-WE Sep 2, 2025
be9f8cd
Update deployment-virtual.md
Karl-WE Sep 2, 2025
5ee0e4a
Aktualisieren von deployment-virtual.md
Karl-WE Sep 22, 2025
995c1a6
Aktualisieren von deployment-virtual.md
Karl-WE Sep 22, 2025
1c3b57f
Aktualisieren von deployment-virtual.md
Karl-WE Sep 22, 2025
765bd02
Aktualisieren von deployment-virtual.md
Karl-WE Sep 22, 2025
7ba1c1a
Aktualisieren von deployment-virtual.md
Karl-WE Sep 22, 2025
bbbf593
Aktualisieren von deployment-virtual.md
Karl-WE Sep 22, 2025
10533cd
Revise deployment instructions for Azure Local
Karl-WE Oct 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 12 additions & 16 deletions azure-local/deploy/deployment-virtual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Deploy a virtual Azure Local, version 23H2 system
title: Deploy a virtual Azure Local, version 23H2 / 24H2 system
description: Describes how to perform an Azure Local, version 23H2 virtualized deployment.
author: alkohli
ms.author: alkohli
Expand Down Expand Up @@ -52,10 +52,10 @@ Before you begin, make sure that each virtual host system can dedicate the follo
| ----------| ------- |
| Virtual machine (VM) type | Secure Boot and Trusted Platform Module (TPM) enabled. |
| vCPUs | Four cores. |
| Memory | A minimum of 24 GB. |
| Memory | A minimum of 32 GB. |
Copy link
Contributor Author

@Karl-WE Karl-WE Sep 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To comply with latest HW requirements as per docs
AzL configurator app will hardcheck for 32 GB.

| Networking | At least two network adapters connected to internal network. MAC spoofing must be enabled. |
| Boot disk | One disk to install the Azure Stack HCI operating system from ISO. At least 200 GB. |
| Hard disks for Storage Spaces Direct | Four dynamic expanding disks. Maximum disk size is 1024 GB. |
| Boot disk | One disk to install the Azure Local operating system from ISO. At least 127 GB. |
| Hard disks for Storage Spaces Direct | Two dynamic expanding disks. Maximum disk size is 1024 GB. |
| Data disks | At least 127 GB each. The size must be the same for each disk. |
| Time synchronization in integration | Disabled. |

Expand Down Expand Up @@ -117,7 +117,7 @@ Follow these steps to create an example VM named `Node1` using PowerShell cmdlet

```PowerShell
New-VHD -Path "your_VHDX_path" -SizeBytes 127GB
New-VM -Name Node1 -MemoryStartupBytes 20GB -VHDPath "your_VHDX_path" -Generation 2 -Path "VM_config_files_path"
New-VM -Name Node1 -MemoryStartupBytes 32GB -VHDPath "your_VHDX_path" -Generation 2 -Path "VM_config_files_path"
```

1. Disable dynamic memory:
Expand Down Expand Up @@ -187,26 +187,22 @@ Follow these steps to create an example VM named `Node1` using PowerShell cmdlet
Set-VmProcessor -VMName "Node1" -Count 8
```

1. Create extra drives to be used as the boot disk and hard disks for Storage Spaces Direct. After these commands are executed, six new VHDXs will be created in the `C:\vms\Node1` directory as shown in this example:
1. Create extra drives to be used as one for boot disk and two hard disks for Storage Spaces Direct. After these commands are executed, three new VHDXs will be created in the `C:\vms\Node1` directory as shown in this example:
Copy link
Contributor

@ronmiab ronmiab Oct 13, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Karl-WE - suggested rewrite:

Create extra drives to be used as one for the boot disk and two hard disks for Storage Spaces Direct.

  • After you run these commands, as shown in the example, three new VHDXs appear in the C:\vms\Node1 directory.


```PowerShell
new-VHD -Path "C:\vms\Node1\OS.vhdx" -SizeBytes 127GB
new-VHD -Path "C:\vms\Node1\s2d1.vhdx" -SizeBytes 1024GB
new-VHD -Path "C:\vms\Node1\s2d2.vhdx" -SizeBytes 1024GB
new-VHD -Path "C:\vms\Node1\s2d3.vhdx" -SizeBytes 1024GB
new-VHD -Path "C:\vms\Node1\s2d4.vhdx" -SizeBytes 1024GB
new-VHD -Path "C:\vms\Node1\s2d5.vhdx" -SizeBytes 1024GB
new-VHD -Path "C:\vms\Node1\s2d6.vhdx" -SizeBytes 1024GB
```
```

1. Attach drives to the newly created VHDXs for the VM. In these commands, six VHDs located in the `C:\vms\Node1` directory and named `s2d1.vhdx` through `s2d6.vhdx` are added to `Node1`. Each `Add-VMHardDiskDrive` command adds one VHD to the VM, so the command is repeated six times with different `-Path` parameter values.
1. Attach drives to the newly created VHDXs for the VM. In these commands, two VHDs located in the `C:\vms\Node1` directory and named `s2d1.vhdx` through `s2d2.vhdx` are added to `Node1`. Each `Add-VMHardDiskDrive` command adds one VHD to the VM, so the command is repeated six times with different `-Path` parameter values.

Afterwards, the `Node1` VM has four VHDs attached to it. These VHDXs are used to enable Storage Spaces Direct on the VM, which are required for Azure Stack HCI deployments:
Afterwards, the `Node1` VM has two VHDs attached to it. These VHDXs are used to enable Storage Spaces Direct on the VM, which are required for Azure Local deployments:

```PowerShell
Add-VMHardDiskDrive -VMName "Node1" -Path "C:\vms\Node1\OS.vhdx"
Add-VMHardDiskDrive -VMName "Node1" -Path "C:\vms\Node1\s2d1.vhdx"
Add-VMHardDiskDrive -VMName "Node1" -Path "C:\vms\Node1\s2d2.vhdx"
Add-VMHardDiskDrive -VMName "Node1" -Path "C:\vms\Node1\s2d3.vhdx"
Add-VMHardDiskDrive -VMName "Node1" -Path "C:\vms\Node1\s2d4.vhdx"
```

1. Disable time synchronization:
Expand All @@ -229,7 +225,7 @@ Follow these steps to create an example VM named `Node1` using PowerShell cmdlet

## Install the OS on the virtual host VMs

Complete the following steps to install and configure the Azure Stack HCI OS on the virtual host VMs:
Complete the following steps to install and configure the Azure Local OS on the virtual host VMs:

1. [Download version 23H2 operating system for Azure Local deployment](./download-23h2-software.md) and [Install the Azure Stack HCI operating system](deployment-install-os.md).

Expand Down