HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

v
vxfsconvert(1M) vxfsconvert(1M)
NAME
vxfsconvert - convert a file system to a vxfs file system or upgrade a VxFS disk layout version.
SYNOPSIS
/sbin/fs/vxfs/vxfsconvert
[-l logsize][-s size][-efnNvyY] special
DESCRIPTION
vxfsconvert converts a file system of a supported type to a
vxfs file system with a Version 4 disk lay-
out. Currently
vxfsconvert only supports conversion of an
hfs file system to a vxfs file system.
Conversion of all file system block and fragment sizes is supported. After a file system is converted to
vxfs, its block size is the value of the fragment size before conversion.
vxfsconvert also converts
VxFS Version 2 and Version 3 disk layouts to Version 4 disk layouts.
Do a full backup of the file system before running
vxfsconvert. File system conversion is complex and
while most file systems will convert without problems, some may not. You could lose data if you don’t
have a backup. See the WARNINGS section.
vxfsconvert requires sufficient disk space to convert existing metadata to vxfs metadata. The space is
acquired from free space within the file system or from the space available immediately after the end of
the file system. In either case, the space must be available on the same device or volume that contains
the file system. vxfsconvert requires approximately 12%-15% of the total file system size as free
space, depending on the number of directories and files.
special is the character disk or volume manager device. Running
vxfsconvert on the character device
is usually faster than running it on a block device.
vxfsconvert converts HFS access control list (ACL) entries to the respective VxFS ACL entries with
limitations. Only the entries that comply with the VxFS ACL standard are converted. See the description
of the conversion process, below, for details.
vxfsconvert takes approximately 2 to 3 times longer to convert a file system than running a full
fsck
on an hfs file system.
Options
vxfsconvert recognizes the following options:
-e Estimate the amount of space required to complete the conversion. This option does not con-
vert the file system to VxFS. No data is written to the file system and the file system remains
clean.
-e generally overestimates the free space because it considers the worst case scenario for allo-
cating blocks (that is, fully fragmented).
-f Display the list of supported file system types. Currently only hfs, the VxFS Version 2 disk
layout, and the VxFS Version 3 disk layout.
-l logsize Specifies the size of the file system intent log. The minimum value for logsize is the number of
blocks that make the log no less than 256K. The maximum value for logsize is the number of
blocks that make the log no greater than 16384K. The default logsize is usually 1024 blocks;
for a small file system the default can be smaller to avoid wasting space.
-n|N Assume a no response to all questions asked by vxfsconvert. This option implies that the
conversion is never committed and the file system is not converted to VxFS.
-s size Directs vxfsconvert to use free disk space past the current end of the file system to store
VxFS metadata (such as the intent log). size specifies the amount of available disk space past
the end of the file system in kilobytes. vxfsconvert uses the space past the current end of
the file system for the conversion process. With this option, all disk space required for the
conversion process is taken from the end of the file system; the existing free space within the
file system remains intact. If the device is a raw partition, you can use -s only if there is
sufficient space on the partition past the end of the file system.
If
-s is not specified, vxfsconvert uses free blocks from within the layout of the file system
being converted. File systems converted with -s cannot be shrunk to a size smaller than their
initial post-conversion size.
-v Specify verbose mode. Verbose mode shows the progress of the conversion process. For every
inode converted, one of the following characters is displayed.
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1M−−893