Update upgrade instructions from 22H2 to Azure Stack HCI version 24H2#4172
Open
Karl-WE wants to merge 4 commits intoMicrosoftDocs:mainfrom
Open
Update upgrade instructions from 22H2 to Azure Stack HCI version 24H2#4172Karl-WE wants to merge 4 commits intoMicrosoftDocs:mainfrom
Karl-WE wants to merge 4 commits intoMicrosoftDocs:mainfrom
Conversation
Clarified prerequisites and registration, converted the bullet points into a more readable table, especially because the resource registration could be overlooked. added note about download does not appear when registration is not made, in order to reduce support calls.
Contributor
|
@Karl-WE : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. |
Contributor
|
Learn Build status updates of commit be54f05:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| azure-local/concepts/plan-network-controller-deployment.md | Details | ||
| azure-local/deploy/deployment-install-os.md | Details | ||
| azure-local/deploy/deployment-introduction.md | Details | ||
| azure-local/deploy/deployment-local-identity-with-key-vault.md | Details | ||
| azure-local/deploy/deployment-prep-active-directory.md | Details | ||
| azure-local/deploy/deployment-virtual.md | Details | ||
| azure-local/manage/upgrade-sdn.md | Details | ||
| azure-local/overview/hyperconverged-overview.md | Details | ||
| azure-local/plan/configure-custom-settings-active-directory.md | Details | ||
| azure-local/TOC.yml | Details | ||
| azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md | Details | ||
| azure-local/whats-new.md | Details | ||
| azure-local/deploy/download-24h2-software.md | 💡Suggestion | Details | |
| azure-local/deploy/download-23h2-software.md | ✅Succeeded | n/a (file deleted or renamed) |
azure-local/concepts/plan-network-controller-deployment.md
- Line 26, Column 132: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/deploy/deployment-install-os.md
- Line 32, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-introduction.md
- Line 40, Column 11: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-local-identity-with-key-vault.md
- Line 54, Column 42: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-prep-active-directory.md
- Line 117, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-virtual.md
- Line 233, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/manage/upgrade-sdn.md
- Line 28, Column 28: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/overview/hyperconverged-overview.md
- Line 29, Column 9: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/plan/configure-custom-settings-active-directory.md
- Line 167, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/TOC.yml
- Line 141, Column 13: [Warning: file-not-found - See documentation]
Invalid file link: 'deploy/download-23h2-software.md'.
azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md
- Line 151, Column 71: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/whats-new.md
- Line 437, Column 239: [Warning: file-not-found - See documentation]
Invalid file link: './deploy/download-23h2-software.md'.
azure-local/deploy/download-24h2-software.md
- Line 0, Column 0: [Suggestion: filename-incomplete - See documentation]
The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed. - Line 27, Column 813: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com//entra/fundamentals/create-new-tenant' will be broken in isolated environments. Replace with a relative link.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
Karl-WE
changed the title
Contributor
|
Can you review the proposed changes? If you approve the new content in this PR, the commits must be moved to the private repository for automated checks and publishing. After you move the commits, close this PR ( #label:"aq-pr-triaged" @MicrosoftDocs/public-repo-pr-review-team |
prmerger-automator
bot
added
the
aq-pr-triaged
troettinger
reviewed
Apr 15, 2026
|
|
||
| This article describes how to download the operating system (OS) software from the Azure portal to deploy an Azure Local instance. | ||
|
|
||
| The first step in deploying Azure Local is to download the OS from the Azure portal. The software download includes a free 60-day trial. However, if you've purchased Integrated System or Premier solution hardware from the [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) through your preferred Microsoft hardware partner (OEM), the Azure Stack HCI OS should be preinstalled. |
Contributor
There was a problem hiding this comment.
This is incorrect, and the right statement is that OEMs have golden images available for the deployment.
Contributor
Author
There was a problem hiding this comment.
I believe this was part of the original instructions but due to the copy paste the whole file is marked as new
Contributor
Author
There was a problem hiding this comment.
@troettinger thanks for another review if this the changes honour your correction.
troettinger
suggested changes
Apr 15, 2026
Contributor
troettinger
left a comment
troettinger
left a comment
There was a problem hiding this comment.
See the comment otherwise looks good
Contributor
|
Hi @Karl-WE: Could you please update the PR to incorporate Thomas’s feedback? Once that’s done, I’ll pull this PR into the private repo to get it merged. I’ll keep this PR open until then. Thanks! |
Contributor
Author
|
Will take care about it |
added remark about OEM images and golden image download section.
Contributor
|
Learn Build status updates of commit 23234e6:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| azure-local/concepts/plan-network-controller-deployment.md | Details | ||
| azure-local/deploy/deployment-install-os.md | Details | ||
| azure-local/deploy/deployment-introduction.md | Details | ||
| azure-local/deploy/deployment-local-identity-with-key-vault.md | Details | ||
| azure-local/deploy/deployment-prep-active-directory.md | Details | ||
| azure-local/deploy/deployment-virtual.md | Details | ||
| azure-local/manage/upgrade-sdn.md | Details | ||
| azure-local/overview/hyperconverged-overview.md | Details | ||
| azure-local/plan/configure-custom-settings-active-directory.md | Details | ||
| azure-local/TOC.yml | Details | ||
| azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md | Details | ||
| azure-local/whats-new.md | Details | ||
| azure-local/deploy/download-24h2-software.md | 💡Suggestion | Details | |
| azure-local/deploy/download-23h2-software.md | ✅Succeeded | n/a (file deleted or renamed) |
azure-local/concepts/plan-network-controller-deployment.md
- Line 26, Column 132: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/deploy/deployment-install-os.md
- Line 32, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-introduction.md
- Line 40, Column 11: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-local-identity-with-key-vault.md
- Line 54, Column 42: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-prep-active-directory.md
- Line 124, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-virtual.md
- Line 234, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/manage/upgrade-sdn.md
- Line 28, Column 28: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/overview/hyperconverged-overview.md
- Line 29, Column 9: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/plan/configure-custom-settings-active-directory.md
- Line 167, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/TOC.yml
- Line 153, Column 13: [Warning: file-not-found - See documentation]
Invalid file link: 'deploy/download-23h2-software.md'.
azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md
- Line 151, Column 71: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/whats-new.md
- Line 526, Column 239: [Warning: file-not-found - See documentation]
Invalid file link: './deploy/download-23h2-software.md'.
azure-local/deploy/download-24h2-software.md
- Line 0, Column 0: [Suggestion: filename-incomplete - See documentation]
The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed. - Line 32, Column 813: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com//entra/fundamentals/create-new-tenant' will be broken in isolated environments. Replace with a relative link.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
consolidated messages.
Karl-WE
commented
Apr 16, 2026
|
|
||
| This article describes how to download the operating system (OS) software from the Azure portal to deploy an Azure Local instance. | ||
|
|
||
| The first step in deploying Azure Local is to download the OS from the Azure portal. The software download includes a free 60-day trial. However, if you've purchased Integrated System or Premier solution hardware from the [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) through your preferred Microsoft hardware partner (OEM), the Azure Stack HCI OS should be preinstalled. |
Contributor
Author
There was a problem hiding this comment.
I believe this was part of the original instructions but due to the copy paste the whole file is marked as new
|
|
||
| This article describes how to download the operating system (OS) software from the Azure portal to deploy an Azure Local instance. | ||
|
|
||
| The first step in deploying Azure Local is to download the OS from the Azure portal. The software download includes a free 60-day trial. However, if you've purchased Integrated System or Premier solution hardware from the [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) through your preferred Microsoft hardware partner (OEM), the Azure Stack HCI OS should be preinstalled. |
Contributor
Author
There was a problem hiding this comment.
@troettinger thanks for another review if this the changes honour your correction.
Contributor
|
Learn Build status updates of commit 85e2ae7:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| azure-local/concepts/plan-network-controller-deployment.md | Details | ||
| azure-local/deploy/deployment-install-os.md | Details | ||
| azure-local/deploy/deployment-introduction.md | Details | ||
| azure-local/deploy/deployment-local-identity-with-key-vault.md | Details | ||
| azure-local/deploy/deployment-prep-active-directory.md | Details | ||
| azure-local/deploy/deployment-virtual.md | Details | ||
| azure-local/manage/upgrade-sdn.md | Details | ||
| azure-local/overview/hyperconverged-overview.md | Details | ||
| azure-local/plan/configure-custom-settings-active-directory.md | Details | ||
| azure-local/TOC.yml | Details | ||
| azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md | Details | ||
| azure-local/whats-new.md | Details | ||
| azure-local/deploy/download-24h2-software.md | 💡Suggestion | Details | |
| azure-local/deploy/download-23h2-software.md | ✅Succeeded | n/a (file deleted or renamed) |
azure-local/concepts/plan-network-controller-deployment.md
- Line 26, Column 132: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/deploy/deployment-install-os.md
- Line 32, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-introduction.md
- Line 40, Column 11: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-local-identity-with-key-vault.md
- Line 54, Column 42: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-prep-active-directory.md
- Line 124, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-virtual.md
- Line 234, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/manage/upgrade-sdn.md
- Line 28, Column 28: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/overview/hyperconverged-overview.md
- Line 29, Column 9: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/plan/configure-custom-settings-active-directory.md
- Line 167, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/TOC.yml
- Line 153, Column 13: [Warning: file-not-found - See documentation]
Invalid file link: 'deploy/download-23h2-software.md'.
azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md
- Line 151, Column 71: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/whats-new.md
- Line 526, Column 239: [Warning: file-not-found - See documentation]
Invalid file link: './deploy/download-23h2-software.md'.
azure-local/deploy/download-24h2-software.md
- Line 0, Column 0: [Suggestion: filename-incomplete - See documentation]
The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed. - Line 28, Column 813: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com//entra/fundamentals/create-new-tenant' will be broken in isolated environments. Replace with a relative link.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
Contributor
Author
|
oopsie. @ManikaDhiman I am sorry I fail to understand the GitHub Automation issues after my PR change. Thanks for guidance. |
improving readability of Important remark
Contributor
|
Learn Build status updates of commit 58d8361:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| azure-local/concepts/plan-network-controller-deployment.md | Details | ||
| azure-local/deploy/deployment-install-os.md | Details | ||
| azure-local/deploy/deployment-introduction.md | Details | ||
| azure-local/deploy/deployment-local-identity-with-key-vault.md | Details | ||
| azure-local/deploy/deployment-prep-active-directory.md | Details | ||
| azure-local/deploy/deployment-virtual.md | Details | ||
| azure-local/manage/upgrade-sdn.md | Details | ||
| azure-local/overview/hyperconverged-overview.md | Details | ||
| azure-local/plan/configure-custom-settings-active-directory.md | Details | ||
| azure-local/TOC.yml | Details | ||
| azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md | Details | ||
| azure-local/whats-new.md | Details | ||
| azure-local/deploy/download-24h2-software.md | 💡Suggestion | Details | |
| azure-local/deploy/download-23h2-software.md | ✅Succeeded | n/a (file deleted or renamed) |
azure-local/concepts/plan-network-controller-deployment.md
- Line 26, Column 132: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/deploy/deployment-install-os.md
- Line 32, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-introduction.md
- Line 40, Column 11: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-local-identity-with-key-vault.md
- Line 54, Column 42: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-prep-active-directory.md
- Line 124, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/deploy/deployment-virtual.md
- Line 234, Column 4: [Warning: file-not-found - See documentation]
Invalid file link: './download-23h2-software.md'.
azure-local/manage/upgrade-sdn.md
- Line 28, Column 28: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/overview/hyperconverged-overview.md
- Line 29, Column 9: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/plan/configure-custom-settings-active-directory.md
- Line 167, Column 3: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/TOC.yml
- Line 153, Column 13: [Warning: file-not-found - See documentation]
Invalid file link: 'deploy/download-23h2-software.md'.
azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md
- Line 151, Column 71: [Warning: file-not-found - See documentation]
Invalid file link: '../deploy/download-23h2-software.md'.
azure-local/whats-new.md
- Line 526, Column 239: [Warning: file-not-found - See documentation]
Invalid file link: './deploy/download-23h2-software.md'.
azure-local/deploy/download-24h2-software.md
- Line 0, Column 0: [Suggestion: filename-incomplete - See documentation]
The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed. - Line 28, Column 813: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com//entra/fundamentals/create-new-tenant' will be broken in isolated environments. Replace with a relative link.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
Contributor
No worries, @Karl-WE. I’ll pull your changes into a private repo PR and keep the file name as-is to avoid any build issues. I'll keep this PR open until then. FYI, we’re planning to update file names as part of a separate bulk update project. Thanks! |
Contributor
Author
|
OK I defer to Thomas' feedback as mentioned the PR Review |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Clarified prerequisites and registration, converted the bullet points into a more readable table, especially because the resource registration could be overlooked.
added note about download does not appear when registration is not made, in order to reduce Microsoft support calls.