vxtemplate(1M)															    vxtemplate(1M)

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 tem- plates. 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 VxVM 5.0.31.1 24 Mar 2008 vxtemplate(1M)