1. Exascale User's Guide
  2. Using ESCLI
  3. ESCLI Command Reference
  4. Vault Management
  5. mkvault

6.2.6.2 mkvault

Create a vault.

Purpose

The mkvault command creates an Exascale vault.

Syntax

mkvault [@]vault [ --attributes attribute=value[,attribute=value] ... ]

Command Options

The options for the mkvault command are:

  • vault: Specifies the name of the vault.

  • --attributes: Optionally specifies attributes to set.

    Use the describe mkvault command to view details about all the vault attributes you can set with mkvault.

Usage Notes

Note the following information when using this command:

  • The default value for all resource provisioning attributes is effectively unlimited. Consequently, a vault that is created without any resource provisioning attribute settings has access to all of the resources in the Exascale cluster.

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

    • spaceProvEF: Provisions the vault with the specified amount of EF storage space.
    • spaceProvHC: Provisions the vault with the specified amount of HC storage space.
    • iopsProvEF: Provisions the vault with the specified number of IOPS from EF storage.
    • iopsProvHC: Provisions the vault with the specified number of IOPS from HC 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.

  • Prior to consumption, all provisioned resources are logically provisioned. For example, the spaceProvHC attribute specifies the maximum amount of HC storage space that the vault can consume. However, physical space is only consumed when data is written to files in the vault.

  • 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.

  • If you specify a value for any provisioning attributes, then the vault is limited to use the provisioned resources from the corresponding storage pools and the other storage pools are effectively disabled.

    If you specify a space provisioning attribute (spaceProvEF, or spaceProvHC) without a corresponding IOPS provisioning attribute (iopsProvEF, or iopsProvHC), then the vault can consume the specified space and use unlimited IOPS in the associated storage pool.

    If you specify an IOPS provisioning attribute without a corresponding space provisioning attribute, then the vault can consume unlimited space in the associated storage pool but the I/O bandwidth is limited by the IOPS provisioning attribute.

  • 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 Create a Vault with Unlimited Storage

The following example shows creating a vault named MYDATA that has unlimited access to all of the resources in the Exascale cluster. 

@> mkvault @MYDATA

Example 6-66 Create a Vault with Provisioned Storage

The following example shows creating a vault named MYDATA2 that is provisioned with 5 terabytes of HC storage space. The resulting vault is implicitly provisioned with unlimited IOPS. 

@> mkvault @MYDATA2 --attributes spaceProvHC=5T

Example 6-67 Create a Vault with Provisioned Storage

The following example shows creating a vault named MYDATA3 that is provisioned to use EF and HC storage media. From the EF storage pool, the vault can consume 10 terabytes of storage space and unlimited IOPS. From the HC storage pool, the vault can consume unlimited storage space and 100000 IOPS. 

@> mkvault @MYDATA3 --attributes spaceProvEF=5T,iopsProvHC=100000

Parent topic: Vault Management