Create vaults by using vault templates

An alternative approach to vault creation is based on the use of vault templates.

These templates allow a user to create multiple vaults with the same parameters quickly and enable common vault configurations to be leveraged across multiple users. A vault template is created on a storage pool and can then be used during the creation of a vault. All parameters that are set in the vault template apply to the vault. When a storage pool is created, the following steps can be performed to create a vault template:

  1. Navigate to the Settings > Vaults tab.
  2. Click Template Management.
  3. Select a Storage Pool for Vault Template from the menu in the Template Management page.
  4. Click Create in the Vault Template section.
  5. A new vault template can be created by either importing an existing template or customizing a new template.
  6. When customizing a new template, you can enter an optional provisioning code (for example, US East). This code determines where data is stored and which vaults are written when using vault provisioning. The provisioning code must be unique for each vault (255 characters max) and defaults to the vault name, once entered. This parameter is typically the S3 Put Bucket locationConstraint or region. In container mode, PUT bucket requests create containers instead of vaults. Therefore, the provisioning code on the vault template is only supported in vault mode.
    • In the Provisioning Code field, you can enter a region (255 characters max). This region is used to indicate where the contents of the vault reside. The locationConstraint shown for the container(s) associated with the vault in the S3 GET Service Extended and S3 GET Bucket Location APIs are populated with this value. The region code on the vault template is only supported in vault mode.
    • In the Provisioning Code field, you can enter a storage class (255 characters max). The storage class is used as a classification assigned to all objects stored within the vault. The header x-amz-storage-class shown in the S3 GET/HEAD object and the storageClass in the response body of the S3 GET Bucket are populated with this value. The storage class on the vault template is only supported in vault mode.
  7. In addition to providing vault configuration parameters, Accesser® devices can be selected for deployment and access to vaults can be controlled by specifying IP addresses. For more information on these configuration parameters, see Creating vaults
  8. Select name index format for the template. For more information on selection see the FDD discussing Vault Index Version Selection. Optionally, set the Name Index Format at the time of standard vault creation. The specified Name Index Format for the standard vault will override the global default and storage pool settings for Name Index Format. Specify the Name Index Format using the Advanced Index Settings using the Create New Standard Vault page: You can chose one of three options.
    1. Storage Pool Default: If selected the value would be inherited from the storage pool selected.
    2. Version 4: Required for all data management features. This provides significantly improved listing performance with a reduce small object write performance.
    3. Version 2: Must not be used for data management features. This provides a better small object write performance over version 4, but significantly lowers S3 listing performance.

    Note: It can only be selected when Name Index is enabled.

    For more information on Use Cases and Workflow see Selecting Vault Name Index Format

  9. Select the Enable Object Lock option to enable Object Lock for this vault template.
    Note:
  10. When complete, click Save.
Note:

(Vault Mode Only) If one or more templates exist or are created, it is possible to specify a default template (Settings > Vaults > Template Management > Default Vault Template Configuration). This default template is used when the Provisioning API is enabled and no provisioning code is specified. Vault templates with Retention enabled cannot be used as a default template.

A vault can be created by using the newly created template.

  1. On the Storage Pool: {storage-pool-name} page, the new template appears under the Vault Templates section.
  2. Click Create Vault next to the template to be used.
  3. Provide the needed information. The newly created vault inherits the SecureSlice™ state (enabled or disabled) from the Vault Template.
  4. Click Save.

Vault templates can be edited and deleted as well:

  1. On the Storage Pool: {storage-pool-name} page, in the Vault Templates section, select the vault template to be edited/deleted, and a new page appears.
  2. Click Change or Delete Vault Template from the action bar at the top of the page.
  3. Edit the template, make any revisions, and click Save.