loading

Documentation

Known Issues

Review known issues and mitigations before deployment or update.

These release notes are continuously updated, and as critical issues requiring a workaround are discovered, they're added. Before you deploy your Azure Local instance, carefully review the information contained here.

Known issues catalog

#1

Partially Installed SBE Version 4.0.0.0 When SBE Is Installed as Part of Cluster Deployment

Severity: Medium

Affected families and versions

  • AZS-8000a 4.2.2601.1801
  • AZS-6000 5.0.2604.600
  • AZS-6000 4.2.2510.630
  • AZS-6000 4.2.2510.610
  • AZS-6000 4.2.2504.601
  • AZS-6000 4.1.2503.604
  • AZS-7000 5.0.2604.700
  • AZS-7000 4.2.2510.730
  • AZS-7000 4.2.2510.710
  • AZS-7000 4.2.2504.701
  • AZS-7000 4.1.2503.700
  • AZS-7000 4.1.2401.49
  • AZL-8000i 5.0.2604.800
  • AZL-8000i 4.2.2510.830
  • AZL-8000i 4.2.2510.810

Issue description

Get-SolutionUpdateEnvironment reports partially installed SBE when installing the SBE as part of Azure Local instance deployment. SBE version 4.0.0.0 indicates a partially installed Solution Builder Extension (SBE).

Get-SolutionUpdateEnvironment

ResourceId        : redmond
SbeFamily         : AZL8000i
HardwareModel     : AZL-8208i
LastChecked       : 4/16/2026 12:51:36 PM
PackageVersions   : {Solution: 12.2602.1002.501, Services: 10.2602.0.502, Platform: 12.2602.0.3018, SBE: 4.0.0.0}
CurrentVersion    : 12.2602.1002.501
CurrentSbeVersion : 4.0.0.0
LastUpdated       :
State             : UpdateAvailable
HealthState       : Success
HealthCheckResult : {Storage Services Physical Disks Summary, Storage Services Physical Disks Summary, Storage Services Physical Disks Summary, Storage Services Physical Disks Summary...}
HealthCheckDate   : 4/16/2026 12:10:29 AM
AdditionalData    : {[SBEAdditionalData, Solution Builder extension is partially installed. Please install the latest Solution Builder Extension provided by your hardware vendor. For more information, see https://aka.ms/SBE.]}

Root cause

Deployment process tries to install SBE but detects existing driver versions are different from the ones in SBE, which causes the installation to fail and roll back, leaving the system in a partially installed state with SBE version 4.0.0.0.

Workaround

Reinstall the same SBE version using the SBE side-load method or automated download method after Azure Local instance deployment successfully completes.

Add-SolutionUpdate -SourceFolder "C:\ClusterStorage\Infrastructure_1\Shares\..." -Verbose # Use THIS command IF doing side-load, otherwise only run the command below. 
Get-SolutionUpdate | Where-Object {$_.State -imatch "Ready" -and $_.PackageType -eq "SBE"}  | Sort-Object -Property ResourceID -Descending | Select-Object -First 1 | Start-SolutionUpdate -PrepareOnly

Open installation guide for pre-check flow

Fix

Microsoft is aware of this limitation and is working to resolve this issue in a future release. Before the fix is available, please follow the workaround steps to resolve the issue.
#2

SBE installation will not downgrade drivers that have a newer version than the same driver in the SBE payload

Severity: Medium

Affected families and versions

  • AZS-8000a 4.2.2601.1801
  • AZS-6000 5.0.2604.600
  • AZS-6000 4.2.2510.630
  • AZS-6000 4.2.2510.610
  • AZS-6000 4.2.2504.601
  • AZS-6000 4.1.2503.604
  • AZS-7000 5.0.2604.700
  • AZS-7000 4.2.2510.730
  • AZS-7000 4.2.2510.710
  • AZS-7000 4.2.2504.701
  • AZS-7000 4.1.2503.700
  • AZS-7000 4.1.2401.49
  • AZL-8000i 5.0.2604.800
  • AZL-8000i 4.2.2510.830
  • AZL-8000i 4.2.2510.810

Issue description

The SBE driver CAU plug-in will not attempt to downgrade installed drivers that are higher version than the ones in its payload unless otherwise specified by DataON.

Root cause

Golden Image used for deployment has newer driver versions than the ones in SBE, which will be ignored by the SBE CAU Plugin.

Workaround

Manually uninstall the drivers that have newer versions than the ones in SBE, then run SBE installation again using the SBE side-load method or automated download method after Azure Local instance deployment successfully completes.

If SBE contains unsupported older driver versions, please contact DataON support for further assistance.

Fix

DataON is aware of this limitation and is working to resolve this issue in a future release. Before the fix is available, please follow the workaround steps to resolve the issue.