12.2601.x SBE known issue updates #241
Open
+117
−0
Conversation
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
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds two new known issue troubleshooting guides for Azure Local 12.2601.x release addressing SBE (Solution Builder Extension) problems introduced in version 12.2601.1002.38.
Changes:
- Added TSG for SBE download failures caused by missing
Assert-SBEResponseSchemacmdlet after updating to 12.2601.1002.38 - Added TSG for SBE update failures due to
DeployADLessparameter validation issues on clusters deployed before 2408 - Added supporting screenshot showing Assert-SBEResponse failure example
Reviewed changes
Copilot reviewed 2 out of 3 changed files in this pull request and generated 8 comments.
| File | Description |
|---|---|
| TSG/SolutionExtension/SBE-download-fails-Assert-SBEResponseSchema-not-recognized.md | New troubleshooting guide documenting SBE download connector failures with detection script and three mitigation options |
| TSG/SolutionExtension/After-2601-SBE-update-fails-on-DeployADLess-parameter.md | New troubleshooting guide documenting DeployADLess parameter validation errors with PowerShell mitigation script |
| TSG/SolutionExtension/images/Assert-SBEResponse-Failure-Example.png | Screenshot illustrating the download failure pattern for issue validation |
TSG/SolutionExtension/After-2601-SBE-update-fails-on-DeployADLess-parameter.md
Show resolved
Hide resolved
| ### Option 3 - Avoid the download by importing the SBE | ||
| If you are experiencing this issue and do not wish to wait for the next Azure Local release you can use `Add-SolutionUpdate -SkipSbeVersionValidation` to import the SBE after manually downloading the 3 SBE files from your hardware vendor. Once the SBE has imported you should be able to start the SBE update as per the normal documented process. | ||
|
|
||
| **Note:** Refer to your hardware vendor SBE documentation for how to download and import your SBE. Microsoft describes the [general process for importing](https://learn.microsoft.com/en-us/azure/azure-local/update/update-via-powershell-23h2?view=azloc-2512#step-3-import-and-rediscover-updates)), but some hardware vendors require additional steps (such as extracting the 3 SBE files from a larger bundle) and thus you should primarily refer to hardware vendor documentation for specific guidance. No newline at end of file |
There was a problem hiding this comment.
The external link contains a version reference "view=azloc-2512" which violates the project's link guidelines. According to the coding guidelines, external links to Microsoft documentation should not include the release/view parameter. Remove the "?view=azloc-2512" portion from the URL.
Contributor
Author
There was a problem hiding this comment.
@copilot open a new pull request to apply changes based on this feedback
TSG/SolutionExtension/SBE-download-fails-Assert-SBEResponseSchema-not-recognized.md
Outdated
Show resolved
Hide resolved
TSG/SolutionExtension/After-2601-SBE-update-fails-on-DeployADLess-parameter.md
Show resolved
Hide resolved
TSG/SolutionExtension/After-2601-SBE-update-fails-on-DeployADLess-parameter.md
Outdated
Show resolved
Hide resolved
TSG/SolutionExtension/After-2601-SBE-update-fails-on-DeployADLess-parameter.md
Show resolved
Hide resolved
TSG/SolutionExtension/SBE-download-fails-Assert-SBEResponseSchema-not-recognized.md
Show resolved
Hide resolved
TSG/SolutionExtension/SBE-download-fails-Assert-SBEResponseSchema-not-recognized.md
Show resolved
Hide resolved
…ema-not-recognized.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…ess-parameter.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
AlBurns-MSFT
approved these changes
Jan 31, 2026
Collaborator
|
I reviewed, looks fine but I didn't see the change yet to alter the link to not point to the specific version, https://github.com/Azure/AzureLocal-Supportability/pull/241/changes/BASE..1a561f41e5577eca58b98ec3a60f6b7608f127a4#r2748678495 I'll merge once I see that's completed. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 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.
Add new known issue pages to mitigate 12.2601.x issues that will cause:
[DeployADLess]value on clusters that were deployed prior to 2408.