unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 mptutil(1M)							 mptutil(1M)




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

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


 DESCRIPTION
      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
      mptutil recognizes the following options. All keywords are case-
      sensitive 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 <&lt&lt&lt;firmware_image>&gt&gt&gt;
		     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 <&lt&lt&lt;device_file>&gt&gt&gt;
		     argument.	WARNING: This is a DESTRUCTIVE operation.
		     Active I/Os will be aborted. Should be used qualified
		     personnel only.

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

		     tgt_reset <&lt&lt&lt;target_id>&gt&gt&gt; Perform a Bus Device Reset on the
		     device specified by the <&lt&lt&lt;target_id>&gt&gt&gt;

		     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 <&lt&lt&lt;filename>&gt&gt&gt;  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
      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
      /opt/bin/mptutil was developed by HP.

 FILES
      /opt/mpt/bin/mptutil     Executable file.

      /dev/mpt<&lt&lt&lt;X>&gt&gt&gt;	       Device files.

 SEE ALSO
      mptconfig(1M), ioscan(1M), scsictl(1M)








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