SDDC-Manager storage Upgrade Pre-checks failures/issues during the VCF upgrade workflow
search cancel

SDDC-Manager storage Upgrade Pre-checks failures/issues during the VCF upgrade workflow

book

Article ID: 400362

calendar_today

Updated On:

Products

VMware SDDC Manager

Issue/Introduction

SDDC-Manager upgrades include manual pre-checks for General Upgrade Readiness or Version Specific Checks, depending on the SDDC-Manager's current state. These checks may reveal errors or warnings that must be addressed before the upgrade. Comprehensive pre-checks aim to prevent upgrade failures, though false positives can occur. This document focuses on a selection of these pre-checks and offers solutions or workarounds.

The pre-checks addressed include:

  • vSAN Cluster Health: Checks for overall cluster health.
  • vSAN Cluster Network Health: Verifies network status.
  • vSAN Encryption Health: Assesses encryption health.
  • Controller Firmware Certification: Confirms firmware certification per the VMware Compatibility Guide.
  • vSAN Advanced Configuration: Checks for consistent non-default configurations across hosts.
  • vSAN Network Latency: Measures network latency between hosts.
  • vSAN Metadata Integrity: Identifies metadata integrity issues on disks.
  • vSAN Disk Group Certification: Ensures disk group type certification for the SCSI controller.
  • Key Management Server Connectivity: Verifies connectivity between vCenter Server, hosts, and Key Management Servers.

Environment

VCF 9.0

VCF 5.2

Resolution

This document outlines the resolution for pre-checks associated with the upgrade mentioned in the Issue/Introduction section.

  • Check if vSAN cluster is healthy:
    Remediation/Workaround: This is an overall vSAN cluster health check, if there are no specific vSAN cluster health issues reported, this check result can be ignored. For further details, please check cluster skyline health from the vCenter.

  • Check if vSAN cluster network is healthy:
    Remediation/Workaround: This is an overall vSAN cluster network health check, if there are no specific vSAN cluster network health issues reported, this check can be ignored. For further details, please check cluster skyline health from the vCenter.

  • Checks for vSAN encryption health:
    Remediation/Workaround: This is an overall vSAN cluster encryption health check, if there are no specific vSAN cluster encryption health issues reported, this check can be ignored. For further details, please check cluster skyline health from the vCenter.

  • Checks if controller firmware is certified per the VMware Compatibility Guide:
    Remediation/Workaround: This check can be ignored, should not affect upgrade workflow. For further details, please check cluster skyline health from the vCenter.

  •  Checks if all the hosts in a vSAN cluster have consistent non-default advanced configuration options:
    Remediation/Workaround: This check can be ignored, as it should not impact the upgrade workflow. Default configuration values are skipped. For details, refer to cluster skyline health in vCenter.

  • Performs a network latency check of vSAN hosts:
    Remediation/Workaround: This check can be ignored, as it should not impact the upgrade workflow. For details, refer to cluster skyline health in vCenter.

  • Checks whether vSAN has encountered an integrity issue of the metadata of a component on a disk for this cluster::
    Remediation/Workaround: This check applies only to vSAN OSA clusters. Issues reported for other cluster types can be disregarded. For details, refer to cluster skyline health in vCenter.

  • Checks if the vSAN disk group type (All-Flash or Hybrid) is certified for the used SCSI controller in the VMware Compatibility Guide:
    Remediation/Workaround: This check applies only to vSAN OSA clusters. Issues reported for other cluster types can be disregarded. For details, refer to cluster skyline health in vCenter.

  • Checks if the vCenter Server and hosts can connect to Key Management Servers:
    Remediation/Workaround: This check does not apply to compute clusters. Issues reported for compute clusters can be disregarded. For details, refer to cluster skyline health in vCenter.

Additional Information

For the listed upgrade pre-check failure, in the section - Issue/Introduction, follow the KB articles:

1. Check if vSAN cluster is healthy - https://knowledge.broadcom.com/external/article/326929/vsan-health-service-data-health-vsan-o.html 
2. Check if vSAN cluster network is healthy - https://knowledge.broadcom.com/external/article/318839/vsan-health-service-network-health-vsa.html 
3. Checks for vSAN encryption health - https://knowledge.broadcom.com/external/article/326769/troubleshooting-vsan-encryption.html 
4. Checks if controller firmware is certified per the VMware Compatibility Guide - https://knowledge.broadcom.com/external/article/326630/vsan-skyline-health-hardware-compatibi.html 
5. Checks if all the hosts in a vSAN cluster have consistent non-default advanced configuration options. The advanced configuration with default value will be skipped and not shown in the result - https://knowledge.broadcom.com/external/article/327010/vsan-health-service-cluster-health-adv.html 
6. Performs a network latency check of vSAN hosts - https://knowledge.broadcom.com/external/article/315544/vsan-health-service-network-health-net.html 
7. Checks whether vSAN has encountered an integrity issue of the metadata of a component on a disk for this cluster - https://knowledge.broadcom.com/external/article/369423/upgrade-prechecks-fails-with-esxi-cluste.html 
8. Checks if the vSAN disk group type (All-Flash or Hybrid) is certified for the used SCSI controller in the VMware Compatibility Guide - https://knowledge.broadcom.com/external/article/325347/vsan-skyline-health-warning-controller-d.html 
9. Checks if the vCenter Server and hosts can connect to Key Management Servers - https://knowledge.broadcom.com/external/article/326514/vsan-health-vmware-vcenter-and-all-host.html