Search the VMware Knowledge Base (KB)
View by Article ID

Understanding vSAN on-disk format versions (2145267)

  • 3 Ratings
Language Editions

Purpose

This article outlines all vSAN on-disk format versions, their purposes, and alternate version numbers where applicable.
 
vSAN has several different on-disk format versions available depending on the version and upgrade history of the cluster. Some on-disk format versions are transient while some are intended for long-term production.

Important: There can be some deviation between the on-disk format version displayed in the vSphere Web Client and the version displayed during command-line troubleshooting or reporting.


Resolution

For more information about on-disk versions, see:
 
Version per vSphere Web Client Version per RVC
Version per esxcli
Version per CMMDS
vSAN Release
Notes
1 1 N/A N/A vSAN 5.5 The primary on-disk format for the first vSAN Release
2 2 N/A 2 vSAN 6.0, vSAN 6.1 New on-disk format for vSAN 6.0/6.1; included performance and snapshot improvements
2.5 3 2.5 3 vSAN 6.2 Intermediate on-disk format for vSAN 6.2; permits object realignment before movement to new feature-enabled on-disk format
3 4 3 4 vSAN 6.2 New on-disk format for vSAN 6.2; includes support for checksum/deduplication/compression features in vSAN 6.2

Note: There is a deviation between the vCenter Serve and esxcli on-disk format version numbers and the RVC/CMMDS on-disk format version numbers in vSAN 6.2.
 
For example:
  • In vCenter Server, you see that the cluster is processing an on-disk upgrade where disks on the host vsan11 are version 3 and disks on the host vsan16 are version 2.5:

     

  • In the Ruby vSphere Console (RVC), you see the output displaying disks format version as 4 and 3 for the same cluster:
    +--------------------------------------+---------------+-------+------+-----------+---------+----------+---------+
    |                                      |               |       | Num  | Capacity  |         |          | Status  |
    | DisplayName                          | Host          | isSSD | Comp | Total     | Used    | Reserved | Health  |
    +--------------------------------------+---------------+-------+------+-----------+---------+----------+---------+
    | naa.644a84202d79f0001d245b37267e9f26 | ds-lab-vsan11 | SSD   | 0    | 92.62 GB  | 2.27 %  | 2.27 %   | OK (v4) |
    | naa.644a84202d79f0001d1efd6404ca467a | ds-lab-vsan11 | MD    | 25   | 276.08 GB | 47.08 % | 5.96 %   | OK (v4) |
    | naa.644a84202d79f0001dcfdde904f0ef31 | ds-lab-vsan11 | MD    | 28   | 276.08 GB | 47.47 % | 0.17 %   | OK (v4) |
    +--------------------------------------+---------------+-------+------+-----------+---------+----------+---------+
    | naa.644a84202d79f0001d1efd5b0443a4b5 | ds-lab-vsan11 | SSD   | 0    | 92.62 GB  | 3.24 %  | 3.24 %   | OK (v4) |
    | naa.644a84202d79f0001dcfddf605b3e997 | ds-lab-vsan11 | MD    | 26   | 276.08 GB | 37.16 % | 0.16 %   | OK (v4) |
    | naa.644a84202d79f0001d1efd7605d88b53 | ds-lab-vsan11 | MD    | 27   | 276.08 GB | 53.14 % | 20.45 %  | OK (v4) |
    +--------------------------------------+---------------+-------+------+-----------+---------+----------+---------+
    | naa.644a84202d7a18001d1f273c038df75f | ds-lab-vsan16 | SSD   | 0    | 92.62 GB  | 4.44 %  | 4.44 %   | OK (v3) |
    | naa.644a84202d7a18001d1f275b0560627d | ds-lab-vsan16 | MD    | 25   | 276.08 GB | 55.60 % | 0.04 %   | OK (v3) |
    | naa.644a84202d7a18001d1f27d70cc230f4 | ds-lab-vsan16 | MD    | 27   | 276.08 GB | 41.31 % | 2.94 %   | OK (v3) |
    +--------------------------------------+---------------+-------+------+-----------+---------+----------+---------+
    | naa.644a84202d7a18001d1f274804460eb5 | ds-lab-vsan16 | SSD   | 0    | 92.62 GB  | 8.68 %  | 8.68 %   | OK (v3) |
    | naa.644a84202d7a18001d1f276405ee02e3 | ds-lab-vsan16 | MD    | 25   | 276.08 GB | 43.79 % | 2.21 %   | OK (v3) |
    | naa.644a84202d7a18001d1f275304ec2a1c | ds-lab-vsan16 | MD    | 26   | 276.08 GB | 50.56 % | 2.93 %   | OK (v3) |
    +--------------------------------------+---------------+-------+------+-----------+---------+----------+---------+
When examining the disk format through the vSAN Health Service, vCenter Server version conventions are used and displays a warning message on hosts without on-disk version 3. This is an expected behavior and can be safely ignored.
 

Tags

vSAN on-disk format versions

See Also

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 3 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)




Please enter the Captcha code before clicking Submit.
  • 3 Ratings
Actions
KB: