7.2.14 mkresourceprofile

Create a resource profile.

Syntax

mkresourceprofile --vault vault-name --name resource-profile-name
                  [ --iopsShareEF iopsShareEF ]
                  [ --iopsLimitEF iopsLimitEF ]
                  [ --iopsShareHC iopsShareHC ]
                  [ --iopsLimitHC iopsLimitHC ]
                  [ --enableFlashCache {true|false} ]
                  [ --flashCacheMin flashCacheMin ]
                  [ --flashCacheMax flashCacheMax ]
                  [ --enableXrmemCache {true|false} ]
                  [ --xrmemCacheMin xrmemCacheMin ]
                  [ --xrmemCacheMax xrmemCacheMax ]
                  [ --enableFlashLog {true|false} ]
                  [{ -w | --wallet } wallet-location ] 
                  [{ -T | --trace } trace-level ]
                  [{ -j | --json } [ --compact ]]

Command Options

The options for the mkresourceprofile command are:

• --vault: Identifies the vault that the resource profile is associated with.

• --name: Specifies the name of the resource profile being created.

• --iopsShareEF, --iopsShareHC: Specifies the relative share of I/O bandwidth (IOPS) from extreme flash (EF) or high capacity (HC) storage 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 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).

• -w, --wallet: Optionally specifies the path to the Exascale wallet directory.

• -T, --trace: Optionally enables tracing, with the trace level (trace-level) set to 1 (minimum tracing), 2 (medium tracing), or 3 (maximum tracing). If the trace level is not specified, then minimum tracing is enabled by default.

  The trace file is written to the first accessible location in the following list:

  1. If the $ADR_BASE environment variable is set:

     $ADR_BASE/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  2. /var/log/oracle/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  3. /tmp/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

• -j, --json: Displays the output in JSON format.

• --compact: Displays JSON formatted output in a compact format, without white space and line breaks.

Examples

Example 7-28 Create a Resource Profile with Default Attribute Values

This example shows how to create a resource profile with default attribute values, which is named silver and is associated with the vault named vault2.

$ xsh mkresourceprofile --vault vault2 --name silver

Example 7-29 Create a Resource Profile with Specific Attribute Values

This example shows how to create a resource profile that contains specific attribute settings.

$ xsh mkresourceprofile --vault vault2 --name gold --iopsShareHC 2000 --enableFlashLog true