6.2.9.1 chtemplate

Change an attribute for an existing template.

Purpose

The chtemplate command changes an attribute for an existing Exascale file template.

Syntax

chtemplate { --file-type file-type | --name template-name } 
           [ --vault vault | --cluster ] 
           [ --content-type content-type ] 
           [ --media-type media-type ] 
           [ --redundancy redundancy ]

Command Options

Specify one or more of the following chtemplate command options to identify the templates that are the subject of the operation:

  • --file-type: Alters a template associated with the specified file type.

  • --name: Alters a user-defined template having the specified name.

  • --vault: Alters a template associated with the specified vault.

  • --cluster: Alters a template associated with the cluster.

Specify one or more of 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.

    • XT: Identifies extended storage, using HDDs on Exadata storage servers optimized for cost-effective online storage of less frequently accessed data.

  • --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.

Examples

Example 6-112 Change a User-Defined Cluster-Wide Template

In this example, the content type is set to DATA for the 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. 

@> chtemplate --name T1 --content-type DATA

Example 6-113 Change a User-Defined Vault-Specific Template

In this example, the media type is set to HC and the redundancy is set to high for the 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> chtemplate --name T2 --media-type HC --redundancy high

Example 6-114 Change a User-Defined Vault-Specific Template

In this example, the media type, content type, and redundancy are all set for the user-defined template named T3 that is associated with the vault named vault2. 

@> chtemplate --name T3 --vault vault2 --content-type DATA --media-type HC --redundancy high

Example 6-115 Change a User-Defined Cluster-Wide Template

In this example, the media type, content type, and redundancy are all set for the cluster-wide user-defined template named T4. The --cluster option overrides the fact that the current working directory in the ESCLI session is inside vault2. 

@vault2> chtemplate --name T4 --cluster --content-type DATA --media-type HC --redundancy high

Example 6-116 Change a Template for a Specific Vault and File Type

This example changes the template associated with the DATAFILE file type and the vault named vault2. 

@> chtemplate --file-type DATAFILE --vault vault2 --content-type DATA --media-type HC --redundancy high

Example 6-117 Change a Cluster-Wide Template for a Specific File Type

This example changes the cluster-wide template associated with the DATAFILE file type. 

@> chtemplate --file-type DATAFILE --cluster --content-type DATA --media-type HC --redundancy high

Related Topics

Parent topic: Template Management