mptconfig(1M)															     mptconfig(1M)

NAME

       mptconfig - 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 privileges(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 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 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 communication 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 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.

       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 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 pro-
			   tocol 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 ini-
			   tiator 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 caution, 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) configurations, 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 ALSO

       mptutil(1M), ioscan(1M), insf(1M), scsictl(1M), privileges(5)

       HP Ultra320 SCSI Adapter Support Guide

																     mptconfig(1M)