7.2.15 mktemplate

Create an Exascale template.

Syntax

mktemplate { --vault vault | --cluster }
           { --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 mktemplate command are:

• --vault: Identifies the vault associated with the template being created.

• --cluster: Specifies the creation of a cluster template.

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

• --name: Creates a 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 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.

• -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-30 Create an Exascale template

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

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