scsimgr.1m (2011 03)

s
scsimgr(1M) scsimgr(1M)
• The tport_max_qdepth
attribute determines the maximum number of IOs issued to the target port.
If a target port is seen through several target paths,
tport_max_qdepth
can be set and displayed
through any one of the target paths.
Automatic distribution of target port’s maximum queue depth over the servers in a HP ServiceGuard
cluster may happen only if appropriate version of HP ServiceGuard software is installed. Please refer
to HP ServiceGuard release notes for more information. If automatic distribution of target port’s max-
imum queue depth over the servers is desired, it is recommended that you set the same value on all
servers in the cluster for a given target port.
• Setting the value of the
tport_qd_dyn attribute to 1 means the number of IOs issued on a target
path to a target port may be adjusted depending on the demand from the incoming IO load relative to
the demand on other target paths to the same target port. If a target port is seen through several tar-
get paths, tport_qd_dyn can be set and displayed through any one of the target paths.
In a HP ServiceGuard environment, it is recommended that you set the same value on all servers in the
cluster for a given target port.
RETURN VALUE
scsimgr exits with one of the following values:
0 Operation successful.
>0 Error condition occurred.
When an error condition occurs,
scsimgr will display an error message specifying the nature and/or the
cause of the error conditions.
However, for operations supporting scriptable output (when the
-p option is used), no errors will be
printed if the error condition only affects one or more of the output fields.
scsimgr will leave the
affected field(s) empty and exit with a non-zero value.
In the following example, the
max_io attribute is not a valid LUN attribute. In the displayed output,
scsimgr leaves the second field corresponding to
max_io empty and exits with EFAULT(14).
# scsimgr -p get_attr -D /dev/rdisk/disk20 -a wwid -a max_io -a max_q_depth
0x20000020371972eb::16
EXAMPLES
To display scsimgr general usage:
scsimgr -h
To display scsimgr usage for get_attr command:
scsimgr -h get_attr
To figure out the SCSI object on which to invoke the command (note that
/dev/rdisk/disk961 is the
character device special file (DSF) in this example):
ioscan -kfnN
Class I H/W Path Driver S/W State H/W Type Desc
=======================================================================
disk 961 64000/0xfa00/0xf9 esdisk CLAIMED DEVICE HP HSV101
/dev/disk/disk961 /dev/rdisk/disk961
To get basic global statistics:
scsimgr get_stat
To get all global statistics:
scsimgr -v get_stat
To display global statistics for driver esdisk:
scsimgr -v get_stat -d esdisk
To get basic statistics for disk0:
scsimgr get_stat -D /dev/rdisk/disk0
HP-UX 11i Version 3: March 2011 − 23 − Hewlett-Packard Company 23