The mptutil command is a diagnostic tool for Ultra320 SCSI controllers claimed by the mpt driver. You can use mptutil to view configuration information, issue task management commands, and read or reset accumulated statistics for the A7173A adapter and connected target devices. The mptutil command can also be used to update the A7173A adapter firmware; see “Using mptutil to Verify or Update A7173A Adapter Firmware”.
A specific device file corresponding to a single channel on an A7173A adapter is necessary to use the mptutil command. Each device file represents a single channel on the A7173A adapter. Commands issued through mptutil are channel specific and do not affect the whole adapter (except for firmware downloads). Some mptutil command options are intended for use by HP support personnel, and require detailed knowledge of the Ultra320 SCSI driver or firmware to interpret the output.
To see a help screen showing the mptutil command syntax, enter mptutil at the system prompt with no additional options:
# mptutil
Usage: mptutil [options] <dev_file>
<dev_file> = /dev/mptX
Options:
-c Read PCI Config Space
-d <firmware_image>
Download Firmware
-t <tmtype> [target_id]
Perform Task Management
where <tmtype> can be,
bus_reset SCSI Bus reset
tgt_reset <target_id> Target Reset
-u <filename>
Upload Firmware
-R Reset Driver statistics
-S Display Channel and Device statistics
-T Display Driver Trace information
Note:
- You must be a privileged user to execute this command. See privileges(5)
for more information on privileged users.
- See mptutil(1M) for tool details.
# |
To determine the device file names for the channels on the A7173A adapters that are installed in your system, use the ioscan -fnkd mpt command. Example 5-3 shows a typical output from this command:
Example 5-3 Typical ioscan -fnkd mpt Command Output
# ioscan -fnkd mpt
Class I H/W Path Driver S/W State H/W Type Description
===================================================================
ext_bus 4 1/0/2/0/0 mpt CLAIMED INTERFACE SCSI Ultra320
/dev/mpt4
ext_bus 5 1/0/2/0/1 mpt CLAIMED INTERFACE SCSI Ultra320
/dev/mpt5
ext_bus 6 1/0/4/0/0 mpt CLAIMED INTERFACE SCSI Ultra320
/dev/mpt6
ext_bus 7 1/0/4/0/1 mpt CLAIMED INTERFACE SCSI Ultra320
/dev/mpt7
ext_bus 8 1/0/6/0/0 mpt CLAIMED INTERFACE SCSI Ultra320 A6961-60011
/dev/mpt8
ext_bus 9 1/0/6/0/1 mpt CLAIMED INTERFACE SCSI Ultra320 A6961-60011
/dev/mpt9
ext_bus 12 1/0/12/0/0 mpt CLAIMED INTERFACE SCSI Ultra320
/dev/mpt12
ext_bus 13 1/0/12/0/1 mpt CLAIMED INTERFACE SCSI Ultra320
/dev/mpt13
ext_bus 14 1/0/14/0/0 mpt CLAIMED INTERFACE SCSI Ultra320 A6961-60011
/dev/mpt14
ext_bus 15 1/0/14/0/1 mpt CLAIMED INTERFACE SCSI Ultra320 A6961-60011
/dev/mpt15
|
The system shown in Example 5-3 has five A7173A adapters installed in the system, with a total of ten SCSI channels and ten device files. The device file name is displayed in the second line of output for each SCSI channel.
Use the mptutil <dev_file> command to display detailed information on the SCSI channel, the SCSI chip, the firmware, and the VPD for the A7173A adapter channel associated with <dev_file>:
Example 5-4 Using mptutil to Display Detailed SCSI Information and VPD for an Adapter
 |
# mptutil /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
---- ADAPTER INFORMATION -----------------------------------------------------
Device File : /dev/mpt14
Hardware Path : 1/0/14/0/0
Driver Version : r11.31/1.02
---- CHIP INFORMATION --------------------------------------------------------
Device ID : 0x0030
Vendor ID : 0x1000
Revision ID : 0x8
Subsystem ID : 0x12c5
Subsystem Vendor ID : 0x103c
IOC Number : 0
Max. Devices : 16
Number of channels : 2
Driver State : OPERATIONAL
---- FIRMWARE INFORMATION ----------------------------------------------------
SCSI Firmware Version : 1.03.35.69 IO
SCSI Firmware Version (Hex) : 1.03.23.45 IO
SCSI Firmware Size : 40356
EFI Driver Version : 1.05.00.01
---- V P D I N F O R M A T I O N -------------------------------------------
Adapter : PCI-X DUAL CHANNEL ULTRA320 SCSI ADAPTER
Part Number : A6961-60011
Engineering Code : C-4429
Specification : PW=15W PCI-X=64BIT,133MHZ
Serial Number : P105283605
Manufacturing Date Code : C-4429
EFI driver version : 1.05.00.01 |
|
The Driver State line in the CHIP INFORMATION section contains important information. The following driver states are defined in the Driver State field:
- UNINITIALIZED
This state indicates that the hardware has not been initialized by the driver. This state could result if the driver was unable to successfully initialize the channel.
- OPERATIONAL
This state indicates that the driver is online and ready to perform normal SCSI I/O operations.
- TASK_MGMT
This state indicates that driver is currently performing task management commands such as SCSI BUSRESET, ABORT TASK, and BUS DEVICE RESET.
- REPAIRING
This state indicates that the driver has detected a controller fault and is currently recovering from that condition.
- CONFIGURING
This state indicates that the controller initialization is complete. The driver is in the process of retrieving and setting various configuration parameters.
- SUSPENDED
This state indicates that the controller has been suspended.
Use the -c option to display the PCI Configuration data stored on the A7173A adapter. Information is displayed as hexadecimal data. For example:
|
# mptutil -c /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
---- PCI Configuration Registers ---------------------------------------------
Device ID : 0x0030
Vendor ID : 0x1000
Status Register : 0x0230
Command Register : 0x0157
Revision ID : 8
Class Code : 0x10000
Cache Line Size : 32
Latency Timer : 64
Header Type : 0x80
IO Base Address : 0x8001
Memory [0] Low Address : 0xc0200004
Memory [0] High Address : 0x0000
Memory [1] Low Address : 0xc0220004
Memory [1] High Address : 0x0000
Sub-System ID : 0x12c5
Sub-System Vendor ID : 0x103c
Expansion ROM Base Address : 0xc0000000
Capabilities Pointer : 80
******************************************************************************
**** End of MPTUTIL Output ****
****************************************************************************** |
|
Use the mptutil -d <firmware_image> <device_file> command to download and flash the mpt SCSI firmware into the ROM of the A7173A adapter specified by <device_file>. See “Using mptutil to Verify or Update A7173A Adapter Firmware”.
|
| |
|
 | WARNING! Changing the adapter firmware is a DESTRUCTIVE operation. Any active I/Os will be aborted. The -d option should only be used by qualified personnel. |
|
| |
|
Example 5-5 Updating A7173A Firmware Online
|
# mptutil -d /tmp/fw_1.03.35.69_IO /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
---- FIRMWARE UPDATE ---------------------------------------------------------
Device File........... /dev/mpt14
New Firmware Image.... /tmp/fw_1.03.35.69_IO
Hardware Path......... 1/0/14/0/0
------------------------------------------------------------------------------
Old SCSI New SCSI
Firmware Firmware
------------------------------------------------------------------------------
Version............... 1.03.35.65 IO 1.03.35.69 IO
Do you want to update firmware on the SCSI controller
at 1/0/14/0/0 with new scsi firmware (y/[n]): y
The firmware update operation may take up to 5 minutes to complete.
Please wait while firmware update is in progress./
Firmware update successful.
******************************************************************************
**** End of MPTUTIL Output ****
****************************************************************************** |
|
Use the mptutil -t <tmtype> <target_id> command to perform task management commands. The <tmtype> variable specifies the command type. Two types of task management commands are currently supported:
The tgt_reset <target_id> task management command performs a Bus Device Reset on the device specified by the <target_id>. The <target_id> for a device can be determined from the ioscan -kfn command output. In the following example the target with an ID of “1” was selected from the ioscan -kfn output example found in the “Using mptconfig for Online Configuration” section of Chapter 3:
|
# mptutil -t tgt_reset 1 /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
WARNING: This is a DESTRUCTIVE operation.
This might result in failure of current I/O requests.
Do you want to continue? (y/n) [n]...y
Task Management operation completed successfully
******************************************************************************
**** End of MPTUTIL Output ****
****************************************************************************** |
The bus_reset <dev_file> task management command performs a SCSI Bus Reset - it will reset all of the devices on the SCSI bus:
# mptutil -t bus_reset /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
WARNING: This is a DESTRUCTIVE operation.
This might result in failure of current I/O requests.
Do you want to continue? (y/n) [n]...y
Task Management operation completed successfully
******************************************************************************
**** End of MPTUTIL Output ****
****************************************************************************** |
|
| |
|
| WARNING! Resetting a SCSI bus or device is a DESTRUCTIVE operation. Active I/Os will be aborted. The -t option should only be used by qualified personnel. |
|
| |
|
Use the -u <filename> option to copy (upload) the firmware image that is currently running on the A7173A adapter to a file specified by <filename>. For example:
# mptutil -u /tmp/fw_1.03.35.69_IO /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
Firmware Image (40356 bytes) has been saved to /tmp/fw_1.03.35.69_IO
******************************************************************************
**** End of MPTUTIL Output ****
****************************************************************************** |
Device Statistics and Trace Information
Use the -R option to clear mpt driver and associated device statistics. For example:
# mptutil -R /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
Successfully reset the stats
******************************************************************************
**** End of MPTUTIL Output ****
****************************************************************************** |
Use the -S option to display mpt driver and associated device statistics.
Use the -T option to dump the mpt driver trace information to the console.
Port Information
Use the -P option to displays port information; the data is displayed as a series of hexadecimal words. For example:
# mptutil -P /dev/mpt14
******************************************************************************
**** ****
**** M P T U T I L S u p p o r t T o o l ****
**** ****
**** for Ultra320 SCSI Controller ****
**** ****
**** Version 1.02 : Oct 22 2006 ****
**** ****
**** (c) Copyright 2003 Hewlett-Packard Development Company, L.P. ****
**** ****
******************************************************************************
Port Facts (40 Bytes)
0x00410129 0x82280050 0x43492d58 0x20445541
0x4c204348 0x414e4e45 0x4c20554c 0x54524133
0x32302053 0x43534920
******************************************************************************
**** End of MPTUTIL Output ****
****************************************************************************** |
Printable version
