mptconfig(1M)mptconfig(1M)NAMEmptconfig - configure Ultra320 SCSI controller and A7173A PCI-X Dual
Channel Host Bus Adapters
SYNOPSIS
<device_file>
DESCRIPTION
command provides a mechanism to query or change the SCSI settings of a
SCSI bus.
The command only operates with Ultra320 SCSI controllers claimed by the
MPT driver.
Prerequisites:
You must be a privileged user in order to run the command. See privi‐
leges(5) for more information on privileged users. In addition, some
of the options are intended for use by HP support personnel and require
detailed knowledge of the Ultra320 SCSI driver or firmware to interpret
the output.
where device_file specifies the MPT device file associ‐
ated with one channel of the Ultra320 SCSI con‐
troller.
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 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
output.
When the device file parameter is specified without
any option, will display command usage information.
Options
recognizes the following options and parameters. Keyword options are
case-sensitive. However, a parameter associated with a keyword is not
case-sensitive.
where target_id specifies the SCSI ID of a target device
on the SCSI bus. Valid values are 0 to 15.
The option can be used alone or in combination with
or option. When used alone, the command displays
the settings and in-use values for the target. When
used with the or option, the command sets limits
for the rate or width to be used in subsequent com‐
munication with the target.
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.
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 option, rate indicates the maxi‐
mum rate at which the Ultra320 controller will com‐
municate 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.
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 option, width indicates the max‐
imum 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.
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
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
Display target parameters and limits at id 4
Set SCSI initiator ID for SCSI controller to 6
Set SCSI bus rate for SCSI controller
Set SCSI bus width for SCSI controller
Set SCSI initiator id, bus rate and bus width in a single command
Set maximum SCSI rate to negotiate with target 8 to ultra2
Restore default SCSI parameters
WARNINGS
Setting the initiator ID on a SCSI controller must be done with cau‐
tion, since duplicate SCSI IDs on a SCSI bus can result in bus hangs,
system hangs, and system panics. The 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) configu‐
rations, the 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 option.
AUTHOR
was developed by HP.
FILES
Executable file.
Device files.
SEE ALSOmptutil(1M), ioscan(1M), insf(1M), scsictl(1M), privileges(5)
HP Ultra320 SCSI Adapter Support Guide
mptconfig(1M)