vxpool

NAME

vxpool - create and administer storage pools

SYNOPSIS

DESCRIPTION

The vxpool utility provides a command line interface for the creation and administration of storage pools that are used with the VERITAS Intelligent Storage Provisioning (ISP) feature of VERITAS Volume Manager (VxVM).

The operations that can be performed by vxpool are selected by specifying the appropriate keyword on the command line. See the KEYWORDS section for a description of the available operations.

Most operations can be applied to a single disk group only. If a disk group is not specified by using the -g option, and an alternate default disk group is not defined by specifying the diskgroup attribute on the command line or in a defaults file (usually /etc/default/allocator), the default disk group is determined using the rules given in the vxdg(1M) manual page.

KEYWORDS

adddisk

Adds one or more disks to a storage pool.

assoctemplate

Associates one or more templates with a storage pool.

assoctemplateset

Associates one or more template sets with a storage pool.

create

Creates a storage pool and associate it with a disk group. This operation allows disks be added to the pool when it is created. Use the dm attribute to specified a comma-separated list of disk media names for these disks. Policies for the pool such as autogrow and selfsufficient can also be specified. By default, the values of autogrow and selfsufficient are set to 2 (diskgroup) and 1 (pool) respectively.

If you specify a storage pool definition, the storage pool is created using this definition. Any other rules or policies that you specify override the corresponding values in the definition.

delete

Deletes a storage pool. If the -r option is specified, any disks in the pool are also dissociated from the pool provided that they are not allocated to volumes.

distemplate

Disassociates one or more templates from a storage pool.

distemplateset

Disassociates one or more template sets from a storage pool.

getpolicy

Displays the values of the policies that are set on a storage pool.

help

Displays information on vxpool usage, keywords, options or attributes.

list

Displays the storage pools (data and clone) that are configured in a disk group.

listpoolset

Lists all available storage pool sets.

listpooldefinitions

Lists all available storage pool definitions.

organize

Creates data and clone storage pools using the storage pool definitions that are contained in a storage pool set. Unique storage pool names are generated by appending a number to the definition name. If required, you can use the rename operation to change these names.

print

Displays the details of one or more storage pools. If no storage pool is specified, the details of all storage pools are displayed.

printpooldefinitions

Displays the definitions for one or more storage pools. If no storage pool is specified, the definitions of all storage pools are displayed.

printpoolsets

Displays the details of one or more storage pool sets. If no storage pool set is specified, the details of all storage pool sets are displayed.

rename

Renames a storage pool.

rmdisk

Removes one or more disks from a storage pool. The disks to be removed are specified as a comma-separated list of disk media names to the dm attribute.

setpolicy

Sets the value of the autogrow and/or the selfsuffiecient policy for a storage pool. See the ATTRIBUTES section for a description of the policy level values that may be specified.

OPTIONS

-g diskgroup

Specifies a disk group by name or ID for an operation. If this option is not specified, and an alternate default disk group is not defined by specifying the diskgroup attribute on the command line or in a defaults file (usually /etc/default/allocator), the default disk group is determined using the rules given in the vxdg(1M) manual page.

-r

Removes all disks from a storage pool as part of a delete operation.

ATTRIBUTES

autogrow=[{1|pool}|{2|diskgroup}]

A storage pool's autogrow policy determines whether the pool can be grown to accommodate additional storage. If set to 1 or pool, the pool cannot be grown, and only storage that is currently configured in the pool can be used. If set to 2 or diskgroup}, it can be grown by bringing in additional storage from the disk group outside the storage pool.

The default value of autogrow is 2 (diskgroup).

description=description

Provides a short description of the pool that is being created.

dm=dmname,...

Specifies disks by their disk media names (for example, mydg01). The disks must have already been initialized by VERITAS Volume Manager.

pooldefinition=storage_pool_definition

Specifies the name of the pool definition that is to be used for creating a storage pool.

rules=rules

Specifies the rules that are to be applied when creating a storage pool. The rules that are supported for storage pools are affinity, confineto, select, exclude, separateby, and strong separateby. Multiple rules may be specified by spaces.

selfsufficient=[{1|pool}|{2|diskgroup}|{3|host}]

A storage pool's selfsufficient policy determines whether the pool can use templates that are not currently associated with it. If set to 1 or pool, the pool can only use template that have been associated with it. If set to 2 or diskgroup}, the pool can use templates as necessary that are associated with the disk group. If set to 3 or host}, the pool can use templates if required that are configured on the host system.

The default value of selfsufficient is 1 (pool).

template=t1[,t2...]

Specifies one or more volume templates to an operation.

template_set=ts1[,ts2...]

Specifies one or more volume template sets to an operation.

EXAMPLES

Create a storage pool called ReliablePool, in the disk group mydg, containing the disks mydg01 through mydg04, and with the autogrow and selfsufficient policies both set to diskgroup:

Delete the storage pool testpool from the disk group mydg, and also remove all disks from the pool:

Rename the pool ReliablePool, in the disk group mydg to HardwareReliablePool:

Associate the templates DataMirroring and PrefabricatedDataMirroring with the storage pool HardwareReliablePool:

Disassociate the template DataMirroring from the storage pool HardwareReliablePool:

Add the disks mydg05, mydg06 and mydg07 to the storage pool datapool:

Remove the disks mydg05 and mydg06 from the storage pool datapool:

Set the autogrow and selfsufficient policies to pool for the storage pool mypool:

Display the policies that are associated with the storage pool mypool:

Display a list of all the storage pools in the disk group mydg:

Obtain details of the storage pool HardwareReliablePool:

EXIT STATUS

The vxpool 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.

NOTES

vxpool displays only disks that are in a pool, and which have at least one path available. Use the vxprint command to list full information about disks and their states.

SEE ALSO

vxprint (1M), vxtemplate (1M), vxusertemplate (1M), vxvoladm (1M)

VERITAS Storage Foundation Intelligent Storage Provisioning Administrator's Guide