Part Number Hot Search : 
2SD2524 920S4 1023J0 NTE8118 ST72T TRLPB ROV10 IRG7PH
Product Description
Full Text Search
 

To Download FUSION-MPT Datasheet File

  If you can't view the Datasheet, Please click here to try to view without PDF Reader .  
 
 


  Datasheet File OCR Text:
  FUSION-MPT device management user? guide august 2002 version 1.2
ii version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. this document contains proprietary information of lsi logic corporation. the information contained herein is not to be used by or disclosed to third parties without the express written permission of an of?er of lsi logic corporation. lsi logic products are not intended for use in life-support appliances, devices, or systems. use of any lsi logic product in such applications without written consent of the appropriate lsi logic of?er is prohibited. document db15-000186-01, second edition this document describes version 1.2 of lsi logic corporations FUSION-MPT device management product and will remain the of?ial reference source for all revisions/releases of this product until rescinded by an update. lsi logic corporation reserves the right to make changes to any products herein at any time without notice. lsi logic does not assume any responsibility or liability arising out of the application or use of any product described herein, except as expressly agreed to in writing by lsi logic; nor does the purchase or use of a product from lsi logic convey a license under any patent rights, copyrights, trademark rights, or any other of the intellectual property rights of lsi logic or third parties. copyright 2002 by lsi logic corporation. all rights reserved. trademark acknowledgment lsi logic, the lsi logic logo design, FUSION-MPT, gigablaze, integrated mirroring, lvdlink, metastor, and surelink are trademarks or registered trademarks of lsi logic corporation. arm is a registered trademark of arm ltd., used under license. all other brand and product names may be trademarks of their respective companies. ap to receive product literature, visit us at http://www.lsilogic.com. for a current list of our distributors, sales of?es, and design resource centers, view our web page located at http://www.lsilogic.com/contacts/na_salesof?es.html
FUSION-MPT device management users guide iii version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. preface this book is the primary reference for using the FUSION-MPT (message processing technology) ?mware and device drivers. this users guide is intended to explain how to install and con?ure the FUSION-MPT product, which encompasses FUSION-MPT ?mware architecture, scsi hardware architecture, fibre channel (fc) hardware architecture, and the operating system level device drivers that support these architectures. audience this book assumes you have some familiarity with microprocessors and related support devices. the people who bene? from this book are: ? oem customers ? end users organization this document has the following chapters: ? chapter 1, FUSION-MPT device management product , provides general information about the FUSION-MPT device management product. ? chapter 2, flash and nvdata utilities for scsi devices , provides information on the flash and nvdata utilities. ? chapter 3, scsi bios and con?uration utility , describes the FUSION-MPT scsi bios and con?uration utility (cu) for 32-bit systems. ? chapter 4, scsi efi and con?uration utility , describes the FUSION-MPT efi and cu for 64-bit systems.
iv preface version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ? chapter 5, fibre channel firmware and con?uration utility , provides information about the flash con?uration utility for installing the fibre channel ?mware. ? chapter 6, fibre channel bios , provides installation instructions for the fibre channel bios. ? chapter 7, windows driver installations , provides instructions for installing the FUSION-MPT device driver onto window-based system. it provides detailed instructions for windows 98, windows me, window xp, windows nt 4.0, windows 2000, and windows.net. ? chapter 8, unix operating system device drivers , provides instructions for installing the FUSION-MPT device driver into unix-based operating system. it includes detailed instructions for sparc 8, solaris, openunix, unixware, sco unix, and linux. ? chapter 9, linux integrated mirroring con?uration utility , describes the linux integrated mirroring (im) con?uration utility (limcu). ? chapter 10, cim solution , provides information on the common information model (cim) solution for monitoring systems. related publications lsi53c1030 multifunction dual channel ultra320 scsi to pci-x controller technical manual , document no. db14-000156-03 lsi53c1020 single channel ultra320 scsi to pci-x controller technical manual , document no. db14-000176-02 lsi53c320 ultra320 scsi bus expander technical manual , document no. db14-000163-01 lsifc929 dual channel fibre channel i/o processor technical manual, document number db14-000135-02 lsifc919 single channel fibre channel i/o processor technical manual, document no. db14-000151-01 lsifc909 fibre channel i/o processor technical manual, document no. db14-000150-01
preface v version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ultra320 scsi to pci-x host board adapter users guide , document no. db15-000192-00 2 gbits/s fibre channel to pci host adapters users guide , document no. db15-00182-01 conventions used in this manual hexadecimal numbers are indicated by the pre? ?x ?or example, 0x32cf. binary numbers are indicated by the pre? ?b ?or example, 0b0011.0010.1100.1111. acronyms are speci?d with capital letters. revision history revision date remarks version 1.2 6/2002 added the scsi flash and nvdata utilities chapter. added the cim solution chapter. added the linux im cu chapter. combined the unix oses into a single chapter. combined the windows oses into a single chapter. added the linux and linux cu. added the scsi efi and con?uration utility chapter. updated the fibre channel bios chapters. updated scsi cu and bios. expanded the related publications list. updated the front matter to correspond with the current template. reapplied templates with updated variables for version 1.2. preliminary version 1.0 8/2001 initial release of document.
vi preface version 1.2 copyright 2002 by lsi logic corporation. all rights reserved.
FUSION-MPT device management users guide 1-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 1 FUSION-MPT device management product this chapter provides general information about the FUSION-MPT device management technology. this chapter contains the following sections: ? section 1.1, ?usion-mpt firmware, bios, and device drivers ? section 1.2, ?verview ? section 1.3, ?escription 1.1 FUSION-MPT firmware, bios, and device drivers lsi logic provides a common device-level interface for FUSION-MPT compatible devices, which use a single, binary device driver for both scsi and fibre channel (fc) devices. the supported lsi logic devices are the lsi53c1030, lsi53c1020, lsifc929, lsifc919, lsifc909 controllers and their supported host adapters. this set of controllers represents the lsi logic common architecture. this guide documents how to install the FUSION-MPT ?mware, bios, and device drivers.
1-2 FUSION-MPT device management product version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 1.2 overview the FUSION-MPT architecture bases its architecture on industry standard arm processor technology and supports ultra320 scsi and fc protocols. FUSION-MPT architecture encompasses the lsi logic ?mware architecture, the lsi logic scsi and fc hardware architecture, and the operating system device drivers. FUSION-MPT technology supports the intel 32-bit and 64-bit architecture and provides 64-bit pci/pci-x interfaces for high host side performance. FUSION-MPT technology is readily extensible across different physical interfaces, such as scsi and fc, as well as emerging technologies such as in?iband and serial ata. the FUSION-MPT technology provides the highest performance i/o architecture available by encapsulating all the information necessary for i/o controllers to autonomously complete an i/o. additional bene?s include reduced host cpu utilization and a decreased number of host interrupts per i/o to streamline i/o transactions. it also provides host software binary compatibility between the lsi logic fc, ultra320 scsi products, and future interface controller products.
description 1-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 1.3 description the FUSION-MPT design supports a single binary device driver, intelligent ?mware, and various hardware cores. 1.3.1 single binary device driver FUSION-MPT technology uses a single, binary, operating system device driver to support both fc and scsi. this technology provides common drivers for windows nt 4.0, windows 2000, windows millennium, windows 98, solaris, unixware, open unix, and linux operating systems, thus reducing system integration and certi?ation effort. lsi logic uses the same device driver ?ename ( symmpi.sys )for different windows operating systems. the driver ?es are packaged either in separate subdirectories based on the windows operating system or on different driver diskettes. you can also download current drivers from the lsi logic web site at http://www.lsilogic.com . 1.3.2 FUSION-MPT firmware the FUSION-MPT ?mware presents a multiprotocol service layer. the ?mware isolates the host drivers from the hardware and provides a high-level message passing interface (mpi) to the host drivers. the ?mware manages all phases of an i/o request and optimizes interrupt management for the system. for fc systems, the ?mware also manages all fc-2 through fc-4 services, which minimizes the amount of fc-unique services required with the host driver. 1.3.3 FUSION-MPT hardware the FUSION-MPT hardware encapsulates various technologies that deliver new levels of performance. FUSION-MPT fc products utilize gigablaze transceivers and amba bus architecture. FUSION-MPT scsi products utilize lvdlink transceivers, surelink domain validation, and an ahb bus architecture. furthermore, the FUSION-MPT interface isolates the hardware from the host, making hardware upgrades transparent to the host.
1-4 FUSION-MPT device management product version 1.2 copyright 2002 by lsi logic corporation. all rights reserved.
FUSION-MPT device management users guide 2-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 2 flash and nvdata utilities for scsi devices this chapter explains the ?sh utility and the nvdata utility. this chapter contains the following sections: ? section 2.1, ?lash utility ? section 2.2, ?vdata utility 2.1 flash utility this section provides information about the dos-based lsi logic ?sh utility, which downloads ?mware and bios images to boards using the lsi53c1030 or lsi53c1020. the ?sh utility: ? supports host adapter selection for updating the flash rom. ? provides a means to identify the ?mware or bios image version on the adapter or residing in a ?e. ? provides for complete flash rom erasure. ? provides the means to modify ascii banner information in a bios image prior to downloading to an adapter or for writing back to a ?e. ? supports command line execution. this utility allows the user to update the FUSION-MPT firmware and/or scsi bios. the board must have an on-board flash rom to use this utility.
2-2 flash and nvdata utilities for scsi devices version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 2.1.1 running the flash utility the utilitys executable is flsh1030.exe. it requires the dos extender, dos4gw.exe. lsi logic strongly recommends placing both ?es on a dos bootable diskette and running the utility from this diskette. you can run the ?sh utility from a hard drive. however, the hard drive cannot connect with a board that you intend to update, and the dos4gw extender must reside in the same directory as the ?sh utility. to run the ?sh utility: step 1. insert the ?sh utility diskette into the a: drive. step 2. boot the system to the a:\> prompt. step 3. type flsh1030 and press enter. the utility starts and displays its main menu. 2.1.2 menu options the main menu allows the user to select the scsi device that performs the selected tasks. the utility displays two entries for dual channel. only one of the paths must be chosen; the utility re?cts the data to the second scsi channel. the main menu screen appears as: choice vendor id device id bus device ------- ------- ------- ------- ------- 1 0x1000 0x0030 0x3 0x10 lsi logic, inc. lsi53c1030 ultra320 scsi 2 0x1000 0x0030 0x3 0x11 lsi logic, inc. lsi53c1030 ultra320 scsi 3 refresh which pci chip (0 to quit)?
flash utility 2-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. after you select a chip, the utility displays another menu list: a identify the identify option displays the version number of the ?mware or bios on the selected adapter. if multiple bios images are present, this option returns the version of the FUSION-MPT bios. this option can also provide the version number of the ?mware and bios image ?es. to do so, input the ?ename of the image to check. b download flash the download flash option provides the user with choices for downloading images to the flash rom. downloading of the ?mware and bios images are separate choices and require the corresponding image ?e name as an input. this utility supports FUSION-MPT bios download ?es that contain multiple images concatenated together. to enable a streamlined process when downloading identical ?mware and bios images, you can use a complete image as the input ?e for a ?mware download. this utility enables you to alter the ascii banner string in the bios image. you can do this prior to downloading to the adapter, or you can write the altered image to a ?e. the utility prompts the user for the new banner contents and informs the user of the maximum allowable length. after the banner has been altered in an image, that image cannot be the input for this operation. flash a - identify b - download flash c - upload current flash to a file d - erase flash misc. z - select pci chip q - quit
2-4 flash and nvdata utilities for scsi devices version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. c upload current flash to a file the upload option uploads the flash rom contents and writes them to a user-speci?d ?e. this image contains the ?mware image, bios image, and any unused areas of the flash rom. this utility cannot separate the ?mware and bios images. the image size is 512 kbytes. truncated upload images can result if the destination disk is not large enough to hold the entire upload image. d erase flash the erase option erases the flash rom on the selected adapter. 2.1.3 command line options the ?sh utility supports the following command line options: -/a update all boards this option causes the ?sh utility to update the images on all the boards with the images that the /b or /f options specify. this option causes the utility to ignore the /d option, if it is entered. -/b:?ename download bios image this option causes the ?sh utility to download the bios image given by lename. the ?sh utility ignores this option if the user omits the ?ename. -/c:?ename concatenate bios images this option must precede the /b option. this option causes the ?sh utility to concatenate the image speci?d by lename with the image speci?d by the /b option. the concatenation occurs before the utility downloads the resulting image. the utility ignores this option if the user omits the ?ename. -/d select chip this option enables the user to select the current chip from a menu. the utility uses the selection to process the command line arguments that follow this command. -/e erase flash rom this option causes the flash utility to erase the flash rom.
flash utility 2-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. -/f:?ename download firmware image this option causes the ?sh utility to download the ?mware image given by lename. the utility ignores this option if the user omits the ?ename. -/m multiple flash images this option indicates that the bios image speci?d by the /b option contains multiple images. this option must precede the /b option. do not use this option in combination with the /c option. -/o:?ename redirect bios image output this option causes the flash utility to redirect the modified bios image to a file. the utility modifies fields in a new bios image to reflect the chip type. if the user specifies the /o and /b options, the utility modifies the image that the /b option specifies for the chip type and then writes the modified image to the file that the /o option specifies. the utility does not download the image to the board. the utility ignores this option if the user omits the filename or enters the /a option. this option must precede the /b option. -/? help this options causes the ?sh utility to display the help screen.
2-6 flash and nvdata utilities for scsi devices version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 2.2 nvdata utility this section describes the nvdata.exe utility, version 1.01.00. the nvdata utility allows the user to test and write default nvdata to the serial eeprom on FUSION-MPT scsi devices. the nvdata utility enables each serial eeprom to support up to four adapters. because dual channel adapters share a single serial eeprom, a dual channel adapter is considered a single adapter for the purposes of the nvdata utility. 2.2.1 command line usage syntax you can use the nvdata utility interactively or with command line options. the command line usage is: nvdata [/?] [/upld] [/conv] [/ci] [filename(s)] a .img ?e is a serial eeprom binary image, which is typically 2 kbytes in length. a .dat ?e is an nvdata ascii text ?e, which is typically greater than 20 kbytes in length. table 2.1 describes the command line options for the nvdata utility. table 2.1 nvdata command line options option description /? this option prints help information. /upld this option uploads the serial eeprom .img ?e from all adapters. /conv this option converts an nvdata data ?e to an ?mg ?e. the nvdata ?e is speci?d as ?ename.dat. the .img ?es is speci?d as ?ename.img. /ci this option concatenates the nvdata image ?e to the ?mware image and creates a new image ?e. you must specify three ?enames after /ci. file1 is the ?mware image ?e. file2 is the nvdata image ?e. file3 is the ?al concatenated image ?e. filename this ?ename speci?s the .img or .dat ?e. if you only specify the ?ename, the utility downloads the .dat or .img ?e to the serial eeprom.
nvdata utility 2-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 2.2.2 command line examples this section provides examples of command usage. 2.2.2.1 downloading a .dat ?e to the serial eeprom to perform this operation, type: nvdata filename.dat this command causes the nvdata utility to run a pattern test on the serial eeprom that tests its functionality. the utility reads, parses, and converts the input ?e to the correct image format and writes it to the serial eeprom. the utility then saves the serial eeprom image to a ?e named image?.img, where ? is the adapter number and can be either 1, 2, 3, or 4. the command generates a log ?e, log.txt, that indicates whether the update passed or failed. this test uses default data from filename.dat and calculates the necessary sizes, lengths, page versions, bytes, and checksums. you can skip the pattern test by placing /notest in the command line. 2.2.2.2 downloading a .img ?e to the serial eeprom to perform this operation, type: nvdata filename.img this command causes the nvdata utility to read the serial eeprom binary image from filename.img and to write the data to the serial eeprom. this command generates a log ?e, log.txt, that indicates whether the update passed or failed. 2.2.2.3 uploading .img ?e(s) from the serial eeprom to perform this operation, type: nvdata /upld this command causes the nvdata utility to read the serial eeprom binary image from each adapter and to save it to a ?e named image?.img, where ? is the adapter number and can be either 1, 2, 3, or 4.
2-8 flash and nvdata utilities for scsi devices version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 2.2.2.4 converting a .dat ?e to a .img ?e to perform this operation, type: nvdata /conv filename.dat filename.img this command causes the nvdata utility to convert a .dat ?e to a serial eeprom binary .img ?e. the utility uses the default data from filename.dat and calculates the necessary sizes, lengths, page versions, bytes and checksums to create filename.img. 2.2.2.5 concatenating images to perform this operation, type: nvdata /ci file1 file2 file3 this command causes the nvdata utility to concatenate the nvdata image ?e to the ?mware image and then to create a new concatenated image ?e. file1 is the ?mware image ?e. file2 is the nvdata image ?e. file3 is the ?al concatenated image ?e. 2.2.2.6 running in interactive mode this command is for advanced users. the command line usage for this command is: nvdata this command causes the utility to display a list of host bus adapters (hbas) that the nvdata utility found. after you select an adapter, the utility displays a menu of action options. the options are as follows: 1. erase serial eeprom memory (0x..) this option writes 0s to the serial eeprom from the speci?d address to the end of the serial eeprom. 2. serial eeprom memory pattern test (0x..) the option tests the serial eeprom by writing and reading a prede?ed pattern to and from the serial eeprom. 3. serial eeprom memory boundary test (0x..)
nvdata utility 2-9 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. this option performs a boundary test on the serial eeprom by reading and writing random data in an incrementing pattern. be aware that this test takes a long time. 4. display raw nvdata this option displays the raw data in the serial eeprom. 5. display formatted manufacturing settings this option displays the autodownload data, pci con?uration data, and option rom offsets. 6. display fw variables this option displays ?mware speci? data. 7. display formatted nvdata header this option displays the formatted master data header. 8. display formatted nvdata page data this option displays menus to select the desired con?uration pages. it then displays the selected con?uration pages. 9. save nvdata to a binary ?e this option saves the current serial eeprom content to a binary ?e. 2.2.3 creating custom input files the .dat ?e is an ascii text ?e that contains the default nvdata information that is stored in the serial eeprom. the .dat ?es follow a de?ed format that coincides with the FUSION-MPT data structures. any deviation from this format causes the nvdata utility to fail. to create a custom input ?e, edit the provided .dat ?e. you can modify the several data ?lds within the .dat ?e. the modi?ble data ?lds are any data ?lds other than: ? checksums ? ioc number ? pageversion ? pagelength ? pagenumber ? pagetype (except for manufacturing pages 0?)
2-10 flash and nvdata utilities for scsi devices version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ? total bytes of nvdata ? nvdataversion ? mpiversion the nvdata utility calculates these data items. the nvdata utility reads all other data items directly from the .dat ?e. note that you can modify the pagetype ?ld for manufacturing page 0 through manufacturing page 4. the data entry ?lds are in the form: field=data where field is the name of the data structure ?ld and data is the field value. for example: chip_name=?1030?device_id=30 use hexadecimal numbers for numerical data. enclose strings by double quotes. precede comments with a semicolon. note that vpd data is not supported.
FUSION-MPT device management users guide 3-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 3 scsi bios and con?uration utility this chapter presents general information about the FUSION-MPT scsi basic input/output system (bios) and con?uration utility (cu), version 5.02.00, for 32-bit systems. this chapter contains the following sections: ? section 3.1, ?verview and features ? section 3.2, ?nitialization ? section 3.3, ?tarting the scsi bios con?uration utility ? section 3.4, ?sing the scsi cu 3.1 overview and features a scsi bios is the bootable rom code that manages scsi hardware resources. the FUSION-MPT scsi bios integrates with a standard system bios to extend the standard disk service routine that is provided through int13h. during the boot time initialization, the scsi bios determines if the system bios has already installed other hard disks, such as an ide drive. if so, the scsi bios maps any scsi drives it ?ds behind the already-installed drive(s). otherwise, the scsi bios installs drives starting with the system boot drive and the system boots from a drive controlled by the scsi bios. the FUSION-MPT bios supports the bios boot speci?ation (bbs). the FUSION-MPT scsi bios: ? supports the lsi53c1030 and lsi53c1020 ultra320 scsi devices ? supports con?uration of up to 256 adapters ? provides int13 bootrom support for up to four adapters ? supports surelink domain validation
3-2 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 3.2 initialization this section describes the bbs initialization and cd-rom initialization procedures. 3.2.1 boot initialization with bbs the FUSION-MPT scsi bios provides support for the bbs, which enables selection of the boot device. if the system supports the bbs, use the system bios setup menu to select the boot and drive order. 3.2.2 cd-rom boot initialization the FUSION-MPT scsi bios supports boot initialization from a cd-rom drive. the ?e types of emulation are: ? no emulation disk ? floppy 1.2 mbyte emulation disk ? floppy 1.44 mbyte emulation disk ? floppy 2.88 mbyte emulation disk ? hard disk emulation the type of emulation assigns the drive letter for the cd-rom. for example, if a 1.44 mbyte ?ppy emulation cd is loaded, the cd-rom drive becomes the a: drive and the existing ?ppy becomes drive b:. 3.3 starting the scsi bios con?uration utility the FUSION-MPT scsi bios and cu allow you to change the default con?uration of the scsi host adapters. you can change the default values to resolve con?cts between device settings or to optimize system performance. during boot, the system displays the version number of the scsi bios. if the cu is installed, the system displays the message: press ctrl-c to start lsi logic configuration utility... this message remains on the screen for about 5 seconds. after pressing ctrl-c , the message changes to:
using the scsi cu 3-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. please wait, invoking lsi logic configuration utility... the system displays the main menu of the FUSION-MPT scsi bios cu. the system might display the following messages during the boot process: ? adapter removed from boot order, parameters will be updated accordingly appears if an adapter is removed from the system or relocated behind a pci bridge. ? configuration data invalid, saving default configuration! appears if the nonvolatile (nvram) information is invalid. ? adapter configuration may have changed, reconfiguration is suggested! appears if less than four adapters are in the boot order and more adapters exist than are shown. pressing ctrl-e or ctrl-a after memory initialization during reboot allows you to re-enable and recon?ure devices. note: the FUSION-MPT bios cannot control all the devices the the cu detects. devices such as tape drives and scanners require a device driver that is speci? to the peripheral. the scsi bios cu allows parameter modi?ation to support these devices. 3.4 using the scsi cu this section describes the scsi bios cu. the options in the scsi cu depend upon which bios and ?mware you have installed. you could have installed either the standard scsi bios and its associated ?mware, or the im-enabled scsi bios and its associated ?mware. all of the scsi bios cu screens follow fixed field areas. the header area provides static information text, which is typically the product title and version. the menu area provides the current menu and uses a cursor for menu item selection. the footer area provides general help information.
3-4 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 3.4.1 user input table 3.1 summarizes the possible user inputs. 3.4.2 main menu when invoked, the cu ?st displays the main menu, which contains a scrolling list of up to 256 lsi logic pci to scsi host adapters and information about each of them. use the arrow keys to select an adapter. press enter to view and modify the properties of the selected adapter, and to gain access to the attached devices. the cu can only access adapters with lsi logic control enabled. after selecting an adapter and pressing enter, the cu scans the adapters scsi bus and then displays the adapter properties screen. the main menu contains two selections: boot adapter list and global properties. the boot adapter list allows selection and ordering of boot adapters. the global properties allows changes to global settings. figure 3.1 shows the main menu for the standard scsi bios. figure 3.2 shows the main menu for the im-enabled scsi bios. table 3.1 user input key de?ition description f1 help context sensitive help for the cursor-resident ?ld. f2 menu sets cursor context to the menu selection area. select a menu item and press enter. arrow keys select item use these keys to position the cursor. home/end +/- change item the items with values in ? ] brackets are modi?ble. use the numeric keypad ? and ? to change a modi?ble ?ld to its next relative value. esc abort/exit escape stops the current context operation and exits the current screen. enter execute item items with values in ? > brackets are executable. press enter to execute the function of the selected ?ld.
using the scsi cu 3-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 3.1 main menu for the mptps.rom bios figure 3.2 main menu for the mptpsim.rom bios table 3.2 describes the main menu ?ld for both the mptps.rom bios and the mptpsim.rom bios. lsi logic mpt scsi setup utility version mpt -x.xx lsi logic host bus adapters adapter pci bus dev/ func port number irq nvm boot order lsi logic control e400 10 --- 0 enabled e000 12 yes 1 enabled f800 9 yes 2 enabled e800 11 yes 3 enabled lsi logic mpt scsi setup utility version mpt -x.xx lsi logic host bus adapters adapter pci bus dev/ func port number irq nvm boot order lsi logic control mirror status e400 10 --- 0 enabled optimal e000 12 yes 1 enabled --- f800 9 yes 2 enabled --- e800 11 yes 3 enabled ---
3-6 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 3.4.3 boot adapter list menu the boot adapter list menu speci?s the adapter boot order when more than one os adapter is present. the cu can designate up to four adapters as bootable. to access the boot adapter menu, select on the main menu and press enter. the cu then displays the boot adapter list menu. to add an adapter to the boot list, press insert while on the boot adapter list. this locates the cursor on the adapter select list. use the arrow keys to select an adapter and press enter to add it to the end of boot adapter list. to remove an adapter from the boot list, select the adapter and press delete. select the adapter and press the ? key to decrease the adapters relative order in the boot list, or press the ? key to increase table 3.2 main menu field description field description adapter indicates the speci? family of lsi logic host adapters. pci bus indicates the pci bus number assigned by the system bios to an adapter. the pci bus number can be between 0x00 and 0xff. dev/func indicates the pci device and pci function assigned by the system bios to an adapter. bits [2:0] of this 8-bit value designate the pci function. bits [7:3] designate the pci device. port number indicates the i/o port number that communicates with an adapter. the system bios assigns this number. irq indicates the interrupt request line for the adapter. the system bios assigns this value. nvm indicates whether an adapter has nonvolatile memory. the possible values are ye s o r n o . boot order indicates the relative boot order of an adapter. the bios traverses up to four adapters in the speci?d order in search of bootable media. the possible values are 0, 1, 2, or 3. the boot adapter list menu modi?s this item. lsi logic control indicates whether an adapter is eligible for lsi logic software control or is reserved for control by non-lsi logic software. mirror status this ?ld indicates the status of the integrated mirroring volume if one exists. the possible values are nothing (?---? if no mirrored volume exists, optimal, degraded, disabled, quiesced, resynching, or failed.
using the scsi cu 3-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. the adapters relative order in the boot list. figure 3.3 shows the boot adapter list menu for both the standard scsi bios and the im-enabled scsi bios. figure 3.3 boot adapter list menu table 3.3 describes the ?lds in the boot adapter menu. lsi logic mpt scsi setup utility version mpt -x.xx boot adapter list insert=add an adapter delete=remove an adapter adapter pci bus dev/ fun boot order current status next boot [0] on [on] [1] on [on] [2] on [on] [3] on [on] press insert to select an adapter from this list: table 3.3 boot adapter menu field descriptions field description adapter indicates the speci? family of lsi logic host adapters. pci bus indicates the pci bus number assigned by the system bios to an adapter. the pci bus number can be between 0x00 and 0xff. dev/func indicates the pci device and pci function assigned by the system bios to an adapter. bits [2:0] of this 8-bit value designate the pci function. bits [7:3] designate the pci device.
3-8 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 3.4.4 global properties the global properties menu allows con?uration of the display and video modes, as well as a pause if the cu displays an alert message. to access the global properties menu, select ?global properties> on the main menu and press enter. the system then displays the global properties menu. figure 3.4 shows the global properties menu for both the standard scsi bios and the im-enabled scsi bios. figure 3.4 global properties menu boot order speci?s the relative boot order of an adapter. this value of this ?ld can be 0, 1, 2, or 3. press ? to decrease an adapters relative boot order. press ? to increase an adapters relative boot order. current status indicates if an adapter in the boot list was enabled during the most recent boot. the FUSION-MPT scsi bios ignores disabled adapters and their attached devices, but these adapters and devices are visible to the cu. next boot speci?s whether to enable an adapter upon the next boot. table 3.3 boot adapter menu field descriptions field description lsi logic mpt scsi setup utility version mpt -x.xx global properties pause when boot alert displayed [yes] boot information display mode [verbose] negotiate with devices [supported] video mode [color] support interrupt [hook interrupt, the default]
using the scsi cu 3-9 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 3.4 describes the global properties menu ?lds. 3.4.5 adapter properties menu the adapter properties menu allows you to view and modify adapter settings. it also provides access to an adapters device settings. to access the adapter properties menu, select the adapter on the main menu and press enter. the cu then displays the adapter properties menu for the selected adapter. figure 3.5 shows the adapter properties menu for the standard scsi bios. figure 3.6 shows the adapter properties menu for the im-enabled scsi bios. table 3.4 global properties menu field description field description pause when boot alert displayed this option speci?s whether or not the cu pauses for user acknowledgement after displaying an alert message during boot. to continue after displaying a message, specify ?o. to wait for the user to press any key after displaying a message, specify ?es. boot information display mode this option speci?s the information display mode of the bios. it controls how much adapter and device information the system displays during boot. you can set the display mode to either ?erse or ?erbose. specify the terse mode to display the minimum amount of information. specify the verbose mode to display detailed information. negotiate with devices this option sets the default value for synchronous and wide negotiations with speci?d devices. options are: all, none, or supported. video mode this option speci?s the default video mode for the cu. you can set the video mode to either ?olor or ?onochrome. the monochrome setting enhances readability on a monochrome monitor. support interrupt this option allows the ability to stop the system from hanging on int40. pressing enter obtains default settings.
3-10 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 3.5 host adapter properties menu example for the standard scsi bios lsi logic mpt scsi setup utility version mpt -x.xx adapter properties adapter pci bus dev/ func lsi1030 0 60 host scsi id [ 7] scsi bus scan order [low to high (0..max)] removable media support [none] chs mapping [scsi plug and play mapping] spinup delay (secs) [ 2] secondary cluster server [no] termination control [auto]
using the scsi cu 3-11 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 3.6 host adapter properties menu example for the im-enabled scsi bios lsi logic mpt scsi setup utility version mpt -x.xx adapter properties adapter pci bus dev/ func lsi1030 0 60 host scsi id [ 7] scsi bus scan order [low to high (0..max)] removable media support [none] chs mapping [scsi plug and play mapping] spinup delay (secs) [ 2] secondary cluster server [no] termination control [auto]
3-12 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 3.5 describes the adapter properties menu ?lds for both the standard scsi bios and the im-enabled scsi bios. table 3.5 adapter properties menu field description field description press enter to view and modify device properties. press enter to view and modify the mirroring properties. the cu grays-out this ?ld if the integrated mirroring feature is currently unavailable. this could result from using ?mware that does not support the im feature or having an incompatible setup. if a mirrored volume currently exists, press enter to resynchronize the volume. the cu greys-out this ?ld if the current ?mware in use does not support the im feature or if the existing mirrored volume does not need resynchronization. host scsi id this ?ld indicates the scsi identi?r of an adapter. lsi logic recommends setting this ?ld to the highest priority scsi identi?r, which is scsi id 7. scsi bus scan order this ?ld indicates the order in which to scan scsi identi?rs on an adapter. changing this item affects drive letter assignments if more than one device is attached to an adapter and might create a con?ct with an operating system that automatically assigns drive order. removable media support this ?ld speci?s the removable media support option for an adapter. there are three possible settings: none, boot drive only, and with media installed. ?one indicates there is no removable media support, whether the drive is selected as ?st (bbs), or is the ?st in the scan order (non-bbs). ?oot drive only provides removable media support for a removable hard drive if it is ?st in the scan order. ?ith media installed provides removable media regardless of the drive ordering. chs mapping this ?ld de?es the cylinder head sector (chs) values mapping method. chs mapping allows two settings: ?csi plug and play mapping (default value) and ?lternate chs mapping. scsi plug and play mapping automatically determines the most ef?ient and compatible mapping. alternate chs mapping utilizes an alternate method that might be required if a device is moved between adapters from different vendors. these options have no effect after the fdisk command partitions the disk. to change the chs mapping on a partitioned disk, use the fdisk command to delete all partitions and reboot the system to clear the memory. be certain that the correct disk is the target of an fdisk command. spinup delay this ?ld indicates the number of seconds to wait between spin-ups of devices attached to an adapter. staggered spin-ups balance the electrical current load on the system during boot. the default value is 2 seconds, with choices between 1 and 10 seconds.
using the scsi cu 3-13 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 3.4.6 device properties the device properties screen provides viewing and updating of device settings for an adapter. to access the device properties menu, select ?device properties> on the host adapter properties list menu and press enter. changing a setting for the host device changes the setting for all devices. figure 3.7 provides an example of the device properties screen for both the standard scsi bios and the im-enabled scsi bios. secondary cluster server the options for this ?ld are ?es or ?o (default). setting this ?ld to yes indicates that the FUSION-MPT adapter shares devices with another adapter, and prevents the FUSION-MPT scsi bios from issuing scsi bus resets. this is a requirement for the microsoft cluster server. termination control this ?ld indicates if an adapter has automatic termination control. the options for this ?ld are ?uto or ?ff. ?uto indicates that the adapter automatically determines to enable or disable its termination. ?ff indicates that termination at the adapter is off and that other devices at the ends of the scsi bus must terminate the bus. if auto is grayed out, it means that termination is not programmable. restore defaults to obtain default settings, press enter. table 3.5 adapter properties menu field description (cont.) field description
3-14 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 3.7 device properties menu lsi logic mpt scsi setup utility version mpt -x.xx scsi id device identi?r mb/sec mt/sec data width scan id scan luns >0 dis- connect 0 [160] [80] [16] [yes] [yes] [on] 1 [160] [80] [16] [yes] [yes] [on] 2 [160] [80] [16] [yes] [yes] [on] 3 seagate st31055n [160] [80] [16] [yes] [yes] [on] 4 [160] [80] [16] [yes] [yes] [on] 5 [160] [80] [16] [yes] [yes] [on] 6 [160] [80] [16] [yes] [yes] [on] 7 lsi1030 [160] [80] [16] [yes] [yes] [on] 8 [160] [80] [16] [yes] [yes] [on] 9 [160] [80] [16] [yes] [yes] [on] 10 [160] [80] [16] [yes] [yes] [on] 11 [160] [80] [16] [yes] [yes] [on] 12 [160] [80] [16] [yes] [yes] [on] 13 [160] [80] [16] [yes] [yes] [on] 14 [160] [80] [16] [yes] [yes] [on] 15 [160] [80] [16] [yes] [yes] [on] << scroll indicator >>
using the scsi cu 3-15 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 3.7 device properties menu (cont.) scsi id device identi?r scsi timeout queue tags boot choice format 0 < 10> [on] [no] 1 < 10> [on] [no] 2 < 10> [on] [no] 3 seagate st31055n < 10> [on] [no] 4 < 10> [on] [no] 5 < 10> [on] [no] 6 < 10> [on] [no] 7 lsi1030 < 10> [on] [no] 8 < 10> [on] [no] 9 < 10> [on] [no] 10 < 10> [on] [no] 11 < 10> [on] [no] 12 < 10> [on] [no] 13 < 10> [on] [no] 14 < 10> [on] [no] 15 < 10> [on] [no] << scroll indicator >>
3-16 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 3.7 device properties menu (cont.) table 3.6 describes the ?lds in the device properties menu. scsi id device identi?r verify restore defaults 0 1 2 3 seagate st31055n 0594 4 5 6 7 lsi1030 8 |9 10 11 12 13 14 15 << scroll indicator >> table 3.6 device properties menu fie ld description field description scsi id this ?ld indicates the devices scsi identi?r. device identi?r this ?ld indicates the ascii device identi?r string extracted from the devices inquiry data.
using the scsi cu 3-17 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. mb/sec this ?ld speci?s the maximum synchronous data transfer rate in mbytes/s. users cannot directly edit this ?ld because the data width or mt/s ?lds determine its setting. the default for this ?ld is 320. mt/sec this ?ld indicates the maximum synchronous data transfer rate, in mega transfers/s. the default value is 160 mt/sec. table 3.7 provides more information. data width this ?ld indicates the maximum data width in bits. scan id this ?ld indicates whether to scan for this scsi identi?r at boot time. set this option to ?o if there is a device that you do not want to be available to the system. to decrease the boot time, choose no for unused scsi ids. scan luns > 0 this ?ld indicates whether to scan for non-zero luns. lun 0 is always queried. use this option if a multi-lun device responds to unoccupied luns, or to reduce the visibility of a multi-lun device to lun 0. set this option to ?o if there is a problem with a device that responds to all luns. disconnect this ?ld allows a device to disconnect during scsi operations. some newer devices run faster with disconnect enabled, while some older devices run faster with disconnect disabled. scsi timeout this ?ld indicates the maximum amount of time [0 to 9999] in seconds to wait for a scsi operation to complete. because time-outs provide a safeguard that allows the system to recover if an operation fails, lsi logic recommends using a value greater than zero. a value of zero allows unlimited time for an operation to complete and could result in the system hanging. to specify a new timeout value, press enter, type in a value, and press enter again. queue tags this ?ld allows the use of queue tags for a device. the FUSION-MPT scsi bios does not use queue tags. this item speci?s queue tag control to higher level device drivers. boot choice this ?ld indicates if this device can be selected as the boot device. this option is only applicable to devices attached to adapter 0 in the boot list on non-bbs systems. it provides primitive bbs ?xibility to non-bbs systems. format press enter to low-level format the device. if enabled, this option allows low-level formatting on a disk drive. low-level formatting completely erases all data on the drive. formatting the drive creates a 512-byte sector size, even if the drive was formatted to another sector size. verify press enter to verify all sectors on the device and to reassign defective logical block addresses. restore defaults press enter to obtain default settings. table 3.6 device properties menu fie (cont.) ld description field description
3-18 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 3.7 provides information on data transfer rates . 3.4.7 mirroring properties menu the mirroring properties screen allows the user to view and modify the im settings. this screen lists each device attached and allows the user to set the primary, secondary, and hot spare disks. this screen is only accessible if there is FUSION-MPT ?mware running that supports the im feature and the current con?uration supports im. to determine if the ?mware is im-compatible, view the product ?ld on the main adapter list screen. figure 3.8 provides an example of the mirroring properties menu. table 3.7 data transfer rate information mega transfers/s data width = 8 (mbytes/s) data width = 16 (mbytes/s) synchronous period (nsec) 0 = asynchronous 0 = asynchronous 0 = asynchronous 0 = asynchronous 5 5 10 200 10 10 20 100 20 20 40 50 40 40 80 25 80 160 12.5 160 320 6.25
using the scsi cu 3-19 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 3.8 mirroring properties menu lsi logic corp. efi mpt scsi setup utility version - x.xx mirroring properties volume scsi id: 2 size (mb): 4567 scsi id device identi?r mirrored pair status predict failure size (mb) 0 - [no] ---- --- ---- 1 - [no] ---- --- ---- 2 seagate st31055n [primary] optimal [no] 4567 3 seagate st31055n [secondary] optimal [no] 4567 4 - [no] ---- --- ---- 5 - [no] ---- --- ---- 6 - [no] ---- --- ---- 7 53c1030 [no] ---- --- ---- 8 - [no] ---- --- ---- 9 seagate st31055n [hot spare] ---- --- ---- |10 - [no] ---- --- ---- 11 - [no] ---- --- ---- 12 - [no] ---- --- ---- 13 - [no] ---- --- ---- 14 - [no] ---- --- ---- |15 - [no] ---- --- ----
3-20 scsi bios and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 3.8 describes the ?lds in the mirroring properties menu. 3.4.8 exiting the scsi bios con?uration utility because some changes only take effect after the system reboots, it is important to exit this con?uration utility properly. to exit, press esc and respond to the veri?ation prompts. some changes might be lost if you reboot before properly exiting the cu. table 3.8 mirroring properties menu field description field description volume scsi id this ?ld indicates the scsi identi?r of the im volume. size (mbytes) this ?ld indicates the size of the im volume. scsi id this ?ld indicates the devices scsi identi?r. device identi?r this ?ld indicates the ascii device identi?r string extracted from the devices inquiry data. mirrored pair this ?ld displays which disks are part of the im volume, and which disks are the primary, secondary, and hot spare disks. there can be one disk set as the primary disk and one disk set as the secondary disk. a hot spare disk is optional. status this ?ld displays the current status of the im volume. options for this ?ld are ok, missing, incompatible, failed, initing, cfgof?ne, userfailed, of?ne, out of sync, and incomplete mirrored pair. predict failure this ?ld displays predict failure information. options for this ?ld are yes and no. size (mbytes) this ?ld indicates the size of each disk. when an im volume is created, this ?ld re?cts the size of the disk volume and not the size of each individual disk.
FUSION-MPT device management users guide 4-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 4 scsi efi and con?uration utility this chapter contains information about the lsi logic efi 1.1 FUSION-MPT scsi boot services driver and the associated con?uration utility (cu). this chapter contains the following sections: ? section 4.1, ?ntroduction ? section 4.2, ?eatures ? section 4.3, ?oot services driver ? section 4.4, ?fi con?uration utility ? section 4.5, ?xiting the scsi setup utility 4.1 introduction the extensible firmware interface (efi) FUSION-MPT scsi bios is a native ia64 efi 1.1 boot services driver (bsd) that provides pre-os support for the FUSION-MPT architecture lsi53c1030 and the lsi53c1020 scsi processors. a bsd is a bios for systems based on intel architecture and the efi speci?ation. the bios is delivered as one executable, and contains a bsd and a cu. 4.2 features the efi FUSION-MPT bios: ? supports up to 256 host adapter channels per pci function, with up to 15 targets/channel and 8 luns/target. ? supports media removal and media change for scsi removable media device types.
4-2 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ? installs the following efi protocols for each supported host adapter channel: device path scsi pass thru ? installs the following efi protocols for each supported scsi target/lun: device path block i/o ? supports efi 1.1 driver binding and con?uration protocol. ? provides full control of the con?uration settings through the cu. 4.3 boot services driver the FUSION-MPT efi bsd conforms to the efi 1.1 driver model speci?ation. the bsd integrates with efi system ?mware and extends disk services by installing block io (lba) interfaces for supported scsi devices. at load time the driver automatically detects all supported scsi i/o processors and attached scsi devices. the driver then installs block i/o interfaces for the scsi hard drives, removable media devices, cd-roms, write-once, and magneto-opticals (mo) devices. platform ?mware can use the driver services to boot from any supported scsi device. systems normally use the driver services to copy an os loader to boot a system, but can also use the driver services for ?e system i/o at the efi shell.
efi con?uration utility 4-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 4.3.1 bsd installation use the efi shell load command to load the bsd. from the efi shell change to the ?e system that contains the lsimpt.efi boot services driver ?e. this is the same as switching to the desired drive in a dos prompt environment. type load lsimpt.efi to load the boot services driver. the bsd detects all the FUSION-MPT scsi devices. the bsd then installs the necessary efi protocols. you can also load the lsi logic bsd from an option rom with the lsimpt.rom ?e. load the lsimpt.rom ?e onto the flash rom using the lsi logic efi ?sh utility. if a system supports option rom loading, the system installs the lsi logic driver at boot time. after installation, this form of the bsd functions identically to the .efi form of the bsd. 4.4 efi con?uration utility this section describes the scsi bios efi cu. the efi cu provides viewing and editing of controller parameters. the cu uses the efi 1.1 con?uration protocol, and can be invoked with the drvcfg command. the cu can change the default con?uration of the scsi host adapters. alter the default values if there is a con?ct between device settings or to optimize system performance. one or more of the FUSION-MPT scsi host adapters must have an nvram to store the changes. all the scsi bios cu screens follow xed ?ld areas. the header area provides static information text, which is typically the product title and version. the menu area provides the current menu and uses a cursor for menu item selection. the footer area provides general help information.
4-4 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. the cu uses several input keys that are not directly supported by all terminal emulation programs. refer to your terminal emulation program documentation to determine which alternate key to use. table 4.1 summarizes the possible user inputs. the cu grays-out the selections that are not permissible. 4.4.1 main menu when invoked, the cu ?st displays the main menu, which contains a scrolling list of up to 256 lsi logic pci to scsi host adapters and information about each of them. use the arrow keys to select an adapter. press enter to view and modify the properties of the selected adapter, and to gain access to the attached devices. the cu can only access adapters with lsi logic control enabled. after selecting an adapter and pressing enter, the cu scans the adapters scsi bus and then displays the adapter properties screen. the cu can only access adapters with lsi logic control enabled. adapters that do not have a nonvolatile memory display the defaults setting, which the cu cannot change. after selecting an adapter and pressing enter, the cu scans the adapters scsi bus and then displays the adapter properties screen. figure 4.1 provides an example of the main menu. table 4.1 user input key de?ition description f1/shift+1 help context sensitive help for the cursor-resident ?ld. arrow keys/ h,j,k,l; home,end/i,o select item use these keys to position the cursor. +/- change item the items with values in ? ] brackets are modi?ble. use the numeric keypad ? and ? to change a modi?ble ?ld. esc stop/exit escape stops the current context operation and exits the current screen. enter execute item items with values in ? > brackets are executable. press enter to execute the function of the selected ?ld.
efi con?uration utility 4-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 4.1 efi main menu table 4.2 describes the main menu ?lds. lsi logic corp. efi mpt scsi setup utility version v-x.xx lsi logic host bus adapters adapter pci bus pci dev pci fnc rev id fw rev mpi rev product lsi control mirror status 53c1030 0 1 0 03 00010300 0102 im enabled optimal 53c1030 0 2 1 03 00010300 0102 im enabled ------- 53c1030 0 3 0 03 00010300 0102 basic enabled ------- 53c1030 0 3 1 03 00010300 0102 basic enabled ------- lsi logic corp. efi mpt scsi setup utility version pci -x.xx lsi logic host bus adapters adapter pci bus pci dev pci fnc mpi rev product lsi control mirror status nvm irq 53c1030 0 1 0 0102 im enabled optimal ye s 10 53c1030 0 2 1 0102 im enabled ------- ye s 12 53c1030 0 3 0 0102 basic enabled ------- ye s 7 53c1030 0 3 1 0102 basic enabled ------- ye s 3
4-6 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 4.2 main menu field descriptions field description adapter indicates the speci? family of lsi logic host adapters. pci bus indicates the pci bus number that the system bios assigns to an adapter. pci dev indicates the pci device number that the system bios assigns to an adapter. pci fnc indicates the pci function number that the system bios assigns to an adapter. rev id indicates the chip revision of the device. fw rev indicates the FUSION-MPT ?mware version number. mpi rev indicates the FUSION-MPT revision level. product indicates the capabilities of the FUSION-MPT ?mware. the values for this ?ld are either ?asic or ?ntegrated mirroring (im). lsi control indicates whether an adapter is eligible for lsi logic software control or is reserved for control by non-lsi logic software. the possible values for this ?ld are ?nabled, ?isabled, or forbidden. if set to ?orbidden, access to the controller is not available. if set to ?isabled, the user can view and modify settings for the adapter but the lsi logic efi driver does not attempt to control the adapter. if set to ?nabled, the FUSION-MPT efi driver attempts to control the adapter. if set to either ?nabled or ?isabled, the boot support setting in the adapter properties menu can change this setting. for the new setting to take effect, you must either reload the efi driver or reboot the system. mirror status indicates the status of the integrated mirroring volume if one exists. the possible values are nothing (?---? if no mirrored volume exists, optimal, degraded, disabled, quiesced, resyncing, or failed. nvm indicates if an adapter has nonvolatile memory. the possible values are yes or no. irq indicates the interrupt request line for an adapter. the system bios assigns this value.
efi con?uration utility 4-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 4.4.2 adapter properties menu the adapter properties menu allows you to view and modify adapter settings. it also provides access to an adapters device settings. to access the adapter properties menu, select the adapter on the main menu and press enter. the cu then displays the adapter properties menu for the selected adapter. figure 4.2 provides an example of the adapter properties menu. figure 4.2 adapter properties menu lsi logic corp efi mpt scsi setup utility version pci x.xx adapter properties adapter pci bus pci dev pci func 53c1030 0 3 0 boot support [enabled bios & os] host scsi id [7] spinup delay (secs) [2] secondary cluster server [no] termination control [auto]
4-8 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 4.3 describes the ?lds of the adapter properties menu. table 4.3 adapter properties menu field description field description press enter to view and modify device properties. press enter to view and modify the mirroring properties. the cu grays-out this ?ld if the integrated mirroring feature is currently unavailable. this could result from using ?mware that does not support the im feature or having an incompatible setup. if a mirrored volume currently exists, press enter to resynchronize the volume. the cu grays-out this ?ld if the current ?mware in use does not support the im feature or the existing mirrored volume does not need resynchronization. boot support this ?ld indicates if an adapter is enabled for lsi logic software control. the possible selections are disabled, enabled bios only, enabled os only, and enabled bios and os. if disabled is set, then the efi driver does not control the adapter, but the adapter is still visible in the setup utility and users can change settings. if enabled bios only is set, then the efi driver controls the adapter. this setting might not be supported by your os or os drivers. if enabled os only is set, then the os driver controls the adapter. if enabled bios & os is set, then both the efi driver and os driver control the adapter. set this ?ld to disabled or to enabled os only if you do not want the lsi logic efi driver to control. lsi logic recommends setting this ?ld to enabled bios and os. if you want the efi driver to control the adapter. changes in this setting are re?cted in the lsi control ?ld on the main adapter list menu. the new setting does not take effect until the efi driver reloads or the system reboots. host scsi id this ?ld indicates the scsi identi?r of an adapter. lsi logic recommends setting this ?ld to the highest priority scsi identi?r, which is scsi id 7. spin-up delay (secs) this ?ld indicates the number of seconds to wait between spin-ups of devices attached to an adapter. staggered spin-ups balance the electrical current load on the system during boot. the default value is 2 seconds, with choices between 1 and 10 seconds. secondary cluster server the options for this ?ld are ?es or ?o (default). setting this ?ld to yes indicates that the FUSION-MPT adapter shares devices with another adapter, and prevents the FUSION-MPT scsi bios from issuing scsi bus resets. this is a requirement for the microsoft cluster server. lsi logic recommends setting this ?ld to ?es in multi-initiator con?urations.
efi con?uration utility 4-9 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 4.4.3 device properties menu the device properties screen provides viewing and allows updating of the device settings for an adapter. to access the device properties menu, select ?device properties> on the host adapter properties list menu and press enter. changing a setting for the host device changes the setting for all devices. figure 4.3 provides an example of the device properties screen. termination control this ?ld indicates if an adapter has automatic termination control. the options for this ?ld are ?uto or ?ff. ?uto indicates that the adapter automatically determines to enable or disable its termination. ?ff indicates that termination at the adapter is off and that other devices at the ends of the scsi bus must terminate the bus. the default for this ?ld is auto. the cu greys-out auto if the termination is not programmable. nvdata settings determine the ability to modify the termination control setting. the serial eeprom store the nvdata settings. to enable the termination control setting, you must update the nvdata image in the serial eeprom with an nvdata.dat ?e that speci?s the gpio pin to use for termination control. the nvdata.efi utility writes the new nvdata.dat ?e to the serial eeprom. restore defaults to obtain default settings, press enter. table 4.3 adapter properties menu field description (cont.) field description table 4.4 driver support field settings driver support setting description disable the efi driver does not control the adapter when loaded, but the adapter is visible in the cu and users can change settings. enabled bios only the efi driver controls the adapter and the os drivers do not control adapter. some os drivers do not support this setting. enabled os only the efi driver does not control the adapter and the os driver controls the adapter. enabled bios and os both the efi driver and os driver control the adapter. lsi logic recommends using this setting if you want the FUSION-MPT efi to control the adapter.
4-10 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 4.3 device properties menu lsi logic corp. efi mpt scsi setup utility version - x.xx scsi id device identi?r mb/sec mt/sec data width scan id scan luns > 0 dis- connect 0 - [320] [160] [16] [yes] [yes] [on] 1 - [320] [160] [16] [yes] [yes] [on] 2 - [320] [160] [16] [yes] [yes] [on] 3 seagate st31055n [160] [80] [16] [yes] [yes] [on] 4 - [320] [160] [16] [yes] [yes] [on] 5 - [320] [160] [16] [yes] [yes] [on] 6 - [320] [160] [16] [yes] [yes] [on] 7 53c1030 [320] [160] [16] [yes] [yes] [on] 8 - [320] [160] [16] [yes] [yes] [on] 9 - [320] [160] [16] [yes] [yes] [on] 10 - [320] [160] [16] [yes] [yes] [on] 11 - [320] [160] [16] [yes] [yes] [on] 12 - [320] [160] [16] [yes] [yes] [on] 13 - [320] [160] [16] [yes] [yes] [on] 14 - [320] [160] [16] [yes] [yes] [on] 15 - [320] [160] [16] [yes] [yes] [on] << scroll indicator >>
efi con?uration utility 4-11 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 4.3 device properties menu (cont.) scsi id device identi?r scsi timeout queue tags format 0 - < 10> [on] 1 - < 10> [on] 2 - < 10> [on] 3 seagate st31055n < 10> [on] 4 - < 10> [on] 5 - < 10> [on] 6 - < 10> [on] 7 53c1030 < 10> [on] 8 - < 10> [on] 9 - < 10> [on] 10 - < 10> [on] 11 - < 10> [on] 12 - < 10> [on] 13 - < 10> [on] 14 - < 10> [on] 15 - < 10> [on] << scroll indicator >>
4-12 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 4.3 device properties menu (cont.) table 4.5 describes the ?lds in the device properties menu. scsi id device identi?r verify restore defaults 0 - 1 - 2 - 3 seagate st31055n 4 - 5 - 6 - 7 53c1030 8 - 9 - 10 - 11 - 12 - 13 - 14 - 15 - << scroll indicator >> table 4.5 device properties menu field description field description scsi id this ?ld indicates the devices scsi identi?r. device identi?r this ?ld indicates the ascii device identi?r string extracted from the devices inquiry data.
efi con?uration utility 4-13 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. mb/sec this ?ld speci?s the maximum synchronous data transfer rate in mbytes/s. users cannot directly edit this ?ld because the data width or mt/s ?lds determine its setting. the default for this ?ld is 320. mt/sec this ?ld indicates the maximum synchronous data transfer rate, in mega transfers/s. the default value is 160 mt/sec. table 4.6 provides more information. data width this ?ld indicates the maximum data width in bits. possible values are 8 or 16. the default value for this ?ld is 16. scan id this ?ld indicates whether to scan for this scsi identi?r at boot time. set this option to ?o if there is a device that you do not want to be available to the system. to decrease the boot time, choose ?o for unused scsi ids. scan luns > 0 this ?ld indicates whether to scan for non-zero luns. lun 0 is always queried. use this option if a multi-lun device responds to unoccupied luns, or to reduce the visibility of a multi-lun device to lun 0. set this option to ?o if there is a problem with a device that responds to all luns. disconnect this ?ld allows a device to disconnect during scsi operations. the default for this ?ld is on. some newer devices run faster with disconnect enabled, while some older devices run faster with disconnect disabled. this ?ld is not modi?ble on integrated raid volumes. scsi timeout this ?ld indicates the maximum amount of time [0 to 9999] in seconds to wait for a scsi operation to complete. because time-outs provide a safeguard that allows the system to recover if an operation fails, lsi logic recommends using a value greater than zero. a value of zero allows unlimited time for an operation to complete and could result in the system hanging. the default value for this ?ld is 10 seconds. queue tags this ?ld allows queue tags for a device. the bsd does not use queue tags. this item speci?s queue tag control to higher level device drivers. the possible values of the ?ld are on or off. this ?ld is not modi?ble on integrated raid volumes. the default for this ?ld is on. format press enter to low-level format the device. if enabled, this option allows low-level formatting on a disk drive. low-level formatting completely erases all data on the drive. formatting the drive creates a 512-byte sector size, even if the drive was formatted to another sector size. verify press enter to verify all sectors on the device and to reassign defective logical block addresses (lbas). restore defaults press enter to obtain default settings. table 4.5 device properties menu field description (cont.) field description
4-14 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 4.6 provides information on data transfer rates . 4.4.4 mirroring properties menu the mirroring properties screen allows the user to view and modify the im settings. this screen lists each device attached and allows the user to set the primary, secondary, and hot spare disks. this screen is only accessible if there is FUSION-MPT ?mware running that supports the im feature and the current con?uration supports im. to determine if the ?mware is im-compatible, view the product ?ld on the main adapter list screen. figure 4.4 provides an example of the mirroring properties menu. table 4.6 data transfer rate information mega transfers/s data width = 8 bits (mbytes/s) data width = 16 bits (mbytes/s) synchronous period (nsec) 0 = asynchronous 0 = asynchronous 0 = asynchronous 0 = asynchronous 5 5 10 200 10 10 20 100 20 20 40 50 40 40 80 25 80 160 12.5 160 320 6.25
efi con?uration utility 4-15 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 4.4 mirroring properties menu lsi logic corp. efi mpt scsi setup utility version - x.xx mirroring properties volume scsi id: 2 size (mb): 4567 scsi id device identi?r mirrored pair status predict failure size (mb) 0 - [no] ---- --- ---- 1 - [no] ---- --- ---- 2 seagate st31055n [primary] optimal [no] 4567 3 seagate st31055n [secondary] optimal [no] 4567 4 - [no] ---- --- ---- 5 - [no] ---- --- ---- 6 - [no] ---- --- ---- 7 53c1030 [no] ---- --- ---- 8 - [no] ---- --- ---- 9 seagate st31055n [hot spare] ---- --- ---- |10 - [no] ---- --- ---- 11 - [no] ---- --- ---- 12 - [no] ---- --- ---- 13 - [no] ---- --- ---- 14 - [no] ---- --- ---- |15 - [no] ---- --- ----
4-16 scsi efi and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 4.7 describes the ?lds in the mirroring properties menu. 4.5 exiting the scsi setup utility because some changes only take effect after the system reboots, it is important to exit the con?uration utility properly. to exit, press esc and respond to the veri?ation prompts. some changes might be lost if you reboot before properly exiting the cu. table 4.7 mirroring properties menu field description field description volume scsi id this ?ld indicates the scsi identi?r of the im volume. size (mbytes) this ?ld indicates the size of the im volume. scsi id this ?ld indicates the devices scsi identi?r. device identi?r this ?ld indicates the ascii device identi?r string extracted from the devices inquiry data. mirrored pair this ?ld displays which disks are part of the im volume, and which disks are the primary, secondary, and hot spare disks. there can be one disk set as the primary disk and one disk set as the secondary disk. a hot spare disk is optional. status this ?ld displays the current status of the im volume. options for this ?ld are ok, missing, incompatible, failed, initing, cfgof?ne, userfailed, of?ne, out of sync, and incomplete mirrored pair. predict failure this ?ld displays predict failure information. options for this ?ld are yes and no. size (mbytes) this ?ld indicates the size of each disk. after an im volume is created, this ?ld re?cts the size of the disk volume and not the size of each individual disk.
FUSION-MPT device management users guide 5-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 5 fibre channel firmware and con?uration utility this chapter provides information about installing and con?uring fibre channel (fc) ?mware and con?uration utility (cu) for standard operating systems. this chapter contains the following sections: ? section 5.1, ?eneral description ? section 5.2, ?c firmware ? section 5.3, ?nstalling the firmware ? section 5.4, ?on?uring the firmware ? section 5.5, ?unning a linux operating system 5.1 general description the lsi logic fc chips and host adapters contain ?mware that presents a multiprotocol service layer based on the FUSION-MPT architecture. the fc ?mware provides fcp (scsi-3 over fc) initiator, fcp target, and lan interface services to the host system. the fc929.rom ?e contains the ?mware that supports the lsifc919 or lsifc929 chips and their related host adapters.
5-2 fibre channel firmware and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 5.2 fc firmware this section includes the features, description, installation, and con?uration of the fc ?mware. 5.2.1 features the lsi logic fc chips and host adapters: ? support FUSION-MPT, version 1.2 ? support concurrent initiator, target, and lan roles ? act as a multiple initiator ? provide auto negotiation between 1 gbit/s and 2 gbits/s operation ? support auto topology con?uration (ability to con?ure n-port, nl-port, or default auto mode) ? support storage networking industry association (snia) system management firmware interface ? support fc device hot-plug ? support fc tape 5.2.2 description the fc controllers operate in an environment where one or more host drivers serve as the interface layer between the operating system and the FUSION-MPT services provided by the lsi logic fc ?mware. the host driver is responsible for initializing the controller, building request message frames, issuing request message frames to the controller, and processing reply message frames received from the controller. the lsi logic firmware translates FUSION-MPT message frames into fc specific sequences, frames, and primitives that are delivered to the fc transmit and receive physical interfaces. the firmware-based link services library transparently provides all link service support used by the host for all fc topologies. the firmware manages all link exceptions, which isolates the host driver from fc-unique exceptions. the FUSION-MPT architecture enables the use of parallel scsi host drivers with the fc controllers, with little or no modification to the scsi host driver.
installing the firmware 5-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 5.3 installing the firmware you can use the fc flash cu to update the fc ?mware. 5.3.1 installing the flash con?uration utility the fcutil.exe program runs on dos on intel-based hardware. follow these steps to install the flash cu. step 1. make a directory on your local hard drive by typing: c:\ md fcutil step 2. copy the fcutil.exe into the directory by typing: copy a:\fcutil exe c:\fcutil\*.*/v step 3. for the flash cu to work, you must also type: copy a:\dos4gw.exe c:\fcutil 5.3.2 running the flash con?uration utility use the fcutil.exe program to update the FUSION-MPT ?mware on the fc controllers and/or host adapters. to execute the fcutil.exe program, follow these steps: step 1. type: fcutil the system displays: ?hich chip (0 to quit)? step 2. type the number on the left side of the menu and press enter. the system displays menu options with the world wide port name and world wide node name for each port of the fc device. this menu also displays each ports current topology, each ports current board speed, the current device path setting, and the current ?mware loaded in the flash. step 3. select the download firmware option.
5-4 fibre channel firmware and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 4. enter the name of the ?mware: fc929.rom fc929.rom is the default ?mware ?e name. during the download operation, the controller validates the ?mware image and displays a message while loading the ?mware image. flashing the ?mware takes approximately 45 seconds. step 5. cycle the power. 5.4 con?uring the firmware the lsi logic ?mware supports several con?uration options for the fc host adapters. the FUSION-MPT flash cu provides the ability to con?ure the fc host adapter(s). impor tant. to ensure the con?uration change takes effect, reboot your system before selecting another option. follow these steps to con?ure your host adapter: step 1. type: fcutil the system displays a menu of the detected fc host adapters. step 2. select the host adapter to update. the system displays: ?hich chip (0 to quit)? step 3. type the number on the left side of the menu and press enter. step 4. the following items detail how to con?ure various options. refer to table 5.1 for information about con?uration options. 1. to change the port speeds, use the autonegotiation option. by default, autonegotiation is enabled. if port 0 is set to a 1 gbit/s operation, the menu displays: toggle port 0 board speed to 2 gbit/s toggle port 0 board speed to auto if port 1 is set to 2 gbit operation, the menu displays: toggle port 1 board speed to 1 gbit toggle port 1 board speed to auto
con?uring the firmware 5-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 2. to change the interrupt coalescing values on port 0 or port 1, use the interrupt coalescing option. the default values are queue depth = 9 and delay time = 500 ms. 3. to change the device path, use the multipathing option. by default, this option is enabled. 4. to change topology, use the autotoplogy option. by default, this option is enabled. 5. to change adapters, use the change adapters option. 6. to exit from this utility, use the quit option. table 5.1 con?uration options for fc adapters option description autonegotiation this option allows the fc chip to automatically adjust to 2 gbits/s or 1 gbit/s operation, depending on the link speed of the other nodes on the link. some older switches or peripherals might prevent this option from working. in those cases, manually set the link speed to either 2 gbits/s or 1 gbit/s. interrupt coalescing this option optimizes system performance by con?uring the number of i/o replies that the controller posts to the host driver per host interrupt. the queue depth speci?s the number of i/o replies that the controller queues before generating a host interrupt. the delay time speci?s the amount of time, in milliseconds, to wait for an interrupt to be generated if the number of posted replies is less than queue depth. multipathing this option recognizes the need to provide a unique logical id for each port of a dual ported target. if a dual ported target is attached to a single channel of the fc chip, enabling the multipathing option creates two logical ids for the single drive, one for each port on the drive. with multipathing disabled, the fc chip recognizes that both ports on the target address the same drive and a single logical id is created for the drive. carefully analyze your system and topology requirements before enabling or disabling this option. autotopology this option allows the fc chip to automatically con?ure itself for private loop, public loop, and direct n-port connections. with autotopology, the chip starts link initialization with a lip. if the lip does not returned to the fc chip, the chip assumes that it is not on a loop and tries to login to an attached switch. if the switch does not respond, the chip assumes it is directly connected to another n-port. change adapters this option allows you to switch between fc host adapters.
5-6 fibre channel firmware and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 5.5 running a linux operating system this section describes the procedure for updating the FUSION-MPT ?mware while your linux operating system is running. 5.5.1 using the FUSION-MPT flash utility the FUSION-MPT flash utility (mptflash) updates the FUSION-MPT ?mware on FUSION-MPT fc chips and their associated host adapters. this utility uses the mpi fwdownload command to update the ?mware image in ?sh while the current ?mware is running. the ?mware update becomes effective after a subsequent reboot. because the lsifc929 controller is a dual channel device, each channel appears as two separate i/o controllers (iocs) to the system. you only need to perform this update procedure to one of the two visible iocs for each lsifc929. also note that the lsifc919 and lsifc929 controllers must use the same ?mware image ?e. 5.5.2 updating the firmware the following examples show procedures for updating the FUSION-MPT ?mware on a fc controller chip or host adapter in a linux os. step 1. boot your system. step 2. log in as root. step 3. verify that the FUSION-MPT base driver is properly installed by typing: # insmod mptbase the system displays: fusion mpt base driver 1.02.00 mptbase: initiating ioc0 bringup ioc0: fc919: capabilities=(initiator, target, lan) mptbase: initiating ioc1 bringup ioc1: fc929: capabilities=(initiator, target, lan) mptbase: initiating ioc2 bringup ioc2: fc929: capabilities=(initiator, target, lan) mptbase: 3 mpt adapters found, 3 installed.
running a linux operating system 5-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 4. verify the current layout and version of existing FUSION-MPT controllers by typing: # cat /proc/mpt/summary the system displays: ioc0: lsifc919, fwrev=1000h, ports=1, maxq=256 lanaddr=00:a0:b8:04:78:55, irq=9 ioc1: lsifc929, fwrev=0900h, ports=1, maxq=256 lanaddr=00:a0:b8:04:0b:32, irq=10 ioc2: lsifc929, fwrev=0900h, ports=1, maxq=256 lanaddr=00:a0:b8:04:0b:33, irq=5 step 5. verify that the FUSION-MPT miscellaneous device (ioctl) driver is loaded by typing: # insmod mptctl the system displays: FUSION-MPT misc device (ioctl) driver 1.02.00 mptctl: registered with FUSION-MPT base driver mptctl: /dev/mptctl @ (major,minor=10,220) step 6. verify that a proper /dev/mptctl character special device node exists by typing: # ls -l /dev/mptctl the system displays a message similar to: crw-r--r--r 1 root root 10, 220 dec 27 16:32 /dev/mptctl if you do not have one a /dev/mptctl character special device node, you can create one by typing: # mknod /dev/mptctl c 10 220 step 7. create the mpt?sh utility program by changing your directory to the drivers/message/fusion/utils subdirectory. type: #cd /usr/src/linux/drivers/message/fusion/utils step 8. type: # make mptflash the system displays: gcc -g -o -wall -i. -i.. -i../../../../ include -c mptflash.c\ -o mptflash.o gcc mptflash.o -o mptflash
5-8 fibre channel firmware and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 9. move the resulting mpt?sh program by typing: # mv mptflash /sbin step 10. find the ioc ?mware image by changing your directory and listing the ?e by typing: #cd /tmp #ls -l fc929-100.rom the system displays: -rw-rw-r-- 1 fibre fibre 195876 jul 19 01:00 fc929- 100.rom run the mpt?sh utility program by specifying the ioc to update as ioc1 or ioc2. step 11. type at the command prompt: # mptflash fc929-100.rom 1 the system displays: step1: cmd line check: ok step2: get_oldver() results: ?sifc9x9-0.09.00 step3: open (?c929-100.rom?: ok, fwfd=3 step4: stat (?c929-100.rom?: ok, size=195876 bytes step5: malloc(195876): ok step6: read(3,,195876): ok current f/w version = ?sifc9x9-0.09.00 new f/w version = ?sifc929-1.00.00 (2001.07.19) step7: open(?dev/mptctl?: ok, ctlfd=4 pre-step8: ioctl(4,mptfwdownload,) okay, this is like, a ?eally?dangerous procedure. are you absolutely sure you want to do this? (y [n]) step 12. type y and press enter. the system takes approximately 10?5 seconds and then displays: !!! mpt firmware transfer to ioc1 succeeded!!! (8 of 8 f/w update steps were successful) change effective only after next reset/ power cycle step 13. reboot your system.
running a linux operating system 5-9 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 5.5.3 firmware troubleshooting if the ?mware download using FUSION-MPT flash utility (mptflash) fails, reinstall the ?mware using the dos-based flash cu program.
5-10 fibre channel firmware and con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved.
FUSION-MPT device management users guide 6-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 6 fibre channel bios this chapter describes the fibre channel (fc) bios installation process for intel and solaris sparc systems. this chapter contains the following sections: ? section 6.1, ?ntroduction ? section 6.2, ?c bios ? section 6.3, ?pdating the bios and firmware 6.1 introduction the system loads the fc bios to facilitate booting from fc drivers. the bios also contains an embedded con?uration manager that con?ures ?mware-provided options. for this release, the bios cu is not documented. to make con?uration changes, use the flash cu, which is documented in chapter 5, ?ibre channel firmware and con?uration utility. the lsi logic bios integrates with a standard system bios, extending the standard disk service routine provided through int13h. two types of bios are available for lsi logic host adapters: an intel bios for intel-based platforms, and open boot bios for solaris sparc platforms.
6-2 fibre channel bios version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 6.2 fc bios this section provides the features, description, and installation of the fc bios. 6.2.1 intel bios features the FUSION-MPT fc intel bios: ? supports FUSION-MPT, version 1.2 ? supports selection and con?uration for up to 256 adapters ? allows boot device selection from any four host adapters ? offers con?uration options for autonegotiation, autotopology, and multipathing ? provides automatic int13 drive mapping for fc drives ? uses a shared interface with the FUSION-MPT scsi bios and cu 6.2.2 solaris sparc bios features the fc solaris sparc bios is an fcode image that: ? supports FUSION-MPT, version 1.2 ? offers con?uration options for autonegotiation, autotopology, and multipathing ? uses a shared interface with the FUSION-MPT scsi bios and cu
updating the bios and firmware 6-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. the solaris sparc system must have the available resources listed in table 6.1 to install the FUSION-MPT host adapters. 6.2.3 description during the boot time initialization, the fc bios determines if there are other hard disks, such as an ide drive, already installed by the system bios. if there are, the fc bios maps any fc drives it ?ds behind the drive(s) that are already installed. otherwise, the fc bios installs drives starting with the system boot drive and the system boots from a drive controlled by the fc bios. 6.3 updating the bios and firmware the bios and fcode images (for solaris sparc) are updated using the fc flash con?uration utility. to install this con?uration utility ( fcutil.exe ), follow the directions in section 5.3.1, ?nstalling the flash con?uration utility, page 5-3 . to update the bios and fcode images from a ?e, follow these steps: step 1. execute the fcutil.exe by typing at the command prompt: c:\fcutil step 2. press enter. step 3. select the host adapter. step 4. press enter. step 5. select the update bios menu option to download the bios and fcode image. the system prompts you to enter a ?ename for the bios image. table 6.1 solaris sparc resources resource requirement host bus slot sun solaris system with available pci slot operating system solaris 2.6 release or later firmware openboot prom version 3.0 or greater
6-4 fibre channel bios version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 6. enter the source ?e for bios image: mptbios.rom or press enter to select the default value. the system prompts you to select one of two options. the solaris sparc fcode image for the lsi44929 is lsi929f.rom. the solaris sparc fcode image for the lsi40919 is lsi919f.rom .
updating the bios and firmware 6-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 7. enter the source ?e for fcode image: lsi929f.rom or lsi919f.rom . the intel bios and solaris fcode images are downloaded together. the system displays a download message while writing the images to the host adapter.
6-6 fibre channel bios version 1.2 copyright 2002 by lsi logic corporation. all rights reserved.
FUSION-MPT device management users guide 7-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 7 windows driver installations this chapter describes the symmpi.sys driver windows-based operating system and provides installation instructions for various windows operating systems. this chapter contains the following sections: ? section 7.1, ?indows device driver description ? section 7.2, ?indows 98 driver installation ? section 7.3, ?indows millennium driver installation ? section 7.4, ?indows xp driver installation ? section 7.5, ?indows nt 4.0 installation ? section 7.6, ?indows 2000 driver installation ? section 7.7, ?indows.net driver installation 7.1 windows device driver description microsoft and lsi logic provide the miniport device driver, called symmpi.sys. the symmpi.sys driver is named ?si logic pci scsi/fc mpi miniport driver, and completes the path to the lsi logic controller with an optional scsi or fc bios. the symmpi.sys driver supports the lsi53c1030, lsi53c1020, lsifc929, lsifc919, and lsifc909 controllers, as well as their associated host bus adapters. the symmpi.sys driver contains these features: ? supports 320 mbytes/s parallel scsi transfers ? supports integrated mirroring technology ? supports pci and pci-x bus protocols ? supports 1 and 2 gbaud fc transfers ? supports FUSION-MPT common software interface
7-2 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ? supports multiple host adapters ? supports multiple logical unit numbers (luns) ? supports scatter-gather operations ? supports scsi pass-through functionality ? supports disk array con?urations with no lun 0 ? supports disk array con?urations with noncontiguous luns ? auto request sense ? supports a maximum block size of 1 mbyte depending on the media used to distribute the lsi logic drivers (web or cd-rom), you might need to create a driver diskette. to do so, copy the ?es listed for your operating system in table 7.1 to the root directory of a clean diskette and label this diskette ?indows driver diskette and use it during the installation process. you can also download the current drivers from the lsi logic web site at http://www.lsilogic.com. the windows-based operating systems runs on intel architecture processors using current technology and provides a graphical user interface environment. an i/o manager handles i/o requests for the operating system. it also provides class drivers for hard disk, optical, cd-rom, printer, and scanner peripherals. you can add other class drivers to support new devices. the windows operating systems described in the guide provide tape device support and does not require a class driver for tape devices. table 7.1 FUSION-MPT device driver files for windows os windows os files windows nt 4.0 txtsetup.oem , symmpi.sys , symmpi.tag , oemsetup.inf windows 2000 txtsetup.oem , symmpi.sys, symmpi.tag , oemsetup.inf, symmpi2k.cat windows xp \txtsetup.oem, \symmpi.tag, \32_bit\oemsetup.inf, \32_bit\symmpi.sys, \64_bit\oemsetup.inf, \64_bit\symmpi.sys, \32_bit\mpixp32.cat, \64_bit\mpixp64.cat windows 98 symmpi.mpd, symmpi.inf, symmpi.cat windows millennium symmpi.mpd, symmpi.inf, symmpi.cat
windows 98 driver installation 7-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. the symmpi.sys driver meets the microsoft speci?ation for miniport drivers. this driver allows connection of parallel scsi and fc devices for pci and pci-x based machines. the symmpi.sys driver ?es does not require any changes. a windows application passes commands directly to the scsi or fc devices by using the scsi pass-through facility. this facility allows applications to control and access devices directly by ?ling in a data structure and calling into the port or class driver. refer to the microsoft windows documentation for more details. 7.1.1 miniport driver con?uration options by default, the symmpi.sys driver provides optimum performance in most standard systems. some nonstandard systems require ?e tuning to obtain peak system memory utilization and performance. if you observe less than the advertised functionality and performance on any platform after installation, please contact lsi logic technical support. go to the lsi logic technical support home page at: http://www.lsilogic.com/support/index.html#hotline and call the listed number for assistance. lsi logic can provide additional registry settings to customize the driver for speci? systems and applications. 7.2 windows 98 driver installation this section describes the symmpi.sys driver for the windows 98 operating system and includes these topics: ? section 7.2.1, ?ew system installation ? section 7.2.2, ?xisting system installation the following procedures install the symmpi.sys driver onto a new or existing windows 98 system.
7-4 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 7.2.1 new system installation this procedure installs the symmpi.sys driver onto a new windows 98 system. follow these instructions for new system installations: step 1. start the windows 98 according to the microsoft instructions. step 2. go to the start menu and choose settings-->control panel. step 3. select system and click on the device manager tab. step 4. under the other devices section, double-click on the pci scsi bus controller. step 5. select the re-install driver button under the general tab, and click next. step 6. select the ?earch for a better driver than... and click on next. step 7. insert the windows 98 driver diskette. step 8. check the specify a location box and type a:\win98 and click the next button. step 9. click next again and click the finish button. step 10. remove the diskette from the drive and click yes to restart the computer. the windows 98 setup is complete and the new driver is operational. 7.2.2 existing system installation review this procedure before you install the symmpi.sys driver onto an existing windows 98 system. follow these steps to install the symmpi.sys driver: step 1. boot windows 98. the found new hardware wizard window pops up. click next. step 2. select the ?earch for a suitable driver... and click on the next button. step 3. click on the next button again. step 4. select the specify location box, and click next. step 5. type a:\win98 and click the ok button.
windows millennium driver installation 7-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. the next screen displays: ?indows has found a driver for this device. step 6. click next, and then finish. repeat steps 2 through 6 for the second scsi channel, if one is present. 7.3 windows millennium driver installation this section describes the symmpi.sys driver for the windows millennium operating system and includes these topics: ? section 7.3.1, ?ew system installation ? section 7.3.2, ?xisting system installation the following procedures install the symmpi.sys driver onto a new or existing windows millennium system. 7.3.1 new system installation follow these instructions for new system installations: step 1. start the windows millennium according to the microsoft instructions. step 2. go to the start menu and choose settings-->control panel. step 3. select system and click on the device manager tab. note: you may have to select the view control panel settings on the left side of the control panel window to see the system option. step 4. under the other devices section, double-click on the pci scsi bus controller. step 5. select the re-install driver button under the general tab and select next. step 6. select the ?pecify location of the driver (advanced) and click next. step 7. select the ?earch for a better driver... and check the specify location box and uncheck all other boxes.
7-6 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 8. type a:\winme in the text area under the specify location check box. step 9. insert the driver diskette, and click next. step 10. click next again and click the finish button. step 11. remove the diskette from the drive and click yes to restart the computer. the windows millennium setup is complete and the new driver is operational. 7.3.2 existing system installation follow these instructions for already existing system. step 1. boot windows millennium. the found new hardware wizard window pops up. step 2. insert the driver diskette. step 3. select the install software automatically option, and click on the next button. step 4. click on the finish button. repeat steps 1? for the second scsi channel, if one is present.
windows xp driver installation 7-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 7.4 windows xp driver installation this section describes the symmpi.sys driver for the windows xp operating system. it provides instructions for existing system installations and includes these topics: ? section 7.5.1, ?nstalling the symmpi.sys driver ? section 7.5.2, ?erformance tuning this driver supports only windows xp. 7.4.1 installing the symmpi.sys driver the following procedures install the symmpi.sys driver onto a new or existing windows xp system. 7.4.1.1 new system installation this procedure installs the symmpi.sys driver onto a new windows xp system. windows xp automatically adds the driver to the registry and copies the driver to the appropriate directory. these instructions assume the use of a cd-rom. the system bios must support booting from a cd-rom. bios settings might require changes to allow cd-rom booting. refer to your system documentation. step 1. start the windows xp installation by booting from the windows xp cd-rom. the system bios must support booting from a cd-rom. bios settings might require changes to allow cd-rom booting. refer to your systems documentation. step 2. press f6 to install the symmpi.sys driver when the screen displays: ?ress f6 if you need to install... note: you must press f6 for the system to recognize the new driver. otherwise, the system does not recognize the devices controlled by the driver during the windows setup.
7-8 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 3. choose s to specify an additional device when the screen displays: ?etup could not determine the type... note: if this screen is not displayed as the ?st user input, then the f6 key press was not seen by the setup program. reboot the system and return to step 2. the system prompts for the manufacturer-supplied hardware support disk. step 4. insert the window xp driver diskette and press enter. step 5. select the appropriate windows xp driver from the menu by highlighting it and press enter to proceed. step 6. follow the windows xp installation procedure from this point. 7.4.1.2 existing system installation this procedure installs or upgrades the symmpi.sys driver onto an existing window xp system. step 1. boot windows xp. the found new hardware wizard appears. the information on the ?st page of this window identi?s the scsi controller and requests the driver diskette. step 2. insert the windows xp driver diskette into the ?ppy drive. step 3. choose the install software automatically option. step 4. click on the next button. step 5. in some cases, a message displays saying that this driver is not digitally signed. this message informs you that a nonsigned driver is being installed. click on continue anyway. step 6. the system loads the driver from the windows xp driver diskette and copies the driver to the system disk. the found new hardware wizard screen appears and displays the message: ?he wizard has finished... step 7. click on the finish button to complete the driver upgrade. step 8. repeat this process for the second channel, if one is present.
windows xp driver installation 7-9 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 7.4.2 performance tuning for windows xp windows xp offers registry entries that can tune the performance of scsi i/o for certain con?urations. the tunable parameters are the large transfer block size support and the guaranteed number of concurrent i/os for a particular scsi bus. 7.4.2.1 large block size support the symmpi.sys drivers can support up to a 1 mbyte transfer size in windows xp; however, the default windows xp transfer size is 64 kbytes. to enable better performance, the driver installation process adds a registry entry to enable 256 kbytes transfer sizes. programmers can also use the mpi_256k.reg ?e to set or re-enable the maximum transfer size. there are two methods to add this registry setting. the ?st method is to locate the mpi_256k.reg data ?e using windows explorer, double-click on the ?e, and edit it. the second method is to type at the command prompt: regedit mpi_256k.reg this command inserts an entry in the registry to enable 256 kbytes block size support. editing the mpi_256k.reg can set any maximum block size between 64 kbytes and 1 mbyte. the formula to calculate the proper value for maximumsglist in a 32-bit os is: maximumsglist = [(maximum block size)/4 kbytes] + 1 for 64-bit systems, the os page size is 8 kbytes instead of 4 kbytes. therefore, the maximum transfer size is 2 mbytes, the default driver installation enables support for 512 kbytes transfer size, and the formula to calculate the maximumsglist is: maximumsglist = ((maximum block size)/8 kbytes) + 1 as an example, to determine the maximumsglist value for 256 kbytes in a 32-bit os, take [(256 kbytes/4 kbytes) +1] = 65 (or 0x41 in hexadecimal). the maximum value allowed for maximumsglist is 255 or 0xff. for the particular value of 0xff, the internal value passed to windows xp is increased to 0x101, allowing support for a full 1 mbyte transfer.
7-10 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. read the information in the mpi_256k.reg data ?e before editing it. the system must reboot 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 ?e. 7.4.2.2 maximum number of concurrent i/os (guaranteed) windows xp guarantees a maximum of 32 concurrently active i/os on a particular scsi bus. due to the method of memory allocation, the actual limit of concurrent i/os can vary between various drivers or versions of drivers. this can have a signi?ant impact on performance benchmarking between different driver versions or adapter vendors. in effect, one adapter could support 80 outstanding i/os, while another adapter could only support 32 outstanding i/os. 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, programmers can use the mpi100io.reg data file to add a registry entry that set the maximum numbers of concurrent i/os. there are two methods to add this registry setting. one method is to locate the mpi100io.reg data file using windows explorer, double-click on the file, and edit it. the other method is to type at the command prompt: regedit mpi100io.reg this command inserts an entry in the registry to guarantee a maximum of 100 concurrent i/os per adapter. note: setting this value to a high number uses increasing amounts of nonpaged pool memory, which is a critical windows xp resource. high values for this setting can degrade system performance. be sure to read the information in the mpi100io.reg data ?e before editing it. you must reboot system for the new registry setting to take effect. to reset the guaranteed number of concurrent i/os to the windows xp default of 32, follow the instructions above but use mpidefio.reg as the data ?e.
windows nt 4.0 installation 7-11 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 7.5 windows nt 4.0 installation this section provides instructions for driver installation on the windows nt 4.0 operating system and includes the following subsections: ? section 7.5.1, ?nstalling the symmpi.sys driver ? section 7.5.2, ?erformance tuning this driver supports only windows nt 4.0 and its service packs. 7.5.1 installing the symmpi.sys driver the following procedures installs the symmpi.sys driver onto a new or existing windows nt 4.0 system. 7.5.1.1 new system installation this procedure installs the symmpi.sys driver onto a new windows nt 4.0 system. windows nt 4.0 automatically adds the driver to the registry and copies the driver to the appropriate directory. to install these drivers onto a windows nt 4.0 system, you can either boot directly from the windows nt 4.0 cd-rom or use windows nt 4.0 boot ?ppy driver diskettes. each installation method requires different steps, which the following sections explain. cd-rom installation the following steps describe a windows nt 4.0 installation using a cd-rom: step 1. start the windows nt 4.0 installation by booting from the windows nt 4.0 cd-rom. the system bios must support booting from a cd-rom. bios settings might require changes to allow cd-rom booting. please refer to your system documentation. step 2. press f6 when the screen displays ?indows nt setup. note: you must press f6 for system to recognize the new driver. otherwise, the system does not recognize the devices controlled by the driver during the windows setup.
7-12 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 3. choose s to specify an additional device when the screen displays: ?etup could not determine the type of one or more mass storage devices... . note: if this screen is not displayed as the ?st user input, then pressing f6 was not seen by the setup program. reboot the system and return to step 2. the system prompts for the driver diskette. step 4. insert the windows nt 4.0 driver diskette and press enter. step 5. select the windows nt 4.0 driver from the menu by highlighting it. press enter to proceed. step 6. windows nt 4.0 now recognizes the miniport driver and the scsi hardware. press enter to continue. step 7. follow the microsoft windows nt 4.0 installation procedure from this point. step 8. install the windows nt 4.0 service packs 5 or higher after windows nt 4.0 installation completes. boot floppy disk installation the following steps describe a windows nt 4.0 installation using a boot ?ppy disk: step 1. start the windows nt 4.0 installation by booting from the microsoft setup ?ppy diskette. step 2. press enter when the ?elcome to setup screen appears. the ?indows nt 4.0 workstation setup window appears next. step 3. press s to skip automatic detection and perform manual selection. a screen displays the message: ?etup has recognized the following mass storage devices in your computer... step 4. choose s to con?ure additional adapters when a screen displays the adapters found. step 5. move the highlight bar to other and press enter. the system prompts for the driver diskette. step 6. insert the windows nt 4.0 driver diskette and press enter. the system displays and highlights: "lsi logic pci scsi/fc mpi miniport driver"
windows nt 4.0 installation 7-13 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 7. press enter to proceed. the windows nt workstation setup window reappears. step 8. if using an ide cd-rom for installation, press s to load additional drives. another window appears. scroll up and select: "ide cd-rom (atapi 1.2)/pci ide controller" press enter. otherwise, press enter if you have completed con?uring additional adapters. upon exiting, a screen displays the message: "setup will load support ... step 9. press enter to continue. this message implies that windows nt 4.0 recognizes the miniport device driver. step 10. follow the microsoft windows nt 4.0 installation procedure at this point. 7.5.1.2 existing system installation to install the symmpi.sys driver, follow these steps: step 1. boot windows nt 4.0 and log on as administrator. step 2. click on the start button. move to settings-->control panel and click. step 3. double-click on scsi adapters. step 4. click on the drivers tab. step 5. click add. a list of installed adapters appears. step 6. click the have disk button. step 7. when prompted, insert the windows nt 4.0 driver diskette. step 8. enter the path to copy the driver ?es from: a:\nt select ok.
7-14 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 9. the driver name ?si logic pci scsi/fc mpi driver install disk is highlighted on the install driver menu. if it is not highlighted, select it. choose ok . step 10. choose new. step 11. verify the path to the scsi adapter ?es reads: a:\nt if not, enter it as shown above. select continue . step 12. remove the diskette from your a: drive. step 13. the system settings change message displays: ?ou must restart your computer before.. step 14. click on the yes button to restart and reboot windows nt 4.0. you must restart the computer to load the new driver. step 15. repeat this process for the second channel, if one is present. 7.5.2 performance tuning windows nt 4.0 offers registry entries that can tune the performance of scsi i/o for certain con?urations. the tunable parameters are the large transfer block size support and the guaranteed number of concurrent i/os for a particular scsi bus. 7.5.2.1 large block size support the symmpi.sys drivers can support up to a 1 mbyte transfer size in windows nt 4.0; however, the default windows nt 4.0 transfer size is 64 kbytes. to enable better performance, the driver installation process adds a registry entry to enable 256 kbytes transfer sizes. you can also use the mpi_256k.reg ?e to set or re-enable the maximum transfer size. there are two methods to add this registry setting. the ?st method is to locate the mpi_256k.reg data ?e using windows explorer, double-click on the ?e, and edit it. the second method is to type at the command prompt: regedit mpi_256k.reg this command inserts an entry in the registry to enable 256 kbytes block size support.
windows nt 4.0 installation 7-15 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. editing the mpi_256k.reg can set any maximum block size between 64 kbytes and 1 mbyte. the formula to calculate the proper value for maximumsglist is: maximumsglist = [(maximum block size)/4 kbytes] + 1 as an example, to determine the maximumsglist value for 256 kbytes take [(256 kbytes/4 kbytes) +1] = 65 (or 0x41 in hexadecimal). the maximum value allowed for maximumsglist is 255 or 0xff. for the particular value of 0xff, the internal value passed to windows nt 4.0 is increased to 0x101, allowing support for a full 1 mbyte transfer. read the information in the mpi_256k.reg data ?e before editing it. the system must reboot 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 ?e. 7.5.2.2 maximum number of concurrent i/os (guaranteed) windows nt 4.0 guarantees a maximum of 32 concurrently active i/os on a particular scsi bus. due to the method of memory allocation, the actual limit of concurrent i/os can vary between various drivers or versions of drivers. this can have a signi?ant impact on performance benchmarking between different driver versions or adapter vendors. in effect, one adapter could support 80 outstanding i/os, while another adapter could only support 32 outstanding i/os. 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, programmers can use the mpi100io.reg data file to add a registry entry that sets the maximum numbers of concurrent i/os. there are two methods to add this registry setting. one method is to locate the mpi100io.reg data file using windows explorer, double-click on the file, and edit it. the other method is to type at the command prompt: regedit mpi100io.reg this command inserts an entry in the registry to guarantee a maximum of 100 concurrent i/os per adapter.
7-16 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. note: setting this value to a high number uses increasing amounts of nonpaged pool memory, which is a critical windows nt 4.0 resource. high values for this setting can degrade system performance. be sure to read the information in the mpi100io.reg data ?e before editing it. you must reboot system for the new registry setting to take effect. to reset the guaranteed number of concurrent i/os to the windows nt 4.0 default of 32, follow the instructions above but use mpidefio.reg as the data ?e. 7.6 windows 2000 driver installation this section describes the symmpi.sys driver for the windows 2000 operating system and includes these topics: ? section 7.6.1, ?nstalling the symmpi.sys driver ? section 7.6.2, ?erformance tuning this driver supports only windows 2000. 7.6.1 installing the symmpi.sys driver the following procedures install the symmpi.sys driver onto a new or existing windows 2000 system. 7.6.1.1 new system installation this procedure installs the symmpi.sys driver onto a new windows 2000 system. windows 2000 automatically adds the driver to the registry and copies the driver to the appropriate directory. the method for installing windows 2000 on a new system involves using a cd-rom. refer to the microsoft document for installing windows 2000 using boot ?ppy diskettes. step 1. start the windows 2000 installation by booting from the windows 2000 cd-rom. the system bios must support booting from a cd-rom. bios settings might require changes to allow cd-rom booting. refer to your system documentation.
windows 2000 driver installation 7-17 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 2. press f6 to install the symmpi.sys driver when the screen displays: ?ress f6 if you need... note: you must press f6 for the system to recognize the new driver. otherwise, the system does not recognize the devices controlled by the driver during the windows 2000 setup. step 3. choose s to specify an additional device when the screen displays: ?etup could not determine the type of one or more mass storage devices... note: if this screen is not displayed as the ?st user input, then pressing f6 was not seen by the setup program. reboot the system and return to step 2. step 4. the system prompts for the manufacturer-supplied hardware support disk. insert the driver diskette containing the windows 2000 device driver and press enter. step 5. select the windows 2000 device driver from the menu by highlighting it and press enter. step 6. press enter to proceed. step 7. return to the windows 2000 setup screen. step 8. press enter to proceed. step 9. follow the microsoft windows 2000 installation procedure at this point. step 10. repeat this process for the second channel, if one is present. 7.6.1.2 existing system installation this procedure installs or upgrades the symmpi.sys driver onto an existing windows 2000 system. step 1. boot windows 2000. the found new hardware wizard begins. step 2. click on the next button.
7-18 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 3. click on the ?earch for a suitable driver... button to select it, and then click on the next button. step 4. click on the next button. step 5. check the specify location box, uncheck all other boxes, and click on the next button. step 6. type a:\w2k and click on the ok button. step 7. click on the next button on the driver files search results window. step 8. click on the finish button to complete the driver installation. step 9. repeat this process for the second channel, if one is present. 7.6.2 performance tuning the windows 2000 operating system has registry entries that you can use to tune the performance of scsi i/o for certain con?urations. the tunable parameters are the large transfer block size support and the guaranteed number of concurrent i/os for a particular scsi bus. 7.6.2.1 large block size support the symmpi.sys drivers can support up t oa1mbytetr ansfer size in a windows 2000 system; however, the default windows 2000 transfer size is 64 kbytes. to enable better performance, the driver installation process adds a registry entry to enable 256 kbytes transfer sizes. programmers can also use the mpi_256k.reg ?e to set or re-enable the maximum transfer size. there are two methods to add this registry setting. the ?st method is to locate the mpi_256k.reg data ?e using windows explorer, double-click on the ?e, and edit it. the second method is to type at the command prompt: regedit mpi_256k.reg this command inserts an entry in the registry to enable 256 kbytes block size support. editing the mpi_256k.reg data ?e can set any maximum block size between 64 kbytes and 1 mbyte. the formula to calculate the proper value for maximumsglist is: maximumsglist = [(maximum block size)/4 kbytes] + 1
windows 2000 driver installation 7-19 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. as an example, to determine the maximumsglist value for 256 kbytes, take [(256 kbytes/4 kbytes) +1] = 65 (or 0x41 in hexadecimal). the maximum value allowed for maximumsglist is 255 or 0xff. for the particular value of 0xff, the internal value passed to windows 2000 is increased to 0x101, allowing support for a full 1 mbyte transfer. read the information in the mpi_256k.reg data ?e before editing it. the system must reboot 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 ?e. 7.6.2.2 maximum number of concurrent i/os (guaranteed) windows 2000 guarantees a maximum of 32 concurrently active i/os on a particular scsi bus. due to the method of memory allocation, the actual limit of concurrent i/os can vary between various drivers or versions of drivers. this can have a signi?ant impact on performance benchmarking between different driver versions or adapter vendors. in effect, one adapter could support 80 outstanding i/os, while another adapter could only support 32 outstanding i/os. 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, programmers can use the mpi100io.reg data file to add a registry entry that set the maximum numbers of concurrent i/os. there are two methods to add this registry setting. one method is to locate the mpi100io.reg data file using windows explorer, double-click on the file, and edit it. the other method is to type at the command prompt: regedit mpi100io.reg this command inserts an entry in the registry to guarantee a maximum of 100 concurrent i/os per adapter. note: setting this value to a high number uses increasing amounts of nonpaged pool memory, which is a critical windows 2000 resource. high values for this setting can degrade system performance.
7-20 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. be sure to read the information in the mpi100io.reg data ?e before editing it. you must reboot system for the new registry setting to take effect. to reset the guaranteed number of concurrent i/os to the windows 2000 default of 32, follow the instructions above but use mpidefio.reg as the data ?e. 7.7 windows.net driver installation this section describes the symmpi.sys driver for the windows.net operating system. it provides instructions for existing system installations and includes these topics: ? section 7.5.1, ?nstalling the symmpi.sys driver ? section 7.5.2, ?erformance tuning this driver supports only windows window.net. 7.7.1 installing the symmpi.sys driver the following procedures installs the symmpi.sys driver onto a new or existing windows.net system. 7.7.1.1 new system installation this procedure installs the symmpi.sys driver onto a new windows.net system. windows.net automatically adds the driver to the registry and copies the driver to the appropriate directory. the system bios must support booting from a cd-rom. bios settings might require changes to allow cd-rom booting. refer to your system documentation. step 1. start the windows.net installation by booting from the windows.net cd-rom. the system bios must support booting from a cd-rom. bios settings might require changes to allow cd-rom booting. refer to your systems documentation.
windows.net driver installation 7-21 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 2. press f6 to install the symmpi.sys driver when the screen displays: ?ress f6 if you need to install... note: you must press f6 for the system to recognize the new driver. otherwise, the system does not recognize the devices controlled by the driver during the windows setup. step 3. choose s to specify an additional device when the screen displays: ?etup could not determine the type... note: if this screen is not displayed as the ?st user input, then the f6 key press was not seen by the setup program. reboot the system and return to step 2. the system prompts for the manufacturer-supplied hardware support disk. step 4. insert the windows.net driver diskette and press enter. step 5. select the appropriate windows.net driver from the menu by highlighting it. press enter to proceed. step 6. follow the windows.net installation procedure from this point. 7.7.1.2 existing system installation this procedure installs or upgrades the symmpi.sys driver onto an existing window.net system. step 1. boot windows.net. the found new hardware wizard appears. the information on the ?st page of this window identi?s the scsi controller and requests the driver diskette. step 2. insert the windows.net driver diskette into the ?ppy drive. step 3. choose the install software automatically option. step 4. click on next button. step 5. in some cases, a message displays saying that this driver is not digitally signed. this message informs you that a nonsigned driver is being installed. click on continue anyway.
7-22 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 6. the system loads the driver from the windows.net driver diskette and copies the driver to the system disk. the found new hardware wizard screen appears and displays the message: ?he wizard has finished... step 7. click on the finish button to complete the driver upgrade. step 8. repeat this process for the second channel, if one is present. 7.7.2 performance tuning windows.net offers registry entries that can tune the performance of scsi i/o for certain con?urations. the tunable parameters are the large transfer block size support and the guaranteed number of concurrent i/os for a particular scsi bus. 7.7.2.1 large block size support the symmpi.sys drivers can support up to a 1 mbyte transfer size in windows.net; however, the default windows.net transfer size is 64 kbytes. to enable better performance, the driver installation process adds a registry entry to enable 256 kbytes transfer sizes. programmers can also use the mpi_256k.reg ?e to set or re-enable the maximum transfer size. there are two methods to add this registry setting. the ?st method is to locate the mpi_256k.reg data ?e using windows explorer, double-click on the ?e, and edit it. the second method is to type at the command prompt: regedit mpi_256k.reg this command inserts an entry in the registry to enable 256 kbytes block size support. editing the mpi_256k.reg can set any maximum block size between 64 kbytes and 1 mbyte. the formula to calculate the proper value for maximumsglist in a 32-bit os is: maximumsglist = [(maximum block size)/4 kbytes] + 1
windows.net driver installation 7-23 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. for 64-bit systems, the os page size is 8 kbytes instead of 4 kbytes. therefore, the maximum transfer size is 2 mbytes, the default driver installation enables support for 512 kbytes transfer size, and the formula to calculate the maximumsglist is: maximumsglist = ((maximum block size)/8 kbytes) +1 as an example, to determine the maximumsglist value for 256 kbytes in a 32-bit os, take [(256 kbytes/4 kbytes) +1] = 65 (or 0x41 in hexadecimal). the maximum value allowed for maximumsglist is 255 or 0xff. for the particular value of 0xff, the internal value passed to windows.net is increased to 0x101, allowing support for a full 1 mbyte transfer. read the information in the mpi_256k.reg data ?e before editing it. the system must reboot 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 ?e. 7.7.2.2 maximum number of concurrent i/os (guaranteed) windows.net guarantees a maximum of 32 concurrently active i/os on a particular scsi bus. due to the method of memory allocation, the actual limit of concurrent i/os can vary between various drivers or versions of drivers. this can have a signi?ant impact on performance benchmarking between different driver versions or adapter vendors. in effect, one adapter can support 80 outstanding i/os, while another adapter can only support 32 outstanding i/os. 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, programmers can use the mpi100io.reg data file to add a registry entry that sets the maximum numbers of concurrent i/os. there are two methods to add this registry setting. one method is to locate the mpi100io.reg data file using windows explorer, double-click on the file, and edit it. the other method is to type at the command prompt: regedit mpi100io.reg this command inserts an entry in the registry to guarantee a maximum of 100 concurrent i/os per adapter.
7-24 windows driver installations version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. note: setting this value to a high number uses increasing amounts of nonpaged pool memory, which is a critical windows.net resource. high values for this setting can degrade system performance. be sure to read the information in the mpi100io.reg data ?e before editing it. you must reboot system for the new registry setting to take effect. to reset the guaranteed number of concurrent i/os to the windows.net default of 32, follow the instructions above but use mpidefio.reg as the data ?e. 7.8 troubleshooting the symmpi.sys driver logs error messages to the system error log. for these errors, the system error log eventid is 11, and the speci? error code values are displayed at offset 0x10. data is displayed in words.
FUSION-MPT device management users guide 8-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 8 unix operating system device drivers this chapter describe the FUSION-MPT device driver for various unix operating systems. this chapter contains the following sections: ? section 8.1, ?olaris 8 device driver installation ? section 8.2, ?nixware 7 and open unix 8 device driver installation ? section 8.3, ?co openserver 5 device driver installation ? section 8.4, ?inux device driver installation 8.1 solaris 8 device driver installation this section describes version 5.04.00 of the FUSION-MPT device driver for the solaris 8 operating systems. this section includes the following subsections: ? section 8.1.1, ?ntroduction ? section 8.1.2, ?uilding the lsimptsl driver update diskette ? section 8.1.3, ?nstalling the FUSION-MPT solaris driver ? section 8.1.5, ?roubleshooting 8.1.1 introduction the solaris 8 operating system for x86 runs on single or multiple processors. it provides a command line interface environment and a graphical environment that incorporates many high level features. refer to the sun microsystems web site ( http://www.sun.com/docs )for solaris 8 x86 documentation. the FUSION-MPT driver package, lsimptsl , allows the solaris 8 operating system to interface with FUSION-MPT devices.
8-2 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. caution: all other users must be logged off the system when performing this upgrade. also, any server applications must be shut down before performing this procedure. lsi logic recommends placing the system in single user mode because this prevents many services from running and prevents other users from logging in. note: lsi logic has tested this driver software on the solaris 8 01/01 and 04/01 releases. lsi logic assumes no responsibility or liability when a user attempts to use this software with other versions of solaris. 8.1.1.1 features the lsimptsl driver package supports these features: ? meets the sun microsystems sun scsi common architecture (scsa) speci?ations for device drivers ? 1 gbaud fc data transfers (100 mbytes/s) ? 2 gbaud fc data transfers (200 mbytes/s) ? ultra320 scsi (320 mbytes/s) ? multiple host adapters ? multiple and noncontiguous logical unit number (lun) support ? scatter/gather ? tagged command queuing ? multiprocessor safe 8.1.1.2 lsi logic devices supported the lsimptsl driver package supports the following devices and their associated host adapters: ? lsi53c1030 dual channel ultra320 scsi controller ? lsi53c1020 single channel ultra320 scsi controller ? lsifc929 dual port 2 gbaud fc controller ? lsifc919 single port 2 gbaud fc controller ? lsifc909 single port 1 gbaud fc controller
solaris 8 device driver installation 8-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.1.2 building the lsimptsl driver update diskette before proceeding to the installation instructions, create an lsimptsl driver update diskette for solaris installations. do this by copying the raw dd image ?e onto a 1.44 mbyte diskette. the image ?e is named lsimptsl.dd. building the driver update diskette is dependent upon the operating system that you are using. note: the current solarix x86 FUSION-MPT driver is also available from the lsi logic web site at http://www.lsilogic.com. 8.1.2.1 solaris systems follow these steps to create the lsimptsl driver diskette on a solaris system: step 1. insert a clean 3.5-inch diskette into the ?ppy diskette drive. step 2. at the shell prompt, type: #volcheck -v #dd if=//lsimptsl.dd of=/vol/dev/aliases/floppy0 bs=32768 #eject floppy is the path to the directory holding the lsimptsl.dd. the ?d command copies the image to the ?ppy diskette. step 3. label this diskette ?simptsl driver diskette. 8.1.2.2 for dos of windows system users to create the lsimptsl driver update diskette, use a utility that copies the raw dd image onto a 1.44 mbyte diskette. lsi logic recommends the fdimage.exe program, which is a public utility. this program and operating instructions are available through the world wide web or cd-rom. the fdimage utility is available from the lsi logic web site. to create the lsimptsl driver diskette, follow these steps: step 1. insert a formatted 3.5-inch (1.44 mbyte) diskette into the ?ppy drive. step 2. at the command prompt, type: fdimage -qv lsimptsl.dd a:
8-4 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. note: this command works when running ms-dos, windows 9x, windows me, windows nt, or windows 2000 operating systems. if you are running anti-virus software, lsi logic recommends that you temporarily disable it when running the fdimage program. otherwise, the fdimage program might not be able to get exclusive access to your ?ppy drive, which it requires to write the image to a diskette. step 3. label the diskette ?simptsl driver. step 4. use this diskette for solaris 8 installations when the system prompts you to insert the driver diskette. 8.1.3 installing the FUSION-MPT solaris driver this section provides the lsimptsl driver installation instructions for new and existing systems. 8.1.3.1 new system installation follow the steps below to install the lsimptsl driver diskette on a new solaris (intel platform edition) system. if booting from a solaris device con?uration assistant diskette, make sure to use the diskette appropriate for the release of solaris 8. step 1. insert the boot media and boot the system. for network installations, verify with the system administrator that the solaris network installation image is available on the network. step 2. choose f4_add driver when the solaris device con?uration assistant screen appears. the message enumerating buses... appears. then, the install driver update screen appears. step 3. remove the diskette and insert the solaris driver itu diskette. step 4. press f2_continue. the select solaris system version screen appears.
solaris 8 device driver installation 8-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 5. select the appropriate solaris operating system, and press f2_continue. the loading driver update software screen appears, along with a progress bar that shows the percentage of drivers that have been extracted from the diskette. when the new drivers on the diskette have loaded, the continue driver update installation screen appears. step 6. repeat step 3 to step 5 until all the needed solaris driver itu diskettes are installed. step 7. remove the solaris driver itu diskette. if you booted from the solaris device con?uration assistant diskette, reinsert it into the diskette drive. impor tant: do not remove the solaris device con?uration assistant diskette from the drive until the systems displays the following message: ?f you want to bypass the device configuration and boot screens when the system reboots, eject the device configuration assistant/boot diskette now. step 8. press f2_continue. the solaris device con?uration assistant screen appears. step 9. press f2_continue. the message enumerating buses... appears. the system scan the devices and displays the scanning devices screen. when ?ished, the system displays the identi?d devices screen. step 10. press f2_continue. the system displays a loading driver... message and messages about required drivers. after a few seconds, the system displays the boot solaris screen. step 11. select the device controller attached to the device that contains the installation medium. step 12. press f2_continue. the system displays the drivers for the selected device controller. the system starts the installation program and boots the complete solaris 8 operating environment.
8-6 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 13. the following messages appear and prompt for each of the solaris driver itu diskette(s) : ?nstalling unbundled device driver support extracting driver list from tree.. driver-name... please insert the driver update diskette labeled press when ready. step 14. remove the solaris device con?uration assistant diskette. step 15. re-insert the lsimptsldrive itu diskette and press enter. the system installs packages and/or patches that contain the new drivers from the diskette. step 16. the system prompts: please insert the driver update diskette labeled press enter when ready. step 17. insert the lsimptsl driver itu diskette into the ?ppy drive. step 18. the system prompts to create a new instance of the lsimptsl package. respond n and press enter. step 19. the system prompts overwrite the existing instance of lsimptsl driver. respond y and press enter. step 20. if drivers on other solaris driver itu diskettes are required, remove the driver itu diskette from the diskette drive, insert the next driver itu diskette when the system prompts for it, and press enter. step 21. repeat step 20 until all the required drivers are installed. when the installation completes, the system displays: ?nstallation complete. step 22. remove the diskette from the diskette drive. step 23. reboot the system. when the solaris operating environment has ?ished booting and is running, the new devices are available for use.
solaris 8 device driver installation 8-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.1.3.2 existing system installation before adding new or updated drivers, install and con?ure new hardware devices according to the instructions in the corresponding device reference page. when the solaris intel platform edition software is already installed, the simplest way to add new or updated drivers is to install the lsimptsl driver diskettes as patches. for more information about managing diskettes and drives, see the system administration guide. to add new or updated drivers, follow these steps: step 1. go to the root directory. step 2. to see if the volume management software is running on the machine that you are updating, type: # ps -ef | grep vold step 3. to stop volume management temporarily if it is running, type: # /etc/init.d/volmgt stop step 4. insert the solaris driver itu diskette into the diskette drive. step 5. mount the solaris driver itu diskette at the /mnt mount point: # mount -f pcfs /dev/diskette /mnt you must mount the solaris driver itu diskette at this point in the ?e structure to update the system successfully. step 6. execute the install script on the diskette: # /mnt/du/sol_28/i86pc/tools/install.sh -i the install.sh script searches for all new or updated drivers on the diskette. when a new or updated driver is found, this prompt appears: unconditionally installing itus do you want to create a new instance of this package [y, n, ?, q] step 7. if the driver is the one that you want to install, type y or press enter. if the driver is not the one you want to install, type n . if you specify yes, the install.sh script installs the indicated driver as well as the bootmod and bootbin patches.
8-8 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 8. when the installation completes and the install.sh script extis, unmount the diskette by typing: # cd / # umount /mnt step 9. remove the solaris driver itu diskette from the diskette drive. step 10. reboot your machine by typing: # reboot step 11. if you have not already done so, turn off your system, add the new hardware, and reboot your system. step 12. at the << current boot parameters >> prompt, type: b -r to force recon?uration of the machine. the new devices are available for use when the solaris operating environment ?ishes booting and is running. 8.1.4 upgrading the symcasl driver to lsimptsl this section provides instructions describing how to upgrade a system currently using the lsi logic symcasl driver with the lsimptsl driver. use the normal installation procedure documented in section 8.1.3.2, ?xisting system installation, to upgrade the lsimptsl driver to a newer version. caution: the following procedure can cause permanent data loss. lsi logic strongly recommends backing up all data before proceeding with this upgrade. lsi logic recommends that only experienced solaris system administrators perform this procedure. the following steps outline the procedure to upgrade the symcasl driver the lsimptsl driver. step 1. log on as root or use the su command to get super-user privileges. step 2. mount the lsimptsl driver package using the volcheck command. change working directories to: /floppy/floppy0/du/sol_28/i86pc/tools
solaris 8 device driver installation 8-9 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 3. remove the symcasl driver package using the pkgrm command. step 4. run the install.sh shell script in the current working directory. step 5. reboot your system into single-user state. this is a recon?uration boot. log in as root. step 6. edit the /etc/path_to_inst ?e and remove any lines containing symcasl. the path_to_inst ?e does not have write permissions. it is necessary either to change the permission of the ?e using the chmod command, or to use the forced write command (for the vi-editor, this is :w! ?. step 7. reboot the system using the reboot command. do not perform a recon?uration boot because the changes to the path_to_inst ?e will be lost. 8.1.5 troubleshooting this section lists some potential error messages. in the message descriptions below, the system replaces the with a number of the scsi bus that is reporting the error. and are placeholders for strings and numbers that the operating system displays. message: lsimptsl: this hardware not supported by this driver cause/solution: the lsimptsl driver was asked to control an lsi53c1030, lsi53c1020, lsifc929, lsifc919, or lsifc909 located on a host adapter board (hab) that is manufactured by a company other than lsi logic. this hab requires a special driver provided by that manufacturer. contact the manufacturer for assistance. message: lsimptsl: failed to map device registers cause/solution: the lsimptsl driver could not access the hardware registers necessary for operation. the operating system did not properly con?ure the pci device.
8-10 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. message: lsimptsl: hardware not properly enabled by system, cmd=0x cause/solution: the system has not properly enabled the con?uration resources that the lsimpts l driver requires to use this hardware. report the cmd=0x value to lsi logic technical support at 719-533-7230. message: lsimptsl: unsupported 64-bit register address. please load 64-bit version of kernel and driver cause/solution: this version of the lsimptsl driver does not support physical addresses using 64-bit values. contact lsi logic technical support at 719-533-7230 to determine if a new driver is available to support 64-bit version. an updated driver may also be located on the lsi logic web page at: http://www.lsilogic.com . message: lsimptsl: the host adapter id in the .conf file is being ignored because the scsi bios configuration utility will override it. cause/solution: the lsimptsl.conf ?e has a line (scsi-initiator-id=x) to change the host adapter scsi id. this line is being ignored because the scsi bios con?uration utility has set the scsi id. please use the scsi bios con?uration utility to change the scsi id. message: lsimptsl: ignored invalid scsi-initiator-id value = cause/solution: the lsimptsl.conf ?e has an invalid scsi-initiator-id value. the allowable values are between 0 and 128. message: lsimptsl: property value is too large. using maximum value of cause/solution: a property value in the lsimptsl.conf value is greater than the maximum allowed value. the driver uses the value instead. message: lsimptsl: property value is too small. using default value of
solaris 8 device driver installation 8-11 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. cause/solution: a property value in the lsimptsl.conf value is less than the minimum allowed value. the driver uses the value instead. message: lsimptsl: could not allocate memory to read configuration data cause/solution: the driver could not allocate the memory required to process the con?uration data. this is because the con?uration was not properly determined. to ? this problem, manually con?ure the driver using the lsimptsl.conf ?e. message: lsimptsl: configuration data is corrupt and will be ignored cause/solution: the con?uration data provided by the scsi bios con?uration utility has been determined to be corrupted. run the scsi bios con?uration utility to correct this error. message: lsimptsl: unable to make reset notification callbacks cause/solution: the driver could not notify the target device driver of a scsi bus reset. this error might cause the target driver to malfunction. message: lsimptsl: disabling queue tags for target id cause/solution: the lsimptsl driver determined that the target is not responding properly to queue tagged i/os and has disabled queue tags for the device. this is usually because the device does not support queue tags. to disable this message, disable queue tags for the given device using the fc bios con?uration utility. message: device (id=, lun=) not supported cause/solution: a solaris target driver attempted to initialize a device whose target id is out of the supported range or whose lun is not zero. this warning is most likely triggered by illegal entries in the target driver conf ?e.
8-12 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. messages: lsimptsl: ddi_dma_sync() failed for data buffer. data corruption may occur. lsimptsl: ddi_dma_sync() failed for i/o data at . data corruption may occur. lsimptsl: ddi_dma_sync() failed for adapter data. data corruption may occur. cause/solution: a call to the operating system ddi_dma_sync function failed. the system data caches might not be properly synchronized with system main memory, which results in data corruption or a driver failure. messages: lsimptsl: ddi_dma_numwin() failed lsimptsl>: ddi_dma_getwin() failed lsimptsl: ddi_dma_alloc_handle: 0x unknown/impossible lsimptsl: ddi_dma_buf_bind_handle: ddi_dma_inuse impossible lsimptsl: ddi_dma_buf_bind_handle: 0x unknown/impossible lsimptsl: ddi_dma_unbind_handle: failed cause/solution: the operating system did not respond to the named routine in a known manner. this is a fatal error that is not recoverable. report this error to lsi logic technical support at 719-533-7230. messages: lsimptsl: device in a slave-only slot and is unusable lsimptsl: hi-level interrupts not supported. cause/solution: the adapter is in a slot that cannot be used with this driver. move the adapter to a different pci slot. message: lsimptsl: failed to attach. this adapter will not be installed. cause/solution: because of the previous error, this adapter could not attach to the i/o subsystem and is not accessible. see the previous error message and solve that problem.
solaris 8 device driver installation 8-13 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. messages lsimptsl: failed to allocate memory cause/solution: the lsimptsl driver could not allocate the memory needed during initialization. message: lsimptsl: unbind failed! cause/solution: the driver could not unload itself. this is a fatal error. message: lsimptsl: unable to obtain soft state structure. cause/solution: the driver could not initialize a required data structure and did not load. please call technical support at 719-533-7230. message: lsimptsl: failed to attach interrupt handler cause/solution: the driver could not initialize the interrupt handler. please call technical support at 719-533-7230. messages: lsimptsl: the adapter is malfunctioning. lsimptsl: the adapter is either malfunctioning, of an unknown type, or a revision that isn? supported. cause/solution: the driver is not able to communicate with hardware. update the device driver or the hardware. device driver updates are available on the lsi logic web site at http://www.lsilogic.com . message: lsimptsl: could not attach to the scsi subsystem cause/solution: the lsimptsl driver could not communicate with the solaris scsa subsystem. update the device driver. device driver updates are available on the lsi logic web site at http://www.lsilogic.com .
8-14 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.1.6 solaris sparc this section provides instructions for installing the solaris sparc FUSION-MPT driver and includes these topics: ? section 8.1.7, ?ntroduction ? section 8.1.8, ?nstalling the fc host adapters ? section 8.1.9, ?nstalling the solaris sparc driver ? section 8.1.10, ?roubleshooting 8.1.7 introduction the FUSION-MPT driver, itmpt , allows the solaris sparc operating system to interface with the fc lsifc919 and lsifc929 controllers. this FUSION-MPT driver is optimized for low cpu overhead and high i/o throughput, making use of the FUSION-MPT architecture. lsi logic fc host adapters have built-in fcode, designed to operate in the sun openboot environment, allowing fc devices to be available to the openboot (ok) prompt. this driver minimizes cpu utilization through including interrupt coalescing, which can result in less than one interrupt per i/o. to preserve a consistent mapping between solaris target ids and fc target devices, the driver maintains a con?uration ?e with entries that map each solaris target id to an fc target world wide name (wwn). this is done for all fc target devices, and is in addition to the root boot persistent target id selection, which is con?urable through the fcode bios. by default, the itmpt driver does not maintain persistent bindings between targets and wwns. however, lsi logic recommends persistent bindings for most raid controllers, such as the metastor raid product. to con?ure persistent bindings, lsi logic provides the lsiadm utility and the lsiprobe utility to con?ure the driver. to facilitate updates to the adapter in a native solaris environment, lsi logic provides the lsiupdate utility. table 8.1 describes these three utilities.
solaris 8 device driver installation 8-15 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.1.7.1 features the solaris sparc FUSION-MPT driver supports these features: ? FUSION-MPT interface for fc, scsi, and raid devices using a single binary image. ? a highly ef?ient, low cpu usage architecture. ? 66 mhz/64-bit pci interface support provides maximum i/o bandwidth. ? multiple host adapters. ? multiple luns. ? scatter/gather. ? disk array con?urations with no lun 0. ? disk array con?urations with noncontiguous luns. ? multiprocessor environments. the lsiadm, lsiprobe, and lsiupdate solaris sparc utilities support these features: ? con?ures persistent bindings between targets and wwns (lsiadm) ? con?ures extended lun support (lsiprobe) ? updates the int13h bios, fcode, and FUSION-MPT ?mware that reside on lsifc919 and lsifc929 controllers (lsiupdate) table 8.1 solaris sparc utilities solaris utilities description lsiadm maintains persistent bindings between targets and wwns by automatically adding bindings to or deleting bindings from the /kernel/drv/itmpt.conf ?e, that the i tmpt driver uses. lsiprobe automatically adds the extended lun support to or deletes extended lun support from the /kernel/drv/ssd.conf ?e that the itmpt driver uses. lsiupdate updates the int13h bios, fcode, and FUSION-MPT ?mware that reside on the lsifc919 and lsifc929 controllers from a running solaris machine. this utility communicates through icctls to the itmpt driver to perform the updates.
8-16 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.1.7.2 lsi logic devices supported the lsi logic solaris sparc itmpt driver supports the lsifc929, lsifc919, lsi53c1030, and lsi53c1020 controllers and their associated host adapters. 8.1.8 installing the fc host adapters this section provides system requirements for installing your fc host adapter(s). 8.1.8.1 system requirements table 8.2 lists the solaris sparc system resources that are required to install the fc host adapters. after installing the module in an appropriate pci slot and making all the necessary internal and external connections to the module, follow the steps in section 8.1.8.2, ?erifying correct installation . 8.1.8.2 verifying correct installation use this procedure to verify installation of your fc host adapters before booting your system: step 1. power on the system. the system displays a banner. step 2. press the stop-a keys to interrupt the boot process and stop at the ok prompt. step 3. use the show-devs command to list the system devices. for example, type: table 8.2 solaris sparc resource requirements resource requirement host bus slot sun solaris system with available pci slot operating system solaris 2.6 release or later network boot server sparc or intel solaris boot server 1 1. only required if using the lsi logic module to support your system disk. firmware openboot prom version 3.0 or greater 1
solaris 8 device driver installation 8-17 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ok show-devs the system displays output similar to: /sunw,ultrasparc-iii@0,0 /pci@1f,0 /virtual-memory /memory@0,10000000 /aliases /options /openprom /chosen /packages /pci@1f,0/pci@1 /pci@1f,0/pci@1,1 /pci@1f,0/pci@1/pci@2 /pci@1f,0/pci@1/intraserver,ultra2-scsi@1 /pci@1f,0/pci@1/pci@2/intraserver,fc@4 /pci@1f,0/pci@1/pci@2/intraserver,fc@4/disk /pci@1f,0/pci@1/pci@2/intraserver,fc@4/tape /pci@1f,0/pci@1/intraserver,ultra2-scsi@1/tape /pci@1f,0/pci@1/intraserver,ultra2-scsi@1/disk /openprom/client-services note: the above output is an example. the output of show-devs depends on the system con?uration. use the entries corresponding to your system, not those given here. step 4. if adapter is not listed, check that it is correctly installed. reseat the adapter if necessary.
8-18 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.1.8.3 identifying the fc disks the probe-scsi-all command identi?s the fc disk devices on the lsi logic fc host adapter. to display this information, type: ok probe-scsi-all the system displays output similar to: /pci@1f,0/pci@1/intraserver,ultra2-scsi@1 target 0 unit 0 disk ibm dnes-309170w sa30 /pci@1f,0/pci@1/pci@2/intraserver,fc@7 mpt firmware version 1.00 target 0 unit 0 disk seagate st39173fc 6615 wwn 220000203710d063 id 111d2 target 1 unit 0 disk seagate st39173fc 6258 wwn 220000203710c09b id 111d6 target 2 unit 0 disk seagate st39173fc 6258 wwn 220000203710b066 id 111d5 target 3 unit 0 disk seagate st39173fc 6258 wwn 220000203710b063 id 111d3 target 4 unit 0 disk seagate st39173fc 6258 wwn 220000203710b04f id 111d4 target 5 unit 0 disk seagate st39173fc 6615 wwn 2200002037104f73 id 111d9 target 6 unit 0 disk seagate st39173fc 6615 wwn 2200002037102d0f id 111d1 if the fc disks on the lsi logic fc host adapter are not identi?d by the system, check the following: ? are all the fc cables correctly connected to the disk enclosure? ? is the disk enclosure powered up? ? if the external disk enclosure requires a loopback connector, is the loopback connector correctly installed?
solaris 8 device driver installation 8-19 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.1.9 installing the solaris sparc driver the lsi logic lsifc919 and lsifc929 controllers use the itmpt fc FUSION-MPT driver for solaris. this FUSION-MPT driver is included with the host adapter kit. note: if using an lsi logic fc host adapter for your system disk, use the network installation procedure to load the device driver during installation. 8.1.9.1 existing system installation these instructions provide instructions for installing the FUSION-MPT itmpt driver to an existing solaris operating system. note: log on as root to perform the installation. to create a directory named install, follow these steps; step 1. uncompress and untar the itmpt_install.tar.z ?e by typing the following commands: # uncompress itmpt_install.tar.z # tar -xvf itmpt_install.tar # cd install step 2. load the itmpt driver using the pkgadd command by typing: pkgadd -d . the system displays: the following packages are available: 1 itimpt lsi logic/intraserver fusionmpt(tm) fibrechannel/scsi drivers (sparc) itmpt kit version 1.3 select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]: 1 processing package instance from lsi logic/intraserver fusionmpt(tm) fibrechannel/scsi drivers (sparc) itmpt kit version 1.3 intraserver technology, inc / lsi logic using as the package base directory. ## processing package information. ## processing system information. 2 package pathnames are already properly installed. ## verifying disk space requirements.
8-20 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ## checking for conflicts with packages already installed. ## checking for setuid/setgid programs. this package contains scripts which will be executed withsuperuser permission during the process of installing this package. do you want to continue with the installation of [y,n,?] y installing lsi logic/intraserver fusionmpt(tm) fibrechannel/scsi drivers as ## installing part 1 of 1. /kernel/drv/itmpt /kernel/drv/itmpt.conf [ verifying class ] ## executing postinstall script. installing /kernel/drv/sparcv9/itmpt updating /kernel/drv/ssd.conf with itmpt entries... entries added. for support of more than 15 targets or nonzero luns it may be necessary to edit /kernel/drv/ssd.conf to addadditional entries. following installation, please reboot the system to properly configure and load the drivers. installation of was successful. 8.1.9.2 network system installation if the lsi logic fc host adapter supports a solaris sparc system disk, install the solaris operating system using a network installation. this section describes a complete installation of solaris to a client system using lsi logic fc adapters for the system disk. the method described in this section installs the lsi logic itmpt driver onto a network boot kit, making it available during the sparc installation process. if the lsi logic fc host adapter is an additional storage adapter in an existing system, use the driver installation procedure as follows:
solaris 8 device driver installation 8-21 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. setting up a boot/install server refer to the ?reparing to install solaris software over the network section of the solaris advanced installation guide , available at http://docs.sun.com . to set up a boot and install server, follow these steps: step 1. insert the solaris distribution cd-rom in your boot/install server's cd-rom drive. step 2. change the directory to the tools area on your solaris distribution cd-rom: cd /cdrom/cdrom0/solaris_2.7/tools step 3. use the setup_install_server script to copy the boot and installation ?es to the boot/install server: ./setup_install_server /export/home/install installing the itmpt driver on the boot/install server to install the itmpt driver on the boot/install server, and run the install.sh script with the ? parameter to copy the driver kit to the boot server's boot ?es: step 1. place the diskette in the ?ppy drive and execute the volcheck command. step 2. change the directory to the root of the ?ppy: cd /floppy/floppy0 step 3. execute the install.sh shell script to add the itmpt driver to the boot installation area. type at the command prompt the following command along with the appropriate directory (all on one line): ./install.sh -n for solaris 2.7 boot ?es, the directory is /export/home/install/solaris_2.7 for solaris 2.8 boot ?es, the directory is /export/home/install/solaris_2.8 the system displays a message that can safely be ignored: major number maximum based on server, not client running the install.sh script copies and installs the FUSION-MPT drivers into the tools/boot/ area of the boot ?es and allows the boot server to boot fc host adapters for installation.
8-22 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. adding clients to your boot/install server for each machine that boots into the boot/install server, follow these steps to add a client entry on the boot/install server: step 1. change the directory to the boot/install kit (either solaris 2.7 or solaris 2.8): cd /export/home/install/solaris_2.7/tools step 2. use the add_install_client script to add the client machine by typing at the command prompt: ./add_install_client -i ipaddr -e ethernetid client_name platform_group where: ipaddr is the tcp/ip address of the client ethernetid is the ethernet hardware (mac) address of the client client_name is the client's system name platform_group is the client's vendor de?ed hardware group an example is: ./add_install_client -i 192.168.103.124 -e 00:08:26:02:25:34 sunsys sun4u note: obtain the platform_group from a machine of the same type as the target client using the uname -m command.
solaris 8 device driver installation 8-23 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. booting the client using the boot/install server begin the installation of the solaris operating system to the client target machine using the boot and install server. to boot the network install kit on the client machine, follow these steps. step 1. type this command at the openboot prompt: ok boot net -v step 2. choose ?anual reboot rather than ?uto reboot during the installation of solaris on the target machine. auto reboot does not provide the opportunity to complete the installation of the fc FUSION-MPT drivers, and the system fails to boot. after the system installs the solaris operating system, the system waits for a manual reboot. step 3. proceed to a console window and run the /sbin/itmptinst script, which copies and installs the drivers from the boot server to the newly created solaris installation. after this script completes, the FUSION-MPT device driver installation is complete. step 4. manually reboot the system. the system displays a message that can safely be ignored: major number maximum based on server, not client step 5. the solaris sparc system prompts to allow power saving automatic shutdown. step 6. respond no if you are using the fc host adapter to support your boot disk. if the disk drive con?uration of the machine changes, it might be necessary to issue the command: touch /reconfigure. then, reboot the system so that the system can detect and correctly install the new disks. 8.1.10 troubleshooting refer to the lsi logic 2 gbit/s pci to fibre channel host adapter users guide for troubleshooting techniques.
8-24 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.2 unixware 7 and open unix 8 device driver installation this chapter describes the FUSION-MPT driver version 1.03.04 for the unixware 7 and open unix 8 operating systems. this document refers to both operating systems as ?nixware. this chapter includes the following sections: ? section 8.2.1, ?ntroduction ? section 8.2.2, ?uilding the FUSION-MPT driver diskette ? section 8.2.3, ?nstalling the unixware FUSION-MPT driver ? section 8.2.4, ?roubleshooting use FUSION-MPT driver version 1.03.00 for unixware. 8.2.1 introduction unixware software extends the unix svr4.2 operating system. unixware features include a graphical user interface (gui), networking, application compatibility, multitasking capability, and multiuser capability. the FUSION-MPT device driver allows unixware operating systems to interface with FUSION-MPT devices. the unixware FUSION-MPT driver supports the lsi53c1030, lsi53c1020, lsifc929, lsifc919, and lsifc909 devices and their associated lsi logic host adapters. 8.2.1.1 features the unixware FUSION-MPT driver supports these features: ? easy installation using unixware tools ? multiple host adapters ? multiple and noncontiguous logical unit numbers (luns) ? dynamic interrupt mapping ? scatter/gather ? pass-through functionality ? 1 ultra320 scsi bus with 15 scsi devices per bus ? 8 fc buses with 16 fc devices per bus
unixware 7 and open unix 8 device driver installation 8-25 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.2.1.2 driver diskette description the FUSION-MPT driver for unixware operating systems is available on a 3.5-inch diskette labeled ?usion-mpt unixware driver. use this diskette to load the driver during the installation of the operating system, or to access attached devices after a unixware installation. the following sections describe these procedures. the current unixware FUSION-MPT driver is also available from the lsi logic web site at http://www.lsilogic.com . 8.2.2 building the FUSION-MPT driver diskette to create a FUSION-MPT driver diskette to use with unixware 7 from the raw dd image ?e, copy the raw dd image ?e onto a 1.44 mbyte diskette. the dd image ?e is in the zipped ?e that was downloaded from the lsi logic web site. the following sections describe this process for unix and dos operating systems. 8.2.2.1 unix system users follow these steps to create the unix FUSION-MPT driver diskette on a unix system: step 1. insert a blank 3.5-inch (1.44 mbyte) diskette. step 2. type: dd if=//unixware.dd of=/dev/fd0 in this command, is the path the directory where the dd image ?e resides. this command copies the raw dd image ?e to the blank diskette. step 3. label this diskette ?usion-mpt driver diskette.
8-26 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.2.2.2 dos system users follow these steps to create the unixware FUSION-MPT driver diskette on a dos system: step 1. copy the raw dd image onto a 1.44 mbyte diskette. the rawrite3.com utility, which is a public domain utility, can perform this copy. the rawrite3.doc ?e provides instructions for using this utility. rawrite3.com and rawrite3.doc are in the zipped ?e downloaded from the lsi logic web site at http://www.lsilogic.com . step 2. label the diskette ?usion-mpt driver diskette. 8.2.3 installing the unixware FUSION-MPT driver this section provides installation instructions for new and existing unixware systems. 8.2.3.1 new system installation step 1. boot the system using the installation diskettes or cd-roms in the unixware operating system media kit. step 2. follow the instructions on the screen. step 3. insert the FUSION-MPT driver diskette when the installation prompts for the host adapter diskette. the system loads the required drivers and indicates when ?ished. at the end of the installation, the system prompts you to reinsert the host adapter driver diskette. step 4. insert the FUSION-MPT driver diskette and press enter. the kernel builds and the installation terminates. step 5. remove the driver diskette when prompted. step 6. reboot your system.
unixware 7 and open unix 8 device driver installation 8-27 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.2.3.2 existing system installation before installing the FUSION-MPT driver, make a backup copy of the existing kernel. follow these steps to back up the kernel and to add or update the unixware FUSION-MPT driver: step 1. log on as root. step 2. at the shell prompt type: cp /stand/unix /stand/unix.safe use this copy of the old kernel to reboot the system if the driver installation fails. refer to the section 8.2.4, ?roubleshooting, page 8-28 , for more information. step 3. insert the FUSION-MPT driver diskette after the kernel back-up completes. step 4. load the driver using the pkgadd command: pkgadd -d diskette1 step 5. select the FUSION-MPT driver package. the system installation then loads the FUSION-MPT driver. the system prompts you again to load a driver, even if loading was successful. step 6. type q (quit) and press enter. step 7. verify that the driver loaded successfully by typing: pkginfo mpt if the driver loaded successfully, the package information looks like: system mpt lsi logic ihv hba step 8. reboot your system by typing this command: init 6 during the boot process, the operating system scans the system and lists the devices found. if the kernel panics during boot, then reboot the system with the saved copy of the old kernel. if the reboot is successful, the system is ready to use.
8-28 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.2.4 troubleshooting if the driver installation fails, reboot the system with the unix.safe kernel ?e that was created before installing the FUSION-MPT host adapter driver. follow these steps: step 1. reboot your system. step 2. wait for the unixware logo screen to appear, then press the space bar to begin an interactive boot session. step 3. type at the command prompt when the interactive boot prompt appears: boot unix.safe the unixware logo screen reappears and the system boots from the unix.safe kernel ?e. 8.3 sco openserver 5 device driver installation this section describes how to install the version 1.03.05 of the lsil device driver and con?ure various peripherals with the sco openserver 5 operating system from caldera. this section consists of the following subsections: ? section 8.3.1, ?co openserver introduction ? section 8.3.2, ?nstalling the openserver unix driver ? section 8.3.3, ?roubleshooting 8.3.1 sco openserver introduction sco unix is the ?st unix operating system licensed for ibm-compatible microcomputers. the integrated communications, ?e system, international application support, and documentation create an ideal platform for those requiring a full-featured, unix-based operating system. sco unix takes full advantage of the 80386-and-above microprocessor capabilities. sco openserver 5 provides only one installation diskette, labeled boot disk. this diskette, the lsil btld driver diskette, and other software media are used during an sco openserver 5 installation. to connect
sco openserver 5 device driver installation 8-29 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. scsi devices to one or more host adapters, you must place the proper host adapter driver in the sco unix kernel. the lsil boot time loadable driver (btld) diskette contains one package: lsil. you must link-edit the proper driver into the sco unix kernel. the kernel must reside on the boot drive: either an internal, non-scsi hard drive or a scsi hard drive attached to host adapter 0 with scsi id 0 and lun 0. the btld permits an easy installation of sco unix with the software provided by caldera. the lsil driver allows sco openserver 5 operating systems to interface with scsi devices connected to the lsi53c1030 family of chipsets and/or lsi53c1030 host adapter cards. driver 1.03.05 also features support for the lsifc929, lsifc919, and lsifc909 fc chipsets and their associated host adapter boards. the current openserver drivers are also available for downloading from the lsi logic web site at http://www.lsilogic.com . the following sections provide instructions for con?uring the sco unix kernel with the lsil driver, installing openserver unix onto a hard drive, and adding peripheral devices. these instructions assume that you are familiar with unix system administration. several features of the lsil openserver device driver are: ? provides easy unix installation through the lsil btld diskette ? supports surelink domain validation ? supports multiple host adapters 8.3.2 installing the openserver unix driver openserver unix installation requires creation of a kernel that contains driver support for the lsi logic device. the two possible installation procedures are: 1. installing openserver unix and the lsil driver for the ?st time on a boot drive. for this option, follow the procedure in section 8.3.2.1, ?ew system installation. a btld to provides a user-friendly method for installing openserver unix onto a hard disk drive. 2. loading or updating the proper lsil driver to an already created openserver unix boot drive. for this option, follow the procedure in section 8.3.2.2, ?xisting system installation.
8-30 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. lsi logic recommends that you complete the entire installation in one session. 8.3.2.1 new system installation this procedure installs sco unix onto a hard disk drive and builds a new unix kernel that includes the lsil driver. refer to the sco openserver handbook for more details on sco unix installation. step 1. link the lsil btld into the unix kernel during installation. a. insert the openserver unix installation diskette and reboot the system. for openserver 5, this diskette is labeled boot disk. b. at the prompt, type link and press enter. c. at the next prompt, type link and press enter. do not remove the diskette. d. when the installation prompts for the diskette, insert either the installation diskette or the lsil btld diskette, and press enter. the system might prompt for a routine: "please enter which routine (0-40) to replace'?' to list): 'a' to add "lsilinit" at the end [default], 'n' to do nothing, or 'q' to quit" enter the routine number that precedes this message. the system might prompt with another inquiry: "please enter which routine (0-2) to replace '?' to list), 'a' to add "lsilpoll" at the end [default], 'n' to do nothing, or 'q' to quit" enter the routine number that proceeded this message. e. continue the installation according to the sco unix documentation. the sco openserver 5 system automatically creates a ?e, unix.safe, during installation. to access this unix kernel, type unix.safe ? step 2. install scsi device support by continuing from step 3 in section 8.3.2.2, ?xisting system installation.
sco openserver 5 device driver installation 8-31 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.3.2.2 existing system installation this procedure assumes that a openserver unix installation already exists on a system hard disk drive and builds a new unix kernel that includes the lsil driver. refer to the openserver unix system administrator's reference manual for more details on sco unix installation. step 1. the sco openserver 5 system automatically creates a unix.safe ?e during installation. to access this unix kernel, type unix.safe ? step 2. installing the lsil driver a. insert the lsil btld diskette in the drive. type installpkg and press enter. b. a prompt appears to insert the requested diskette. because the btld diskette is already inserted, press enter. c. a prompt asks for the name of the package. type lsil and press enter. d. if a driver exists from a previous installation, the installation prompts about replacing it. press y ?oryes. e. after the package installation routine completes, relink the kernel by typing /etc/conf/cf.d/link_unix f. the installation prompts: ?o you want this kernel to boot by default (y/n)? type y and press enter. the system backs up the old kernel. g. the installation prompts: ?o you want the kernel environment rebuilt (y/n)? type y and press enter. h. reboot the system by typing reboot and pressing enter. step 3. adding a scsi or fc disk drive if you are not adding a scsi or fc disk drive, go to step 4. to add a scsi or fc disk drive: a. type mkdev hd and press enter. b. the installation prompts for the name of the driver. type lsil and press enter.
8-32 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. c. the installation prompts for the host adapter that supports the disk drive. type the host adapter number and press enter. if you are adding another lsi logic host adapter to the sco unix kernel, the system might prompt to update the link-kit. type y and press enter. if you entered the host adapter number incorrectly, type n and press enter. the system then prompts for the host adapter number. d. in sco openserver 5 installations, the system prompts for the bus number of the disk drive. lsi logic host adapters support one bus per adapter. type 0 and press enter. e. the installation prompts for the target id of the disk drive. type the disk drive id number and press enter. f. the installation prompts for the lun of the disk drive. type the lun and press enter, or press enter to select the default value of zero. g. the installation prompts to update the con?uration ?e. type y and press enter if the displayed values are correct. type n ?f the values are incorrect and retry from step d. h. the installation prompts to create a new kernel. type y and go to step 6 if this is the last device to add. type n and return to step 3 if there are more devices to add. step 4. adding a tape drive if you are not adding a tape drive, go to step 5. to add a tape drive to the system: a. type mkdev tape and press enter. b. the tape drive con?uration program menu appears. select option 1 to install a tape drive, and press enter. c. the tape drive installation menu appears. select option 4 to install a tape drive, and press enter. d. from the next list, select the type of tape drive and press enter. e. the installation prompts to con?ure the tape drive. type y and press enter. f. the installation prompts for the name of the device driver. type lsil and press enter.
sco openserver 5 device driver installation 8-33 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. g. the installation prompts for the host adapter that supports the tape drive. type the host adapter number, and press enter. if you are adding another lsi logic host adapter to the sco unix kernel, the system might prompt to update the link-kit. type y and press enter. if you entered the host adapter number incorrectly, type n ? and press enter. the system then prompts for the host adapter number. h. in sco openserver 5 installations, the system prompts for the bus number of the disk drive. lsi logic host adapters support one bus per adapter. type 0 and press enter. i. the installation prompts for the id of the tape drive. type the id number of the tape drive and press enter. j. the installation prompts for the lun of the tape drive. type 0 and press enter. k. the installation prompts to update the con?uration ?e. type y and press enter. l. a list shows the special devices created. press enter. m. a list shows the links to the installed tape drive. when the system prompts for a boot string, type q and press enter to return to the tape drive con?uration program menu. n. type q and press enter to terminate the tape drive con?uration program menu. o. the installation prompts to create a new kernel. type y and proceed to step 6 if this is the last device to add. type n and return to step 3 if there are more devices to add. step 5. 5. adding a cd-rom drive if you are not adding a cd-rom drive to this system, proceed to step 6 . a. type mkdev cdrom and press enter. b. the cd-rom con?uration program menu appears. select option 1 to install a cd-rom drive and press enter. c. the installation prompts to con?ure the cd-rom drive. type y and press enter. d. the installation prompts for the name of the device driver that supports this device. type lsil and press enter.
8-34 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e. the installation prompts for the host adapter that supports the cd-rom drive. type the host adapter number and press enter. if you are adding another lsi logic host adapter to the sco unix kernel, the system might prompt to update the link-kit. type y and press enter. if you entered the host adapter number incorrectly, type n ? and press enter. the system then prompts for the host adapter number. f. in sco openserver 5 installations, the system prompts for the bus number of the disk drive. lsi logic host adapters support one bus per adapter. type 0 and press enter. g. the installation prompts for the id of the cd-rom drive. type the id number and press enter. h. the installation prompts for the lun of the cd-rom drive. type the lun and press enter, or press enter for the default value of zero. i. the installation prompts to update the con?uration ?e. type y and press enter. j. the installation prompts to con?ure a cd-rom/tape installation device. type n and press enter. k. the installation prompts to add a ?e system. type y and press enter. the system displays the ?e system con?uration program menu. select option 1 to add and press enter. the system updates the con?uration ?e and returns to the cd-rom con?uration program menu. l. type q and press enter to terminate the cd-rom con?uration program menu. m. the installation prompts to create a new kernel. type y and proceed to step 6 if this is the last device to add. type n and return to step 3 if there are more devices to add. step 6. rebuilding the kernel a. to rebuild the kernel, type /etc/conf/cf.d/link_unix b. the installation prompts: do you want this kernel to boot by default (y/n)? type y and press enter. the system backs up the old kernel.
sco openserver 5 device driver installation 8-35 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. c. the installation prompts: do you want the kernel environment rebuilt (y/n)? type y and press enter. d. reboot the system by typing reboot and pressing enter. e. press enter to load the new kernel. 8.3.3 troubleshooting this section provides a troubleshooting guide. 8.3.3.1 successful installation conditions this subsection outlines the conditions that exist after a successful installation. ? the etc/conf/sdevice.d directory contains a ?e named ?sil. this ?e contains the sdevice entries. ? the etc/conf/cf.d directory contains the sdevice, mdevice, and mscsi ?es. the sdev.hdr and mdev.hdr ?es describe the ?ld entries in the sdevice and mdevice ?es, respectively. ? the sdevice ?e contains an lsil entry for each lsi logic host adapter in the system. ? the second ?ld in the sdevice ?e reads ?. ? an lsil entry appears in the mdevice ?e. ? an lsil entry for each con?ured device appears in the mscsi ?e. ? the / etc/conf/pack.d/lsil directory exists and contains the driver.o and space.c ?es.
8-36 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.3.3.2 potential problems and solutions some potential problems and their suggested solutions are: 1. dif?ulty loading the sco unix kernel to an ide hard drive. * * * solution * * * only link the kernel if there is a device attached to an lsi logic host adapter. follow the instructions in the sco unix installation documentation. after the installation completes, proceed to step 2 in section 8.3.2.2, ?xisting system installation, and use installpkg ?o install the lsil device driver. 2. a device is not found. * * * solution * * * reboot and press cntl-c when the installation prompts to view the lsi logic con?uration utility. verify that the device has the correct host adapter and id. if the device is not shown, then it could be turned off or a cabling problem could exist. 3. the unix system is unreliable after the con?uration change. * * * solution * * * after altering the hardware or software con?uration is altered, you must rebuild the kernel. use the /etc/conf/cf.d directory and type: ./link_unix 4. an error message occurs during the rebuild of the kernel. * * * solution * * * reinstall the proper lsil driver using the installpkg utility. relink the kernel and reboot the system. 5. the root disk is not found or the partitioning of the disk fails. * * * solution * * * if the boot drive is a disk, use the bios con?uration utility to check that the disk is assigned id 0 and is con?ured to host adapter 0, lun 0.
linux device driver installation 8-37 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.4 linux device driver installation this section provides general information about the fusion- mpt device drivers for the linux operating system. this section includes the following subsections: ? section 8.4.1, ?eneral description ? section 8.4.2, ?nstalling the linux driver modules ? section 8.4.3, ?ebugging and troubleshooting 8.4.1 general description the FUSION-MPT linux drivers are free software. lsi logic distributes these drivers in the hope that they are useful, but without any warranty or implied warranty of merchantability or ?ness for a particular purpose. users can redistribute them and/or modify them under the terms of version 2 or later of the gnu public license as published by the free software foundation. for detailed information on the gnu public license, contact the free software foundation, inc., at http://www.gnu.org/copyleft/gpl.html ,orat 59 temple place suite 330, boston, ma 02111-1307. the linux FUSION-MPT device driver: ? supports the FUSION-MPT architecture and common software interface ? supports scsi and ietf-compliant lan protocols over fc ? supports 1 gbit/s and 2 gbit/s fc ? supports ultra320 scsi the linux FUSION-MPT device driver supports the following controllers and their associated lsi logic host adapters: ? lsi53c1030 and lsi53c1020 ultra320 scsi controllers ? lsifc929, lsifc919, and lsifc909 fc controllers
8-38 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.4.2 installing the linux driver modules lsi logic provides the driver in binary form for selected releases and provides driver source to enable compilation and installation with any linux kernel. the linux kernel source tree must be available to perform these procedures. 8.4.2.1 installing a FUSION-MPT controller lsi logic provides driver update disks that are suitably formatted to allow installation of red hat 7.0, 7.1, 7.1sbe, 7.2, 7.2ase, or suse 7.2, 7.3. the FUSION-MPT driver is bundled in red hat 7.3 and suse 8.0. you can use the driver disks to upgrade the bundled driver on these installations. the driver disks are packaged according to the os vendor and release version. download the tar ?es for the version of interest, extract and then use the ?d command or ?awrite command to transfer the appropriate image to a diskette. to install red hat 7.3 to an i686 machine, download the redhat73-2.01.tar.gz and redhat_readme.txt ?es. extract the red hat tar ?e by typing: # tar xzvf redhat73-2.01.tar.gz # cd redhat73-2.01 # dd if=rh73_i686.img of=/dev/fd0 you must select the appropriate architecture. i386 binaries are not compatible with an i686 installation. 8.4.2.2 adding or updating FUSION-MPT binaries to an existing installation lsi logic driver disks contain binaries that are compatible with many standard installations. if your installation is supported, you can add these binaries to your installation without being required to patch and rebuild the kernel. to install the binaries, follow the procedure described above to transfer the appropriate image to a ?ppy diskette. then perform the following commands as a root user:
linux device driver installation 8-39 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. # mount /dev/fd0 /mnt/floppy # cd /mnt/floppy # ./post_install.scr (dot-slash) the script ?ost_install.scr transfers the binaries on the diskette into the appropriate location in your installation. if you are not using the FUSION-MPT driver to boot the system, proceed to section 8.4.2.7, ?oading the drivers as modules, page 8-43 .ifyou are using the FUSION-MPT driver to boot the system, you must recreate the ramdisk image. if you use lilo, you must also rerun lilo and then reboot for the new binaries to be accessible. 8.4.2.3 adding FUSION-MPT support to the kernel users must add FUSION-MPT support to the kernel source tree for red hat 7.0, 2.2, and 2.4.0 through 2.4.6 kernels. you can unpack the mptlinux driver source tar archive from the root of the linux kernel source tree, which is normally located at /usr/src/linux , by typing: # cd /usr/src/linux # zcat /tmp/mptlinux-2.01-src.tar.gz | tar xvf - the user must patch the kernel as section 8.4.2.5, ?ernel patch instructions, describes. 8.4.2.4 updating the bundled FUSION-MPT driver the mptlinux driver bundled in red hat 7.1, red hat 7.2, and in the of?ial linux kernels starting with version 2.4.7, requires an update. before updating the bundled driver, save the original driver in a compressed tar ?e by typing: # cd /usr/src/linux/drivers/message # tar czvf fusion.orig.tar.gz fusion delete the original driver tree to remove obsolete ?es and unpack the new driver ?es by typing: # rm -rf fusion # cd /usr/src/linux # zcat /tmp/mptlinux-2.01-src.tar.gz | tar xvf - the user must patch the kernel as section 8.4.2.5, ?ernel patch instructions, describes.
8-40 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.4.2.5 kernel patch instructions no kernel patches are required if the kernel version is greater than version 2.4.18. all kernel versions less than or equal to kernel version 2.4.18 require a kernel patch. kernel.org provides kernel patches for kernel versions 2.2.12 through 2.2.20, and kernel versions 2.4.0 through 2.4.18. the red hat, caldera, turbolinux, and suse releases provide additional patches, as table 8.3 and table 8.4 shows. FUSION-MPT lan support and ia64 support requires a linux 2.4.x kernel. ia64 support also requires modutils v2.3.15 or newer. table 8.3 provides a list of FUSION-MPT patch ?es available for linux 2.4.x kernel versions. table 8.3 mptlinux patch files for linux kernel versions 2.2.x patch files linux 2.2.x kernel versions 2.2.5-15, 2.2.5-16 red hat 6.0 2.2.12-20 red hat 6.1 2.2.14-5.0, 2.2.14-6.0 red hat 6.2 2.2.16-22 red hat 7.0 2.2.14-caldera caldera 2.3.1 2.2.18-2 turbo linux 6.5 table 8.4 mptlinux patch files for linux kernel versions 2.4.x patch files linux 2.4.x kernel versions 2.4.2-2, 2.4.3-12, 2.4.9-6 red hat 7.1 none needed caldera 3.1 2.4.3-6 red hat 7.1sbe
linux device driver installation 8-41 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. the following steps illustrate patch installation. step 1. to identify the kernel version, display the make?e by typing: # more /usr/src/linux/makefile on a red hat 6.2 system, the system displays: version = 2 patchlevel = 2 sublevel = 14 extraversion = -5.0 step 2. apply the closest patch set available. for a red hat 6.2 system, type: # patch -p0 8-42 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. note: there might not be an exact match for the kernel version. apply the closest patch set. manual correction of any ?es for which the patch procedure produces *.rej ?e sections might be necessary. optionally, users can hand-apply the required kernel patches by examining the kernel patch ?es. 8.4.2.6 driver build instructions the following example illustrates how to con?ure and build the FUSION-MPT driver(s) as kernel modules. users can alternatively compile the mptbase and scsihost drivers into the linux kernel. step 1. run normal kernel con?uration routine from the /usr/src/linux directory by typing: $ make xconfig or $ make menuconfig or $ make config or $ make oldconfig step 2. select ?usion-mpt device support to access the FUSION-MPT drivers submenu entries. the system displays: FUSION-MPT (base + scsihost) drivers enhanced scsi error reporting < > FUSION-MPT misc device (ioctl) driver < > FUSION-MPT lan driver step 3. select ?usion-mpt (base + scsihost) drivers. step 4. enter m to build support as a module or enter y to build support into the kernel. the enhanced scsi error reporting and ioctl drivers are optional. lsi logic recommends building these items as modules due to kernel size considerations. do not accept the FUSION-MPT lan driver option because support for this driver is restricted to module use. step 5. turn on fc driver support in the network device support section to enable lan support.
linux device driver installation 8-43 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 6. save the kernel con?uration changes. step 7. follow the post con?uration instructions and rebuild the kernel. typically, this includes these commands: # make dep # make bzimage step 8. rebuild the kernel modules by typing: # make modules step 9. install newly compiled kernel modules by typing: # make modules_install the output display is similar to: installing modules under /lib/modules/2.2.14-5.0/block installing modules under /lib/modules/2.2.14-5.0/net installing modules under /lib/modules/2.2.14-5.0/ipv4 installing modules under /lib/modules/2.2.14-5.0/scsi installing modules under /lib/modules/2.2.14-5.0/fs installing modules under /lib/modules/2.2.14-5.0/fs installing modules under /lib/modules/2.2.14-5.0/cdrom installing modules under /lib/modules/2.2.14-5.0/video installing modules under /lib/modules/2.2.14-5.0/net installing modules under /lib/modules/2.2.14-5.0/misc step 10. you must perform the additional steps necessary to make the new kernel bootable. typically, this involves updating /boot, creating a ramdisk image, and updating and running the boot loader. refer to your installation documentation for details. 8.4.2.7 loading the drivers as modules these steps describe how to load the new kernel and modules: step 1. load the FUSION-MPT base driver by typing: # insmod mptbase the system displays: FUSION-MPT base driver 1.02.00 copyright (c) 1999-2002 lsi logic corporation mptbase: initiating ioc0 bringup ioc0: fc919: capabilities={initiator,target,lan} mptbase: 1 mpt adapter found, 1 installed.
8-44 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. step 2. load the isense driver to enable enhanced scsi error reporting by typing: # insmod isense the system displays: scsi-3 opcodes & asc/ascq strings 1.02.00 mptbase: english readable scsi-3 ops & asc/ascq strings enabled step 3. if the FUSION-MPT controller is the only scsi controller in the system, you might need to load the ?csi_mod module manually. typically, this module is auto-loaded by the kernel. if the kernel does not auto-load the module, type: insmod scsi_mod step 4. load the FUSION-MPT host driver by typing: # insmod mptscsih the system display depends on the attached devices. an example display is: fusion mpt scsi host driver 1.02.00 scsi0 : ioc0: lsifc919, fwrev=1000h, ports=1, maxq=256, irq=9 scsi : 1 host. vendor: seagate model: st39102fc rev: 0007 type: direct-access ansi scsi revision: 02 detected scsi disk sda at scsi0, channel 0, id 0, lun 0 vendor: seagate model: st19171fc rev: 0017 type: direct-access ansi scsi revision: 02 detected scsi disk sdb at scsi0, channel 0, id 1, lun 0 scsi device sda: hdwr sector= 512 bytes. sectors= 17783240 [8683 mb] [8.7 gb] sda: sda1 scsi device sdb: hdwr sector= 512 bytes. sectors= 17783112 [8683 mb] [8.7 gb] sdb: sdb1
linux device driver installation 8-45 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. when the mptscsih module loads, the installation detects the fc target devices and maps them to linux scsi devices, /dev/sd{a,b,c,...}. all linux commands pertaining to scsi disk storage management using the /dev/sdx[n] notation are now functional. the following example illustrates a typical installation. # fdisk /dev/sdb # mke2fs /dev/sdb1 # mount /dev/sdb1 /mnt/s1 8.4.2.8 boot setup commands this section outlines the boot command syntax and available arguments. the boot setup commands control domain validation, scsi bus width, and the scsi synchronous factor. FUSION-MPT passes setup commands to the mptscsih driver as a string variable by using the insmod command. specify each string argument with the keyword:value format. the command line only permits digits and lowercase characters. the following example installs the driver module, set the bus width to narrow, and disables domain validation. $ insmod mptscsih.o mptscsih="dv:n width:0" domain validation command argument this command argument enables or disables domain validation on scsi device driver. this command does not affect fc devices. the command syntax is: dv:n /* disabled */ dv:y /* enabled [default]*/ to disable domain validation on a per-device basis, set the transfer characteristics in the bios to asynchronous/narrow. domain validation uses an internal buffer. some older scsi devices freeze if they receive a read buffer or a write buffer command. maximum scsi bus width command argument this command argument enables and disables wide scsi bus transfers and does not affect fc devices. the command syntax is: width:0 /* wide scsi disabled */ width:1 /* wide scsi enabled */
8-46 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. lsi logic recommends setting the maximum allowed scsi bus data transfer width to the minimum of the adapter capabilities and nvram settings. minimum scsi synchronous factor command argument this command argument sets the minimum scsi synchronous factor for scsi devices and does not affect fc devices. the command syntax is: factor:0x08 /* ultra320 (160 mega-transfers / second) */ factor:0x09 /* ultra160 ( 80 mega-transfers / second) */ factor:0x0a /* ultra2 ( 40 mega-transfers / second) */ factor:0x0c /* ultra ( 20 mega-transfers / second) */ factor:0x19 /* fast ( 10 mega-transfers / second) */ factor:0x32 /* scsi ( 5 mega-transfers / second) */ factor:0xff /* 5 mega-trasfers/s and asynchronous */ lsi logic recommends setting the minimum allowed scsi synchronous factor to the maximum of the adapters capabilities and nvram setting. programming the minimum synchronous factor to 0xff sets the synchronous offset to 0 for asynchronous transfers. 8.4.2.9 con?uring network interfaces both linuxconf and netcfg con?ure the FUSION-MPT lan connection. the following instructions are for using linuxconf, but they are easily adapted to netcfg. step 1. go to con?->networking->client tasks->basic host information. step 2. select an adaptor. step 3. set the con? mode to manual. step 4. set the primary name. step 5. set the ip address. step 6. set the netmask. lsi logic recommends using the default value of 255.255.255.0. step 7. set net device to fc0 for the ?st lan port, fc1 for the second lan port, and so on. step 8. select enabled and type mptlan on the kernel module line to activate this interface automatically at boot.
linux device driver installation 8-47 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.4.3 debugging and troubleshooting this section describes several debugging tools and issues. 8.4.3.1 scsi isense driver the FUSION-MPT scsi isense driver offers enhanced driver error reporting and improved readability. an optional isense driver/shim provides scsi-3 opcode string lookup and a sorted table of 463 scsi-3 additional sense code and quali?r (asc/ascq) strings. lsi logic translated this table from a text ?e on the scsi t10 ftp site located at ftp://ftp.t10.org/t10/drafts/spc2/asc-num.txt . if the isense driver is loaded, the system displays an english-readable asc/ascq string when the system generates a scsi check condition. for example, the console might display: scsi error report =-=-= (ioc0,scsi5:0) scsi_status=02h (check_condition) original_cdb[]: 2a 00 00 00 00 41 00 00 02 00 - "write(10)" sensedata[12h]: 70 00 02 00 00 00 00 0a 00 00 00 00 04 02 02 00 00 00 sensekey=2h (not ready); fru=02h asc/ascq=29h/00h "logical unit not ready, initializing cmd. required" 8.4.3.2 /proc support features if the linux kernel offers the /proc ?e system support, you can examine scsi devices by typing: $ cat /proc/scsi/scsi you can examine the recognized FUSION-MPT adapters by typing: $ cat /proc/mpt/summary you can determine the FUSION-MPT driver version by typing: $ cat /proc/mpt/version
8-48 unix operating system device drivers version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 8.4.3.3 visible but not accessible luns in a fc raid system depending on the con?uration of the raid controller(s), some of the scsi devices in a fc raid system are visible but not accessible. if there are two active controllers in a single subsystem and each controller connects to 8 active luns, then all 16 luns are visible through each controller. however, only 8 luns are accessible through each controller.
FUSION-MPT device management users guide 9-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 9 linux integrated mirroring con?uration utility this chapter describes the linux integrated mirroring (im) con?uration utility (cu). this chapter contains the following sections: ? section 9.1, ?ntroduction ? section 9.2, ?ommand line synopsis ? section 9.3, ?rror messages 9.1 introduction the linux integrated mirroring con?uration utility (limcu) con?ures the im function on linux-based, FUSION-MPT scsi controllers. this utility requires no user interaction. the con?uration actions initiated by limcu might not complete before the program exits. but, the con?urations actions do complete, even if the system reboots. im requires raid quali?d drives. a raid quali?d drive is a drive that is not part of an existing im or raid volume, has not been previously con?ured as a raid physical disk, and has a sector size of 512 bytes. the ?a option adds the requirement that the raid quali?d drive must not contain a valid partition table. the erase options ( ?e and ?eall ) erase the partition table. limcu requires the mptctl.o , mptbase.o, and mptscsih.o drivers. use insmod or modprobe to load the mptctl.o driver. lsi logic tested limcu using the red hat 7.2 linux. users must update the FUSION-MPT bundled driver to the mptlinux-2.00.08 version or newer.
9-2 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 9.2 command line synopsis the command line syntax for limcu is: limcu -a [-c controller_number] [-so volume_settings] [-ss] [-sz volume_size] limcu [-c controller_number] -t target_id,target_id[,target_id] [-so volume_settings] [-ss] [-sz volume_size] limcu -d [-c controller_number] limcu -e [-c controller_number] -t target_id[,target_id[,target_id]] limcu -eall [-c controller_number] limcu [-c controller_number] [-ve | -vd] [-re | -rd] [-so volume_settings] limcu [-c controller_number] [-vi ?endor_id? [-pi ?roduct_id? [-pr ?roduct_revision? \[-vs volume_settings] [-io offset ?s size [-io offset ?s size]] 9.2.1 command line options this section describes the command line options for the limcu command. -a automatically create an im volume limcu automatically selects the targets to use when creating an im volume. this option does not require any other command options. limcu searches controllers in increasing numerical order until identifying a controller that meets the requirements for creating an im volume. these requirements are: (1) the controller must support im, and (2) it must have two or more drives that meet the quali?ations for use in an im volume. limcu chooses targets by their target id. limcu searches for targets based on valid target ids, starting with 0 and ending at 15, and terminates the search after three targets are found. limcu must ?d at least two targets to create an im volume.
command line synopsis 9-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. -c controller number this option speci?s the controller to which limcu sends all con?uration requests. if this option is not speci?d, limcu selects the ?st controller that satis?s the requirements of the requested con?uration action. this is typically the ?st controller that supports im. the -a option is the only exception. when the -a option is speci?d, limcu chooses the ?st controller that supports two or more im-quali?d drives. -d delete im volume this option deletes an existing im volume and all of the underlying raid physical disks on a controller. the data on the drives is not altered, but the controller now treats the drives as normal drives. because this option deletes all raid volumes and physical disks found on a controller, you can use it to correct corrupted raid con?urations. -dc display FUSION-MPT con?uration pages this option displays the following FUSION-MPT con?ura- tion pages for the selected controller: manufacturing page 4 , ioc page 2, ioc page 3 , raid volume page 0 , and raid physical disk page 0 . limcu displays the last two pages zero or more times, depending on the current controller con?uration. limcu prohibits use of this option with any option that creates a disk volume. -e write zeroes to speci?d disks this option writes zeroes to the ?st 64 sectors of the speci?d disk drive(s) that are attached to a speci? con- troller. the ?t option speci?s a maximum of three disks, or the ?c option speci?s a speci? controller. if neither the ?t or the ?c options are speci?d, limcu writes zeroes to the ?st im-capable controller found. -eall write zeroes to all disks this option writes zeroes to the ?st 64 sectors of all raid volumes or raid quali?d disk drives that are attached to a single controller. the ?c option speci?s the controller, or limcu chooses the ?st im-capable controller found.
9-4 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. -i read options from standard input this option causes limcu to read command options from standard input until encountering an end-of-?e (eof). limcu parses the command line and standard input options to create the ?al set of command options. the ?v option displays the outcome of this process. command line options take precedence over standard input options. the option syntax does not allow the user to disable standard input options. -io offset_value information offset option this option changes the information offset to the speci?d value. users can specify this option twice. because the ?io and ?is options are pairs, users must specify the ?is and ?io options the same number of times. -is size_value information size option this option changes the information size to the speci?d value. users can specify this option twice. because the ?io and ?is options are pairs, users must specify the ? is and ?io options the same number of times. -nr no reboot option by default, limcu reboots the system after creating or deleting an im volume. this option stops the reboot. -pi ?roduct_id_string change product identi?ation string this option changes the product id string of an im volume. the string can be 0 to 16 characters long. if the user speci?s fewer than 16 characters, the remaining characters become spaces. -pr ?roduct_revision_string change product revision string this option changes the product revision string of an im volume. this string can be 0 to 4 characters long. if the user speci?s fewer than 4 characters, the remaining characters become spaces. -rd disable drive synchronization this option takes the secondary drive off line.
command line synopsis 9-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. -re enable drive synchronization this option brings the secondary drive on line. the controller resynchronizes the drives. -so volume_settings volume settings override this option creates a volume or changes the volume settings on an existing volume. -ss disable disk synchronization this option disables disk synchronization during creation of an im volume. use this option if the primary disk contains invalid data. -sz maximum_volume_size_in_mbytes limit volume size this option limits the size of the im volume. the parameter for this option is the size of the volume in mbytes and must be a number between 1 and 999,999, inclusively. use this option when creating an im volume. -t target_id_list specify target id(s) this option speci?s up to three scsi target ids for a con?uration action. -v verbose this option prints additional information about the requested actions. -vd volume disable this option disables an im volume. when a volume is disabled, the drives are no longer in sync. -ve volume enable this option enables an im volume and causes the controller to resynchronize the disk volumes. -vi ?endor_id_string vendor identi?ation this option changes the vendor id string of an im volume. this string can be 0 to 8 characters long. if the user speci?s fewer than 8 characters, the remaining characters become spaces.
9-6 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. -vs volume_settings default volume settings this option changes the default im volume settings. limcu uses the default settings if the user does not specify the ?so option when creating an im volume. 9.2.2 example command usage this section provides examples of limcu command line usage. limcu -a this command line creates an im volume on the ?st im capable controller that connects with two or more available drives. limcu -c 0 -t 0,5,3 this command line creates an im volume on controller number 0, and assigns scsi id 0 to the primary drive, scsi id 5 to the secondary drive, and scsi id 3 to the hot spare drive. limcu -c 4 -t 10,8 this command line creates an im volume on controller number 4, and assigns scsi id 10 to the primary drive and scsi id 8 to the secondary drive. this command line does not create a hot spare drive. the scsi id of the im volume is 8, because the im volume uses the lowest id of the primary and secondary drives. limcu -d this command line deletes all the im volumes and raid physical disk drives on the controller.
error messages 9-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 9.3 error messages this section describes limcu error messages. the error number and message is listed in bold, and the description immediately follows. limcu stops operating after encountering an error. if multiple problems exist, multiple runs of the utility are necessary to locate them. e001: could not allocate memory an attempt to allocate memory using the c library memory allocation functions failed. unload any unneeded programs or daemons that might be running. if this is not successful, add more memory to the system. limcu allocates a number of buffers during execution, but none are large and most are freed when no longer needed. e002: no executable options were entered on the command line there were no executables on the command line. e003: bad or malformed option limcu encountered an unrecognizable option. check for unde?ed options or valid options with extraneous characters at the end of them. the option must also begin with a ? or a ?? e004: controller option entered more than once limcu permits a single controller option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e005: controller number format is bad the controller number is either missing or contains an invalid character. the controller number must use the same numerical constant formats as are in the c programming language (for example., 4, 0xa, or 010). e006: too many target ids were entered limcu permits a maximum of three target ids. to erase more than three disk drives, either invoke limcu multiple times or use the erase all option.
9-8 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e007: target id number format is bad the target id number is either missing or contains an invalid character. the target id number must use the same numerical constant formats as are in the c programming language (e.g., 4, 0xa, or 010). e008: volume settings override entered more than once limcu permits a single volume settings override option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e009: volume settings override number format is bad the volume settings override value is either missing or contains an invalid character. this value must be entered as a 4-digit hexadecimal number. e010: drive maximum size option is entered more than once limcu permits a single drive maximum size option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e011: drive maximum size number format bad the drive maximum size value is either missing or contains an invalid character. the drive maximum size value must use the same numerical constant formats in the c programming language (for example, 4, 0xa, or 010). e012: autocreate volume option entered more than once limcu permits a auto create volume option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e013: resynchronization disable option entered more than once limcu permits a single disable volume resynchronization option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case.
error messages 9-9 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e014: resynchronization disable option format is bad the disable volume resynchronization option does not have a parameter. check for extraneous characters at the end of the option. e015: resynchronization enable option entered more than once limcu permits a single enable volume resynchronization option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e016: resynchronization enable option format is bad the enable volume resynchronization option does not have a parameter. check for extraneous characters at the end of the option. e017: delete volume option entered more than once limcu permits a single delete volume option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e018: display con?uration pages option entered more than once limcu permits a single display con?uration pages option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e019: erase disks option entered more than once limcu permits a single erase disks option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option is entered more than once in either case. e020: erase all disks option entered more than once limcu permits a single erase all disks option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case.
9-10 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e021: disable volume option entered more than once limcu permits a single disable volume option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e022: disable volume option format is bad the disable volume option does not have a parameter. check for extraneous characters at the end of the option. e023: enable volume option entered more than once limcu permits a single enable volume option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e024: enable volume option format is bad the disable volume option does not have a parameter. check for extraneous characters at the end of the option. e025: vendor id option entered more than once limcu permits a single vendor id option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e026: vendor id string format is bad the entered string is either too long (>8 characters, not including quotation marks), contains an opening set of double quotation marks but lacks a closing set, or contains a non-ascii character. e027: persistent volume settings option entered more than once limcu permits a single persistent volume settings option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e028: persistent volume settings number format is bad the persistent volume settings value is either missing or contains an invalid character. it must be entered as a hexadecimal number.
error messages 9-11 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e029: product id option entered more than once limcu permits a single product id option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e030: product id string format is bad the string entered is either too long (>16 characters, not including quotation marks), contains an opening set of double quotation marks but lacks a closing set, or contains a non-ascii character. e031: product revision option entered more than once limcu permits a single product revision option entry. it is permissible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e032: product revision string format is bad the string entered is either too long (>4 characters, not including quotation marks), contains an opening set of double quotation marks but lacks a closing set, or contains a non-ascii character. e033: data offset option entered more than twice limcu permits two data offset option entries. it is permissible to enter it twice on the command line and twice in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than twice in either case. e034: data offset number format is bad the data offset number is either missing or contains an invalid character. the drive maximum size value must use the same numerical constant formats in the c programming language (for example, 4, 0xa, or 010). e035: data size option entered more than twice limcu permits two data size option entries. it is permissible to enter it twice on the command line and twice in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than twice in either case.
9-12 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e036: data size number format is bad the data size number is either missing or contains invalid character. the drive maximum size value must use the same numerical constant formats in the c programming language (for example, 4, 0xa, or 010). e037: format error encountered while reading options from standard input limcu encountered an error while reading options from standard input. the previous error messages indicate the nature of the problem. e038: error reading from standard input an i/o error occurred while reading standard input. e039: too many characters in the option limcu limits the length of any individual option to 79 characters. check for missing white space characters separating the options. e040: open of mptctl device node failed limcu could not open the device node, which communicates with the driver. limcu tries to create the device node if one does not exist. possible causes for this error are: ? the device node does not exist and limcu cannot create it. ? the driver is not loaded. the mptctl, mptscsih, and mptbase drivers must be loaded. use lsmod to verify this. ? the user does not have the privileges to open the device node. the user must have root privileges to access the driver through the mptctl device node. e041: i/o request failed the ioctl call to the mptctl driver failed. the use of an older version driver usually causes this error. use version 2.00.08 or later of the FUSION-MPT linux driver package. e042: incorrect number of targets for the requested operation the wrong number of targets was speci?d for the requested operation. the auto create volume ( -a ? requires no target ids. the create volume option requires two or three target ids. the delete volume option
error messages 9-13 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. requires no target ids. the erase all disks option require no target ids. the erase disk option requires one to three target ids. e043: cannot delete and create volumes at the same time limcu cannot simultaneously delete and create im volumes. to do this, run limcu twice. e044: number of data offsets and sizes does not match for every instance of the -io option limcu requires a matching instance of the -is option. if this is not the case, limcu ?gs an error. e045: cannot enable and disable volumes at the same time limcu cannot simultaneously enable and disable an im volume. to do this, run limcu twice. e046: cannot enable and disable resync at the same time limcu cannot simultaneously enable and disable drive resynchronization. to do this, run limcu twice. e047: cannot disable the volume and resync at the same time limcu cannot simultaneously disable both the volume and resynchronization. disabling the volume also disables resynchronization of the volume. e048: if volume size is speci?d, must create a volume limcu only permits speci?ation of the maximum volume size when creating a volume. entering a maximum size for any other option is of no value. limcu ?gs an error. e049: volume size must be between 0 and 999,999 the maximum volume size number must be between 0 and 999,999, inclusive. these numbers are decimal val- ues. e050: if autocreate volume, no target ids or erase options allowed you cannot specify target ids or erase options when creating a volume with the auto create option. e051: cannot set volume settings and delete the volume at the same time volume settings are used when creating a volume. when deleting a volume, the volume setting has no value. limcu ?gs an error.
9-14 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e052: volume settings override number is too large (four hex digits max) the volume setting is too large. re-enter a smaller vol- ume setting. e053: cannot do erase targets and erase all at the same time limcu does not permit simultaneous entry of these options because they cannot be completed simultaneously. the erase targets option erases some but not all disks, while the erase all option erases all disks. e054: if erase target, the user must specify at least one target id the erase targets option erases one to three disks. the user must specify the target disks using the ?t option. e055: if erase all, the user cannot specify any targets the erase all option erases all disks. if the user enters target ids, limcu assumes that the user is either trying to create a volume, which is not allowed when erasing disks, or is confused about which disks to erase. limcu ?gs this as an error, to prevent a potential catastrophe. e056: data offset + size is too large; must be < 256 the data window de?ed by a -io ? -is pair cannot be outside the maximum inquiry buffer size de?ed by the scsi standard. e057: same target id was entered more than once the user entered duplicate target id values. limcu only permits unique target ids. e058: no reboot option format is bad check for extra characters on the end of the -nr option. e059: no reboot option entered more than once limcu permits a single no reset option entry. it is permis- sible to enter the option once on the command line and once in the standard input stream. limcu ?gs a fatal error if the option entry occurs more than once in either case. e060: controller number does not match that of an im controller the controller number provided in the -c option is that of a controller that does not support im.
error messages 9-15 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e061: could not read manufacturing con? page 4 limcu could not read manufacturing con?uration page 4. other messages accompany this error message and pinpoint the reason for the error. e062: manufacturing con? page 4 is not writable/persistent the ioc was not con?ured to allow writing this con?uration page or the values written are not saved across reboots. e063: manufacturing con? page 4 nvram settings write failed an attempt to write new data for manufacturing con?uration page 4 to flash memory failed. a hardware failure typically causes this error. e064: bad raid action code this error is currently not in use. e065: i/o request failed; bad controller status the ioc detected an error when completing a FUSION-MPT request. e066: attempting to operate on a nonexistent volume. limcu cannot locate a volume on the ioc. limcu cannot process options such as: -ve , -vd , -re , or -rd . e067: volume enable failed the volume enable raid action request failed. other error messages printed before this message provide information regarding this failure. e068: volume disable failed the volume disable raid action request failed. other error messages printed before this message provide information regarding this failure. e069: resync enable failed the resynchronization enable raid action request failed. other error messages printed before this message provide information regarding this failure. e070: resync disable failed the resynchronization disable raid action request failed. other error messages printed before this message provide information regarding this failure.
9-16 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e071: bad im volume con?uration the raid volume type is not im or the con?uration of the physical disks is not correct for an im volume. all operations except delete volume are locked out. e072: error while attempting to override volume settings the volume settings raid action request failed. other error messages printed before this message provide information regarding this failure. e073: volume delete failed the volume delete raid action request failed. other error messages printed before this message provide information regarding this failure. e074: physical disk delete failed the delete raid physical disk raid action request failed. other error messages printed before this message provide information regarding this failure. e075: no controllers were found all attempts by limcu to retrieve ioc information from the driver failed. this may be the result of controller failure. limcu stops scanning for controllers at the ?st failure to retrieve controller information. limcu uses an error to terminate the scan. e076: no im capable controllers were found no controllers were found that support im volumes. check that the controllers are using the proper ?mware. e077: unable to retrieve controller information an error occurred while attempting to retrieve con?uration pages from the ioc. e078: failed to delete all volumes and physical disks after a delete volume request, the ioc con?uration pages indicate that raid volumes or physical disks are still con?ured on the ioc. e079: too few raid quali?d drives for the requested operation not enough quali?d disks were found for an im volume during the execution of an auto create volume request. disks must have 512-byte sectors, be nonremovable, and must not have a valid master boot record (mbr). the
error messages 9-17 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. most likely cause of the error is that the drive has a valid mbr. use the erase disk or erase all options to correct this situation. e080: erase i/o request failed an i/o error occurred while trying to write zeroes to a disk drive. e081: too many raid volumes on the controller the number of de?ed raid volumes on the controller has reached the limit for the controller. the user must delete an existing volume before creating a new one. e082: can? use speci?d drive in a raid volume the drive does not meet one of the following quali?a- tions: (1) 512-byte sectors, (2) nonremovable, (3) no valid master boot record, (4) not part of an existing raid volume, or (5) not an existing raid physical disk. e083: create raid physical disk failed the create raid physical disk raid action request failed. other error messages printed before this message provide information regarding this failure. e084: drive read capacity failed a scsi read capacity command failed. other error messages printed before this message provide information regarding this failure. e085: drive is too small for the raid volume based on a valid partition table found on the primary drive, limcu calculates the minimum drive size. limcu issues a scsi read capacity command to all the disks that are to be included in the volume, and compares the values received to the minimum drive size. the size one of the drives to be included in the im volume or the hot spare is smaller than the minimum disk drive size. e086: display con? pages option format is bad limcu found extraneous characters found at the end of the -dc option. e087: can not create a volume and display con? pages at the same time the user cannot simultaneously specify the create volume and display con?uration pages options.
9-18 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e088: skip sync option entered more than once the user entered the skip drive synchronization ( -ss ? option multiple times. e089: skip sync option format is bad limcu found extraneous characters at the end of the -ss option. e090: if skip resync, must be creating a volume the user can only specify the skip drive resynchronization option when creating an im volume. e091: can not erase disk(s) and create a volume at the same time limcu does not permit the user to simultaneously create im volumes and erase disks. e092: persistent volume setting value too large (> 0xffff) this value must be entered using hexadecimal digits and cannot be more the four hexadecimal digits long. e093: read of raid physical disk con? page 0 failed a request to read a raid physical disk con?uration page 0 failed. other error messages printed before this message provide information regarding this failure. e094: couldn? update ioc information after creating a raid volume after creating an im volume, limcu attempted to and failed to retrieve current copies of the con?uration pages from the ioc. other error messages printed before this message provide information regarding this error. e095: raid action request to create volume failed other error messages printed before this message provide information regarding this failure. e096: read of mbr on primary disk failed during maximum volume lba calculation a scsi i/o read request for sector 0 of the primary volume failed. other error messages printed before this message provide information regarding this failure. e097: manufacturing con? page 4 current settings write failed an attempt to write updated con?uration information to manufacturing con?uration page 4 failed. other error messages printed before this message provide information regarding this failure.
error messages 9-19 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. e098: no drives were found that can be erased the erase options clears the ?st 64 sectors on a raid volume or raid quali?d disk (that is, nonremovable, 512-byte sectors.) limcu did not ?d any drives that satisfy these requirements. if a controller has raid quali?d drives and this error occurs, use the ?c option to specify the controller number. e099: sum of values entered using '-is' option too large (> 32) the sum of the ?is options cannot exceed 32.
9-20 linux integrated mirroring con?uration utility version 1.2 copyright 2002 by lsi logic corporation. all rights reserved.
FUSION-MPT device management users guide 10-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. chapter 10 cim solution this chapter describes the FUSION-MPT common information model (cim) solution. this chapter contains the following sections: ? section 10.1, ?escription ? section 10.2, ?im browser window description ? section 10.3, ?indows installation instructions for the cim solution ? section 10.4, ?inux installation instructions for the cim solution 10.1 description the cim solution enables the presentation of networked storage components through an easy to navigate user interface. the cim solution enables the storage system administrator to monitor multiple systems on a network easily. the administrator uses the cim to identify and locate storage device failures quickly. the cim solution also provides information concerning the topology of the storage network, adapters, and devices. the cim solution supports im virtual volumes and the underlying physical drives that compose the virtual volume. the lsi logic cim solution is a cim-compliant management application for FUSION-MPT mass storage elements. this tool allows you to connect with devices through a tcp/ip based network and manage the attached FUSION-MPT host adapters, peripheral devices, and device drivers. the cim solution supports the lsi53c1030, lsi53c1020, lsifc929, and lsifc919 controllers and their associated host adapters. the latest version of the cim solution is available on the lsi logic web site: http://www.lsilogic.com/support/support+drivers/scsi/cimbrow ser.html
10-2 cim solution version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 10.1.1 components the cim solution consists of two separate software components: a cim browser and a cim provider. the cim browser runs on the machine that monitors the storage elements and connects to any computer on a tcp/ip based network. the cim browser provides an easily-navigated window to monitor the attached storage elements. a single cim browser can monitor multiple elements on the network. the monitored elements include host adapters, peripheral devices, and device drivers. the cim provider runs on the system being monitored and provides information about the FUSION-MPT controllers and the devices connected to the system running the cim provider. you must install the lsi logic cim provider on every computer that you plan to monitor. 10.1.2 features the cim solution offers the following features: ? multisystem manageability ? visual acknowledgement of component failures ? displays current information about each adapter and its attached storage devices ? monitors the current status of FUSION-MPT im volumes ? supports remote management over a tcp/ip based network ? provides graphical representation of FUSION-MPT storage elements ? displays device and adapter hierarchy as a device tree ? implements a highly portable user interface ? launches the lsi logic cim browser as a stand-alone application ? launches the lsi logic cim provider automatically 10.1.3 installation and system requirements the tool and system requirements for the cim installation are: ? running either windows nt version 4.0, service pack 6 or above; windows 2000, service pack 2 or above; or linux.
cim browser window description 10-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. ? 20 mbytes of available disk space for windows installations; 40 mbytes of available disk space for linux installations. ? tcp/ip protocol installed and enabled. ? video card support for at least 256 colors. ? desktop area must be 800 by 600 pixels or greater. lsi logic recommends using a desktop area of 1024 by 768 pixels. on linux-based systems, lsi logic recommends viewing under kde or gnome. 10.2 cim browser window description this section describes the cim browser window. 10.2.1 connect menu options the connect menu is located on the upper left corner of the cim browser window. table 10.1 provides description of the options available on the connect menu. table 10.1 connect menu option description option description connect this option connects the computer running the cim browser to a single computer that is running the cim provider. enter either the ip address or the host name of the system that you plan to connect to. connect to local host this option connects the cim browser to the local host.
10-4 cim solution version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 10.2.2 hardware device tree options the hardware device tree provides an easily navigated list of the devices being monitored by the cim browser. clicking on a device in the tree provides information about the device. figure 10.1 illustrates the structure of the hardware device tree for scsi, scsi with im, and fc systems. table 10.2 describes each level in the device trees. the status of the device is given by a green status icon, a yellow status icon, or a red status icon that appears in the right-hand window. a green status icon indicates that the device is functioning properly. a yellow status icon indicates that there is a problem with the device and the cim browser cannot identify the problem. a red status icon indicates that there is a problem with the device and the cim browser can identify the problem. on the im volume and physical disk levels, the cim browser displays a ?ppy disk icon if the media is present. if the media is not present, as could be the case with removable media such as cd-roms or tape drives, the cim browser displays a ?ppy drive with an ?. advanced connections this option connects the computer running the cim browser to multiple systems that are each running the cim provider. when you select this window, the cim browser displays an ?dvanced connection window. the advanced connection window allows you to select a range of internet protocol (ip) addresses for the cim browser to scan using either the ?p address option or the ?p subnet option. the ?llow selection of systems option allows the user to select manually which cim-enabled system to manage. the ?onnect to all addresses option automatically connects the cim browser to all systems that have an enabled cim provider. if there are more than 50 systems to scan, the cim browser displays a message with information about how many systems are present. disconnect allows you to disconnect from the host. this option is only available when you click on the host in the host tree. table 10.1 connect menu option description option description
cim browser window description 10-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. figure 10.1 hardware device tree structures storage device network host name scsi controller im volume loop a) scsi hardware device tree b) scsi with im hardware device tree c) fc device tree storage device storage device network host name scsi controller network host name fc controller storage device storage device storage device
10-6 cim solution version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. table 10.2 device tree description device tree level description network this level displays the cim browser welcome window. host name this level displays the name of the system that the cim provider is running on and that the cim browser is monitoring. the cim browser displays a window that provides information about the system that the cim provider is running on. the ?ystem connection option usually reads ?k. however, if the system is too busy to respond, this option reads ?rovider is busy and the devices connected to the system do not appear in the device tree. fc or scsi controller this level displays information concerning the host adapter. the cim browser displays a separate entry for each channel. im volume this level describes the logical im volume. the cim browser only includes this level in the device tree if an im volume is present on the monitored system. the status ?ld describes the status of the im volume and has two options: ?k or ?nknown. ?k indicates either that the im volume is completely operational. the ?nknown option indicates that there is problem with the im volume that the cim browser cannot identify. the ?edundancy status ?ld describes the status of the im volume redundancy and has three options: ?ully redundant? ?n degraded mode? or ?edundancy is lost. ?ully redundant indicates that the im volume is functioning properly and that the data is fully redundant. ?n degraded mode indicates that the im volume is running in a degraded mode. a possible cause of this mode is the failure of a single disk. ?edundancy is lost indicates that the redundant data is lost. a possible cause of this mode is the failure of both disks. the ?dditional redundancy information ?ld options are ?esynch in progress or ?esynch not in progress. when the resynchronization is in progress, the cim browser displays a status bar giving the approximate percent completion and an estimate of the time until completion. loop this ?ld provides information on the fc loop con?uration. physical disk this level provides information on the physical disks in the system. physical disks have a ?hysical disk state ?ld that provides information concerning the status of the physical disk. storage device this ?ld provides information on the storage device.
windows installation instructions for the cim solution 10-7 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 10.3 windows installation instructions for the cim solution this section describes a windows installation for version 2.00.00 of the cim solution. 10.3.1 installing the cim solution follow these steps to install the cim solution step 1. double-click on the ?nstall.htm program that you downloaded from the lsi logic web site. a ?ecurity warning window appears. you must grant additional privileges to the installanywhere so that it can complete the installation. step 2. click on yes. step 3. click on ?tart installer for windows... the installanywhere begins. step 4. follow the instructions and steps in installanywhere. to verify the installation of the cim provider, click on the start button and choose: settings--> control panel--> services . confirm that the cim provider is listed with a status of ?tarted. to verify the installation for the cim browser, launch the application from the start menu. 10.3.2 uninstalling the cim solution to uninstall the cim solution, follow these steps: step 1. exit from the lsi logic cim browser. step 2. click on the start button. step 3. move to settings-->control panel-->add/remove programs . step 4. remove the lsi logic cim solution program to uninstall it.
10-8 cim solution version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. 10.4 linux installation instructions for the cim solution this section describes a linux installation for version 2.00.00 of the cim solution. 10.4.1 installing the cim solution follow these steps to install the cim solution: step 1. unzip the cim package after downloading it. step 2. double-click on the ?nstall.htm program that you downloaded from the lsi logic web site. a ?ecurity warning window appears. you must grant additional privileges to the installanywhere to complete the installation. step 3. click on yes. step 4. click on ?tart installer for linux... the installanywhere begins. step 5. follow the instructions and steps in installanywhere. if this button does not appear in the browser, launch a terminal window and type ?/install.bin from the directory that accesses the cd-rom. to verify the installation for the cim browser, launch the application from /usr/local/bin/lsicim prompt by typing: ./cimlsibrowser 10.4.2 uninstalling the cim solution to uninstall the cim solution, follow these steps: step 1. exit the cim browser. step 2. change the directory by typing: cd /usr/local/bin/lsicim/uninstallerdata step 3. at the command prompt, type: ./uninstall_cim_solution step 4. click the uninstall button in the installanywhere window.
FUSION-MPT device management users guide ix-1 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. index symbols ?roc support 8-47 numerics 1030flsh.exe 2-1 a adapter 3-6 , 3-7 , 4-6 adapter boot order 3-6 adapter properties 3-4 , 4-4 adapter properties menu cu 3-9 efi cu 4-7 amba bus architecture 1-3 autonegotiation 5-5 autotopology 5-5 b basic input/output system 3-1 bbs 3-1 , 3-17 bbs initialization 3-2 binary device driver 1-3 bios 3-1 , 4-1 efi 4-1 im 3-3 , 3-4 , 3-7 initialization 3-2 updating 6-5 bios boot specification 3-1 boot 4-8 boot adapter list 3-4 cu 3-6 boot choice 3-17 boot information display mode 3-9 boot order 3-6 , 3-8 boot services driver 4-1 , 4-2 boot setup command 8-45 boot support 4-8 boot time loadable driver 8-29 boot/install server adding clients 8-22 booting the client 8-23 installing the itmpt driver 8-21 setting up 8-21 bsd 4-1 , 4-2 btld 8-29 bus width 8-45 c caldera. see linux. change adapters 5-5 chs mapping 3-12 cim 10-1 solution 10-1 cim browser 10-2 advance connections 10-4 allow selection of systems 10-4 connect 10-3 connect menu 10-3 connect to all addresses 10-4 connect to local host 10-3 disconnect 10-4 fully redundant 10-6 green status icon 10-4 hardware device tree 10-4 , 10-6 in degraded mode 10-6 provider is busy message 10-6 red status icon 10-4 redundancy is lost 10-6 yellow status icon 10-4 cim provider 10-2 cim solution features 10-2 installation 10-7 linux installation 10-8 requirements 10-2 common architecture 1-1 common information model 10-1 configuration protocol 4-2 configuration utility. see cu. cu 4-1 , 9-1 32-bit systems 3-1 64-bit systems 4-1 adapter properties menu 3-9 boot adapter list 3-6 device properties 3-13 , 3-16 efi 4-3 exiting 3-20 fc autonegotiation 5-5 autotopology 5-5 installing 5-3 multipathing 5-5 running 5-3 using 5-4 fibre channel 5-1 global properties menu 3-8 main menu 3-4 , 3-5 starting 3-2 user inputs 3-4 using 3-3 current status 3-8
ix-2 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. d data transfer rates 3-18 , 4-14 data width 3-17 , 3-18 , 4-13 , 4-14 degraded mode 10-6 delay time 5-5 dev/func 3-6 , 3-7 device driver windows 7-1 device identifier 4-12 device path 4-2 device properties 3-12 , 4-8 cu 3-13 , 3-16 efi cu 4-9 disable 4-9 disconnect 3-17 , 4-13 , 10-4 domain validation 1-3 , 3-1 domain validation command 8-45 dos4gw.exe 2-2 driver binding 4-2 driver diskette unixware 7 8-25 driver installation linux 8-38 sco openserver 5 8-29 solaris 8 8-1 , 8-4 sparc 8-19 sparc verfication 8-16 unixware 7 8-26 windows 2000 7-16 windows 98 7-3 windows millennium 7-5 windows nt 4.0 7-11 windows xp 7-7 windows.net 7-20 drvcfg 4-3 dual ported target 5-5 e eeprom 2-1 , 2-6 efi 4-1 , 4-3 efi cu adapter properties menu 4-7 device properties 4-9 exiting 4-16 main menu 4-4 , 4-5 mirroring properties menu mirroring properties menu 3-18 , 4-14 efi driver support field settings 4-9 enabled bios and os 4-9 enabled bios only 4-9 enabled os only 4-9 error log 7-24 extensible firmware interface 4-1 f fc 1-1 , 10-6 firmware 5-4 link speed 5-5 using flash utility 5-6 fc bios features intel 6-2 solaris sparc 6-2 updating 6-3 fc bios installation 6-1 fc cu change adapters 5-5 interrupt coalescing 5-5 fc firmware 5-1 updating 5-6 , 6-3 updating on linux systems 5-6 fc firmware troubleshooting 5-9 fc929.rom 5-1 fcode 8-15 fcode image 6-3 , 6-4 fcutil.exe 6-3 fcutil.exe 5-3 fdisk 3-12 fibre channel 1-1 bios mapping and installing drives 6-3 cu 5-1 features 5-2 files .dat 2-6 .img 2-6 firmware 1-3 , 4-2 configuring 5-4 to 5-5 fibre channel 5-2 to ?? translating message frames 5-2 firmware interface 4-1 firmware revision 4-6 flash configuration utility 5-3 flash rom 2-1 flash utility 2-1 command line options 2-4 menu options 2-2 floppy disk icon cim browser floppy disk icon 10-4 format 3-17 , 4-13 fully redundant 10-6 FUSION-MPT 1-1 architecture 1-2 firmware 1-3 hardware 1-3 single binary device driver 1-3 fw rev 4-6 g gigablaze 1-3 global properties 3-4 global properties menu cu 3-8 green status icon 10-4 h hardware device tree 10-4 , 10-6 host drivers 1-3 host scsi id 3-12 , 4-8 hot spare disk 3-18 , 4-14 i i/o replies 5-5 ia64 4-1 im 9-1 , 10-1 bios 3-3 , 3-4 , 3-7 device identifier 3-20 , 4-16 disk size 3-20 , 4-16 firmware 4-6 mirrored pair 3-20 , 4-16
ix-3 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. predict failure 3-20 , 4-16 scsi id 3-20 , 4-16 status 3-20 , 4-16 volume 10-6 volume scsi id 3-20 , 4-16 volume size 3-20 , 4-16 in degraded mode 10-6 infiniband 1-2 initialization bbs 3-2 cd-rom 3-2 input files 2-9 insmod 8-45 installation bsd 4-3 cim solution 10-7 , 10-8 fc cu 5-3 linux driver 8-38 sco openserver 5 driver 8-29 solaris 8 driver 8-1 , 8-4 sparc driver 8-19 sparc driver verfication 8-16 unixware 7 driver 8-26 windows 2000 driver 7-16 windows 98 driver 7-3 windows millennium driver 7-5 windows nt 4.0 driver 7-11 windows troubleshooting 7-24 windows xp driver 7-7 windows.net driver 7-20 int13h 3-1 , 8-15 integrated mirroring 9-1 , 10-1 interrupt coalescing 5-5 irq 3-6 , 4-6 isense driver 8-47 itmpt 8-14 , 8-19 device support 8-16 k kernel patch files 8-40 l lan connection 8-46 large block size support windows 2000 7-18 windows nt 4.0 7-14 windows xp 7-9 windows.net 7-22 limcu 9-1 command line options 9-2 command line synopsis 9-2 command line usage 9-6 error messages 9-7 required drivers 9-1 link speed 5-5 linux 1-3 , 8-37 ?roc support 8-47 adding FUSION-MPT support to the kernel 8-39 boot setup commands 8-45 building a driver 8-42 cu 9-1 device driver features 8-37 domain validation 8-45 driver installation 8-38 driver modules 8-43 im 9-1 integrated mirroring configuration utility 9-1 isense driver 8-47 kernel patch files 8-40 kernel patch steps 8-41 kernel versions 8-38 lan connection 8-46 limcu 9-1 linuxconf 8-46 maximum scsi bus width 8-45 minimum scsi synchronous factor 8-46 netcfg 8-46 supported devices 8-37 tar file extraction 8-38 troubleshooting 8-47 updating an existing installation 8-38 updating fc firmware 5-6 visible but not accessible luns 8-48 linuxconf 8-46 logical ids 5-5 lsi logic control 3-6 , 4-6 lsi logic pci scsi/fc mpi miniport driver 7-1 lsi logic website 1-3 , 7-2 , 8-3 , 8-29 cim solution 10-1 lsi919f.rom fcode image 6-4 lsi929f.rom 6-4 lsiadm 8-14 , 8-15 lsil 8-29 lsimpt.rom 4-3 lsimptsl driver creating a diskette 8-3 lsimptsl driver 8-4 , 8-16 , 8-19 , 8-20 , 8-26 , 8-29 , 8-38 building the update diskette 8-3 features 8-2 for solaris 8 systems 8-1 supported devices 8-2 updating the symcasl driver 8-8 lsiprobe 8-14 , 8-15 lsiupdate 8-14 , 8-15 lvdlink 1-3 m main menu cu 3-4 , 3-5 efi cu 4-4 , 4-5 maximum number of concurrent i/os windows 2000 7-19 windows nt 4.0 7-15 windows xp 7-10 maximum scsi bus width command 8-45 maximumsglist 7-9 , 7-15 , 7-18 , 7-22 mega transfers 3-18 , 4-14 message passing interface 1-3 message passing technology 1-3 metastor 8-14 mimimum scsi synchronous factor 8-46 miniport driver 7-3 configuration options 7-3 mirror status 4-6 mirroring properties 3-12 , 4-8 modifying adapter properties 3-4 , 4-4 mpi 1-3 mpi rev 4-6 mpi_256k.reg 7-10 , 7-14 , 7-18 , 7-22 mpi100io.reg 7-10 , 7-15 , 7-19 , 7-23 , 7-24 mpidefio.reg 7-10 , 7-20 , 7-24 mpidfblk.reg 7-10 , 7-15 , 7-19 , 7-23
ix-4 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. mpixp32.cat 7-2 mpixp64.cat 7-2 mpt 1-3 mptbios.rom 6-4 mptflash 5-6 mptlinux driver 8-39 mptscsih 8-45 multipathing 5-5 n negotiate with devices 3-9 netcfg 8-46 network 10-6 network system installation 8-20 next boot 3-8 n-port 5-5 nvdata utility command line examples 2-7 command line usage 2-6 creating input files 2-9 nvdata.dat 4-9 nvdata.efi 4-9 nvdata.exe 2-1 , 2-6 nvm 3-6 , 4-6 nvram 3-3 o oemsetup.inf 7-2 open unix 8. see unixware 7 openserver. see sco openserver 5. p patch files 8-40 pause when boot alert displayed 3-9 pci bus 3-6 , 3-7 , 4-6 pci dev 4-6 pci func 4-6 performance tuning windows 2000 7-18 windows nt 4.0 7-14 windows xp 7-9 windows.net 7-22 physical disk 10-6 plug and play 3-12 port number 3-6 primary disk 3-18 , 4-14 private loop 5-5 product 4-6 provider is busy message 10-6 public loop 5-5 q queue depth 5-5 queue tags 3-17 , 4-13 r red hat. see linux. red status icon 10-4 redundancy is lost 10-6 removable media support 3-12 rev id 4-6 s scan id 3-17 , 4-13 scan luns 3-17 , 4-13 sco openserver 5 8-28 adding a cr-rom drive 8-33 adding a disk drive 8-31 adding a tape drive 8-32 driver installation 8-29 existing system installation 8-31 features 8-29 installing the lsil driver 8-31 new system installation 8-30 potential problems 8-36 rebuilding the kernel 8-34 successful installation conditions 8-35 supported devices 8-29 troubleshooting 8-35 sco unix 8-28 scsi 1-1 , 10-6 scsi bios 3-1 scsi bus scan order 3-12 scsi data transfer rates 3-18 , 4-14 scsi id 4-12 scsi isense driver 8-47 scsi pass thru 4-2 scsi timeout 3-17 , 4-13 secondary cluster server 3-13 , 4-8 secondary disk 3-18 , 4-14 serial ata 1-2 serial eeprom 2-1 , 2-6 show-devs 8-16 solaris 1-3 solaris 8 building the update diskette 8-3 creating an lsimptsl driver diskette 8-3 driver features 8-2 driver installation 8-4 supported devices 8-2 troubleshooting 8-9 solaris 8 driver installation 8-1 solaris 8 x86 8-1 solaris sparc driver features ?? to 8-15 identifying fibre channel disks ?? to 8-18 solaris utilities 8-15 sparc device support 8-16 driver 8-14 , 8-20 driver features 8-15 driver installation 8-19 identifying fc disks 8-18 required system resources 8-16 supported devices 8-16 troubleshooting 8-23 sparc driver installation existing system 8-19 verfication 8-16 sparc system required resources 6-3 spin-up delay 3-12 , 4-8 storage network topology 10-1 support interrupt 3-9 supported devices 10-1 surelink domain validation 1-3 , 3-1 suse. see linux. svr4.2 operating system 8-24 symcasl 8-8 symmpi.cat 7-2 symmpi.inf 7-2
ix-5 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. symmpi.mpd 7-2 symmpi.sys 1-3 , 7-1 , 7-3 , 7-5 , 7-7 , 7-9 , 7-11 , 7-14 , 7-16 , 7- 18 , 7-20 , 7-22 , 7-24 features 7-1 symmpi.tag 7-2 symmpi2k.cat 7-2 synchronize whole mirror 3-12 , 4-8 synchronous period 3-18 , 4-14 system resources sparc 8-16 t target dual ported 5-5 termination control 3-13 , 4-9 timeout 3-17 , 4-13 topology 10-1 transfer rates 3-18 , 4-14 troubleshooting 7-24 fc firmware 5-9 linux 8-47 lsimptsl 8-9 sco openserver 5 8-35 solaris 8 8-9 sparc 8-23 unixware 7 8-28 turbolinux. see linux. txtsetup.oem 7-2 u unix svr4.2 8-24 unixware 1-3 unixware 7 8-24 building a driver diskette 8-25 supported devices 8-24 troubleshooting 8-28 unixware 7 driver features 8-24 unixware 7 driver installation 8-26 updating the symcasl driver 8-8 user inputs cu 3-4 utility 1030flsh.exe 2-1 flash 2-1 nvdata.exe 2-1 , 2-6 v verify 3-17 , 4-13 video mode 3-9 visible but not accessible luns 8-48 w website 1-3 , 7-2 , 8-3 , 8-29 , 10-1 windows 2000 1-3 driver installation 7-16 large block size support 7-18 maximum number of concurrent i/os 7-19 performance tuning 7-18 98 1-3 driver installation 7-3 class drivers 7-2 device driver 7-1 device driver files 7-2 installation 7-24 millennium 1-3 driver installation 7-5 net driver installation 7-20 large block size support 7-22 performance tuning 7-22 nt 4.0 1-3 configuration options 7-3 driver installation 7-11 large block size support 7-14 maximum number of concurrent i/os 7-15 performance tuning 7-14 supported devices 7-1 troubleshooting 7-24 xp driver installation 7-7 large block size support 7-9 maximum number of concurrent i/os 7-10 performance tuning 7-9 y yellow status icon 10-4
ix-6 version 1.2 copyright 2002 by lsi logic corporation. all rights reserved.
FUSION-MPT device management users guide version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. customer feedback we would appreciate your feedback on this document. please copy the following page, add your comments, and fax it to us at the number shown. if appropriate, please also fax copies of any marked-up pages from this document. impor tant: please include your name, phone number, fax number, and company address so that we may contact you directly for clari?ation or additional information. thank you for your help in improving the quality of our documents. readers comments fax your comments to: lsi logic corporation technical publications m/s e-198 fax: 408.433.4333 please tell us how you rate this document: FUSION-MPT device management users guide. place a check mark in the appropriate blank for each category. excellent good average fair poor completeness of information ____ ____ ____ ____ ____ clarity of information ____ ____ ____ ____ ____ ease of ?ding information ____ ____ ____ ____ ____ technical content ____ ____ ____ ____ ____ usefulness of examples and illustrations ____ ____ ____ ____ ____ overall manual ____ ____ ____ ____ ____
customer feedback version 1.2 copyright 2002 by lsi logic corporation. all rights reserved. what could we do to improve this document? if you found errors in this document, please specify the error and page number. if appropriate, please fax a marked-up copy of the page(s). please complete the information below so that we may contact you directly for clari?ation or additional information. name date telephone title company name street city, state, zip department mail stop fax
you can ?d a current list of our u.s. distributors, international distributors, and sales of?es and design resource centers on our web site at http://www.lsilogic.com/contacts/na_salesof?es.html


▲Up To Search▲   

 
Price & Availability of FUSION-MPT

All Rights Reserved © IC-ON-LINE 2003 - 2022  

[Add Bookmark] [Contact Us] [Link exchange] [Privacy policy]
Mirror Sites :  [www.datasheet.hk]   [www.maxim4u.com]  [www.ic-on-line.cn] [www.ic-on-line.com] [www.ic-on-line.net] [www.alldatasheet.com.cn] [www.gdcy.com]  [www.gdcy.net]


 . . . . .
  We use cookies to deliver the best possible web experience and assist with our advertising efforts. By continuing to use this site, you consent to the use of cookies. For more information on cookies, please take a look at our Privacy Policy. X