Vsan Upgrade System Ex Perform Vsan Upgrade Preflight Check Ex
Perform an upgrade preflight check on a cluster.
It deprecates API vim.VsanUpgradeSystem.PerformVsanUpgradePreflightCheck, and helps to check following issues which would break vSAN upgrade process:
- Any vSAN host is disconnected from vCenter server
- ESXi host before vSphere 6.0 exists in vSAN cluster, of which on-disk format cannot be upgraded
- Any vSAN host enables auto-mode to claim disk
- Network issue exists in vSAN cluster, which leads to communication problem among vSAN hosts
- Not all vSAN member hosts reside in specified vCenter cluster
- Any vSAN host contributes in the other vSAN cluster
- There is inaccessible vSAN object in vSAN datastore
- Any in-use vSAN disk that are unhealthy, such as physical disk lost
- Hybrid disk group exists in vSAN cluster, and requests to enable Deduplication and Compression
- To request enable Deduplication and Compression, but there is ESXi host software version is below then ESXi 6.0 Update 2
- vSAN downgrade is requested, but vSAN objects have already been upgraded to 2.0 or above
- Any vSAN object that would present an upgrade issue
Any issue detected by preflight check, requires manual fix by end user, before trigger vSAN upgrade process through PerformVsanUpgradeEx.
The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId
, in this case VsanUpgradeSystemEx/{moId}
.
The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.
"PerformVsanUpgradePreflightCheckExRequestType Object"
The target cluster to be converted.
Required privileges: Host.Config.Storage
Intend to perform a on-disk format downgrade instead of upgrade. Adds additional checks.
The specification of advanced disk format configuration. Adds additional checks. The specification cannot be supported in downgrade process, for now we don't have any advanced features supported by lower disk format.
Preflight check result.
"VsanDiskFormatConversionCheckResult Object"
Whether vSAN could process disk format conversion on given cluster with specified conversion options.
If this field is set to false, please check the issues field to get the detailed reason which blocks disk format conversion.
Goal format version the given cluster could support.
The goal format version is up to the versions of ESXi hosts under given cluster, please reference to below: ESXi of vSphere6.0U2 and latter, supported version is 3 in upgrade process, and 2 in downgrade process; ESXi of vSphere6.0 series before vSphere6.0U2, supported version is 2 in upgrade process, and 1 in downgrade process; ESXi of lower version, is not supported;
Whether data movement is required if disk format conversion process is triggered.
Cannonical name of the disk removed by previous DFC but not added back.
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/vsan/VsanUpgradeSystemEx/{moId}/PerformVsanUpgradePreflightCheckEx