6.2.9.3 mktemplate
Create a file template.
Purpose
The mktemplate
command creates an Exascale file template.
Syntax
mktemplate { --file-type file-type | --name template-name }
[ --vault vault | --cluster ]
--content-type content-type
--media-type media-type
--redundancy redundancy
Command Options
Specify the following mktemplate
command options to
identify the template and its scope:
-
--file-type
: Create a template associated with the specified file type. If you specify this option, the template name is the same as the file type. -
--name
: Create a user-defined template having the specified name. -
--vault
: Create a template associated with the specified vault. -
--cluster
: Create a template associated with the cluster.
Specify the following File Storage Attributes, which are associated with the template:
-
--media-type
: Specifies the physical media type used to store the file. Exascale uses this attribute to place the file in a storage pool that utilizes the specified media type. Possible values are:-
HC
: Identifies high capacity storage, using hard disk drives (HDDs) on high-performance Exadata storage servers. -
EF
: Identifies extreme flash storage, using low-latency, high-throughput flash devices.
-
-
--redundancy
: Specifies the number of data copies that are maintained. Currently, the only permitted value is:-
high
: Indicates three mirrored copies of the file data.
-
-
--content-type
: Specifies the type of content in the file. Exascale internally uses this attribute to place file extents on physically separate devices in a manner that maximizes availability in the event of a failure. Possible values are:-
DATA
: Principally associated with user data. -
RECO
: Primarily for data used in backup and recovery operations.
-
Usage Notes
Note the following information when using this command:
-
You can define the scope of the template by specifying the
--vault
option or the--cluster
option. You cannot specify both options simultaneously.If neither option is specified, then the scope of the template is inferred from the current working directory in the ESCLI session. If the current working directory in the ESCLI session is the root directory, then the template is associated with the cluster. Otherwise, the template is associated with the vault that is referenced in the current working directory.
-
You must define the template as a user template by specifying the
--name
option, or you must associate the template with a file type by using the--file-type
option. You cannot specify both options simultaneously. -
You can view a list of Exascale file types by using the ESCLI
lstemplate
command. For example:@> lstemplate --cluster
@> lstemplate --vault vault2 --all
Examples
Example 6-124 Create a User-Defined Cluster-Wide Template
This example shows creating a user-defined template named
T1
. The template is associated with the cluster, as neither
--vault
or --cluster
are specified, and the
current working directory in the ESCLI session is the root directory.
@> mktemplate --name T1 --content-type DATA --media-type HC --redundancy high
Example 6-125 Create a User-Defined Vault-Specific Template
This example shows creating a user-defined template named T2
. The template is associated with the vault named vault2
, as neither --vault
or --cluster
are specified, and the current working directory in the ESCLI session is inside vault2
.
@vault2> mktemplate --name T2 --content-type DATA --media-type HC --redundancy high
Example 6-126 Create a User-Defined Vault-Specific Template
This example shows creating a user-defined template named T3
that is associated with the vault named vault2
.
@> mktemplate --name T3 --vault vault2 --content-type DATA --media-type HC --redundancy high
Example 6-127 Create a User-Defined Cluster-Wide Template
This example shows creating a user-defined cluster-wide template named T4
. The --cluster
option overrides the fact that the current working directory in the ESCLI session is inside vault2
.
@vault2> mktemplate --name T4 --cluster --content-type DATA --media-type HC --redundancy high
Example 6-128 Create a Template for a Specific Vault and File Type
This example shows creating a template associated with the DATAFILE
file type and the vault named vault2
.
@> mktemplate --file-type DATAFILE --vault vault2 --content-type DATA --media-type HC --redundancy high
Example 6-129 Create a Cluster-Wide Template for a Specific File Type
This example shows creating a cluster-wide template associated with the
DATAFILE
file type.
@> mktemplate --file-type DATAFILE --cluster --content-type DATA --media-type HC --redundancy high
Related Topics
Parent topic: Template Management