Home > Veritas Storage Foundation™ File System Manual Pages
FSCDSADM (1M) |
Maintenance Commands |
fscdsadm -o { list | none } mount_point
fscdsadm -l { enforce | ignore } mount_point
fscdsadm -s mount_point
fscdsadm -v [ -t target_specifiers ] mount_point
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.
The VxFS CDS commands, fscdsadm and fscdsconv, use the information available in the CDS limits file, /opt/VRTS/bin/cdslimitstab. The limits file is installed as part of the VRTSvxfs package. Do not edit /opt/VRTS/bin/cdslimitstab manually.
- 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.
- 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:
- Operating system name
- Operating system release
- Architecture
- VxFS version
- 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.
- 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 calculated 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 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.
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, 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.
- 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.
# 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
Veritas Storage Foundation Cross-Platform Data Sharing Administrator's Guide
Last updated: 7 May 2007
Copyright ©2009 Symantec Corporation
All rights reserved.