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 withmkvault
.
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 ofEF
storage space.spaceProvHC
: Provisions the vault with the specified amount ofHC
storage space.iopsProvEF
: Provisions the vault with the specified number of IOPS fromEF
storage.iopsProvHC
: Provisions the vault with the specified number of IOPS fromHC
storage.flashCacheProv
: Provisions the vault with the specified amount of flash cache space.flashLogProv
: Boolean value (true
orfalse
) indicating whether the vault is provisioned with access to Exadata Smart Flash Log. The default value istrue
.-
xrmemCacheProv
: Provisions the vault with the specified amount of Exadata RDMA Memory Cache (XRMEM cache) space.Use this attribute only on systems with
HC
orEF
storage, but not both. For systems withHC
andEF
storage, use the following media-specific XRMEM cache provisioning attributes. -
xrmemCacheProvEF
: Provisions the vault with the specified amount of XRMEM cache space associated withEF
media. -
xrmemCacheProvHC
: Provisions the vault with the specified amount of XRMEM cache space associated withHC
media.
-
Prior to consumption, all provisioned resources are logically provisioned. For example, the
spaceProvHC
attribute specifies the maximum amount ofHC
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
, orspaceProvHC
) without a corresponding IOPS provisioning attribute (iopsProvEF
, oriopsProvHC
), 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
, orxrmemCacheProvHC
) 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