6.2.6.1 chvault

Change the attributes of a vault.

Purpose

The chvault command modifies the attributes of a vault.

Syntax

chvault vault --attributes attribute=value[,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.

Usage Notes

Note the following information when using this command:

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

  • Following is the list of vault-specific resource provisioning attributes that may be changed:

    • 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. The default value is true.

    • 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) effectively disables use of the corresponding cache for the vault.

Examples

Example 6-65 Set the Amount of Space Provisioned for a Vault

The following example shows setting the amount of provisioned HC storage space to 10 terabytes for the vault named my-data. 

@> chvault my-data --attributes spaceProvHC=10T

Parent topic: Vault Management