6.2.10.3 mkresourceprofile
Create a resource profile.
Purpose
The mkresourceprofile
command creates a resource profile.
Syntax
mkresourceprofile [vault-name/]resource-profile-name [ --attributes attribute=value[,attribute=value] ... ]
Command Options
The options for the mkresourceprofile
command are:
-
resource-profile-name: Specifies the name for the resource profile being created.
-
vault-name: Specifies the vault that the resource profile is associated with.
If not specified, then the current working directory is used to specify the vault.
-
--attributes
: Optionally specifies values for attributes of the resource profile. The following list outlines all of the available attributes:iopsShareEF
: Specifies the relative share of I/O bandwidth (IOPS) from extreme flash (EF) storage media that is available to each client associated with the resource profile. Each client’s share is relative to all other client shares. A higher share value implies higher priority. The range of valid values is1
-100
, and the default is1
.iopsLimitEF
: Specifies the upper limit of the I/O bandwidth (IOPS) from extreme flash (EF) storage media that is available to each client associated with the resource profile. The value represents a fraction out of 10000. The range of valid values is1
-10000
. The default value is10000
(effectively unlimited).iopsShareHC
: Specifies the relative share of I/O bandwidth (IOPS) from high capacity (HC) storage media that is available to each client associated with the resource profile. Each client’s share is relative to all other client shares. A higher share value implies higher priority. The range of valid values is1
-100
, and the default is1
.iopsLimitHC
: Specifies the upper limit of the I/O bandwidth (IOPS) from high capacity (HC) storage media that is available to each client associated with the resource profile. The value represents a fraction out of 10000. The range of valid values is1
-10000
. The default value is10000
(effectively unlimited).enableFlashCache
: Enables or disables use of flash cache for clients associated with the resource profile. The value is Boolean, and the default istrue
(enabled).flashCacheMin
: Specifies the guaranteed minimum fraction of flash cache available to each client associated with the resource profile. The range of valid values is0
-10000
. The default value is0
(no set minimum). If the sum of all values across all resource profiles exceeds 10000, then all values are proportionally scaled down. This option is valid only whenenableFlashCache=true
.flashCacheMax
: Specifies the maximum fraction of flash cache available to each client associated with the resource profile. This option is valid only whenenableFlashCache=true
. The range of valid values is0
-10000
. The default value is10000
. This option is valid only whenenableFlashCache=true
.enableXrmemCache
: Enables or disables use of Exadata RDMA Memory Cache (XRMEM cache) for clients associated with the resource profile. The value is Boolean, and the default istrue
(enabled).xrmemCacheMin
: Specifies the guaranteed minimum fraction of XRMEM cache available to each client associated with the resource profile. The range of valid values is0
-10000
. The default value is0
(no set minimum). If the sum of all values across all resource profiles exceeds 10000, then all values are proportionally scaled down. This option is valid only whenenableXrmemCache=true
.xrmemCacheMax
: Specifies the maximum fraction of XRMEM cache available to each client associated with the resource profile. This option is valid only whenenableXrmemCache=true
. The range of valid values is0
-10000
. The default value is10000
. This option is valid only whenenableXrmemCache=true
.enableFlashLog
: Enables or disables use of flash log for clients associated with the resource profile. The value is Boolean, and the default istrue
(enabled).
Usage Notes
In addition to regular user-defined resource profiles, you can also
create a system-reserved resource profile named $UNASSIGNED
. All
Exascale clients not explicitly
associated with a resource profile are automatically governed by the
$UNASSIGNED
profile. The $UNASSIGNED
resource
profile contains only two modifiable attributes:
flashCacheMax
: Specifies the maximum fraction of flash cache shared by clients associated with the$UNASSIGNED
profile. The range of valid values is0
-10000
. The default value is10000
.xrmemCacheMax
: Specifies the maximum fraction of XRMEM cache shared by clients associated with the$UNASSIGNED
profile. The range of valid values is0
-10000
. The default value is10000
.
All Exascale clients governed by the
$UNASSIGNED
profile share the corresponding cache resources.
The behavior differs from regular resource profiles, where each application of the
resource profile defines the resource allocation for one associated client.
If the $UNASSIGNED
resource profile does not exist, all
unassigned Exascale clients share any
unassigned flash cache space and XRMEM cache space. If there is no unassigned space
to share, the system automatically reserves 5% of the cache space for unassigned Exascale clients.
Examples
Example 6-138 Create a Resource Profile with Default Attribute Values
This example shows two ways to create a resource profile with default
attribute values, which is named SILVER
and is associated with the
vault named VAULT1
.
@> mkresourceprofile VAULT1/SILVER
@> mkresourceprofile SILVER --attributes vault=VAULT1
Example 6-139 Create a Resource Profile with Default Attribute Values
This example shows how to create a resource profile with default
attribute values, which is named BRONZE
and is associated with the
vault named VAULT1
. In this example, the vault association is not
specified in the command but is derived from the current working directory in the
ESCLI session.
@VAULT1> mkresourceprofile BRONZE
Example 6-140 Create a Resource Profile with Specific Attribute Values
This example shows how to create a resource profile that contains specific attribute settings.
@> mkresourceprofile VAULT1/GOLD --attributes iopsShareHC=11,enableFlashLog=false
Parent topic: Resource Profile Management