loading

Backup and Preparation

critical Prepare for the upgrade by backing up configurations

Step Information
{ "instructions": [ "Backup all cluster configurations and settings", "Document current cluster state and applications", "Verify backup integrity before proceeding", "Plan maintenance window for upgrade process" ] }

Upgrade to Azure Local 23H2

Required Perform the operating system upgrade

Content Not Available

The content for this step (ID: os-upgrade) is not yet available.

Expected partial: ../installation/step-os-upgrade

Verify 23H2 Upgrade

Confirm the OS upgrade completed successfully

Step Information
{ "commands": [ "Get-SolutionUpdateEnvironment", "whoami", "Get-Cluster" ], "checks": [ "Verify CurrentVersion shows 23H2 (2311.2) or later", "Confirm HealthState is Success", "Check all cluster nodes are online", "Verify cluster services are running" ] }

SBE Installation - Introduction

Learn about SBE installation process

Migration from Azure Stack HCI 22H2 to 23H2

Upgrading from 22H2 and installing SBE for the first time

Prerequisites:
  • Azure Stack HCI 22H2 currently installed
  • Backup of all cluster configurations completed
  • Review Microsoft upgrade documentation
  • Administrative access to the cluster
  • Network access for OS upgrade and SBE download
Overview of Steps:
  1. Backup and Preparation - Prepare for the upgrade by backing up configurations
  2. Upgrade to Azure Local 23H2 - Perform the operating system upgrade
  3. Verify 23H2 Upgrade - Confirm the OS upgrade completed successfully
  4. SBE Installation - Introduction - Learn about SBE installation process
  5. Connect & Discover Updates - Discover available SBE updates
  6. Download SBE Package - Choose your download method for SBE packages
  7. Complete SBE Installation - Follow remaining installation steps
Important Notes:
  • IMPORTANT: Complete the 22H2 → 23H2 upgrade BEFORE installing SBE
  • SBE is only available for Azure Local 23H2 (2311.2) and later
  • Allow sufficient time for both OS upgrade and SBE installation
  • Test cluster functionality after OS upgrade before installing SBE
SBE All Versions
General

DataON Solution Builder Extension (SBE) Update Package

This installation guide will walk you through the complete process of updating your DataON Azure Stack HCI cluster with the latest SBE version. The Solution Builder Extension provides essential firmware packages that ensure optimal performance, security, and compatibility for your DataON hardware and Azure Stack HCI environment.

Supported Models
Ready for multiple series
AZS-6000 family AZS-7000 family

Select a model family in the previous page or use the update catalog to see model-specific details.

Connect & Discover Updates

Discover available SBE updates

Prerequisites
Connect to Your Azure Local

Open a remote PowerShell session to one machine in the system using the deployment user account.

PowerShell Commands
$cred = Get-Credential
Enter-PSSession -ComputerName "YOUR_CLUSTER_NODE" -Credential $cred

Sign in with the deployment user account created during Active Directory prep.

Confirm Software and Verify System Health

Ensure the system is on Azure Local 2311+ and is healthy before proceeding.

PowerShell Commands
whoami
Get-SolutionUpdateEnvironment
Important Checks:
  • Record CurrentVersion
  • Verify HealthState is Success; if Failure/Error/Warning, troubleshoot readiness first
Discover Available Updates

List update candidates and inspect details of the one you plan to install.

PowerShell Commands
Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
Get-SolutionUpdate | FL DisplayName, Description, ResourceId, State, PackageType
$Update = Get-SolutionUpdate -Id RESOURCE_ID
$Update.ComponentVersions

You may see both Solution and SBE (Solution Builder Extension) items.

If the expected update isn't Ready, remove filters to see non-ready states.

Download SBE Package

Required Choose your download method for SBE packages

Step Information
{ "description": "Select how you want to download the SBE packages. You only need to choose one method.", "methods": { "download-connector": { "title": "Automatic Download", "description": "Enable download connector for automatic package downloads during updates", "badge": "recommended", "icon": "bi-download", "benefits": [ { "title": "Automatic Downloads", "description": "Files download automatically during Start-SolutionUpdate", "icon": "bi-lightning-charge" }, { "title": "Version Validation", "description": "Ensures correct package for your hardware is downloaded", "icon": "bi-shield-check" }, { "title": "Time Savings", "description": "No manual file management required", "icon": "bi-clock" }, { "title": "Future Updates", "description": "Works on all subsequent updates", "icon": "bi-arrow-repeat" } ], "prerequisites": [ "Azure Local cluster is registered on the SBE portal", "SBE version is 4.1.2411.xxxx or higher", "Network connectivity to Microsoft Update services and https://dataonsbe.azurewebsites.net/download" ], "commands": { "status_check": [ "Get-SolutionExtensionProperty" ], "enable": [ "Set-SolutionExtensionProperty -PropertyHash @{EnableSBEDownload='true'}" ] }, "status_interpretation": { "enabled": "EnableSBEDownload = 'true' - Download connector is enabled", "disabled": "EnableSBEDownload = 'false' or not found - Download connector is disabled" } }, "manual": { "title": "Manual Import", "description": "Download and import SBE packages manually", "badge": "as_needed", "icon": "bi-upload", "benefits": [ { "title": "Full Control", "description": "Full control over download process", "icon": "bi-gear" }, { "title": "Private Builds", "description": "Works with private builds", "icon": "bi-lock" }, { "title": "Offline Capability", "description": "Offline download capability", "icon": "bi-wifi-off" }, { "title": "Required Scenarios", "description": "Required for AdditionalContentRequired scenarios", "icon": "bi-exclamation-triangle" } ], "when_to_use": [ "The update reports AdditionalContentRequired", "You received a private build", "You want to avoid online download of the SBE", "Download connector is not enabled or fails" ], "commands": { "import": [ "New-Item C:\\\\ClusterStorage\\\\Infrastructure_1\\\\Shares\\\\SU1_Infrastructure_1\\\\import -ItemType Directory", "Add-SolutionUpdate -SourceFolder C:\\\\ClusterStorage\\\\Infrastructure_1\\\\Shares\\\\SU1_Infrastructure_1\\\\import" ] }, "process_steps": [ { "number": 1, "title": "Download Files", "description": "Download all required SBE package files using the download section above" }, { "number": 2, "title": "Create Import Directory", "description": "Run the first command to create the import directory on your cluster storage" }, { "number": 3, "title": "Copy Files", "description": "Copy downloaded files to the created import directory on the cluster" }, { "number": 4, "title": "Import Updates", "description": "Run the Add-SolutionUpdate command to import the packages" } ], "important_notes": [ "Ensure all required files are downloaded before running import commands", "The import directory will be created automatically if it doesn't exist", "Files must be placed in the correct cluster storage path", "Verify file integrity before importing", "Check cluster storage space before copying large files" ], "follow_up": [ "Proceed to Step 5: Predownload & Check Update Readiness" ] } } }

Complete SBE Installation

Follow remaining installation steps

Step Information
{ "instructions": [ "Continue with remaining installation steps (predownload, install, verify)", "Refer to first-time installation guide for detailed instructions", "Consider enabling automatic updates for future maintenance" ], "links": [ { "text": "First-Time Installation Guide", "url": "/updates/first-time-install" }, { "text": "Setup Automatic Updates", "url": "/updates/setup-automatic-updates" } ] }