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, iopsShareHC: Specifies the relative share of I/O bandwidth (IOPS) from extreme flash (EF) or 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 associated with the corresponding media type. A higher share value implies higher priority. The range of valid values is 1-100, and the default value is 1.

    • iopsLimitEF, iopsLimitHC: Specifies the upper limit of the I/O bandwidth (IOPS) from extreme flash (EF) or high capacity (HC) storage media that is available to each client associated with the resource profile. Each value represents a fraction out of 10000. The range of valid values is 1-10000, and the default value is 10000 (effectively unlimited).

    • enableFlashCache, enableXrmemCache, enableFlashLog: Enables or disables use of the flash cache, XRMEM cache, or flash log for clients associated with the resource profile. Each value is Boolean, and the default is true (enabled).

    • flashCacheMin, xrmemCacheMin: Specifies the guaranteed minimum fraction of flash cache or XRMEM cache space available to each client associated with the resource profile. The range of valid values is 0-10000, and the default value is 0 (no set minimum). For each cache type, if the sum of all values across all resource profiles exceeds 10000, then all the values are proportionally scaled down. Each value applies only when the corresponding cache is enabled in the resource profile (for example, enableFlashCache=true).

    • flashCacheMax, xrmemCacheMax: Specifies the maximum fraction of flash cache or XRMEM cache space available to each client associated with the resource profile. The range of valid values is 0-10000, and the default value is 10000. Each value applies only when the corresponding cache is enabled in the resource profile (for example, enableFlashCache=true).

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 is 0-10000. The default value is 10000.
  • xrmemCacheMax: Specifies the maximum fraction of XRMEM cache shared by clients associated with the $UNASSIGNED profile. The range of valid values is 0-10000. The default value is 10000.

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

@> mkresourceprofile vault2/silver
@> mkresourceprofile silver --attributes vault=vault2

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 vault2. In this example, the vault association is not specified in the command but is derived from the current working directory in the ESCLI session. 

@vault2> 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 vault2/gold --attributes iopsShareHC=11,enableFlashLog=false

Parent topic: Resource Profile Management