Home > Veritas Storage Foundation™ Volume Manager Manual Pages

VXTEMPLATE (1M)

Maintenance Commands

Table of contents


NAME

vxtemplate - install and administer volume templates and template sets

SYNOPSIS

vxtemplate [-g diskgroup] [-P storage_pool] \
    activate template=t1[,t2...]

vxtemplate [-g diskgroup] [-P poolname] \
    deactivate template=t1[,t2...]

vxtemplate help [keywords | options]

vxtemplate [-C | -g diskgroup] [-ir] \
    [-d file] [-P storage_pool]
    install [template=t1[,t2...]] \
    [capability=c1[,c2...]] \
    [template_set=ts1[,ts2...]]

vxtemplate [-C | -g diskgroup] [-P storage_pool] \
    list [template=t1[,t2...]] \
    [capability=c1[,c2...]] \
    [template_set=ts1[,ts2...]] \
    [storage_pool_set=ps1[,ps2...]]
    [pool_definition=pd1[,pd2...]]

vxtemplate [-C | -g diskgroup] [-P storage_pool] [-r] [-w] \
    listcapability [c1 [c2 ...]]

vxtemplate listpooldefinition [pd1 [pd2 ...]]

vxtemplate listpoolset [ps1 [ps2 ...]]

vxtemplate [-C | -g diskgroup] [-P storage_pool] \
    listtag template=template_name

vxtemplate [-C | -g diskgroup] [-P storage_pool] [-r] [-w] \
    listtemplate [t1 [t2 ...]] [tag=tagname[=tagvalue]] ...

vxtemplate listtemplateset [template=t1[,ts2...]] [ts1 [ts2 ...]]

vxtemplate [-C | -g diskgroup] [-P storage_pool] \
    print [template=t1[,t2...]] \
    [capability=c1[,c2...]] \
    [template_set=ts1[,ts2...]] \
    [storage_pool_set=ps1[,ps2...]] \
    [pool_definition=pd1[,pd2...]]

vxtemplate [-C | -g diskgroup] [-P storage_pool] \
printcapability [c1 [c2 ...]]

vxtemplate printpooldefinition [pd1 [pd2 ...]]

vxtemplate printpoolset [ps1 [ps2 ...]]

vxtemplate [-C | -g diskgroup] [-P storage_pool] \
    printtemplate [t1 [t2 ...]]

vxtemplate printtemplateset [ts1 [ts2 ...]]

vxtemplate [-g diskgroup] renamecapability c1 c2

vxtemplate [-g diskgroup] renametemplate t1 t2

vxtemplate [-C | -g diskgroup] [-P storage_pool] [-r] \
    uninstall [template=t1[,t2...]] \
    [capability=c1[,c2...]] \
    [template_set=ts1[,ts2...]]


DESCRIPTION

The vxtemplate utility provides a command line interface for administering the volume templates and template sets that are used with the Veritas Intelligent Storage Provisioning (ISP) feature of Veritas Volume Manager (VxVM).

The operations that can be performed by vxtemplate 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 performed either on a configuration database if the -C option is specified, or on a single storage pool which is associated with a disk group. If a disk group is not specified by using the -g option, the default disk group that is aliased by defaultdg is selected.


KEYWORDS

activate
Activates one or more templates in a disk group or storage pool.
deactivate
Deactivates one or more templates in a disk group or storage pool.
help
Displays information on vxtemplate usage, keywords or options.
install
If the -C option is specified, installs one or more templates and/or capabilities in the configuration database.

Otherwise, one or more templates, capabilities and/or template sets are installed in the specified disk group and/or storage pool.

Templates are installed recursively to resolve any dependencies.

Note: By default, installing a template also activates the template unless the -i option is specified.

list
If the -C option is specified, lists templates, capabilities, template sets, storage pool sets and/or storage pool definitions in the configuration database.

Otherwise, lists templates, capabilities and/or template sets that are installed in the specified disk group and/or storage pool.

listcapability
If the -C option is specified, lists capabilities in the configuration database.

Otherwise, lists capabilities in the specified disk group and/or storage pool.

If the -r (recursive) option is specified, lists all capabilities that depend on the specified capabilities.

If the -w (whole) option is specified, lists all capabilities on which the specified capabilities depend (that is, whcih make them complete).

listpooldefinition
List the storage pool definitions in the configuration database.
listpoolset
List the storage pool sets in the configuration database.
listtag
Lists the tags that are referenced in the specified template.
listtemplate
If the -C option is specified, lists templates in the configuration database.

Otherwise, lists templates in the specified disk group and storage pool, and which have the specified tag name and optional tag value.

If one or more template names and the -r (recursive) option are specified, lists all templates that depend on the specified templates.

If one or more template names and the -w (whole) option are specified, lists all templates which the specified templates depend (that is, which make them complete).

listtemplateset
List the template sets in the configuration database.
print
If the -C option is specified, prints details of the templates and/or capabilities in the configuration database.

Otherwise, prints details of the templates and/or capabilities in the specified disk group and/or storage pool.

If a list of templates is specified to the template attribute, only the template sets that contain the specified templates are listed.

printcapability
If the -C option is specified, prints details of the capabilities in the configuration database.

Otherwise, prints details of the capabilities in the specified disk group and/or storage pool.

printpooldefinition
Print details of the storage pool definitions in the configuration database.
printpoolset
Print details of the storage pool sets in the configuration database.
printtemplate
If the -C option is specified, prints details of the templates in the configuration database.

Otherwise, prints details of the templates in the specified disk group and/or storage pool.

printtemplateset
Prints details of the template sets in the configuration database.
renamecapability
Renames a capability.
renametemplate
Renames a template.
uninstall
If the -C option is specified, uninstalls templates and/or capabilities from configuration database.

Otherwise, templates, capabilities and/or template sets are uninstalled from the specified disk group and/or storage pool.

Templates are uninstalled recursively where this is possible without breaking any dependencies.


OPTIONS

-C
Performs an operation on the configuration database.
-d file
Specifies a file from which to install templates and/or capabilities.
-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.
-i
Prevents activation of a template on installation.
-P storage_pool
Specifies a storage pool for an operation.
-r
Performs the install and uninstall operations recursively.

EXAMPLES

List all templates that are installed in the disk group mydg:

vxtemplate -g mydg listtemplate

List the templates t1 and t2, and the capabilities c1 and c2 that are installed in the storage pool mypool within the disk group mydg:


vxtemplate -g mydg -P mypool list template=t1,t2 capability=c1,c2

List all elements that are defined in the configuration database:


vxtemplate -C list

Print details of the template t1 and the capability c1 for the default disk group:


vxtemplate print template=t1 capability=c1

Print details of the templates Template1 and Template2, and the capability C1 from the configuration database:


vxtemplate -C print template=Template1,Template2 capability=c1

Rename the template mytemplate installed in disk group mydg as template1:


vxtemplate -g mydg renametemplate mytemplate template1

Install the templates from the file template1.txt into the configuration database:


vxtemplate -C -d template1.txt install

Install the templates HardwareReliable and SoftwareReliable, and the capability Reliable from the file template1.txt into the configuration database:


vxtemplate -C -d template1.txt install
  template=HardwareReliable,SoftwareReliable \
  capability=Reliable

Install the templates t1 and t2, and the capabilities c1 and c2 into the disk group mydg:


vxtemplate -g mydg install template=t1,t2 \
  capability=c1,c2

Recursively uninstall the templates temp1 and temp2, and the capability cap1 from the configuration database:


vxtemplate -C -r uninstall template=temp1,temp2 \
  capability=cap1

List all the template sets known to the system:


vxtemplate listtemplateset

Print details of the template sets ts1 and ts2.


vxtemplate printtemplateset ts1 ts2


EXIT STATUS

The vxtemplate 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

If a template is associated with any ISP volumes, you cannot dissociate the template from a storage pool, or uninstall the template from a disk group without first deleting the volumes. To display which templates are associated with ISP volumes, use the following command:


vxvoladm -g 
diskgroup
 printintent 
volume_name
 ...

SEE ALSO

vxpool(1M), vxusertemplate(1M), vxvoladm(1M)

Veritas Storage Foundation Intelligent Storage Provisioning Administrator's Guide

Last updated: 31 Aug 2008
Copyright ©2009 Symantec Corporation
All rights reserved.