fscdsadm(1M)fscdsadm(1M)NAMEfscdsadm - perform online Cross-Platform Data Sharing operations on
VxFS file systems
AVAILABILITY
VRTSvxfs
SYNOPSIS
/opt/VRTS/bin/fscdsadm -o { add | remove } -t target_specifiers
mount_point
/opt/VRTS/bin/fscdsadm -o { list | none } mount_point
/opt/VRTS/bin/fscdsadm -l { enforce | ignore } mount_point
/opt/VRTS/bin/fscdsadm -s mount_point
/opt/VRTS/bin/fscdsadm -v [ -t target_specifiers ] mount_point
DESCRIPTION
The fscdsadm command performs online administration functions for the
Veritas File System Cross-Platform Data Sharing (CDS) feature. Main‐
taining the list of targets between which the file system is regularly
migrated, enforcing or ignoring established CDS limits, validating the
file system to detect violations of these limits, and displaying the
current CDS state of the file system are some of the tasks that can be
performed on VxFS file system through the fscdsadm command.
mount_point specifies the directory on which the file system to be
migrated is mounted.
target_specifiers specifies the target to which the file system is pro‐
posed to be migrated.
NOTES
In the 4.0 and 4.1 releases of VxFS, the fscdstask script was provided
to perform the various VxFS CDS administration tasks. Starting in the
VxFS 5.0 release, the fscdsadm command should be used to perform all
online CDS tasks on VxFS file systems. The fscdstask script is depre‐
cated and is provided only for backward compatibility with previous
releases. The support for the fscdstask script may be discontinued in
future VxFS releases.
The VxFS CDS commands, fscdsadm and fscdsconv, use the information
available in the CDS limits file, /opt/VRTS/bin/cdslimitstab. The lim‐
its file is installed as part of the VRTSvxfs package. Do not edit
/opt/VRTS/bin/cdslimitstab manually.
Cluster File System Issues
No cluster issues; command operates the same on cluster file systems.
OPTIONS-l Specifies the limit enforcement CDS commands. The valid
options are:
enforce Causes the established CDs limits to be enforced on
mount_point. When the CDS limits are enforced, the
file system prevents the creation of any new file
system metadata that exceeds the established lim‐
its. The CDS limits that can be enforced are file
size, UID, and GID. After enforcing the CDS lim‐
its, a file created that exceeds the established
CDS limits will have permissions 0000 in the desti‐
nation directory. You can either delete this par‐
tial file, or set the appropriate permissions on
the file. Enforcing the CDS limits has no effect
on files violating the limits that already exist in
the file system at the time when the limits are
being enforced. Use the validation capability of
fscdsadm to detect and rectify these violations.
ignore Causes the enforced CDS limits to be ignored on
mount_point. Once the CDS limits have been
ignored, the file system will no longer control
activities that might cause the CDS limits to be
violated.
-o Specifies the CDS commands for target list manipulation. The
valid options are:
add Adds the specified target to the list of targets
between which the file system mounted at
mount_point will be migrated on an ongoing basis.
The target list is maintained by the file system.
The CDS limits, when enforced, are determined by
the constituents of the target list of mount_point.
If the CDS limits are already enforced when a new
target is added, the limits corresponding to the
newly added target will be reflected in the
enforced limits.
remove Removes the specified target from the target list
of mount_point. If the CDS limits are already
enforced when a target is removed, the limits cor‐
responding to the newly removed target will be
reflected in the enforced limits. If the target
list becomes empty by removing the specified target
and if the CDS limits are already enforced, the CDS
limits will be ignored since the target is now
empty.
none Removes all targets from the target list of
mount_point. If the CDS limits are already
enforced, the CDS limits will be ignored since the
target list is now empty.
list Lists information regarding the targets that are in
the target list of mount_point. The following
information is displayed for each target in the
target list:
· Operating system name
· Operating system release
· Architecture
· VxFS version
· Kernel bits
A value of any displayed for any of the above tar‐
get specifiers, except operating system name, indi‐
cates that the CDS limits are the same regardless
of the value for this particular target specifier.
-s Displays the following information regarding the CDS state of
mount_point:
· Whether CDS limits been enforced on mount_point.
· Details regarding the targets in the migration target
list for mount_point.
· The limit values for file size, UID, and GID calcu‐
lated on the basis of the targets in the target list.
· Whether all files are within the CDS limits for the
targets in the target list of mount_point.
If the status indicates that there might be files exceeding
the CDS limits established for mount_point, use the valida‐
tion capability of fscdsadm to detect the files violating the
limits. After rectifying the violations, enforce the limits
to update the CDS status of the file system.
-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_version][,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 fscdsadm 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‐
sadm 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 and reports any file system enti‐
ties with metadata that exceed the established CDS limits for
the specified target. Also reports if the file system must
be byteswapped to be migrated to the specified target. If no
target is specified, fscdsadm provides the validation report
for each of the targets in the target list of the specified
mount point, provided that the target list is not empty. For
each file with metadata that exceeds CDS limits, the follow‐
ing information is reported:
· Inode number. The vxlsino command can be used to
find the corresponding file.
· File size
· UID
· GID
· Reason for violation. Indicates which of the CDS
limits are being violated.
· Fileset name. The specified mount_point or the name
of the Storage Checkpoint file system where the file
in violation resides.
EXAMPLES
The following command adds an HP-UX/11.23 system running VxFS 4.1 to
the target list of a file system that is currently on Linux:
# fscdsadm-o add -t os_name=HP-UX,os_rel=11.23,vxfs_vers=4.1 /mnt1
The arch and bits are not specified as part of the target in the above
example. This causes the command to assume the defaults in accordance
with the definition provided for the target in the limits file.
The following command enforces the CDS limits:
# fscdsadm-l enforce /mnt1
The following command validates the file ssytem to detect if any limits
are violated for an HP-UX/IA target:
# fscdsadm-v -t os_name=HP-UX,arch=ia /mnt1
SEE ALSOfscdsconv(1M)
Veritas Storage Foundation Cross-Platform Data Sharing Administrator's
Guide
VxFS 5.0 7 Jan 2008 fscdsadm(1M)