setsvcthresh
You can use the
setsvcthresh command
to set or change the SAN Volume Controller performance thresholds. To modify
an existing threshold setting for a specific device, use the
setsvcthresh command again. Only new values specified will change; unspecified
settings will be preserved.
- All changes to threshold settings apply immediately, even if a current
performance data collection task is already active and running.
- Threshold checking does not occur on a device unless a performance data
collection task has been created for that device and the task has been started
as part of a performance collection job. Performance data collection jobs,
when run, check devices for which thresholds are enabled to see if any of
the performance statistics, for which thresholds are set, exceed the threshold
value.
- Enabling a threshold status results in any detected exception data to
be recorded in the Performance Manager database, but if the alert level is
set to none, a log message is entered into the MDM event
log and the exception information is saved in the Performance Manager database.
If the alert level is set to anything other than none,
the Performance Manager sends an internal event to Director. Users can configure
how these alerts manifest (for example, SNMP, E-mail, and so on) using Director's
Event Action Planner.
Syntax

>>-perfcli-- --setsvcthresh-- ---threshtype--+-vdiskbps----+---->
+-vdiskiorate-+
+-mdiskbps----+
+-mdiskiorate-+
'-all---------'
>-- ---dev--+-ID [...]-+-- --+------------------+-- ------------>
'-all------' '--status--+-on--+-'
'-off-'
>--+------------------+-- --+-----------------+-- -------------->
'--warn--threshold-' '--err--threshold-'
>--+------------------+-- --+--------+-------------------------><
'--alert--+-warn-+-' '--quiet-'
+-err--+
'-none-'
Parameters
- -threshtype vdiskbps | vdiskiorate | mdiskbps | mdiskiorate
| all
- Specifies which threshold is to be set. Specify one of the following
types:
- vdiskbps
- The total number of virtual disk I/s for each I/O group.
- vdiskiorate
- Virtual disk megabytes per second, for each I/O group.
- mdiskbps
- Total number of managed disk I/Os for each managed disk group.
- mdiskiorate
- For each managed disk group, the megabytes per second for each I/O group.
- all
- Sets all the thresholds.
- -dev id [...] | all
- Specifies the device that will apply the threshold to be set. The device
ID is the nickname or model-serial-manufacturer of the device. Separate multiple
device IDs by commas. All devices must be of the same device type.
- -status on | off
- An optional parameter that specifies whether the specified threshold
type should be enabled or disabled for checking. The default is off and disabled for checking.
- -warn threshold
- An optional parameter that specifies the warning threshold percentage
value. Valid ranges are 0 - 100. There are no default values.
- -err threshold
- An optional parameter that specifies the error threshold percentage
value. Valid ranges are 0 - 100. There are no default values.
- -alert warn | err | none
- An optional parameter that specifies which thresholds should send an
alert if the threshold is exceeded. One of the following alert values can
be specified:
- Warn. An alert is sent when the warning threshold is exceeded.
- Err. An alert is sent when the warning and error threshold is exceeded.
- None. No alerts are sent. This is the default.
 | Note: If the threshold
status is enabled for checking, but no alerts are set to be sent, a log message
is still entered into the Multiple-Device Resource Manager event log and exception
information is recorded in the database. |
- -quiet
- An optional parameter that turns off the confirmation prompt for this
command.
Description
You can use the setsvcthresh command to set the threshold
properties for the SAN Volume Controller.
Return values
Threshold thresh_type successfully set.
- return value
- An explanation of the return value.
Possible failures
- Device device does not exist.
Examples
An example:
perfcli setsvcthresh -threshtype mdiskiorate -devid all -status off
The resulting output:
Threshold successfully set.