Home > Veritas Storage Foundation™ File System Manual Pages

FSCDSTASK (1M)

Maintenance Commands

NAME
AVAILABILITY
SYNOPSIS
DESCRIPTION
NOTES
Cluster File System Issues
KEYWORDS
EXAMPLES
SEE ALSO

NAME

fscdstask - perform various CDS operations

AVAILABILITY

VRTSvxfs

SYNOPSIS

fscdstask limit command mount_point

fscdstask os command [operating_system] mount_point

fscdstask status mount_point

fscdstask validate OS_list mount_point

fscdstask help keyword

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 fscdstask command has been deprecated. For all online CDS operations, use the fscdsadm command. The fscdstask command is provided for compatibility with previous VxFS releases and may be discontinued in future releases.

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

Cluster File System Issues

No cluster issues; command operates the same 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.

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 AIX, HP-UX, or the Solaris operating system 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, when migrating from AIX, HP-UX, or the Solaris operating system to 64-bit Linux, no validation is required.

EXAMPLES

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

# fscdstask os add Linux /mnt
# fscdstask os add SunOS /mnt
# fscdstask os list /mnt
Linux SunOS
# fscdstask os remove SunOS /mnt
# fscdstask os list /mnt
Linux

To validate a file system against an OS:

# fscdstask validate Linux /mnt

To display the current CDS status of a file system:

# fscdstask status /mnt
Status:
        current untracked
        mounted plain
        policy none
        policy not downgraded

OS list: Linux
     .
     .
     .
     CUR_GID=untracked
     CUR_SIZE=untracked
     CUR_UID=untracked
     LIM_GID=4g
     LIM_SIZE=16t-64k
     LIM_UID=4g

FSCDSTASK (1M)

Table of contents