mptutil(1M)                                                     mptutil(1M)




 NAME    [Toc]    [Back]
      mptutil - Diagnostic utility for Ultra320 SCSI controllers and A7173A
      PCI-X Dual channel Host Bus Adapters

 SYNOPSIS    [Toc]    [Back]
      /opt/mpt/bin/mptutil [options] <device_file>


 DESCRIPTION    [Toc]    [Back]
      The mptutil command is a diagnostic tool to be used for Ultra320 SCSI
      controllers claimed by the MPT driver. This command provides the
      ability to retrieve various configuration information, perform
      firmware downloads, issue Task Management commands and read
      accumulated statistics of the controller and connected target devices.

      The utility can be used with various options with a specified device
      file.  Each device file represents only a single channel on the SCSI
      controller. Therefore, commands issued through this utility are
      channel specific and does not affect the whole adapter (except
      firmware download).

      Prerequisites: An effective user ID of 0 (superuser) is required in
      order to run the mptutil command. In addition, some of the mptutil
      options are intended for use by HP support personnel and require
      detailed knowledge of the Ultra320 SCSI driver or firmware to
      interpret the output.


    OPTIONS    [Toc]    [Back]
      mptutil recognizes the following options. All keywords are casesensitive
 and are position dependent.

      <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.


                     When used without any options it provides information
                     such as the Driver and Firmware version, Vendor ID,
                     Device ID, Adapter NVRAM size, Vital Product Data (VPD)
                     along with the driver's current state.







 Hewlett-Packard Company            - 1 -    HP-UX Release 11i: May 20, 2003






 mptutil(1M)                                                     mptutil(1M)




                     The following driver states are defined:

                     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.

                     CONFIGURING This state indicates that the controller
                     initialization is complete. Driver is in the process of
                     retrieving/setting various configuration parameters.

                     OPERATIONAL This state indicates that driver is online
                     and ready to perform normal SCSI I/O operation.

                     TASK_MGMT This state indicates that driver is currently
                     performing Task Management commands such SCSI BUS
                     RESET, ABORT TASK, BUS DEVICE RESET etc.

                     REPAIRING This state indicates that driver has detected
                     a controller fault and is currently recovering from
                     that condition.

                     SUSPENDED This state indicates that controller has been
                     suspended by the user.

      -c             This option is used to display the PCI Configuration
                     data stored on the card. Information is displayed as
                     hexadecimal data.

      -d <firmware_image>
                     This option is used to download the MPT SCSI firmware
                     onto the SCSI controller that has an associated Flash
                     ROM. The controller is specified by the <device_file>
                     argument.  WARNING: This is a DESTRUCTIVE operation.
                     Active I/Os will be aborted. Should be used qualified
                     personnel only.

      -t <tmtype> [target_id]
                     This option is used to perform Task Management
                     commands. The option <tmtype> specifies the command
                     type. Two types of Task Management commands are
                     currently supported.

                     tgt_reset <target_id> Perform a Bus Device Reset on the
                     device specified by the <target_id>

                     bus_reset Perform a SCSI Bus Reset. This will reset all
                     the devices on the SCSI bus.

                     WARNING: This is a DESTRUCTIVE operation. Active I/Os
                     will be aborted. Should be used qualified personnel



 Hewlett-Packard Company            - 2 -    HP-UX Release 11i: May 20, 2003






 mptutil(1M)                                                     mptutil(1M)




                     only.

      -u <filename>  This option is used to upload the currently running
                     firmware image to file specified by the filename

      -R             Clear Driver and Device Statistics

      -S             Display Driver and Device Statistics

      -T             Dump the driver trace information onto the console.

      -P             Display Port Facts Information. The data is displayed
                     as a series of hexadecimal words.


 EXAMPLES    [Toc]    [Back]
      These examples show an Ultra320 SCSI controller that is associated
      with a SCSI bus with instance number 5.

      Display VPD and other general information stored on the controller

           mptutil /dev/mpt5

      Download Firmware to the controller

           mptutil -d a7173a_1_03_06_im.img  /dev/mpt5

      Display driver and device statistics

           mptutil -S /dev/mpt5

      Perform a device reset represented by target_id 1 connected to the
      controller

           mptutil -t tgt_reset 1 /dev/mpt5

 AUTHOR    [Toc]    [Back]
      /opt/bin/mptutil was developed by HP.

 FILES    [Toc]    [Back]
      /opt/mpt/bin/mptutil     Executable file.

      /dev/mpt<X>              Device files.

 SEE ALSO    [Toc]    [Back]
      mptconfig(1M), ioscan(1M), scsictl(1M)


 Hewlett-Packard Company            - 3 -    HP-UX Release 11i: May 20, 2003