fscdsadm (1M)

NAME

fscdsadm - perform online Cross-Platform Data Sharing operations on VxFS file systems

AVAILABILITY

VRTSvxfs

SYNOPSIS

fscdsadm -o { add | remove } -t target_specifiers mount_point

fscdsadm -o { list | none } mount_point

fscdsadm -l { enforce | ignore } mount_point

fscdsadm -s mount_point

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. Maintaining 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 proposed 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 deprecated 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, /etc/vx/cdslimitstab. The limits file is installed as part of the VRTSvxfs package. Do not edit /etc/vx/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 limits. The CDS limits that can be enforced are file size, UID, and GID. After enforcing the CDS limits, a file created that exceeds the established CDS limits will have permissions 0000 in the destination directory. You can either delete this partial 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 corresponding 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:
 
o Operating system name
o Operating system release
o Architecture
o VxFS version
o Kernel bits
A value of any displayed for any of the above target specifiers, except operating system name, indicates 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:
 
o Whether CDS limits been enforced on mount_point.
o Details regarding the targets in the migration target list for mount_point.
o The limit values for file size, UID, and GID calculated on the basis of the targets in the target list.
o 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 validation 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 target 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, 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, fscdsadm 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 operation. The chosen defaults are displayed to the user before proceeding with the migration.
-v Validates the file system and reports any file system entities 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 following information is reported:
 
o Inode number. The vxlsino command can be used to find the corresponding file.
o File size
o UID
o GID
o Reason for violation. Indicates which of the CDS limits are being violated.
o 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 ALSO

fscdsconv(1M)

Veritas Storage Foundation Cross-Platform Data Sharing Administrator’s Guide


VxFS 5.1 SP1 fscdsadm (1M)