Veritas File Systems with Disk Layout Version 4 or Version 5 Cannot be Mounted or Upgraded with Veritas File System Release 5.1
UX:vxfs mount: ERROR: V-3-21270: /dev/vx/dsk/diskgroup/volume disk image is incompatible with this system
The problem is caused by Etrack incident 1922948 listed in the Supplemental Materials section of this article.
As documented in the 5.1 Release Notes, Veritas File System (VxFS) 5.1 supports only disk layout Version 6 and Version 7, and no prior disk layout versions can be created or mounted.
If an upgrade to release 5.1 is performed, it will not be possible to mount any file systems with disk layout Version 4 or Version 5, nor will it be possible to upgrade from disk layout Version 4 or Version 5 to disk layout version 6 or Version 7.
How to Determine if Affected:
Systems upgraded to the 5.1 release with disk layout Version 4 or Version 5 file Systems are affected.
Use the fstyp command to determine the file system version:
# /opt/VRTS/bin/fstyp -v /dev/vx/dsk/diskgroup/volname | grep version
magic a501fcf5 version 4 ctime Thu May 12 11:29:31 2006
As per the upgrade notes in the 5.1 documentation all VxFS file systems with disk layout version 4 and 5 must be upgraded to layout version 6 or 7 before installing or upgrade to Storage Foundation 5.1.
See the vxupgrade man page or see the product documentation at sort.symantec.com/documents for instructions on how to upgrade to disk layout version 6 or 7 before upgrading to the 5.1 release.
Some previous layout versions cannot be mounted on VxFS 5.1. You can
upgrade these layout versions online before installing VxFS 5.1, or upgrade
them using vxfsconvert after installing VxFS 5.1.
6 and Version 7. No prior versions can be created or mounted.
Use the vxfsconvert or vxupgrade utilities to upgrade older disk layout versions
to disk layout Version 7.
The vxfsconvert command converts an unmounted file system from disk layout
Version 5 or prior to disk layout Version 7.
The vxupgrade command upgrades a mounted file system from disk layout Version
6 to Version 7. The vxupgrade cannot upgrade any previous versions because
those versions cannot be mounted.
See the vxfsconvert or vxupgrade man pages.
For more information about disk layouts, see the Veritas File System
------------ End Existing SF/HA 5.1 Installation Guide on Solaris Platform ------------
Upgrading File Systems Post 5.1 Installation:
File systems must be upgraded prior to installing SF 5.1 because 5.1 no longer supports mounting version 4 and 5 file systems and the vxupgrade command requires that file systems be mounted before it can run.
A hotfix has been created that enables mounting version 4 and 5 file systems for the purposes of running vxupgrade to upgrade the disk layout version. Actively using version 4 and 5 file systems without upgrading is not supported. Please upgrade the disk layout version immediately to a supported version after the filesystem is mounted. Please don't try to use any filesystem with disk layout version 4 or 5 with your application programs on SF 5.1.
If impacted by this situation, contact Symantec Support and request the following patch:
Hotfix 1 for Veritas File System 5.1RP1 ( VxFS 5.1RP1HF1 )
# mount -F vxfs /dev/vx/dsk/diskgroup/volume /mountpoint
# vxupgrade -n 5 /mountpoint (for version 4 file systems)
# vxupgrade -n 6 /mountpoint
# vxupgrade -n 7 /mountpoint
Please note that Symantec strongly recommends customers to upgrade the Disk Layout Version BEFORE the upgrade to VxFS 5.1 or above. Symantec also recommends customers to make sure that the filesystems are unmounted cleanly before the upgrade to VxFS 5.1 or above. Customers can check if a filesystem is unmounted cleanly by running a simple fsck against the filesystem. For example,
# fsck -m -F vxfs /dev/vx/rdsk/vvrdg/volvxfs
UX:vxfs fsck: INFO: V-3-20915: sanity check: /dev/vx/rdsk/vvrdg/volvxfs OK
/usr/lib/fs/vxfs/sparcv9/fsck <<< this is version for the latest intent log version
/sbin/helpers/vxfs/bin/fsck <<< this is version for the latest intent log version
/sbin/fs/vxfs5.0/fsck <<< this is version for the latest intent log version
Symantec strongly recommends the following best practices:
1. Always perform a full backup prior to and after any changes to your environment.
2. Always make sure that your environment is running the latest version and patch level.
3. Perform periodic "test" restores.
4. Subscribe to technical articles.
How to Subscribe to Email Notification:
Subscribe to this TechNote for any updates that are made to this article, by clicking on the following link:
If you have not received this from the Symantec Technical Support Email Notification Service, please click on the following link to subscribe to future Notifications:
This article applies to all platforms running VxFS 5.1GA, 5.1RP1 and 5.1RP2 only. It does not apply to VxFS 5.1SP1 and above.
In VxFS 5.1SP1 and above, vxfsconvert utility is fixed to be able to upgrade VxFS filesystems with layout version 4 and 5 to the latest layout version. The fix is done through the Etrack incident 1922948.