test veritas logo


vxvset(1M)

NAME

vxvset - create and administer volume sets

SYNOPSIS

vxvset [-g diskgroup] [-c "ch_addopt"] [-f] [-o index] addvol vset vol [index]

vxvset [-g diskgroup] list [vset]

vxvset [-g diskgroup] [-t ch_subdir] [-m "ch_initopt"] [-o index]
     [-o makedev={on|off}] [-o compvol_access={read-only|read-write}]
    [-c "ch_addopt"] make vset vol [index]

vxvset [-g diskgroup] [-f] [-c "ch_rmopt"] [-o index] rmvol vset {vol | index]

vxvset [-g diskgroup] [-f] set compvol_access={read-only|read-write} vset

vxvset [-g diskgroup] [-f] set makedev={on|off} vset

vxvset [-g diskgroup] [-f] start vset ...

vxvset [-g diskgroup] [-f] stop vset ...

vxvset [-g diskgroup] assoc rvg vset

vxvset [-g diskgroup] [-f] dis vset

DESCRIPTION

Volume sets in Veritas Volume Manager (VxVM) provide support for the Multi-Volume Support feature that can be used with Veritas File System (VxFS). A volume set allows several volumes to be treated as a single object with one logical I/O interface. The vxvset utility is used to create and administer volume sets.

KEYWORDS

addvol Moves the specified standalone volume, vol, into the volume set, vset. If the -o index option is specified, the value of the index argument is assigned to the volume. If the -o index option is not specified, an index value is assigned automatically.
Note: If the volume set is associated to the RVG then the added volume is associated to the RVG automatically.
Note: The volume must be in the same disk group as the volume set, and it may not already be a member of another volume set.
After the move, any ch_addopt argument string that is specified using the -c option is passed to the vset_addvol content-handler operation (if any). This string indicates how the volume is to be processed by the application. For example, the string may indicate how the volume should be incorporated into a file system. The vset_addvol operation may provide a context string that is stored in the volume record.
Note: The -f (force) option must be specified if the volume being added, or any volume in the volume set, is either a snapshot or the parent of a snapshot. Using this option can potentially cause inconsistencies in a snapshot hierarchy if any of the volumes involved in the operation is already in a snapshot chain.
list If a volume set, vset, is specified, lists the component volume information. This includes the values of the volume name, index in the volume set, length and kernel state of the volume, and the context string for the volume set.
If a volume set is not specified, limited information about all volume sets in all disk group is displayed. This includes the volume set name, disk group name, number of volumes in each set, and the context string for the volume.
make Creates a new volume set with a name specified by the vset argument and adds the specified volume, vol, to it.
If specified, the -t option defines the name of a content-handler subdirectory, ch_subdir, under the directory /usr/lib/vxvm/content. This optional subdirectory contains one or more utilities that support all possible volume-set operations for the interface to an application. For example, -t vxfs specifies that the vxfs subdirectory is used for VxFS.
Any ch_initopt argument that is specified using the -m option is passed to the vset_initset content handler operation (if any) that deals with volume set initialization. The vset_initset operation may provide a context string that is stored in the volume set record.
After adding the first volume to the volume set, any ch_addopt argument that is specified using the -c option is passed to the vset_addvol content-handler operation (if any). This string indicates how the volume is to be processed by the application. For example, the string may indicate how the volume should be incorporated into a file system. The vset_addvol operation may provide a context string that is stored in the volume record.
If the -o makedev=on option is specified, raw device nodes are set up for each of the component volumes in the volume set that is being created. If set to off (default), no raw device nodes are created.
If the -o compvol_access option is specified in conjunction with the -o makedev=on option, this specifies the degree of access that is allowed to the raw device nodes. If set to read-only (default), only reads are allowed on the raw device of each component volume of a volume set that is being created. If set to read-write, both reads and writes are allowed.
rmvol Removes the specified volume, vol, from the volume set, vset, and makes it available a standalone volume. If the -o index option is specified and an index is provided instead of a volume name, the volume with that index is removed from the volume set.
Note: If the volume set and the volume is associated to the RVG then this operation automatically dissociate the volume from the RVG.
The content-handler string, ch_rmopt, that is specified by the -c option is passed to the vset_rmvol content-handler operation (if any). Typically, the vset_rmvol operation (if any) may choose to reorganize the data in the data set before performing the remove operation, or alternatively, it may cancel the the remove operation altogether.
Note: A volume set is deleted when the final volume is removed from it.
Note: The -f (force) option must be specified if the volume being removed, or any volume in the volume set, is either a snapshot or the parent of a snapshot. Using this option can potentially cause inconsistencies in a snapshot hierarchy if any of the volumes involved in the operation is already in a snapshot chain.
set Sets one of the following attributes on a volume set:
compvol_access={read-only|read-write}
  If set to read-only, only reads are allowed on the raw device of each component volume of a volume set. If set to read-write, both reads and writes are allowed. This attribute only has any effect if the makedev attribute has been enabled for the volume set. If not specified, the default setting is read-only if makedev is set to on.
makedev={on|off}
  If set to on, creates raw device nodes for each of the component volumes in a volume set. If set to off (default), any existing raw device nodes are removed.
If any of the component volumes of the volume set is open, the -f option is required to forcibly set the makedev attribute to off or the compvol_access attribute to read-only.
start Attempts to start all volumes under the specified volume sets. If a volume would not normally be started because failures and disk removals have left all associated plexes with invalid data, the -f option can be used to try to start the volume. This option can be used after replacing disks to enable the volume. The volume’s contents can then either be restored from a backup or reinitialized.
stop Attempts to stop all volumes under the specified volume sets. The -f option can be used to forcibly stop a volume that is in use. This causes failures to be returned for any further I/O operations on the volume device.
assoc Associates all volumes of the volume set, vset with the specified RVG, rvg. All the volumes of volume set must be of same usage type: either gen or fsgen. Volumes also cannot have an associated DRL.
Note: If the RVG already has associated volumes, then the volumes of new volume set being associated should be of the same type as the existing volumes. All volumes in volume set being associated must be either VxVM ISP volumes or VxVM non-ISP volumes.
dis Dissociates the named volume set, vset from its associated RVG. Dissociating the vset dissociates all the associated volumes of vset from the RVG.
Note: The -f (force) option must be specified to force disassociation of the volume set from its associated RVG.

OPTIONS

-c "ch_addopt"
-c "ch_rmopt"
  Specifies a string that is passed to the vset_addvol content handler operation (if any) when a volume is added to a volume set, or that is passed to the vset_rmvol content handler operation (if any) when a volume is removed from a volume set.
-f For the addvol and rmvol operations, forcibly adds or removes volumes to or from the volume set where this would otherwise not be allowed.
For the start and stop operations, forcibly starts or stops volumes in the volume set where this would otherwise not be allowed.
For the set operation, this option is required to forcibly set the makedev attribute to off or the compvol_access attribute to read-only if any of the component volumes of the volume set is open.
-g diskgroup Specifies the disk group. If a disk group is not specified, the default disk group is used as determined from the rules on the vxdg(1M) manual page.
-m "ch_initopt"
  Specifies a string that is passed to the vset_initset content handler operation (if any) when a volume set is initialized.
-o compvol_access={read-only|read-write}
  If set to read-only, only reads are allowed on the raw device of each component volume of a volume set that is being created. If set to read-write, both reads and writes are allowed. This option only has any effect if the -o makedev=on option is also enabled for the volume set. If not specified, the default setting is read-only if -o makedev=on is specified.
-o index Specifies the index of a volume within a volume set.
-o makedev={on|off}
  If set to on, sets up the raw device nodes for each of the component volumes in the volume set that is being created. If set to off (default), no raw device nodes are created.
-t ch_subdir Specifies the subdirectory under /usr/lib/vxvm/content that contains the handler utilities for a volume set. For example, the VxFS handler utilities are located in the vxfs subdirectory.

EXAMPLES

Create a volume set named acctvs containing the volume vol in the disk group mydg for use with VxFS:

vxvset -g mydg -t vxfs make acctvs vol

Similar to the previous example, but create raw device nodes for each component volume with read-write access to each node:


vxvset -g mydg -t vxfs -o makedev=on \     -o compvol_access=read-write \     make acctvs1 vol1

Add the volumes, v1 and i-vol, to the volume set, acctvs, using specified index numbers:


vxvset -g mydg -o index addvol acctvs v1 0 vxvset -g mydg -o index addvol acctvs i-vol 1

List the volumes in the volume set, acctvs:


vxvset -g mydg list acctvs

Remove the volume, v1, from the volume set, acctvs, by specifying its name:


vxvset -g mydg rmvol acctvs v1

Remove the volume, i-vol, from the volume set, acctvs, by specifying its index number, 1:


vxvset -g mydg -o index rmvol acctvs 1

Remove the raw device nodes from the volume set, acctvs1:


vxvset -g mydg set makedev=off acctvs1

NOTES

Volume sets can be used in place of volumes with the following vxsnap operations on instant volume snapshots: addmir, dis, make, prepare, reattach, refresh, restore, rmmir, split, syncpause, syncresume, syncstart, syncstop, syncwait and unprepare.

A full-sized snapshot of a volume set must itself be a volume set. See the vxsnap(1M) manual page for more information about administering instant volume snapshots.

The maximum number of volumes that may be included in a volume set is 2048.

Raw I/O is not supported for volume sets.

Raw I/O from/to the component volumes of a volume set is if enabled by turning on the makedev attribute. This functionality is only supported for private disk groups; it is not supported for shared disk groups in a cluster.

If the makedev attribute is set to off, and you use the mknod command to create the raw device nodes, you cannot read from or write to those nodes unless you set the value of makedev to on.

SEE ALSO

vxdg(1M), vxedit(1M), vxmake(1M), vxprint(1M), vxvol(1M)


VxVM 7.3.1 vxvset(1M)