test veritas logo


vxdelestat(1M)

NAME

vxdelestat - VxFS cluster-mounted file system delegation tracking utility for extent and inode allocation units

AVAILABILITY

VRTSvxfs

SYNOPSIS

You can specify the following commands for the Primary local node or Secondary local node:

vxdelestat -e [device_index] [-v] [-c count] [-t time] mount_point

vxdelestat -e [device_index] -p [au_number] mount_point

vxdelestat -i [fset_index] [-A] [-v] [-c count] [-t time] mount_point

vxdelestat -i [fset_index] [-A] -p [au_number] mount_point

You can specify the following commands for the entire cluster, executed from the Primary, only:

vxdelestat -e [device_index] [-d [nodeid] | -u | -f] [-v] [-c count] [-t time] mount_point

vxdelestat -e [device_index] [-s] [-c count] [-t time] mount_point

vxdelestat -i [fset_index] [-A] [-d [nodeid] | -u] [-v] [-c count] [-t time] mount_point

vxdelestat -i [fset_index] [-A] [-s] [-c count] [-t time] mount_point

DESCRIPTION

The vxdelestat utility tracks delegations for extent and inode allocation units in a cluster-mounted file system to aid in diagnosing Veritas Storage Foundation Cluster File System High Availability (SFCFSHA)-related issues. The vxdelestat utility reports various delegation statistics for both extent and inode allocation units. Some of these statistics can be displayed only from the primary node of a cluster-mounted file system. The vxdelestat utility can also modify live delegation states.

The mount_point parameter must specify a cluster-mounted file system.

NOTES

The vxdelestat utility is intended primarily for troubleshooting by Veritas personnel. The utility’s functionality and output are subject to change.

Cluster File System Issues

The vxdelestat utility can operate from any node in a cluster. However, only a restricted set of options are allowed from a secondary node.

OPTIONS

-e [device_index]
  Processes delegations for extent allocation units of the device specified by dev_index. The default value for dev_index is 0. If you do not specify any options other than -c, -t, and -v with -e, information of the extent allocation units delegated to the current local node is displayed.
-i [fset_index]
  Processes delegations for inode allocation unit of file set with index fset_index. The default value for fset_index is 999, which specifies the UNNAMED file set. If you do not specify any options other than -c, -t, and -v with -i, information of the inode allocation units delegated to the current local node is displayed.
-A Specify -A along with -i to denote the attribute inode list. If you do not specify -A, then the primary inode list is considered.
-d [nodeid] Displays information for all the extent or inode allocation unit delegations that are currently delegated to the node specified by nodeid. If you do not specify nodeid, then the delegation information is for all nodes in the cluster.
-u Displays information for the allocation units that are not delegated to any node in the cluster.
-f Displays information for the FREE extent allocation units that have not yet had any extent allocations.
-p [au_number]
  Revokes the delegation of a single extent or inode allocation unit specified by au_number that is currently delegated to the current local node. If you do not specify au_number, then -p revokes all of the delegations that are currently delegated to the current local node. Revoke can fail for some allocation units that do not meet certain conditions necessary for revoking a delegation.
-s Prints a summary of extent or inode allocations unit delegation stats. For both extent and inode allocation unit delegations, the summary includes the number of total allocation units, the number of allocation units that are not delegated to any node, and the number of active delegations per node in the cluster. For extent allocation units, the number of free and total allocated allocation units are also displayed as part of the delegation summary.
-v Verbose mode. Specify the -v option with options other than -p and -s to display a list of delegations instead of a delegation count.
-c count Repeats the current operation count times.
-t seconds Specify the -t option with the -c option to specify amount of delay in seconds between each iteration.

EXAMPLES

The following command displays the delegation stats summary for extent allocation units for the default device index 0:

# vxdelestat define -e -s /mnt1 ****** Delegation Summary ****** NUMBER OF TOTAL AUs: 608 NUMBER OF FREE AUs: 600 NUMBER OF ALLOCATED AUs: 2 NUMBER OF UNDELEGATED AUs: 2 NODES HAVING ACTIVE DELEGATIONS: Node01 : 3 Node02 : 1

The following command displays the delegation stats summary for inode allocation units for the default file set index 999:


# vxdelestat -i -s /mnt1 ****** Delegation Summary ****** NUMBER OF TOTAL AUs: 4 NUMBER OF UNDELEGATED AUs: 1 NODES HAVING ACTIVE DELEGATIONS: Node01 : 1 Node02 : 2

The following command displays list of free extent allocation units:


# vxdelestat -e -f -v /mnt1 List of Free EAUs: 11 12 13 14 15 16 17 18 21 22 23 24 25 26 27 28 29 30 31 33 34 35

The following command displays the number of inode allocation units for fileset 1000 that are not delegated to any node in the cluster:


# vxdelestat -i 1000 -u /mnt1 Number of Undelegated AUs: 2

The following command displays the number of extent allocation units that
are delegated to the node with node id 1:


# vxdelestat -e -d 1 /mnt1 Number of delegations on node 1: 5

The following command revokes all inode allocation unit delegations for the attribute ilist of file set 999 from the current local node:


# vxdelestat -i -A -p /mnt1 Revoked all delegations from this node.

SEE ALSO

fsclustadm(1M), vxfsstat(1M), vmstat(1M)


VxFS 8.0 vxdelestat(1M)