unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 mptconfig(1M)						       mptconfig(1M)




 NAME
      mptconfig - configure Ultra320 SCSI controller and A7173A PCI-X Dual
      Channel Host Bus Adapters

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


 DESCRIPTION
      mptconfig command provides a mechanism to query or change the SCSI
      settings of a SCSI bus.

      The mptconfig command only operates with Ultra320 SCSI controllers
      claimed by the MPT driver.

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

      <&lt&lt&lt;device_file>&gt&gt&gt;	  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 class of driver.

			  Example: /dev/mpt6. The device file for a specific
			  Ultra320 SCSI adapter can be determined from the
			  ioscan(1M) output.

			  When the device file parameter is specified
			  without any option, mptconfig will display command
			  usage information.

    Options
      mptconfig recognizes the following options and parameters. Keyword
      options are case-sensitive. However, a parameter associated with a
      keyword is not case-sensitive.

      -t   target_id	  where target_id specifies the SCSI ID of a target
			  device on the SCSI bus.  Valid values are 0 to 15.

			  The -t option can be used alone or in combination
			  with -r or -w option. When used alone, the command
			  displays the settings and in-use values for the
			  target. When used with the -r or -w option, the



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






 mptconfig(1M)						       mptconfig(1M)




			  command sets limits for the rate or width to be
			  used in subsequent communication with the target.

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

      -r   rate		  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 -t 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.

      -w   width	  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 -t 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 protocol automatically adjusts the
			  data transfer width to compensate for 8-bit cables
			  and devices.





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






 mptconfig(1M)						       mptconfig(1M)




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

	    mptconfig /dev/mpt5

      Display target parameters and limits at id 4

	    mptconfig -t 4 /dev/mpt5

      Set SCSI initiator ID for SCSI controller to 6

	    mptconfig -i 6 /dev/mpt5

      Set SCSI bus rate for SCSI controller

	    mptconfig -r ultra2 /dev/mpt5

      Set SCSI bus width for SCSI controller

	    mptconfig -w narrow /dev/mpt5

      Set SCSI initiator id, bus rate and bus width in a single command

	    mptconfig -i 4 -r ultra2 -w wide /dev/mpt5




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






 mptconfig(1M)						       mptconfig(1M)




      Set maximum SCSI rate to negotiate with target 8 to ultra2

	    mptconfig -t 8 -r ultra2 /dev/mpt5

      Restore default SCSI parameters

	    mptconfig  -d /dev/mpt5


 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 mptconfig 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 mptconfig 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 -i option.

 AUTHOR
      /opt/mpt/bin/mptconfig was developed by HP.

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

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

 SEE ALSO
      mptutil(1M), ioscan(1M), insf(1M), scsictl(1M)

      HP Ultra320 SCSI Adapter Support Guide






















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