fscdsconv(1M)fscdsconv(1M)NAMEfscdsconv - perform offline Cross-Platform Data Sharing migration tasks
on VxFS file systems
AVAILABILITY
VRTSvxfs
SYNOPSIS
/opt/VRTS/bin/fscdsconv [ -y | -n ] -e -f recovery_file -t target_spec‐
ifiers special
/opt/VRTS/bin/fscdsconv [ -y | -n ] -i -f recovery_file special
/opt/VRTS/bin/fscdsconv -r -f recovery_file special
/opt/VRTS/bin/fscdsconv -v [ -t target_specifiers ] special
DESCRIPTION
The fscdsconv command performs file system tasks required for the
Cross-Platform Data Sharing (CDS) migration of VxFS file systems from
one machine to another. Exporting the file system for use on a differ‐
ent machine, importing the file system for use on the current machine,
and validating the file system prior to export are some of the tasks
that can be performed on VxFS file systems using the fscdsconv command.
The metadata of the file system is stored in the native byte order of
the system on which it was created. To be able to access a file system
created on a system with a different byte order, the file system's byte
order must first be converted to the native byte order of the system
from which it will be accessed. If the source and destination systems
for the file system migration differ in byte order, the file system
will be byteswapped as part of the fscdsconv operation.
In cases where byteswapping is required to make the file system usable
on the target system, you will be prompted to confirm the operation
before fscdsconv modifies the file system. If you choose not to pro‐
ceed with the operation, the file system is left unchanged.
If the file system has any files that might violate the known maximum
file size or maximum UID or GID limits on the target file system, such
violations are reported as part of the export and import operation.
Symantec recommends that you rectify these violations before proceeding
with the migration to ensure that the file system is fully usable on
the target machine.
The process of converting a file system's byte order can fail for vari‐
ous reasons, such as system failure, power failure, command failures,
or user interruption. fscdsconv creates a recovery file as specified
by the -f option so that the file system can be restored to its origi‐
nal condition in the event of a failure. In the case of a failure,
fscdsconv must be reinvoked with the -r option.
The file system that contains the recovery file must not be a temporary
file system that might be cleaned up after a system reboot or whose
data integrity is less than the data integrity of the file system being
converted. For example, if the file system being converted is on a
mirrored volume, the recovery file should also be on a file system that
is capable of tolerating disk failures. The recovery file is not
removed by fscdsconv when the conversion completes.
See the Veritas Storage Foundation Cross-Platform Data Sharing Adminis‐
trator's Guide for more information.
NOTES
Back up the file system before performing any migration, especially
before migrations that require the file system to be byteswapped.
The file system to be migrated must be unmounted before performing the
conversion.
If quotas will be used on the file system, before unmounting it, remove
the quotas and quotas.grp files, which are in the file system root
directory. Unmount the file system, then use fscdsconv to convert the
file system. On the system to which the file system is being migrated,
mount the file system with quotas turned off. See the vxquotaoff(1M)
manual page. Edit the quotas and quotas.grp files to input the usage
limits, then turn on quotas for the file system. See the vxedquota(1M)
and vxquotaon(1M) manual pages.
Cluster File System Issues
No cluster issues; command operates the same on cluster file systems.
OPTIONS-e Exports the file system for use on the specified target. The
fscdsconv command reports detailed information regarding the
migration target, and waits for user confirmation before pro‐
ceeding with the migration. If the target must be changed or
further refined, the user can abort the migration at this
stage and restart with a new target specification.
The fscdsconv command validates the file system to determine
if there are any files that violate the known maximum limits
of file size, UID, or GID on the target system, reports any
such violations, and waits for user confirmation before pro‐
ceeding. If any violations are reported, Symantec recommends
that you abort the migration, rectify the violations, then
restart the migration.
If the file system metadata must be byteswapped for use on
the specified target, fscdsconv waits for user confirmation
before proceeding with the migration.
After the export is complete and reported to be successful,
the file system is ready for use on the target. If byteswap‐
ping was done as part of the export, the file system will no
longer be accessible on the source machine.
-f recovery_file
Specifies the name of the recovery file. Include the full
path when specifying the file name.
-i Imports the file system for use on the current system. The
fscdsconv command validates the file system to determine if
there are any files that violate the known maximum limits of
the file size, UID, or GID on the system, reports any such
violations, and waits for user confirmation before proceed‐
ing. If any violations are reported, you may either abort
the import, mount the file system on the source system, rec‐
tify the violations, then restart the import on the system,
or proceed with the migration and rectify the violations
after the migration completes.
If the file system metadata needs to be byteswapped for use
on the system, the fscdsconv command waits for user confirma‐
tion before proceeding with the migration.
-n Assumes a no response to the prompt by fscdsconv to continue
with the conversion.
-r Restores the file system to its original state using the
recovery file specified by the -f option. If there was a
failure during the conversion as part of either an export or
import, the recovery file created during the conversion can
be used to restore the file system to its original state,
prior to conversion.
-t target_specifiers
Specifies the migration target for export and validation, and
the migration source for import. Specify the migration tar‐
get for a file system using the target_specifiers argument,
which has the following format:
os_name=os_name[,os_rel=os_release][,arch=arch][,vxfs_vers=vxfs_ver‐
sion][,bits=bits]
os_name=os_name
Specifies the name of the target operating system
to which the file system is planned to be migrated.
os_name can have a value of AIX-UX, HP-UX, Linux,
or SunOS. os_name must be specified if the target
is specified.
os_rel=os_release
Specifies the operating system release version of
the target, such as 5.8, 5.9, or 5.10 for SunOS.
arch=arch Specifies the architecture of the target, such as
x86 or sparc for SunOS.
vxfs_vers=vxfs_version
Specifies the VxFS release version that is in use
on the target, such as 4.1 or 5.0.
bits=bits Specifies the kernel bits of the target. bits can
have a value of 32 or 64 to indicate whether the
target is running a 32-bit kernel or 64-bit kernel.
While os_name must be specified for all fscdsconv invocations
that permit the target to be specified, all other target
specifiers are optional and are available for the user to
fine-tune the migration target specification. If the values
for the optional target specifiers are not specified, fscd‐
sconv will choose the defaults for the specified target based
on the information available in the limits file that best
fits the specified target, and proceed with the CDS opera‐
tion. The chosen defaults are displayed to the user before
proceeding with the migration.
-v Validates the file system for the specified target. The file
system can be validated prior to exporting to the specified
target using the -v option. Validation reports any files
that violate the maximum file size, UID, or GID limits on the
target, and will report whether byteswapping is required for
exporting to the specified target.
-y Assumes a yes response to the prompt by fscdsconv to continue
with the conversion.
EXAMPLES
The following command validates the file system /dev/vx/rdsk/dg1/fs1
for the Linux target, converts the byte order of the file system
/dev/vx/rdsk/dg1/fs1, and creates the recovery file recovery1 on the
file system fs2:
# fscdsconv-e -t os_name=Linux -f /fs2/recovery1 /dev/vx/rdsk/dg1/fs1
The following command recovers the file system /dev/vx/rdsk/dg1/fs1
after a failure, using the recovery file recovery1 located on the file
system fs2:
# fscdsconv-r -f /fs2/recovery1 /dev/vx/rdsk/dg1/fs1
The following command validates the file system /dev/vx/rdsk/dg1/fs1
for the SunOS target. Since the byte order is the same on both the
source and the target, there is no need for a byte order conversion.
As such, the recovery file, /fs2/recovery1, is not used:
# fscdsconv-e -t os_name=SunOS -f /fs2/recovery1 /dev/vx/rdsk/dg1/fs1
The following command imports the file system /dev/vx/rdsk/dg1/fs1 for
use on the current system and creates the recovery file /fs2/recovery1
if a byte order conversion is required:
# fscdsconv-i -f /fs2/recovery1 /dev/vx/rdsk/dg1/fs1
SEE ALSOfscdsadm(1M), vxedquota(1M), vxquotaoff(1M), vxquotaon(1M)
Veritas Storage Foundation Cross-Platform Data Sharing Administrator's
Guide
VxFS 5.0 7 Jan 2008 fscdsconv(1M)