loading

Backup and Preparation

Critical Prepare for the upgrade by backing up configurations

Critical Preparation Step
Preparation Checklist
  1. Backup all cluster configurations and settings
  2. Document current cluster state and applications
  3. Verify backup integrity before proceeding
  4. Plan maintenance window for upgrade process
Important Notes
  • CRITICAL: Do not proceed without verified backups
  • Document all custom configurations

Upgrade to Azure Local 23H2

Required Perform the operating system upgrade

External Process Required

This step involves external processes or documentation. Please follow the instructions carefully.

Steps to Complete
  1. Follow Microsoft's upgrade guide for 22H2 → 23H2
  2. Upgrade all nodes in the cluster
  3. Verify upgrade completion on each node
  4. Test cluster functionality after upgrade
Important Notes
  • Allow sufficient time for the upgrade process
  • Upgrade process may take several hours per node
Additional Resources

Verify 23H2 Upgrade

Confirm the OS upgrade completed successfully

PowerShell Commands
Get-SolutionUpdateEnvironment
whoami
Get-Cluster
Verification Checklist
  • 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

This guide walks you through installing DataON Solution Builder Extension (SBE) for the first time on Azure Local 23H2. First-time installation requires manual package download from the portal, followed by PowerShell-based installation. After successful installation, you can optionally configure automatic downloads for future updates. The entire process includes cluster validation, health checks, package import, installation execution, and optional setup of the download connector for streamlined maintenance.

Configuration Options
Option 1

Manual file import method (Required for first-time installation)

Works in offline environments
Full control over package versions
Required for initial SBE setup
Compatible with private/pre-release builds
Important Notes
  • Now proceed with first-time SBE installation

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 "{{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
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
$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

Select how you want to download the SBE packages. You only need to choose one method.

Automatic Download

Enable download connector for automatic package downloads during updates

Manual Import

Download and import SBE packages manually

Required Files

Every SBE package includes three files:

# Generic file pattern (family and version vary by your system)
  1. SBE_Discovery_DataON.xml
  2. SBE_DataON_<family>_<version>.xml
  3. SBE_DataON_<family>_<version>.zip
# Example with latest version (AZL8000i-4.2.2510.810):
  1. SBE_Discovery_DataON.xml
  2. SBE_DataON_AZL8000i_4.2.2510.810.xml
  3. SBE_DataON_AZL8000i_4.2.2510.810.zip
Browse Update Catalog
Actual Files for Your Selection

View the exact files available for the selected hardware and version. Access requires portal login with download permissions.

Select a System to View Files

Choose a hardware family and version (or log in) to load the exact files available for download.

Open Update Catalog
File Access Required

Register a cluster to access and download SBE package files.

Register Cluster
Import
PowerShell Commands
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
Important Notes
  • You can choose manual or automatic download method

Complete SBE Installation

Follow remaining installation steps

  • Continue with remaining installation steps (predownload, install, verify)
  • Refer to first-time installation guide for detailed instructions
  • Consider enabling automatic updates for future maintenance
Related Guides
First-Time Installation Guide Setup Automatic Updates