7.2.31 volumeiops

Create and manage volume groups and their allocated I/O bandwidth (IOPS).

Syntax

volumeiops create { -i | --id } group
                  { -o | --iops } total-IOPS
                  { -a | --add } volume [{ -a | --add } volume ]...
                  [{ -w | --wallet } wallet-location ] 
                  [{ -T | --trace } trace-level ] 
                  [{ -j | --json } [ --compact ]]

volumeiops update { -i | --id } group
                  [{ -o | --iops } total-IOPS ]
                  [{ -a | --add } volume ]...
                  [{ -r | --remove } volume ]...
                  [{ -w | --wallet } wallet-location ] 
                  [{ -T | --trace } trace-level ] 
                  [{ -j | --json } [ --compact ]]

volumeiops list [{ -i | --id } group ]
                [{ -w | --wallet } wallet-location ] 
                [{ -T | --trace } trace-level ] 
                [{ -j | --json } [ --compact ]]

volumeiops delete { -i | --id } group
                  [{ -w | --wallet } wallet-location ] 
                  [{ -T | --trace } trace-level ] 
                  [{ -j | --json } [ --compact ]]

Command Options

The volumeiops supports the following actions:

• create: Creates a volume group containing one or more volumes and configures the group with an I/O bandwidth allocation expressed in I/O operations per second (IOPS).

• update: Modifies the specified volume group by changing volume membership, adjusting the I/O bandwidth allocation, or both.

• list: Displays details for all volume groups or for the specified volume group.

• delete: Deletes the specified volume group and its associated I/O bandwidth allocation.

The options for the volumeiops command are:

• -i, --id: Identifies the name of the volume group that is the subject of the command.

• -o, --iops: Specifies the I/O bandwidth allocation expressed in I/O operations per second (IOPS).

• -a, --add: Adds a volume to the specified group. The volume is identified using a device path, such as: /dev/exc/exa01adm01vm01_cfg_vol0128_8b144f7d0

• -r, --remove: Removes a volume from the specified group. The volume is identified using a device path, such as: /dev/exc/exa01adm01vm01_cfg_vol0128_8b144f7d0

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

Usage Notes

Note the following information when using this command:

• For update, at least one of { -o | --iops }, { -a | --add }, or { -r | --remove } must be specified.