test veritas logo


vxvolgrp(1M)

NAME

vxvolgrp - perform Veritas Volume Manager operations on application volume groups.

SYNOPSIS

vxvolgrp -g <diskgroup> make <groupname> <volume> [<volume>...]

vxvolgrp -g <diskgroup> list [<groupnames>...]

vxvolgrp -g <diskgroup> set <groupname> <attribute=value>

vxvolgrp -g <diskgroup> clear <groupname> <attribute>

vxvolgrp -g <diskgroup> remove <groupname>

vxvolgrp -g <diskgroup> addvol <groupname> <volume> [<volume>...]

vxvolgrp -g <diskgroup> rmvol <groupname> <volume> [<volume>...]

DESCRIPTION

The vxvolgrp utility performs Veritas Volume Manager (VxVM) operations on application volume groups. An application volume group is a logical grouping of volumes associated with an application. This utility is used to manage all volume group operations such as creating an application volume group, setting and modifying its attributes,and displaying the groups and their attributes. You can add or remove volumes from an application volume group and also remove the groups using this utility. This utility can be used to manage application volume groups in private as well as shared disk groups.

KEYWORDS

make Creates the application volume group by adding volumes and a unique group name in the disk group.
list Displays a list of existing application volume groups and their attributes.
set Sets and modifies the attributes for an application volume group.
remove Removes an application volume group. This option removes only the grouping of the volumes. Individual volumes are not deleted.
clear Clears the attributes of an application volume group.
addvol Adds volumes to an application volume group. All the attributes of the application volume group are applied to the newly added volumes.
rmvol Removes volumes from an application volume group. All the attributes of the application volume group are removed from the individual volumes which are removed from the group.

ATTRIBUTES

maxiops It is the maximum number of I/Os allowed to be processed per second collectively by all the volumes in an application volume group. The maxiops value can be set, modified or cleared at any time, even when the application is running. In a clustered environment, the volume group can be created and managed from any node in the cluster. The group and its attributes are visible on all the cluster nodes. The same maxiops value is propagated to all the nodes, and is honored independently on each individual node in the cluster.
Refer to vxstat(1m) manual page to view maxiops related statistics.

EXIT CODES

The vxvolgrp utility exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered, but rather denotes the first condition that prevented further execution of the utility. See vxintro(1M) for a list of standard exit codes.

EXAMPLES

Create an application volume group datavol_grp consisting of volumes datavol1, datavol2, datavol3


View the list of application volume groups created


Volume Group: datavol_grp volume(s): datavol1 datavol2 datavol3

Create an application volume group logvol_grp consisting of volumes logvol1, logvol2


View the list of application volume groups created from volumes in the oradg disk group


Volume Group: datavol_grp
volume(s): datavol1 datavol2 datavol3
Volume Group: logvol_grp
volume(s): logvol1 logvol2

Set maximum IOPS value of 1000 on the application volume group datavol_grp


Verify the set maximum IOPS value on the application volume group datavol_grp


Volume Group: datavol_grp volume(s): datavol1 datavol2 datavol3 volume group attributes: maxiops=1000

Remove the maximum IOPS setting from application volume group datavol_grp


Volume Group: datavol_grp volume(s): datavol1 datavol2 datavol3

Add volumes to the application volume group logvol_grp


Volume Group: logvol_grp volume(s): logvol1 logvol2 Volume Group: logvol_grp volume(s): logvol1 logvol2 logvol3 logvol4

Remove a volume from the application volume group datavol_grp


Volume Group: datavol_grp volume(s): datavol1 datavol2 datavol3 volume group attributes: maxiops=1000 Volume Group: datavol_grp volume(s): datavol1 datavol2 volume group attributes: maxiops=1000

Remove the application volume group logvol_grp


SEE ALSO

vxassist (1M), vxstat (1M) For more information, see Storage Foundation Cluster File System High Availability Administrator’s Guide


VxVM 7.3.1 vxvolgrp(1M)