***************************************************************************** SYMMPI2003.TXT ***************************************************************************** Installation Guide for the LSI Logic Fusion-MPT (TM) Driver: SYMMPI.SYS V1.09.xx This file describes the features and use of the LSI Logic Fusion-MPT SCSI/Fibre Channel device drivers for the Windows Server 2003 operating system environment. It is divided into the following sections: Introduction for Windows Server 2003 Features LSI Logic Devices Supported Description Installing the Driver(s) New System Installation CD-ROM Installation Existing System Installation Performance Tuning for Windows Server 2003 Large Block Size Support Maximum Number of Concurrent I/Os Miniport Driver Configuration Options Troubleshooting ......................................................................... 1.0 Introduction for Windows Server 2003 Windows Server 2003 is an operating system designed to run on Intel architecture (32-bit) and Itanium Processor Family (64-bit) processors using current technology. It provides a graphical user interface environment incorporating many high-level features. Refer to the Microsoft Windows Server 2003 documentation for details. An I/O manager handles I/O requests in Windows Server 2003. To address a SCSI peripheral, the I/O manager goes through the appropriate drivers. Windows Server 2003 provides class drivers for hard disk, optical, CD-ROM, printer, and scanner peripherals. Other class drivers, provided by peripheral manufacturers, may be added to support new devices. Tape device support is built into the operating system itself and does not require a class driver. Microsoft provides the port driver and LSI Logic provides the miniport driver, which is called SYMMPI.SYS. This driver completes the path to the LSI Logic controller or processor with an optional SCSI or Fibre Channel BIOS. LSI Logic uses the same filenames for their drivers for different Windows operating systems. The driver files are packaged either in separate subdirectories based on the Windows operating system or on different disks. To determine the driver file for Windows Server 2003, note that the filename ends with .SYS. For example, this driver is SYMMPI.SYS. To determine the operating system version, go into Windows Explorer, display the driver file, right click on the filename, click on Properties, and click on the Version tab. Click on the Internal Filename in the lower section. For Windows Server 2003, the filename appears as filename (Server 2003 32-bit) for 32-bit systems and filename (Server 2003 64-bit) for 64-bit systems. The next sections describe these drivers and their installation. ......................................................................... 1.1 Features The SYMMPI.SYS miniport driver supports these features: o Supports 320 Mbytes/s parallel SCSI transfers (for LSI453C1020 and LSI53C1030) o Supports Integrated Mirroring (TM) technology (for LSI453C1020 and LSI53C1030) o Supports PCI and PCI-X bus protocols (for LSI53C1020 and LSI53C1030) o Supports 2Gbaud Fibre Channel transfers (for LSIFC929X, LSIFC929, LSIFC919X, and LSIFC919) o Supports LSI Logic MPT common software interface o Supports multiple host adapters o Supports multiple Logical Unit Numbers (LUNs) o Supports Scatter-Gather o Supports SCSI pass-through functionality o Supports disk array configurations with no LUN 0 o Supports disk array configurations with non-contiguous LUNs o Auto request sense o Maximum block size support: 1 Mbyte (32-bit), 2 Mbyte (64-bit) ......................................................................... 1.2 LSI Logic Devices Supported The SYMMPI.SYS driver is named "LSI Logic Fusion-MPT Miniport Driver." It supports the following devices and their associated host adapters: o LSI53C1020 o LSI53C1030 o LSIFC929X o LSIFC929 o LSIFC919X o LSIFC919 ......................................................................... 1.3 Description The SYMMPI.SYS driver meets the Microsoft specification for miniport drivers. This driver allows connection of parallel SCSI and Fibre Channel devices including disk drives, CD-ROMs, and tape drives for PCI and PCI-X based machines. To support a different SCSI or Fibre Channel device type, the Windows Server 2003 architecture requires that a class driver for that type of device be present (usually supplied by Microsoft, or possibly by the peripheral manufacturer). No changes to SYMMPI.SYS are required. The driver supports only Windows Server 2003 and all subsequent Service Packs. A Windows application passes SCSI commands directly to the parallel SCSI or Fibre Channel Protocol devices by using the SCSI pass-through facility. This facility allows applications to directly control and access devices by filling in a data structure and calling into the port or class driver. Refer to the Microsoft Windows Server 2003 documentation for more details. ............................................................................ 2.0 Installing the SYMMPI.SYS Driver This procedure installs the SYMMPI.SYS driver onto a new or existing Windows Server 2003 system. Depending upon the media used to distribute LSI Logic drivers (web or CD-ROM), you will create a driver diskette. Copy the files listed in this section to the root directory of a clean diskette as shown below. Label this diskette "Windows Server 2003 Driver Diskette". You will use this diskette during the installation process. \txtsetup.oem \symmpi.tag \32_bit\mpi2k332.cat \32_bit\symmpi.inf \32_bit\symmpi.sys \64_bit\mpi2k364.cat \64_bit\symmpi.inf \64_bit\symmpi.sys ............................................................................ 2.1 New System Installation This procedure installs the SYMMPI.SYS driver onto a Windows Server 2003 system. Use this procedure when installing Windows Server 2003 onto an unused drive. Windows Server 2003 automatically adds the driver to the registry and copies the driver to the appropriate directory. The method for installing Windows Server 2003 on a new system involves using a CD-ROM. Installation using boot floppy diskettes is not supported by Windows Server 2003. ............................................................................ 2.1.1 CD-ROM Installation 1. Start the Windows Server 2003 installation by booting from the Windows Server 2003 CD-ROM: The system BIOS must support booting from a CD-ROM. BIOS settings may need to be changed to allow CD-ROM booting. 2. Press the F6 key to install the SYMMPI.SYS driver when the screen displays "Windows Setup". This must be done or else the new driver will not be recognized. Note: Current Windows Server 2003 drivers can be downloaded from the LSI Logic web site at http://www.lsilogic.com/support. After you are connected to this web site, click on "Downloads". Next, click on "Download Center". Select the product category, then the appropriate product. A bullet in the Drivers section will display all driver packages associated with the product selection. 3. Choose S to specify an additional device when the screen displays "Setup could not determine the type of one or more mass storage devices...". NOTE: If this screen is not displayed as the first user input, then pressing the F6 key was not seen by the setup program. Reboot the system and try again. The system prompts for the manufacturer-supplied hardware support disk. 4. Insert the appropriate driver diskette containing the Windows Server 2003 driver required to support your LSI Logic adapter(s) and press Enter. Note: Current Windows Server 2003 drivers can be downloaded from the LSI Logic web site at http://www.lsilogic.com/support. After you are connected to this web site, click on "Downloads". Next, click on "Download Center". Select the product category, then the appropriate product. A bullet in the Drivers section will display all driver packages associated with the product selection. 5. The screen will display a list of two drivers to select from: "LSI Logic PCI SCSI/FC MPI Driver (Server 2003 32-bit)" "LSI Logic PCI SCSI/FC MPI Driver (Server 2003 64-bit)" Select the driver which matches the processor architecture of the system (32-bit or 64-bit). Press Enter to proceed. Return to the Windows Server 2003 Setup screen. 6. Press Enter to proceed. The message about setup loading files appears. 7. Follow the Microsoft Windows Server 2003 installation procedure at this point. ............................................................................ 2.2 Existing System Installation This procedure installs or upgrades the SYMMPI.SYS drivers onto an existing Windows Server 2003 system. NOTE: When a LSI Logic SCSI or Fibre Channel adapter is added to an existing system installation, the new adapter is automatically detected at the next reboot. When the Device Driver Wizard appears at boot, click on the Next button and continue at step 8 below. 1. Boot Windows Server 2003 and logon as a user that has Administrator privileges. 2. Click on the Start button, then right-click on the My Computer entry in the menu. 3. Click on the Properties selection. 4. Click on the Hardware tab, and then the Device Manager button. 5. Click the "+" to the left of the SCSI and RAID controllers line. Find the adapter desired for the driver upgrade and double-click the entry. Click on the Driver tab. 6. Information on the currently installed driver is displayed, and additional driver details can be viewed by clicking the "Driver Details" button. 7. Click on the "Update Driver" button to update the existing driver. The Hardware Update Wizard begins. 8. Click on the "Install from a list or specific location..." button to select it, then click on the Next button. 9. Click on the "Don't search, I will choose the driver to install." button to select it, then click on the Next button. 10. Click on the "Have Disk" button and type the path to the driver, or click on the Browse button. Drivers for 32-bit systems will be in the "32_bit" directory and drivers for 64-bit systems will be in the 64-bit directory. After the path to the driver has been established, click the OK button. 11. Select the driver from the list and click on the Next button. 12. Click on the Next button again to start the driver update. In some cases, a message will display saying that this driver has not passed logo testing. This message informs you that a nonsigned driver is being installed. Note: Drivers are digitally signed by the Microsoft Windows Hardware Quality Lab (WHQL) on completion of logo testing. Due to the time lag between the general customer release by LSI of Windows drivers and the completion of WHQL logo testing, some drivers distributed with adapters or downloaded from the www.lsilogic.com web site may not be digitally signed. 13. Click STOP Installation to cancel the installation if a nonsigned driver is not desired. or Click Continue Anyway to continue the installation. The system will load the driver from the Windows Server 2003 driver diskette. A message box may display indicating that the target (existing) driver is newer than the source (upgrade) driver. 14. Click No to cancel the driver upgrade at this point. or Click Yes to continue the installation. The system copies the driver to the system disk. For any adapter other than the boot adapter, the updated driver will become active immediately. For the boot adapter, a message box displays indicating that you must reboot your system for the new driver to take effect. 15. Click on the Finish button to complete the driver upgrade. ............................................................................ 2.3 Performance Tuning for Windows Server 2003 Windows Server 2003 has registry entries that can be used to tune the performance of SCSI I/O for certain configurations. The tunable parameters are large transfer block size support and a guaranteed number of concurrent I/Os for a particular SCSI bus. ............................................................................ 2.3.1 Large Block Size Support The SYMMPI.SYS drivers can support up to a 1 Mbyte transfer size (for 32-bit systems) and 2 Mbyte transfer size (for 64-bit systems) in Windows Server 2003; however, the default Windows Server 2003 transfer size is 64 Kbytes. To enable better performance, the driver installation process adds a registry entry to enable a maximum 256 Kbytes transfer size (512 KBytes for 64-bit). Also, the mpi_256K.reg file can be used to set or re-enable a 256 Kbytes maximum, but it can be edited to set other desired maximum transfer sizes. There are two methods to add this registry setting. 1. Locate the mpi_256K.reg data file (supplied with the driver files) using Windows Explorer and double-click on the file. -OR- 2. Type at the command prompt: regedit mpi_256K.reg This inserts an entry in the registry to enable 256 Kbytes block size support (512 Kbytes for 64-bit). Editing the mpi_256K.reg can set any maximum block size between 64 Kbytes and 1 Mbyte (2Mbytes for 64-bit). The formula to calculate the proper value for MaximumSGList is: MaximumSGList = ((Maximum Block Size)/4 Kbytes) +1 (for 32-bit) MaximumSGList = ((Maximum Block Size)/8 Kbytes) +1 (for 64-bit) For 256 Kbytes: 256 Kbytes/4 Kbytes = 64. Add 1 for 65 (decimal) or 0x41 (hexadecimal). The maximum value allowed for MaximumSGLIst is 255 or 0xFF. For the particular value of 0xFF, the internal value passed to Windows is increased to 0x101, allowing support for a full 1 Mbyte transfer (2 Mbytes for 64-bit). Be sure to read the information in the mpi_256K.reg data file before editing it. The system must be rebooted for the new registry setting to be effective. To reset the maximum block size to the default of 64 Kbytes, follow the instructions above, except use mpidfblk.reg as the data file. ............................................................................ 2.3.2 Maximum Number of Concurrent I/Os (Guaranteed) Windows Server 2003 guarantees a maximum of 32 concurrent I/Os active on a particular SCSI bus. However, due to the method of memory allocation, the actual limit of concurrent I/Os can vary greatly between various drivers or versions of drivers. This can have a huge impact on performance benchmarking between different driver versions or adapter vendors. In effect, one adapter may actually be able to have 70 or 80 I/Os outstanding, while another adapter could only have 32. This can also affect systems with high performance storage subsystems, such as disk arrays. In order to enable better performance, the driver installation process adds a registry entry to support 128 concurrent I/Os. If a different maximum value is desired, the file mpi100io.reg can be used to add a registry entry to guarantee the desired number of concurrent I/Os. There are two methods to add this registry setting. One is to locate the mpi100io.reg data file (supplied with the driver files) using Windows Explorer and double click on the file. The other method is to type at the command prompt: regedit mpi100io.reg This inserts an entry in the registry to guarantee a maximum of 100 concurrent I/Os per adapter. If a maximum other than 100 is desired, the mpi100io.reg can be edited; however, setting this value to a high number uses increasing amounts of non-paged pool memory, a critical Windows resource. High values for this setting can degrade system performance. Be sure to read the information in the mpi100io.reg data file before editing it. The system must be rebooted for the new registry setting to be effective. To reset the guaranteed number of concurrent I/Os to the default of 32, follow the instructions above, except use mpidefio.reg as the data file. ............................................................................ 2.3.3 Miniport Driver Configuration Options The SYMMPI driver is configured by default to provide optimum performance in most standard systems. Some non-standard systems may require fine tuning to obtain peak system memory utilization and performance. After installation, if less than advertised functionality and performance is observed on any platform, please contact LSI Logic support. Go to the LSI Logic Technical Support Home Page, which is located at: http://www.lsilogic.com/support/index.html and call the listed number for assistance. LSI Logic can provide additional registry settings if required, to customize the driver for specific systems and applications. ............................................................................ 3.0 Troubleshooting The SYMMPI.SYS driver will log error messages to the system error log. For these errors, the system errorlog EventID will be 11, and the specific error code values will be displayed at offset 0x10. Data should be displayed in Appendix A: Package Specific Installation Instruction This update is packaged as a self-extracting PackageForTheWeb (PFTW) executable file. To use this update your TEMP environment variable must be set to a path with read/write access. You must be logged in as an administrator. The command-line syntax for PackageForTheWeb executable device driver update package is: Package.exe [-s] [-a [-s] | [-x directory] | [-?] ] [-s] This command installs an update silently and does not notify you if your files need to be over written in the %temp% directory. [-a] This command passes all subsequent commands to the install package. [-s] This second -s command installs the update silently and unattended. [-x directory] This command extracts the update files to a directory named directory. The PackageForTheWeb executable extracts itself to subdirectory in the %TEMP% directory. Extracted directories will be relative to that location. Typically you must specify an absolute directory. [-?] This command displays information about the command line switches. The command line swithces -a and -x are unattended. Other command line options such as display help (-?) might require that you to hit any key to continue. If Windows packages are run without any command line options, a GUI is displayed. This GUI offers all of the options that are available using the command line.