Manage updates in Azure Stack Hub
Full and express updates, hotfixes, as well as driver and firmware updates from the original equipment manufacturer (OEM) all help keep Azure Stack Hub up to date. This article explains the different types of updates, when to expect their release, and where to find more about the current release.
You can't apply Azure Stack Hub update packages to the Azure Stack Development Kit (ASDK). The update packages are designed for integrated systems. For information, see Redeploy the ASDK.
Update package types
There are three types of update packages for integrated systems:
Azure Stack Hub software updates. Microsoft is responsible for the end-to-end servicing lifecycle for the Microsoft software update packages. These packages can include the latest Windows Server security updates, non-security updates, and Azure Stack Hub feature updates. You download theses update packages directly from Microsoft.
Each update package has a corresponding type: Full or Express.
Full update packages update the physical host operating systems in the scale unit and require a larger maintenance window.
Express update packages are scoped and don't update the underlying physical host operating systems.
Azure Stack Hub hotfixes. Microsoft provides hotfixes for Azure Stack Hub that address a specific issue that's often preventive or time-sensitive. Each hotfix is released with a corresponding Microsoft Knowledge Base article that details the issue, cause, and resolution. You download and install hotfixes just like the regular full update packages for Azure Stack Hub. Hotfixes are cumulative and can install in minutes.
Starting with build 2005, when you update to a new major version (for example, 1.2002.x to 1.2005.x), the latest hotfixes (if any) in the new major version are installed automatically. From that point forward, if a hotfix is released for your build, you should install it.
OEM hardware-vendor-provided updates. Azure Stack Hub hardware partners are responsible for the end-to-end servicing lifecycle (including guidance) for the hardware-related firmware and driver update packages. In addition, Azure Stack Hub hardware partners own and maintain guidance for all software and hardware on the hardware lifecycle host. The OEM hardware vendor hosts these update packages on their own download site.
When to update
The three types of updates are released with the following cadence:
Azure Stack Hub software updates. Microsoft releases multiple full and express software update packages per year.
Azure Stack Hub hotfixes. Hotfixes are time-sensitive releases that can be released at any time. If you are upgrading from one major version to another (for example, 1.2002.x to 1.2005.x), the latest hotfixes (if any) in the new major version are installed automatically.
OEM hardware vendor-provided updates. OEM hardware vendors release their updates on an as-needed basis.
To continue to receive support, you must keep your Azure Stack Hub environment on a supported Azure Stack Hub software version. For more information, see Azure Stack Hub Servicing Policy.
How to know an update is available
Notice of updates varies on a couple of factors, such as your connection to the internet and the type of update.
Microsoft software updates and hotfixes
An update alert for Microsoft software updates and hotfixes will appear in the Update blade for Azure Stack Hub instances that are connected to the internet. If the Update blade isn't displayed, restart the infrastructure management controller VM.
OEM hardware vendor-provided updates
OEM updates depend on your manufacturer. You'll need to establish a communication channel with your OEM so that you can be aware of updates from your OEM that need to be applied. For more information about the OEMs and the OEM update process, see Apply Azure Stack Hub original equipment manufacturer (OEM) updates.
Major version to major version
An update from major version to major version must be step by step: the current environment can only update to the next major version, and you can't skip a major version update.
For example, if your Azure Stack Hub environment is 1908.x, and the latest available update version is 2002.x, you should update from 1908 to 1910, then update to 2002.
Starting with build 2005, when you update to a new major version (for example, 1.2002.x to 1.2005.x), the latest hotfixes (if any) in the new major version are installed automatically.
Hotfixes within major versions
Within the same major version number, Azure Stack Hub may release multiple hotfixes. Hotfixes are cumulative; the latest hotfix package includes all past hotfixes for that version. For more information, see Hotfixes.
Once you know you have an update, apply it by using the following steps.
Plan for the update
Prepare your Azure Stack Hub to make the update process go as smoothly as possible so that there's minimal impact on your users. Notify your users of any possible service outage and then follow the steps to prepare your instance for the update. Be sure to follow all steps in the Azure Stack Hub pre-update checklist to ensure that you've completed the required prerequisites for applying an update. Also make sure to schedule an appropriate maintenance window for the update type being applied.
Upload and prepare the update package
For internet-connected Azure Stack Hub environments, Azure Stack Hub software updates and hotfixes are automatically imported into the system and prepared for update.
For internet-disconnected Azure Stack Hub environments and environments with weak or intermittent internet connectivity, update packages are imported into Azure Stack Hub storage via the Azure Stack Hub administrator portal. For more steps to upload and prepare the update package, see Upload and prepare an Azure Stack Hub update package.
All OEM update packages are manually imported into your environment, regardless of your Azure Stack Hub system's internet connectivity. For more steps to import and prepare the update package, see Upload and prepare an Azure Stack Hub update package.
Apply the update
Apply the update using the Update blade in the Azure Stack Hub portal. During the update, monitor and troubleshoot the update progress. For more information, see Apply an Azure Stack Hub update.
The update resource provider
Azure Stack Hub includes an update resource provider that handles the application of Microsoft software updates. This provider checks that updates are applied across all physical hosts, Service Fabric apps and runtimes, and all infrastructure virtual machines and their associated services.
As updates install, you can view high-level status as the update process targets the various subsystems in Azure Stack Hub (for example, physical hosts and infrastructure virtual machines).