7.2.3 chresourceprofile

Change a resource profile associated with a vault.

Syntax

chresourceprofile --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 chresourceprofile command are:

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

• --name: Identifies the resource profile being changed.

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

• -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-6 Change a Resource Profile

In this example, the iopsShareHC attribute is set to 2000 for the silver resource profile in conjunction with the vault2 vault.

$ xsh chresourceprofile --vault vault2 --name silver --iopsShareHC=2000