|
|
Multi-Copy Device 0.1.1.0 (Default branch)
04-11-2008
|
|
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)