mptconfig(1M) mptconfig(1M)
NAME [Toc] [Back]
mptconfig - configure Ultra320 SCSI controller and A7173A PCI-X Dual
Channel Host Bus Adapters
SYNOPSIS [Toc] [Back]
/opt/mpt/bin/mptconfig [options] <device_file>
DESCRIPTION [Toc] [Back]
mptconfig command provides a mechanism to query or change the SCSI
settings of a SCSI bus.
The mptconfig command only operates with Ultra320 SCSI controllers
claimed by the MPT driver.
Prerequisites: An effective user ID of 0 (superuser) is required in
order to run the mptconfig command. In addition, some of the mptconfig
options are intended for use by HP support personnel and require
detailed knowledge of the Ultra320 SCSI driver or firmware to
interpret the output.
<device_file> where device_file specifies the MPT device file
associated with one channel of the Ultra320 SCSI
controller.
The device files are created at boot time or
during Online Addition of an adapter. They have
the name /dev/mptX, where X is the instance number
of the SCSI channel, as reported by ioscan(1M) for
the MPT driver and the ext_bus class of driver.
Example: /dev/mpt6. The device file for a specific
Ultra320 SCSI adapter can be determined from the
ioscan(1M) output.
When the device file parameter is specified
without any option, mptconfig will display command
usage information.
Options [Toc] [Back]
mptconfig recognizes the following options and parameters. Keyword
options are case-sensitive. However, a parameter associated with a
keyword is not case-sensitive.
-t target_id where target_id specifies the SCSI ID of a target
device on the SCSI bus. Valid values are 0 to 15.
The -t option can be used alone or in combination
with -r or -w option. When used alone, the command
displays the settings and in-use values for the
target. When used with the -r or -w option, the
Hewlett-Packard Company - 1 - HP-UX Release 11i: May 20, 2003
mptconfig(1M) mptconfig(1M)
command sets limits for the rate or width to be
used in subsequent communication with the target.
-i initiator_id where initiator_id specifies the initiator ID of a
SCSI interface. Valid values are 0 to 15.
This option must be used with caution. See the
WARNINGS section for details.
-r rate where rate specifies the rate at which the
Ultra320 controller negotiates with target
devices.
Valid values are ultra320, ultra160, ultra2, or
ultra.
When used alone, rate indicates the maximum rate
at which the Ultra320 controller will communicate
with all devices connected to the SCSI bus.
When used with the -t option, rate indicates the
maximum rate at which the Ultra320 controller will
communicate with one target.
Unless there is a communication problem, the rate
of ultra320 should be used for all target devices,
since the SCSI protocol automatically adjusts the
data transfer rate to compensate for slower
devices.
-w width where width specifies the data width at which the
Ultra320 controller negotiates with target
devices.
Valid values are wide (16-bit) and narrow (8-bit).
When used alone, width indicates the maximum width
at which the Ultra320 controller will communicate
with all devices connected to the SCSI bus.
When used with the -t option, width indicates the
maximum width at which the Ultra320 controller
will communicate with one target.
Unless there is a communication problem, the width
of "wide" should be used for all target devices,
since the SCSI protocol automatically adjusts the
data transfer width to compensate for 8-bit cables
and devices.
Hewlett-Packard Company - 2 - HP-UX Release 11i: May 20, 2003
mptconfig(1M) mptconfig(1M)
-d specifies that default values should be used to
configure the SCSI controller. Default values of
SCSI parameters are: rate = ultra320, width =
wide, and initiator ID = 7.
This option must be used with caution. See the
WARNINGS section for details.
The following table gives an indication of the maximum data transfer
rates, given a particular in use rate and data width.
In Use Data Data Synchronous
Rate Width=16 Width=8 Period nsec
Mbytes/s Mbytes/s
-------- -------- -------- -----------
Ultra320 320 n/a 6.25
Ultra160 160 n/a 12.5
Ultra2 80 40 25
Ultra 40 20 50
Fast 20 10 100
Async up to 5 Mbytes/s n/a
EXAMPLES [Toc] [Back]
These examples show a Ultra320 SCSI controller that is associated with
a SCSI bus with instance number 5.
Display initiator settings and in-use target parameters
mptconfig /dev/mpt5
Display target parameters and limits at id 4
mptconfig -t 4 /dev/mpt5
Set SCSI initiator ID for SCSI controller to 6
mptconfig -i 6 /dev/mpt5
Set SCSI bus rate for SCSI controller
mptconfig -r ultra2 /dev/mpt5
Set SCSI bus width for SCSI controller
mptconfig -w narrow /dev/mpt5
Set SCSI initiator id, bus rate and bus width in a single command
mptconfig -i 4 -r ultra2 -w wide /dev/mpt5
Hewlett-Packard Company - 3 - HP-UX Release 11i: May 20, 2003
mptconfig(1M) mptconfig(1M)
Set maximum SCSI rate to negotiate with target 8 to ultra2
mptconfig -t 8 -r ultra2 /dev/mpt5
Restore default SCSI parameters
mptconfig -d /dev/mpt5
WARNINGS [Toc] [Back]
Setting the initiator ID on a SCSI controller must be done with
caution, since duplicate SCSI IDs on a SCSI bus can result in bus
hangs, system hangs, and system panics. The mptconfig command will
attempt to verify that no targets are using the specified ID before
the change is allowed; however, in the case of multi-initiator (shared
bus) configurations, the mptconfig command cannot detect the presence
of other initiators on the SCSI bus. Use the ioscan command on any
servers connected to the same SCSI bus to verify that the init_id
selected is free before using the -i option.
AUTHOR [Toc] [Back]
/opt/mpt/bin/mptconfig was developed by HP.
FILES [Toc] [Back]
/opt/mpt/bin/mptconfig Executable file.
/dev/mpt<X> Device files.
SEE ALSO [Toc] [Back]
mptutil(1M), ioscan(1M), insf(1M), scsictl(1M)
HP Ultra320 SCSI Adapter Support Guide
Hewlett-Packard Company - 4 - HP-UX Release 11i: May 20, 2003 [ Back ] |
