6.2.6.1 chvault

Change the attributes of a vault and provision storage pool resources.

Purpose

The chvault command modifies the attributes of a vault and enables provisioning of storage pool resources.

Syntax

chvault [@]vault --attributes attribute=value[,attribute=value]...
chvault [@]vault --provision storagePool=storagepool-name[,provisioning-attribute=value]...

Command Options

The options for the chvault command are:

  • vault: Identifies the name of the vault that you want to change.

  • --attributes: Specifies attributes to change.

    Use the describe chvault command to see details about the vault attributes you can change. See also Describing Resources and Attributes.

  • --provision: Provisions the specified vault with resources from a specific storage pool.

    To provision a vault with resources from multiple storage pools, you must use a separate command for each storage pool.

    This option is available starting with Oracle Exadata System Software release 26.1.0, and may not be used in conjunction with any other options.

Usage Notes

Note the following information when using this command:

  • The command only changes the specified attributes. Other settings are unaffected.

  • Starting with Oracle Exadata System Software release 26.1.0, you can create multiple storage pools for each media type within a single Exascale cluster and you can provision a vault with a specific set of storage resources from each storage pool.

    The following list describes these attributes, which may be specified using the --provision option. See also Provision a Vault Using Multiple Storage Pools For Each Media Type.

    • spaceProv: Provisions the vault with the specified amount of storage space.

    • iopsProv: Provisions the vault with the specified number of IOPS.

    • flashCacheProv: Provisions the vault with the specified amount of flash cache space.

    • xrmemCacheProv: Provisions the vault with the specified amount of Exadata RDMA Memory Cache (XRMEM cache) space.

    • flashLogProv: Boolean value (true or false) indicating whether the vault is provisioned with access to Exadata Smart Flash Log.

    • xrmemLogProv: Boolean value (true or false) indicating whether the vault is provisioned with access to XRMEM log (if available).

  • If your Exascale cluster is configured with Oracle Exadata System Software before release 26.1.0, you can specify one set of resource provisioning attributes, covering all media types, that is linked directly to the vault.

    The following list describes these attributes, which may be changed using the --attributes option. See also Provision a Vault Using Only One Storage Pool For Each Media Type.

    • spaceProvEF, spaceProvHC, spaceProvXT: Provisions the vault with the specified amount of extreme flash (EF), high capacity (HC), or extended (XT) storage space.

    • iopsProvEF, iopsProvHC, iopsProvXT: Provisions the vault with the specified number of IOPS from extreme flash (EF), high capacity (HC), or extended (XT) storage.

    • flashCacheProv: Provisions the vault with the specified amount of flash cache space.

    • flashLogProv: Boolean value (true or false) indicating whether the vault is provisioned with access to Exadata Smart Flash Log.

    • xrmemCacheProv: Provisions the vault with the specified amount of Exadata RDMA Memory Cache (XRMEM cache) space.

      Use this attribute only on systems with HC or EF storage, but not both. For systems with HC and EF storage, use the following media-specific XRMEM cache provisioning attributes.

    • xrmemCacheProvEF: Provisions the vault with the specified amount of XRMEM cache space associated with EF media.

    • xrmemCacheProvHC: Provisions the vault with the specified amount of XRMEM cache space associated with HC media.

  • To specify an amount of space, you can:

    • Use an integer value representing the number of bytes. The maximum value is 4503599626321920.

    • Specify a space value using suffixes K, KB, M, MB, G, GB, T, TB. The suffix is not case-sensitive.

    • Use unlimited to specify an unlimited amount of space.

  • To specify a number of IOPS, you can:

    • Use an integer value. The maximum value is 4294967295.

    • Use unlimited to specify an unlimited number of IOPS.

  • Specifying 0 (zero) as the value for a cache provisioning attribute (flashCacheProv, xrmemCacheProv, xrmemCacheProvEF, or xrmemCacheProvHC) disables use of the corresponding cache for the vault.

Related Topics

Parent topic: Vault Management