fscdstask

NAME

fscdstask - perform various CDS operations

AVAILABILITY

VRTSvxfs

SYNOPSIS

DESCRIPTION

The fscdstask script performs various cross-platform data sharing (CDS) tasks, such as enforcing or ignoring established CDS limits, adding or removing from the list of operating systems that will be accessing the file system, and displaying the current CDS settings of a file system.

See the VERITAS Storage Foundation Cross-Platform Data Sharing Administrator's Guide for more information and examples of usage.

NOTES

The specified file system must be mounted before using this script.

The specified file system might be unmounted and remounted as part of the CDS operation.

CLUSTER FILE SYSTEM ISSUES

The status keyword is the only keyword supported on cluster file systems.

KEYWORDS

limit

Causes the established CDS limits to be enforced or ignored on the specified mount_point. If enforced, the file system will make an effort to prevent the creation of file system metadata that exceeds the established limits. If it cannot determine if file system limits have been exceeded (only possible after a full file system check repair operation), it will allow the mount operation to proceed immediately while it asynchronously scans the file system to determine whether limits are actually exceeded. Possible values for command are:

enforce

Enforces established CDS limits. After CDS limits are enforced for a file system, a file created that exceeds the established CDS limits will have permissions of 0000 in the destination directory. You can either delete this partial file or set the appropriate permissions of the file.

ignore

Ignores established CDS limits.

The CDS limits that can be enforced are file size, user ID, and group ID.

os

Manipulates the list of operating systems between which the specified mount_point will be moved on an ongoing basis. The file system maintains this list. Adding or removing an operating system from the list causes the file system limits to be adjusted such that only entities that are accessible from all the operating systems are allowed to be created once the CDS limits are enforced. Possible values for command are:

add

Adds the specified operating_system to the list of operating systems between which the file system will be moved on an ongoing basis.

remove

Removes the specified operating_system from the list of operating systems between which the file system will be moved on an ongoing basis.

none

Removes all operating systems from the list of operating systems between which the file system will be moved on an ongoing basis.

list

Lists the operating systems between which the file system will be moved on an ongoing basis.

Possible values for operating_system are: AIX, HP-UX, Linux, or SunOS. The Linux value refers to 32-bit releases of Linux. The 64-bit Linux limits are the same as or greater than those for the Solaris operating system. As such, there is no need to enforce the Linux (32-bit) limits if migrating from UNIX to 64-bit Linux.

After invoking the add or remove commands one or more times, if the list of operating systems between which this file system will be moved is not empty, invoke the limit enforce command for the changes to take effect.

After invoking the remove command one or more times, if the list of operating systems between which this file system might be moved is empty, invoke the limit ignore command for the changes to take effect.

Note that changes made through the os keyword take effect only after invoking the appropriate limit keyword command.

status

Displays the current CDS settings of the file system specified by mount_point, specifically if the CDS limits have been enforced on this file system. If the CDS limits have been enforced, this command can be used to determine if the limits are being honored. Additionally, status displays CDS policy-related information, which is useful for debugging purposes.

If one or more operating systems have been added through the fscdstask os add command for this file system, status provides the following additional information:

• A list of operating systems between which the file system is expected to be moved on a regular basis. This is the same information as that displayed by the fscdstask os list command.
• The current maximum values and the limiting values for the stablished CDS limits. If the CDS limits have not been enforced, the current values will be displayed as untracked.

validate

Determines whether the specified mount_point has entities with metadata that exceed the limits for operating systems specified in the OS_list. OS_list is a space-separated list of operating systems. Possible values for OS_list are: AIX, HP-UX, Linux, and SunOS. The Linux value refers to 32-bit releases of Linux. The 64-bit Linux limits are the same as or greater than those for the Solaris operating system. As such, you may specify the Solaris operating system if validating a mount point on a 64-bit Linux system.

EXAMPLES

To add and remove an OS from the list of OSes:

To validate a file system against an OS:

To display the current CDS status of a file system:

SEE ALSO

fscdsconv (1M), vxcdsconvert(1M), vxdg(1M)

VERITAS Storage Foundation Cross-Platform Data Sharing Administrator's Guide