大网数据广告活动
磁盘与文件系统

Upgrade a Storage Spaces Direct cluster

· 52CE 我爱测

Upgrade your Storage Spaces Direct cluster efficiently. Review supported upgrade methods, prerequisites, and how to keep your workloads running.

Upgrading a Storage Spaces Direct cluster to a newer version of Windows Server helps you take advantage of the latest features, security updates, and performance improvements. This article describes supported upgrade options for Storage Spaces Direct clusters running Windows Server 2016, including methods that minimize or eliminate virtual machine (VM) downtime. Learn about prerequisites, limitations, and step-by-step instructions for each upgrade approach, so you can choose the best method for your organization's needs.

Tip: The steps covered in this article aren't needed if you're upgrading a cluster from Windows Server 2019 or later. If you're upgrading a cluster from Windows Server 2019 or later, use the cluster OS rolling upgrade process to upgrade the cluster without stopping VMs. The steps in this article are for upgrading a cluster from Windows Server 2016 to Windows Server 2019 only.

To upgrade a Storage Spaces Direct cluster to a newer version of Windows Server, you have four options using the cluster OS rolling upgrade process. Two options involve keeping the virtual machines (VMs) running, and two options involve stopping all VMs. Each option has strengths and weaknesses, so select the option that best suits the needs of your organization.

To read more about an upgrade option, select a link:

  • In-place upgrade while VMs are running on each server in the cluster. This option incurs no VM downtime, but you must wait for storage jobs (mirror repair) to finish after each server is upgraded.

  • Clean OS installation while VMs are running on each server in the cluster. This option incurs no VM downtime. However, you must wait for storage jobs (mirror repair) to finish after each server is upgraded. You also need to set up each server again, including all its apps and roles. We recommend this option over an in-place upgrade.

  • In-place upgrade while VMs are stopped on each server in the cluster. This option incurs VM downtime, but you don't need to wait for storage jobs (mirror repair), so it's faster.

  • Clean OS installation while VMs are stopped on each server in the cluster. This option incurs VM downtime, but you don't need to wait for storage jobs (mirror repair), so it's faster. We recommend this option over an in-place upgrade.

Prerequisites and limitations

Before you proceed with an upgrade:

  • Storage Spaces Direct is enabled.

  • Check that you have usable backups in case any issues occur during the upgrade process.

  • Check that your hardware vendor has a BIOS, firmware, and drivers that are supported.

It's important to be aware of some limitations with the upgrade process:

  • Upgrading is fully supported on Resilient File System (ReFS) volumes, but in Windows Server 2019, upgraded volumes don't benefit from ReFS enhancements. Benefits from ReFS, such as improved performance for mirror-accelerated parity, require a newly created Windows Server 2019 or later ReFS volume. To create a new Windows Server ReFS volume, you must create new volumes by using the New-Volume cmdlet or Server Manager. Here are some of the ReFS enhancements in new volumes:

    • MAP log-bypass: A performance improvement in ReFS that applies only to clustered (Storage Spaces Direct) systems and doesn't apply to standalone storage pools.

    • Compaction: Efficiency improvements that are specific to multi-resilient volumes.

  • Before you upgrade your Storage Spaces Direct cluster server, we recommend that you put the server in storage maintenance mode.

  • A known issue occurs with Software Defined Networking environments that use Switch Embedded Teaming (SET) switches. The issue involves Hyper-V VM live migrations to an earlier version of the operating system. To ensure successful live migrations, we recommend that you change a VM network setting on VMs that you live-migrate.

Because of the known issues described here, some customers might choose to build a new cluster and copy data from the old cluster, instead of upgrading their Windows Server clusters by using one of the four methods described below.

Upgrade

The following section describes the four upgrade options in detail. Each section includes step-by-step instructions for performing the upgrade. Select your preferred upgrade option.

In-place upgrade while VMs are running

This option incurs no VM downtime, but you must wait for storage jobs (mirror repair) to complete after each server is upgraded. Although individual servers are restarted sequentially during the upgrade process, the remaining servers in the cluster and all VMs remain running.

  1. Check that all servers in the cluster have installed the latest Windows Update.

  2. If you're using Software Defined Networking with SET switches, open an elevated PowerShell session and run the following command to disable VM live migration verification checks on all VMs on the cluster:

    Get-ClusterResourceType -Cluster {clusterName} -Name "Virtual Machine" | `
    Set-ClusterParameter -Create SkipMigrationDestinationCheck -Value 1
    
  3. On one cluster server at a time, complete the following steps:

    1. Use Hyper-V VM live migration to move running VMs off the server you're about to upgrade.

    2. Pause the cluster server by running the following PowerShell command. Some internal groups are hidden. We recommend that you do this step with caution. If you didn't already live-migrate VMs off the server, this cmdlet does that step for you. In that case, you can skip the previous step, if you prefer.

      Suspend-ClusterNode -Drain
      
    3. Place the server in storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Enable-StorageMaintenanceMode
      
    4. Run the following cmdlet to check that the OperationalStatus value is In Maintenance Mode:

      Get-PhysicalDisk
      
    5. Perform an upgrade installation of Windows Server on the server by running setup.exe and using the Keep personal files and apps option. When installation is finished, the server remains in the cluster and the cluster service starts automatically.

    6. Check that the newly upgraded server has the latest Windows Server updates.

    7. Remove the server from storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Disable-StorageMaintenanceMode
      
    8. Resume the server:

      Resume-ClusterNode
      
    9. Wait for storage repair jobs to finish and for all disks to return to a healthy state. The process might take considerable time depending on the number of VMs running during the server upgrade. To check for a healthy state, run these commands:

      Get-StorageJob
      Get-VirtualDisk
      
  4. Upgrade the next server in the cluster.

  5. After all servers are upgraded to the latest version of Windows Server, use the following PowerShell cmdlet to update the cluster functional level. After you update the cluster functional level, you can't go back to the previous cluster functional level. That is, after you update the cluster functional level, you can't add the older version of Windows Server nodes to the cluster. For more information, see Cluster operating system rolling upgrade.

    Update-ClusterFunctionalLevel
    

    [!NOTE] Although you have up to four weeks to update the cluster functional level, we recommend that you update the cluster functional level as soon as possible.

  6. After you update the cluster functional level, use the following cmdlet to update the storage pool. At this point, new cmdlets like Get-ClusterPerf are fully operational on any server in the cluster.

    Update-StoragePool
    
  7. Optionally, upgrade VM configuration levels by stopping each VM, using the Update-VMVersion cmdlet, and then starting the VMs again.

  8. If you're using Software Defined Networking with SET switches and disabled VM live migration checks as instructed earlier, use the following cmdlet to reenable VM live verification checks:

    Get-ClusterResourceType -Cluster {clusterName} -Name "Virtual Machine" | `
    Set-ClusterParameter  SkipMigrationDestinationCheck -Value 0
    
  9. Verify that the upgraded cluster works as expected. Roles should fail over correctly. If VM live migration is used on the cluster, VMs should successfully live-migrate.

  10. Validate the cluster by running cluster validation and examining the cluster validation report. In an elevated PowerShell session, run the following command:

    Test-Cluster
    

Clean OS installation while VMs are running

This option incurs no VM downtime, but you must wait for storage jobs (mirror repair) to complete after each server is upgraded. Although individual servers are restarted sequentially during the upgrade process, the remaining servers in the cluster and all VMs remain running.

  1. Check that all servers in the cluster are running the latest updates.

  2. If you're using Software Defined Networking with SET switches, open an elevated PowerShell session and run the following command to disable VM live migration verification checks on all VMs on the cluster:

    Get-ClusterResourceType -Cluster {clusterName} -Name "Virtual Machine" | `
    Set-ClusterParameter -Create SkipMigrationDestinationCheck -Value 1
    
  3. On one cluster server at a time, complete the following steps:

    1. Use Hyper-V VM live migration to move running VMs off the server you're about to upgrade.

    2. Pause the cluster server by running the following PowerShell command. Some internal groups are hidden. We recommend that you do this step with caution. If you didn't already live-migrate VMs off the server, this cmdlet does that step for you. In that case, you can skip the previous step, if you prefer.

      Suspend-ClusterNode -Drain
      
    3. Place the server in storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Enable-StorageMaintenanceMode
      
    4. Run the following cmdlet to check that the OperationalStatus value is In Maintenance Mode:

      Get-PhysicalDisk
      
    5. Evict the server from the cluster:

      Remove-ClusterNode <ServerName>
      
    6. Perform a clean installation of the latest version of Windows Server on the server. For a clean installation, format the system drive, run setup.exe, and use the Nothing option. You must configure the server identity, roles, features, and applications after setup finishes and the server restarts.

    7. Install the Hyper-V role and Failover-Clustering feature on the server (you can use the Install-WindowsFeature cmdlet).

    8. Download and install the latest storage and networking drivers for your hardware from your server manufacturer that are approved for use with Storage Spaces Direct.

    9. Check that the newly upgraded server has the latest updates.

    10. Rejoin the server to the cluster:

      Add-ClusterNode
      
    11. Remove the server from storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Disable-StorageMaintenanceMode
      
    12. Wait for storage repair jobs to finish and for all disks to return to a healthy state. The process might take considerable time depending on the number of VMs running during the server upgrade. To check for a healthy state, run these commands:

      Get-StorageJob
      Get-VirtualDisk
      
  4. Upgrade the next server in the cluster.

  5. After all servers are upgraded to the latest version of Windows Server, use the following PowerShell cmdlet to update the cluster functional level. After you update the cluster functional level, you can't go back to the previous cluster functional level.

    Update-ClusterFunctionalLevel
    

    [!NOTE] Although you have up to four weeks to update the cluster functional level, we recommend that you update the cluster functional level as soon as possible.

  6. After you update the cluster functional level, use the following cmdlet to update the storage pool. At this point, new cmdlets like Get-ClusterPerf are fully operational on any server in the cluster.

    Update-StoragePool
    
  7. Optionally, upgrade VM configuration levels by stopping each VM, using the Update-VMVersion cmdlet, and then starting the VMs again.

  8. If you're using Software Defined Networking with SET switches and disabled VM live migration checks as instructed earlier, use the following cmdlet to reenable VM live verification checks:

    Get-ClusterResourceType -Cluster {clusterName} -Name "Virtual Machine" | `
    Set-ClusterParameter SkipMigrationDestinationCheck -Value 0
    
  9. Verify that the upgraded cluster works as expected. Roles should fail over correctly. If VM live migration is used on the cluster, VMs should successfully live-migrate.

  10. Validate the cluster by running Cluster Validation and examining the cluster validation report. In an elevated PowerShell session, run the following command:

    Test-Cluster
    

In-place upgrade while VMs are stopped

This option performs an in-place upgrade of each server in the cluster while all VMs are stopped. The upgrade process is usually faster than upgrading while VMs are running, because you don't need to wait for storage jobs (mirror repair) to finish after each server is upgraded. Although individual servers are restarted sequentially during the upgrade process, the remaining servers in the cluster remain running.

  1. Check that all servers in the cluster are running the latest updates.

  2. Stop the VMs that are running on the cluster.

  3. On one cluster at a time, complete the following steps:

    1. Pause the cluster server by opening an elevated PowerShell session and running the following PowerShell command. Some internal groups are hidden. We recommend that you do this step with caution.

      Suspend-ClusterNode -Drain
      
    2. Place the server in storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Enable-StorageMaintenanceMode
      
    3. Run the following cmdlet to check that the OperationalStatus value is In Maintenance Mode:

      Get-PhysicalDisk
      
    4. Perform an upgrade installation of Windows Server on the server by running setup.exe and using the Keep personal files and apps option. When installation is finished, the server remains in the cluster and the cluster service starts automatically.

    5. Check that the newly upgraded server has the latest Windows Server updates.

    6. Remove the server from storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Disable-StorageMaintenanceMode
      
    7. Resume the server:

      Resume-ClusterNode
      
    8. Wait for storage repair jobs to finish and for all disks to return to a healthy state. The process should be relatively fast because VMs aren't running. Run these commands to check for a healthy state:

      Get-StorageJob
      Get-VirtualDisk
      
  4. Upgrade the next server in the cluster.

  5. After all servers are upgraded to the latest version of Windows Server, use the following PowerShell cmdlet to update the cluster functional level.

    Update-ClusterFunctionalLevel
    

    [!NOTE] Although you have up to four weeks to update the cluster functional level, we recommend that you update the cluster functional level as soon as possible.

  6. After you update the cluster functional level, use the following cmdlet to update the storage pool. At this point, new cmdlets like Get-ClusterPerf are fully operational on any server in the cluster.

    Update-StoragePool
    
  7. Start the VMs on the cluster and check that they're working properly.

  8. Optionally, upgrade VM configuration levels by stopping each VM, using the Update-VMVersion cmdlet, and then starting the VMs again.

  9. Verify that the upgraded cluster works as expected. Roles should fail over correctly. If VM live migration is used on the cluster, VMs should successfully live-migrate.

  10. Validate the cluster by running Cluster Validation and examining the cluster validation report. In an elevated PowerShell session, run the following command:

    Test-Cluster
    

Clean OS installation while VMs are stopped

This option performs a clean installation of Windows Server on each server in the cluster while all VMs are stopped. The upgrade process is usually faster than upgrading while VMs are running, because you don't need to wait for storage jobs (mirror repair) to finish after each server is upgraded. Although individual servers are restarted sequentially during the upgrade process, the remaining servers in the cluster remain running.

  1. Check that all the servers in the cluster are running the latest updates.

  2. Stop the VMs that are running on the cluster.

  3. One cluster server at a time, complete the following steps:

    1. Pause the cluster server by opening an elevated PowerShell session and running the following PowerShell command. Some internal groups are hidden. We recommend that you do this step with caution.

      Suspend-ClusterNode -Drain
      
    2. Place the server in storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Enable-StorageMaintenanceMode
      
    3. Run the following cmdlet to check that the OperationalStatus value is In Maintenance Mode:

      Get-PhysicalDisk
      
    4. Evict the server from the cluster:

      Remove-ClusterNode <ServerName>
      
    5. Perform a clean installation of Windows Server on the server. For a clean installation, format the system drive, run setup.exe, and use the Nothing option. You must configure the server identity, roles, features, and applications after setup finishes and the server restarts.

    6. Install the Hyper-V role and Failover-Clustering feature on the server (you can use the Install-WindowsFeature cmdlet).

    7. Download and install the latest storage and networking drivers for your hardware from your server manufacturer that are approved for use with Storage Spaces Direct.

    8. Check that the newly upgraded server has the latest Windows Server updates.

    9. Rejoin the server to the cluster:

      Add-ClusterNode
      
    10. Remove the server from storage maintenance mode:

      Get-StorageFaultDomain -type StorageScaleUnit | `
      Where FriendlyName -Eq <ServerName> | `
      Disable-StorageMaintenanceMode
      
    11. Wait for storage repair jobs to finish and for all disks to return to a healthy state. The process might take considerable time depending on the number of VMs running during the server upgrade. To check for a healthy state, run these commands:

      Get-StorageJob
      Get-VirtualDisk
      
  4. Upgrade the next server in the cluster.

  5. After all servers are upgraded to the latest version of Windows Server, use the following PowerShell cmdlet to update the cluster functional level.

    Update-ClusterFunctionalLevel
    

    [!NOTE] Although you have up to four weeks to update the cluster functional level, we recommend that you update the cluster functional level as soon as possible.

  6. After you update the cluster functional level, use the following cmdlet to update the storage pool. At this point, new cmdlets like Get-ClusterPerf are fully operational on any server in the cluster.

    Update-StoragePool
    
  7. Start the VMs on the cluster and check that they're working properly.

  8. Optionally, upgrade VM configuration levels by stopping each VM, using the Update-VMVersion cmdlet, and then starting the VMs again.

  9. Verify that the upgraded cluster works as expected. Roles should fail over correctly. If VM live migration is used on the cluster, VMs should successfully live-migrate.

  10. Validate the cluster by running Cluster Validation and examining the cluster validation report. In an elevated PowerShell session, run the following command:

    Test-Cluster
    

Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Server documentation
适用范围
Windows Server · Source date 06/27/2025
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。