test veritas logo


vxanalyse(1M)

NAME

vxanalyse - Checks if the mounted ext4 file system can be converted to Veritas File System (VxFS)

AVAILABILITY

VRTSvxfs

SYNOPSIS

/opt/VRTS/bin/ vxanalyse [ -l logfile ] [ -s statfile ] [ -NnYy ] mount_point

DESCRIPTION

The vxanalyse utility verifies if the mounted file system is ext4 file system and performs checks to determine whether or not it can be converted to VxFS. It is recommended to run the utility before running vxfsconvert utility for offline conversion. There are three possible scenarios with the utility.

Scenario 1: It returns success if the conversion can be done without losing any state of the mounted file system.

$ /opt/VRTS/bin/vxanalyse /mnt1
check1: Checking Source File System size: passed
check2: Checking Source File System for Extended Attributes: passed
check3: Checking Max file size compatibility: passed
check4: Checking Max symbolic link file size compatibility: passed
All checks passed. Conversion can be started
UX:vxfs vxanalyse: INFO: V-3-20000: The conversion analysis report is generated in: /var/log/analyse_mnt1 file
UX:vxfs vxanalyse: INFO: V-3-20000: The stat report is generated in: /var/log/stat_mnt1 file

Scenario 2: It may prompt for user’s input if there are any state that VxFS will not preserve after conversion.

$ /opt/VRTS/bin/vxanalyse -y /mnt1
check1: Checking Source File System size: passed
check2: Checking Source File System for Extended Attributes: passed(with warnings) Check log file for warnings
check3: Checking Max file size compatibility: passed
check4: Checking Max symbolic link file size compatibility: passed
All checks passed. Conversion can be started
UX:vxfs vxanalyse: INFO: V-3-28561: The conversion analysis report is generated in: /var/log/analyse_mnt1 file
UX:vxfs vxanalyse: INFO: V-3-28562: The stat report is generated in: /var/log/stat_mnt1 file
UX:vxfs vxanalyse: INFO: V-3-28563: Some files have unsupported attribute: immutable
UX:vxfs vxanalyse: INFO: V-3-28564: Unsupported attributes will not be preserved. Do you still want to continue:(y,n,q):y

Scenario 3: It returns failure if the conversion is not possible.

$ /opt/VRTS/bin/vxanalyse /mnt1
check1: Checking Source File System size: failed
check2: Checking Source File System for Extended Attributes: passed
check3: Checking Max file size compatibility: passed
check4: Checking Max symbolic link file size compatibility: passed
Conversion cannot be started
UX:vxfs vxanalyse: INFO: V-3-28561: The conversion analysis report is generated in: /var/log/analyse_mnt1 file
UX:vxfs vxanalyse: INFO: V-3-28562: The stat report is generated in: /var/log/stat_mnt1 file

OPTIONS

-l logfile Specify a name for the log file. The utility generates a log file that provides details about the analysis performed. If no option is specified, then vxanalyse generates a file with a unique name based on the mount point and saves it at /var/log/ location.
-s statfile Specify a name for the stat file. The utility generates a stat file that provides stat of various attributes that are collected from the filesystem. If no option is specified, then vxanalyse generates a file with a unique name based on the mount point and saves it at /var/log/ location.
-nN Assumes a no response to all prompts by vxanalyse.
-yY Assumes a yes response to all prompts by vxanalyse.

ARGUMENTS

mount_point
  Specifies an application-visible mount point.

RETURN VALUES

The vxanalyse command returns 0 on success, and 1 on failure.

SEE ALSO

Storage Foundation Administrator’s Guide


VxFS 7.4.1 vxanalyse(1M)