3.7.3 Modify a Vault Template

A vault template is a named collection of file storage attribute settings defined at the vault level and used when creating new files in the vault. By using vault templates, you can manage file storage attributes automatically and consistently across the vault. A vault template overrides the settings in the corresponding cluster template.

• To modify an existing vault template that is associated with a file type, use the ESCLI chtemplate command with the --vault and --file-type options and specify the file storage attribute settings.

  Use the following command options to specify the file storage attributes:

  • --media-type: Specifies the physical media type used to store files created with the template. 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 for files created with the template. Currently, the only permitted value is:

    • high: Indicates three mirrored copies of the file data.

  • --content-type: Specifies the type of content in files created with the template. 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.

  For example:

  @> chtemplate --vault @my-vault-name --file-type DATAFILE --content-type DATA --media-type EF --redundancy high

  Additionally, starting with Oracle Exadata System Software release 26.1.0, you can use the --storage-pool option to specify the name of a storage pool used to store files created with the template. This option is available only for vault templates.

  For example:

  @> chtemplate --vault @my-vault-name --file-type DATAFILE --content-type DATA --storage-pool my-ef-pool1 --redundancy high

  When a template includes a storage pool specification, it does not require a media type setting. If a storage pool and media type are both specified, the settings must be compatible. For example, a template cannot specify the use of high capacity (HC) storage media and also specify the name of a storage pool that uses extreme flash (EF) storage.

• To modify a user-defined vault template, use the chtemplate command with the --vault and --name options and specify the file storage attribute settings.

  To set the file storage attributes, use the same command options as for modifying a vault template for a file type, as described above. For example:

  @> chtemplate --vault @my-vault-name --name my-data-template --content-type DATA --media-type EF --redundancy high