7.2.4 chtemplate

Change template attributes.

Syntax

chtemplate [ --vault vault ] 
           { --file-type file-type | --name template-name }
           [ --media-type media-type ] 
           [ --redundancy redundancy ] 
           [ --content-type content-type ]
           [{ -w | --wallet } wallet-location ] 
           [{ -T | --trace } trace-level ]
           [{ -j | --json } [ --compact ]]

Command Options

The options for the chtemplate command are:

• --vault: Identifies the vault associated with the valut-level template being changed.

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

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

• --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 uses 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 3 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 way that maximizes availability if a failure occurs. Possible values are:

  • DATA: Principally associated with user data.

  • RECO: Primarily for information used in data recovery operations and to maintain data integrity.

• -w, --wallet: Optionally specifies the path to the Exascale wallet directory.

• -T, --trace: Optionally enables tracing, with the trace level (trace-level) set to 1 (minimum tracing), 2 (medium tracing), or 3 (maximum tracing). If the trace level is not specified, then minimum tracing is enabled by default.

  The trace file is written to the first accessible location in the following list:

  1. If the $ADR_BASE environment variable is set:

     $ADR_BASE/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  2. /var/log/oracle/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  3. /tmp/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

• -j, --json: Displays the output in JSON format.

• --compact: Displays JSON formatted output in a compact format, without white space and line breaks.

Examples

Example 7-7 Modify an Exascale template

The following example sets the specified media type, redundancy, and content type settings in the user-defined template named my-template, which is associated with the my-data vault.

$ xsh chtemplate --vault my-data --name my-template --media-type EF --redundancy high --content-type DATA