============================================================================= MultiBoot Update for QLogic 10 Gb Converged Network Adapter - IBM System x. Kit Version 1.01.94 05/11/2010 ============================================================================= Readme for QLogic MultiBoot Package ----------------------------------- This readme.txt file provides the basic information required for updating the QLogic adapter using automated procedures. For more detailed information on using the flashing utilities, please refer to the appropriate subdirectory. Contents Of Multiboot Package -------------------------------- The files contained in this Multiboot package are zipped into a file that will expand to provide the following versions for the Converged Network Adapter (CNA). Kit Version 1.01.94 Q8I10095.BIN contains: * BIOS version 2.14 * UEFI version 3.33 * Fcode PPC version 3.09 * Firmware version 5.03.05 * MPI version 1.40.00 * EDC PHY version 1.07.00 FlasUtil version 1.84 VPD version 10.00a Efiutil/x64 version 2.86 This update supports BladeCenter Open Fabric Manager (BOFM) NOTE: A QLogic Readme file that accompanied this update is attached to the end of this readme file. It is included for informational purposes only and contains references to update procedures not directly supported by this package. It is recommended that adapters are updated one at a time, or adapters of the same type (SSDID) are updated together. Do not have different adapter models in the system during the update/flash process. IMPORTANT NOTES: (1) This package requires the QLogic utility "SCLI" to perform the flash update. A compatible version of SCLI for 32/64 bit Linux and 32 bit Windows architectures is included in this package and will be automatically installed. The Linux version of SCLI will replace any previous version you had installed, it must be installed using the RPM utility. If your system does not have RPM loaded, then the SCLI utility included with this package will not load successfully and you will need to install SCLI manually prior to running this flash update. (2) If you choose to install the SCLI utility manually, please ensure that you install version 1.7.3-27 or later. The SCLI versions included with this package are 1.7.3-27. It is strongly recommended that you run the script "Uninstall-SCLI.sh" before attempting to install SCLI manaually. This script will remove all traces of previous SCLI installations. The script "SCLI-Inst.sh" will run the SCLI rpm install process. To gain access to these scripts and to the SCLI rpm file, extract this package to your hard drive by following the instructions below. Please see the file "SCLI-readme.txt" for more information about SCLI. (3) The Fibre Channel Driver (STOR) is required for this Multiboot code update to install properly. It is recommended that both the Fibre Channel Driver (STOR) and Network Driver (NIC) be updated to the latest levels before Multiboot code installation. (C) Copyright International Business Machines Corporation 1999, 2009. All rights reserved. US Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Note: Before using this information and the product it supports, read the general information in "Notices and trademarks" in this document. CONTENTS ________ 1.0 Overview 2.0 Installation and setup instructions 3.0 Configuration information 4.0 Unattended mode 5.0 Web information and support phone Number 6.0 Notices and trademarks 7.0 Disclaimer 1.0 Overview _____________ 1.1 This update includes the BIOS and firmware for QLogic HBAs for use with IBM BladeCenter. 1.2 Limitations - None 1.3 Problems fixed: - See change history for more details. 1.4 Level of Recommendations and Prerequisites for the update: - None 1.5 Dependencies - None 1.6 Update Contents o qlgc_fw_nic_qle8142-1.01.94_linux.bin - Flash update package o qlgc_fw_nic_qle8142-1.01.94_linux.chg - Change history o qlgc_fw_nic_qle8142-1.01.94_linux.txt - Readme 2.0 Installation and setup instructions ________________________________________ This package can be used with several of IBM's update management tools, including IBM UpdateXpress Manager, IBM UpdateXpress System Packs, and IBM Director. It can also be used as a standalone executable package. To use the package with one of IBM's update management tools, follow the instructions that came with your specific management tool. 2.1 Standalone usage instructions --------------------------------- As a standalone package, this executable can be used in the following ways: - to update the QLogic HBA FW on the local system - to copy all files necessary for the update to the local hard drive or other media Updating the local system: 1) Type "./qlgc_fw_nic_qle8142-1.01.94_linux.bin -s" at a command prompt. A successful return indicates firmware updated. Extracting files 1) Type "./qlgc_fw_nic_qle8142-1.01.94_linux.bin -x" , where is the fully qualified path where you want to extract the files, at a command prompt. Example of Included files: Q8I10194.BIN - FW/BIOS image file fcscli-exitcodes.txt - Listing of SCLI error/return codes Manual-Update.sh - Runs a manual FW flash without installing SCLI SCLI-Inst.sh - Installs new version of SCLI SCLI-readme.txt - SCLI usage instructions Uninstall-SCLI.sh - Uninstalls previous SCLI installations Update.sh - Runs the entire FW update, including uninstall/install of SCLI 2.2 Troubleshooting tips ------------------------ It has been found that the SCLI installation process is somewhat termpermental on some Linux machines. Extensive effort has been put into making the install work smoothly across all supported OS variants. Even so, it is possible that your machine may not install SCLI correctly, particularly if you've had this application previously installed. It is recommended that you run the automatic installation, as you would with any other update. If this results in a non-zero return code, refer to the file "fcscli-exitcodes.txt" which is included in this package. SCLI installation errors are usually caused by left-over pieces of an old SCLI version. Manually run the script "Uninstall-SCLI.sh" to remove these left-overs, then manually run "SCLI-Inst.sh" to install the new SCLI, or alternatively you can directly install the SCLI RPM (included in the package). Once SCLI is installed, you can either manually flash the FW/BIOS with SCLI (see SCLI-readme.txt for usage information) or you can run "Manual-Update.sh", which does the flash operation without reinstalling SCLI. You can also use the SCLI utility to view information about the HBA, including the installed FW/BIOS. Again, see the usage instructions in SCLI-readme.txt for more information. 3.0 Configuration information ______________________________ - None 4.0 Unattended Mode ____________________ To run this package in unattended mode, use the following command: qlgc_fw_nic_qle8142-1.01.94_linux.bin -s 5.0 Web Sites and Support Phone Number ______________________________________ o You can download new and updated files for IBM products from the IBM Support Web site: http://www.ibm.com/support/ o For the latest list of supported operating systems, see the IBM Server Proven - BladeCenter Web site: http://www.ibm.com/servers/eserver/serverproven/compat/us/eserver.html o With the original purchase of an IBM hardware product, you have access to extensive support coverage. During the IBM hardware product warranty period, you may call the IBM HelpCenter (1-800-IBM-SERV in the U.S.) for hardware product assistance covered under the terms of the IBM hardware warranty. 6.0 Trademarks and Notices __________________________ IBM is a registered trademark of International Business Machines Corporation in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. 7.0 Disclaimer ______________ THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation. **********Below are the Unedited Readme.txt information on components*************** from QLogic Multi-boot Image for 10Gb CNA IBM BIOS Readme File This software license applies only to QLogic customers. QLogic Corporation. All rights reserved. Table of Contents 1. Package Contents 2. 10Gb BIOS 2.1 BIOS Package Contents 2.2 Supported Features 2.3 Adapter Configuration (Fast!UTIL) 2.4 Updating the BIOS (Flasutil) 2.5 Additional Notes 3. Contacting Support ====================================================================== 1. Package Contents The multi-boot package for 10Gb adapters is a compressed file that contains the Qxx81xx BIOS,UEFI,PXE, FCode, and firmware. This package also includes the Flasutil and the VPD applications. * The multi-boot BIOS contained in this package supports 10Gb adapters on Intel x86/x64 and AMD64 platforms. * The UEFI Fibre Channel driver contained in this package supports 10Gb adapters on Intel x64 platforms. * The FCode contained in this package supports 10Gb adapters on PPC. * readme.txt - Readme file for the multi-boot package. This readme file contains details for the multi-boot image, including the BIOS, UEFI code, and FCode contained in this package. * release.txt - Release notes for the multi-boot package. This file contains revision notes for the multi-boot image, including the BIOS,PXE, UEFI code, and FCode contained in the package. ====================================================================== 2. 10Gb BIOS This section provides user notes regarding the BIOS contained in the 10Gb multi-boot package. 2.1 BIOS Package Contents ------------------------- The following list describes the BIOS files included for updating the adapter BIOS. * update.bat - DOS batch file that calls the executable files to update the adapter BIOS. * FlasUtil.exe - Utility to update multi-boot code and firmware. * VPD.exe - Utility to update the adapter's Vital Product Data. * x8xyyyyy.bin - Combined binary file, which includes the binaries for the firmware,PXE, FCode, EFI, and BIOS. 2.2 Supported Features ---------------------- * Up to 2031 target IDs. * Up to 256 LUNs. * Point-to-point configuration. * Boot capability in fabric topologies. * Compatible with DOS, Windows Server 2003,Windows Server 2008,Solaris x86, and Linux on IA32, AMD64, and Intel x64-based systems. 2.3 Adapter Configuration (Fast!UTIL) ------------------------------------- NOTE: The Fast!UTIL BIOS utility does not run on SUN SPARC systems. This section provides detailed configuration information for advanced users who want to customize the configuration of the 10Gb adapter and the connected devices. You can configure the adapter using Fast!UTIL. To access Fast!UTIL, press + or + during the adapter BIOS initialization (it may take a few seconds for the Fast!UTIL menu to appear). If you have more than one adapter, Fast!UTIL asks you to select the adapter you want to configure. After changing the settings, Fast!UTIL reboots your system to load the new parameters. CAUTION! If the configuration settings are incorrect, your adapter may not function properly. The Fast!UTIL Options menu provides the following options: * Configuration Settings (section 2.3.1) * Scan Fibre Devices (section 2.3.2) * Fibre Disk Utility (section 2.3.3) * Loopback Data Test (section 2.3.4) * Select Host Adapter (section 2.3.5) * Exit Fast!UTIL (section 2.3.6) 2.3.1. Configuration Settings ----------------------------- The following topics show and describe the configuration settings for the 10Gb adapter. * Adapter Settings (section 2.3.1.1) * Selectable Boot Settings (section 2.3.1.2) * Restore Default Settings (section 2.3.1.3) * Raw NVRAM Data (section 2.3.1.4) * Advanced Adapter Settings (section 2.3.1.5) 2.3.1.1. Adapter Settings ------------------------- * Host Adapter BIOS (Enabled/Disabled: Default - Disabled) Disabling this setting disables the ROM BIOS on the adapter, which frees space in upper memory. If you are booting from an FC disk drive attached to the adapter, you must enable this setting. For details, see section 2.3.1.2. * Frame Size (512/1024/2048: Default - 2048) This setting specifies the maximum frame length supported by the adapter. * Loop Reset Delay (0 - 60 seconds: Default - 5 seconds) After resetting the loop, the firmware refrains from initiating any loop activity for the number of seconds specified in this setting. * Spin Up Delay (Enabled/Disabled: Default - Disabled) When this bit is set, the BIOS waits up to two minutes to find the first drive. * Fibre Channel Tape Support (Enabled/Disabled: Default - Enabled) This setting enables FCP-2 recovery. 2.3.1.2. Selectable Boot Settings --------------------------------- The Configuration Settings menus provide access to the Selectable Boot Settings option. If you enable the Adapter BIOS in the adapter Settings, this option allows you to select the boot device as follows: Selectable Boot Port Name Boot /LUN Device Boot ---------- -------------- ----------- Disabled X BIOS configures the first disk drive it finds as boot device. Enabled none specified BIOS configures the first disk drive it finds that is also a LUN 0 as boot device. Enabled specified BIOS scans through the specified WWPN/LUN list until it Boot drive. This finds a disk configured as the boot device. This option allows you to specify up to four WWPN/LUN as boot devices. To enable the Selectable Boot option and insert devices into the boot device locations, follow these steps: 1. From the Configuration Settings menu, select Adapter Settings. 2. Enable the adapter BIOS, then press ESC to return to the Configuration Settings menu. 3. From the Configuration Settings menu, select Selectable Boot Settings. 4. Press ENTER to enable or disable (toggle) the Selectable Boot option. Use the down arrow key to move to the Primary location of the Selectable Boot List menu. 5. Press ENTER to see a list of accessible devices (in the Select Fibre Channel Device menu). 6. Select a drive using the arrow keys to scroll down to the device you want to put into your Selectable Boot menu list, then press ENTER to select the requested device and load it into the Selectable Boot menu list. 7. Repeat this step to specify a secondary boot device on the Qxx81xx adapter or up to four alternate boot devices. NOTES: System BIOS Compatibility In a computer system with a multi-boot system BIOS (CMOS), in order to boot from a QLogic adapter, the adapter must be included in the list of bootable devices in the system's Boot menu. Solaris X86 Boot from a SAN To boot from an FC drive connected to a QLogic adapter, reboot the system and enter fast!Util. Enter into the Selectable boot menu,enable selectable boot and insert the BOOT drive in the Primary location of the Selectable Boot menu prior to performing the OS (Solaris X86) installation. For these BOOT from SAN configurations, the Solaris x86 QLA driver supports booting from the Primary location only. The driver will not attempt to boot from the Alternate 1, Alternate 2, and Alternate 3 entries. 2.3.1.3 Restore Default Settings -------------------------------- The Restore Defaults option from the Configuration Settings menu restores the BIOS settings back to default. 2.3.1.4 Raw NVRAM Data ---------------------- This option displays the adapter’s NVRAM contents in hexadecimal format. This is a QLogic troubleshooting tool; You cannot modify the RAW NVRAM data. 2.3.1.5 Advanced Adapter Settings From the Configuration Settings menu in Fast!UTIL, select Advanced Adapter Settings. The following paragraphs describe the default settings for the 10Gb adapter. * Execution Throttle ( 1-65535: Default - 65535) This setting specifies the maximum number of commands executing on any one target port. After reaching a target port’s execution throttle, it stops issuing new commands until one of the current commands finishes executing. * LUNs per Target (0/8/16/32/64/128/256: Default - 128) This setting specifies the number of LUNs supported per target if the target does not support the "Report LUNs" command. Multiple LUN support typically applies to a redundant array of independent disks (RAID) boxes that use LUNs to map drives. * Enable Target Reset (Yes/No: Default - Yes) This setting enables the drivers to issue a Target Reset command to all devices on the loop when a SCSI Bus Reset command is issued. * Login Retry Count (0 - 255: Default - 8) This setting specifies the number of times the software tries to log in to a device. * Port Down Retry Count (0 - 255 seconds: Default - 30 seconds) This setting specifies the number of seconds the software waits to retry a command to a port returning port down status. * Link Down Timeout (0 - 255 seconds: Default - 30 seconds) This setting specifies the number of seconds the software waits for a link down to come up. * Operation Mode (0/5/6: Default - 0) This setting specifies the reduced interrupt operation (RIO) modes, if supported by the software driver. The RIO modes allow posting multiple command completions in a single interrupt. This option supports the following modes: 0 - Interrupt for every I/O completion 5 - Interrupt when Interrupt Delay Timer expires 6 - Interrupt when Interrupt Delay Timer expires or no active I/Os * Interrupt Delay Timer (0 - 255 seconds: Default - 0) This setting contains the value (in 200-microsecond increments) that a timer uses to set the wait time between generating an interrupt. * Enable Interrupt ( Yes/No: Default - No) Enable or disable the interrupt: Yes - Enables the BIOS to use the IRQ assigned to the ISP25xx. No - The BIOS polls for ISP mailbox command completion status. * Primary FCF VLAN ID: (Enabled/Disabled: Default - Disabled) This setting enables the primary VLAN ID to be used. 2.3.2. Scan Fibre Devices ------------------------- This option scans the FC loop and lists all the connected devices by loop ID. It lists information about each device (for example, vendor name, product name, and revision). This information helps when configuring your adapter and attached devices. 2.3.3. Fibre Disk Utility ------------------------- This option scans the Fibre Channel loop and lists all the connected devices by loop ID. You can select a Fibre Channel hard disk and do one of the following tests: * Perform a low-level format * Verify the disk media * Verify the disk data (Some targets do not support this feature.) * Select a different disk device CAUTION! Performing a low-level format destroys all data on the disk. 2.3.4. Loopback Data Test ------------------------- This option allows you to perform an external Loopback test. NOTE: When running the external Loopback data test, make sure that the Loopback connector is attached to the adapter port(s) before starting the test. Do not run this test with the adapter connected to the fabric switch port. 2.3.5. Select Host Adapter --------------------- If you have a multi-port or multiple 10Gb adapters in your system, use this option to select and then configure or view the settings of a specific adapter port or adapter. 2.3.6. Exit Fast!UTIL -------------------- This option allows you to exit the utility and reboot the system or to return to Fast!UTIL. After making changes to the QLogic adapter in Fast!UTIL, make sure you save the changes before you reboot the system. 2.4 Updating the BIOS (FlasUtil) The QLogic flash programming utility is a DOS utility. To run this utility, boot to a DOS hard drive or USB removable drive. NOTE: Do not run this utility from drive connected to the 10Gb adapters. Make sure Flasutil.exe and the x8xyyyyy.bin source files are in the same directory. 2.4.1. Flashing the BIOS ------------------------ To flash the BIOS: 1. Insert the 10Gb adapter in the system. 2. Boot to DOS. 3. Run the update script at the command prompt: C:\>update.bat This script program updates the BIOS image on the adapter. 4. Reboot the system. NOTEs: 1. You can also use SANsurfer GUI/CLI to flash the Multi-boot image. 2. After the multi-boot code is updated, power recycle the server for the new changes to take effect. 2.4.2. FlasUtil Command Line Options ------------------------------------ The executable file Flasutil.exe is used by the UPDATE.BAT file to update your adapter BIOS. The application FlasUtil.exe, may be used to read, write or verify the multi-boot image, or the NVRAM on the adapter. The following paragraphs describe the command line options available with this utility. Use of Flasutil will modify the way your adapter operates, and it must be used with extreme caution. Certain features (i.e. The NVRAM options) may require additional data files and passwords not provided in this file. Default Options --------------- Enter Flasutil will list QLogic adapters at different I/O addresses. Enter adapter I/O address for menu options. Flasutil /? for command line details. /L xxxx = Write NOVRAM to adapter address xxxx.Using this option without an address writes the NOVRAM to all adapters. /F xxxx = Writes BIOS code to the adapter at I/O address = xxxx. Using this option without an address writes BIOS code to all adapters. If the adapter already contains a valid BIOS, this option preserves the existing NVRAM contents. /FR xxxx = Writes firmware (Risc Code) to the adapter at address = xxxx. Using this option without an address writes firmware to all adapters. /D xxxx = Copy NVRAM to file: QLxxNVR.SAV, adapter address = xxxx. /W xxxx = Copies the image of the BIOS from the adapter at address xxxx into a file (for example, QLxxROM.SAV). /WB xxxx = Copies the 1MB complete boot image from the adapter at address xxxx to a file (for example, QLxxROM.SAV). Note: This option is not supported on CNA adapter. /N = Use instead of Qxxxxxx.DAT. /O = Use instead of x8xyyyyy.bin. /I = Ignore Subsystem ID /Q = Quiet Mode, no messages will be displayed. /S xxxx = Display serial number of adapter at address xxxx.Using this option without an address will display serial numbers of all adapters. /V xxxx = Displays current version of the BIOS on adapters at address xxxx. Using this option without an address displays the BIOS version of all adapters. /C xxxx = Verifies the image of the BIOS on the adapter at address xxxx. Using this option without an address verifies the BIOS images of all adapters. Note: This option is not supported on CNA adapter. /X xxxx = Verify NVRAM of adapter at address xxxx.Using this option without an address verifies the NVRAM OF all adapters. /Y xxxx = Displays the port name of the adapter at address xxxx. Entering this option without an address displays the port name of all adapters. For example, for adapters with previously valid flash and NVRAM contents, use the following command line options: * To update the flash on a QLogic adapter: c:\>flasutil /f /o x8xyyyyy.bin * To update the PXE on a QLogic adapter: c:/>flasutil /fp /o Qxxxxxx.bin * To update the firmware code (only) on a QLogic adapter: c:\>flasutil /fr /o qxxxx.bin (Firmware File) 2.5 Additional Notes -------------------- * If you used an FC RAID target in a Cluster Environment, you should enable the Enable Target Reset = Enabled (Advanced Adapter Settings). * Use /I option if the update utility, FlasUtil, does not detect your Fibre Channel adapter. * From the Flasutil application menu, the only option for dumping/copying is W and this will Save/dump the Flash in a file called QLxxROM.SAV * The /D option dumping/copying the NVRAM is will save the NVRAM in a file called QLxxNVR.SAV * Some FlasUtil options may require the use of an external filename instead of the default file. EXAMPLES: C:\Flasutil /C /O x8xyyyyy.bin Note: This above option is not supported on CNA adapter. C:\Flasutil /D /N Qxx81xx.DAT * It is recommended disabling the internal disk before installing OS or Booting to FCoE disk. ====================================================================== 3. Contacting Support Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods: Web: http://support.qlogic.com Email: support@qlogic.com (c)Copyright 2010. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners. *************** 10Gb Fibre Channel Driver and Utilities for UEFI *************** Readme File 10Gb Fibre Channel Driver and Utilities for UEFI Readme File Table of Contents 1. Introduction 2. UEFI Package Contents 3. Supported Adapters 4. Supported Features 5. Supported Computer Systems 6. Supported Operating Systems 7. Adapter Configuration 8. Updating the UEFI Driver 9. Additional Notes 10. Contacting Support 1. Introduction This document provides user notes regarding the Fibre Channel Driver and Utilities for UEFI. 2. UEFI Package Contents The following list describes the files included in the UEFI driver package: * x8xyyyyy.bin - Combined binary file, which includes the binaries for BIOS, FCode, UEFI driver, and RISC Firmware * EfiUtil.EFI or EfiUtilx64.EFI - UEFI Utility to update the UEFI driver, firmware, and NVRAM. * QL8XXX.DRV - Auxiliary driver file used for updating the adapter. * UPDATE.NSH - UEFI script file used to update the adapter on a UEFI system. * EFICFG.PDF - Adapter Configuration and Diagnostic PDF. * EFIUTIL.PDF - Adapter EfiUtil Utility PDF. * REVHISTORY.TXT - Revision History for driver and Efiutil. NOTES: * All bin, efi, and nsh files are required to update the adapter on a UEFI system. 3. Supported Adapters * QLE81xx * QMI81xx 4. Supported Features The UEFI driver supports the following features: * HII (Human Interface Infrastructure) * UEFI Specification 1.10, 2.1 * UEFI protocols: Extended SCSI Pass Thru, Block IO, SCSI IO, Driver Diagnostics, Driver Configuration, Component Name * 382 targets * 2047 LUNs per target * Fabric topology * Boot from SAN 5. Supported Computer Systems The UEFI driver supports the following systems: * x64 based systems 6. Supported Operating Systems The UEFI driver has been tested with the following operating systems: * Windows 2008 x64 * SLES 11 x64 7. Adapter Configuration Refer to the EFICFG.PDF file to configure the adapter parameters. 8. Updating the UEFI Driver For systems that do not include a built-in UEFI Shell, please obtain the UEFI Shell program from the open source site https://www.tianocore.org/ . To update the UEFI Driver and RISC Firmware on all HBAs: 1. Unzip and copy the update kit files to the root level of a USB storage device. NOTE: Please do not change or rearrange the kit directories and/or files that were unzipped and copied to the USB storage device. 2. Connect the USB device to the UEFI based system with the HBAs. 3. As the system is starting to boot-up, Press F1 to enter setup. 4. Go to Boot Manager 5. Go to Boot From File 6. Select the USB device from the list where your files reside. 7. Navigate to the FullShell.efi file that you previously downloaded and hit enter. 8. The system will now be at the UEFI shell prompt "SHELL>", run the "map -b" command to display the file system mapping. 9. Locate the USB device and change to that device. For example, if the USB device is mapped to fs1 after the map -b, run: fs1: The UEFI shell prompt should change as follows: fs1:\> 10. Run the update.nsh script to update the UEFI driver and RISC Firmware. For example: fs1:\> update.nsh Update.nsh will call EfiUtilx64.efi to update all of the HBAs. 11. Reboot the system to make the Driver/Firmware changes take effect. For additional EfiUtilx64.efi functions, refer to efiutil.pdf. 9. Additional Notes If the storage is modified, added or deleted at the UEFI level and is not detected by the QLogic HBA, reboot the system and re-enter UEFI setup. SAN disk installations with Windows 2008 in UEFI Server Mode, requires that the adapter connection to the storage LUNs is on the Active path, and all the storage LUNs are set to GPT partition before starting the installation. At the first Windows 2008 installation menu, the adapter driver is loaded (if necessary) and the storage LUNs are displayed. To ensure the LUNs are in the proper GPT format, press shift-F10 to access a DOS command window and then enter diskpart at the command line. Use diskpart to clean and prepare all SAN attached LUNs as GPT partitions. 10. Contacting Support Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods: Web: http://support.qlogic.com North America Contact Information Email: support@qlogic.com Phone: (952) 932-4040 Support contact information for other regions of the world is available at the QLogic website: http://support.qlogic.com © Copyright 2010. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners. ********************** Multi-boot Image for 10Gb CNA ************************* FCODE Readme File FCode for CNA IBM_PPC Readme File This software license applies only to QLogic customers. QLogic Corporation. All rights reserved. Contents -------- 1. OS Support 2. Supported features & Notes 3. Selecting QLogic HBA port node on IBM machines 3.1 Getting to the OK prompt on IBM PSeries machines 3.2 Getting to the OK prompt on IBM Blade machines 3.3 Selecting the FC device from the OK prompt 4. Setting and viewing NVRAM Parameters 4.1 Setting and viewing login-count 4.2 Setting and viewing link-down-timeout 4.3 Setting and viewing port-down-count 4.4 Setting and viewing max-frame-size 4.5 Setting and viewing boot-wait-time 4.6 Restoring NVRAM Parameter Defaults 5. Diagnostic Commands 5.1 Version command 5.2 Selftest 5.3 ext-loopback-test command 5.4 Show-children command 5.5 disk-test command 5.6 sel-dev 5.7 sel-lun 6. Updating FCode on adapter 7. Building a Bootable FC Disk 8. Contacting QLogic ============================================================================== 1. OS Support -------------- This FCode supports IBM PPC AIX 5.3. This FCode supports IBM PPC Linux RHEL 5.3 This FCode supports IBM PPC Linux SLES 10 This FCode supports IBM PPC Linus SLES 11 ============================================================================== 2. Supported Features & Notes ----------------------------- * 2048 Target ID Support * 8192 LUN/Target Support * CNA support Notes: 1. Some FCode settings at OF will not be reflected in the SCLI or the SANSurfer. 2. Issue reset-all when change is made to the FCode or Fiber link/target. ============================================================================== 3. Selecting QLogic Adapter port node on IBM machines ------------------------------------------------- Prior to setting Fibre Channel Adapter NVRAM parameters or executing Diag commands, the device must be selected. To select the device, you must first get to the to the SMS menu and then to the OpenFirmware(OF) ok prompt, as described below. 3.1. Getting to the OK prompt on IBM PSeies machines ---------------------------------------------------- System is powering on. PRESS ENTER TO CONTINUE: (do not press enter here, wait for IBM banner) ... IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM IBM 1 = SMS Menu 5 = Default Boot List 8 = Open Firmware Prompt 6 = Stored Boot List Memory Keyboard Network SCSI Speaker PowerPC Firmware Version SF240_320 LKM 1.6 (c) Copyright IBM Corp. 2000,2005 All rights reserved. --------------------------------------------------------------------------- Language Selection Menu Current Language : ISO8859-1 English (United States) 1. Change Language 2. Continue to Password Entry -------------------------------------------------------------------------- Type menu item number and press Enter: 2 .---------------------------------------------------------------. | Please enter the Service Processor 'admin' account password. | `---------------------------------------------------------------' ***** (password = admin) PowerPC Firmware Version SF240_320 SMS 1.6 (c) Copyright IBM Corp. 2000,2005 All rights reserved. -------------------------------------------------------------------------- Main Menu 1. Select Language 2. Setup Remote IPL (Initial Program Load) 3. Change SCSI Settings 4. Select Console 5. Select Boot Options -------------------------------------------------------------------------- Navigation Keys: X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key: 0 (zero) .--------------------------------------. | Exit SMS to OK> Prompt? (Y)es/(N)o | `--------------------------------------' y ok 0 > 3.2. Getting to the OK prompt on IBM Blade machines --------------------------------------------------- Open Telnet session to Chassis ystem>env -T blade[x] x= slot number ... ....... PowerPC Firmware Version EA340_062 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. ------------------------------------------------------------------------------- Main Menu 1. Select Language 2. Setup Remote IPL (Initial Program Load) 3. Change SCSI Settings 4. Select Console 5. Select Boot Options 6. Firmware Boot Side Options ------------------------------------------------------------------------------- Navigation Keys: X = eXit System Management Services ------------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:0 (Enter 0) .--------------------------------------. | Exit SMS to OK> Prompt? (Y)es/(N)o | `--------------------------------------' Type "y" 3.3 Selecting the FC device from the OK prompt ------------------------------------------------ 0 > show-devs 0000020882b0: /ibm,serial 00000208aff8: /chosen 00000208b250: /packages ... 000002189960: /pci@2 000002214380: /fibre-channel@0 000002227ec8: /disk 0000022288d0: /fibre-channel@0,1 00000223c418: /disk ok 0 > 02214380 to active-package ok 0 > pwd /pci@800000020000004/pci@2/fibre-channel@0 ok 0 > " /pci@800000020000004/pci@2/fibre-channel@0" select-dev ^-- must have leading space. If you are in a windows environment, you can cut and paste the Adapter's device number and path into the dev and select-dev commands. When the Adapter device is selected the first time, similar banner should appear: QLogic QMIXXXX Host Adapter FCode(IBM): X Y Firmware version Z NOTE: Where X = FCode Version,Y = Date of FCode version release and Z = Firmware Version ============================================================================== 4. Setting and viewing NVRAM Parameters ---------------------------------------- To list all NVRAM and Diagnostic Commands: type "show-commands" at ok prompt. ok 0 > show-commands show-commands NVRAM Parameter commands show-settings set-login-count set-link-timeout set-port-down-count set-max-frame-size set-boot-wait-time restore-default-settings Diag Commands version selftest ext-loopback-test show-children disk-test sel-dev sel-lun See readme.txt for details To show the current value of all of the NVRAM parameters, as well as the version, serial number, and Adapter WWN, type "show-settings". Example: ======== ok 1 > show-settings QLogic QMIxxxx Host Adapter FCode(IBM): x y Firmware version z MPI FW version vv.vv.vv Serial# 11S42C1831YK5122P3POUT node-wwn 20000021 5e4c406d port-wwn 21000021 5e4c406d Enode MAC Address: 0 21 5e 4c 40 6d Current FCF VLAN-ID: Not Valid Current Adapter MAC Address Mode: FPMA only Current FW login-retry-count: 8(8) Current link-down-timeout: 1e(30) seconds Current port-down-retry-count: 1e(30) Current max-frame-size: 800(2048) Current boot-wait-time: DISABLED NOTE: Where X = FCode Version, Y = Date of FCode version release and Z = Firmware version XXXx = Model number vv.vv.vv=MPI Fw version 4.1. Setting and viewing login-count ----------------------------------------- The login-retry-count NVRAM parameter is used by the FCode to determine the number of login retries attempted to the boot device. The default value is 8. Use the set-login-count command to change this parameter. Example: ok 0 > set-login-count Current login-retry-count: 8(8) Do you want to change it? (y/n) y login-retry-count: Enter 1-ff hex: 7 Current login-retry-count: 7(7) 4.2 Setting and viewing link-timeout ----------------------------------------- The link-down-timeout NVRAM parameter is used by the FCode to determine the number of seconds to wait for the link to come up. The default value is 30. Use the set-link-timeout command to change this parameter. Example: ok 0 > set-link-timeout Current link-down-timeout: 1e(30) seconds Do you want to change it? (y/n) y link-down-timeout: in Secs. Enter 2-ff hex: 14 Current link-down-timeout: 14(20) seconds 4.3 Setting and viewing port-down-count --------------------------------------------- The port-down-retry-count NVRAM parameter is used by the FCode to determine the number of retries for the start, read and write SCSI commands. The default value is 30. Use the set-port-down-count command to change this parameter. Example: ok 0 > set-port-down-count Current port-down-retry-count: 1e(30) Do you want to change it? (y/n) y port-down-retry-count: Enter 1-ff hex: 10 Current port-down-retry-count: 10(16) 4.4 Setting and viewing max-frame-size -------------------------------------- The max-frame-size NVRAM parameter is used by the FCode to set the maximum frame length field in the Firmware Initialization Control Block. The default value is 2048. Use the set-max-frame-size command to change this parameter. Example: ok 0 > set-max-frame-size Current max-frame-size: 800(2048) Do you want to change it? (y/n) y Choose max-frame-size: 1 - 512 2 - 1024 3 - 2048 enter: 2 Current max-frame-size: 400(1024) 4.5 Setting and viewing Boot-wait-time --------------------------------------- The boot-wait-time NVRAM parameter is used by the FCode to adjust the time to wait in seconds for the boot device to become online. The default value is 'DISABLED', which sets it to 8 seconds. The maximum value is 65,535 seconds (18 hours, 6 minutes). The minimum value is 8 seconds, same as when disabled. Because this wait-time can be very long, the boot process may be aborted at any time by typing the 'escape' key. Use the set-boot-wait-time command to change this parameter. Example 1: {0} ok set-boot-wait-time Current boot-wait-time: DISABLED Do you want to change it? (y/n) y boot-wait-time: Enter 8-ffff hex: 168 Current boot-wait-time: 168(360) seconds (this example sets it to 6 minutes) Example 2: {0} ok set-boot-wait-time Current boot-wait-time: 168(360) seconds Do you want to change it? (y/n) y Do you want to Disable it? (y/n) y Current boot-wait-time: DISABLED (this example disables the parameter) 4.6 Restoring NVRAM Parameter Defaults --------------------------------------- Use the restore-default-settings command to restore the default values of all NVRAM parameters used by the FCode. Example: ok 0 > restore-default-settings Reset all NVRAM values back to defaults. Are you sure? (y/n) y NVRAM defaults restored Current login-retry-count: 8(8) Current link-down-timeout: 1e(30) seconds Current port-down-retry-count: 1e(30) Current max-frame-size: 800(2048) ok 0 > ============================================================================== 5. Diagnostic Commands ----------------------- To execute any of the diagnostic commands, first select the device as described in section 3, above. Then enter the command. The diagnostc commands described in this section include: Version: List FCode version. beacon : Flashing Adapter's LED. selftest : Test Adapter memory and loopback. ext-loopback-test : Test external Loopback. show-children : List all attached targets. disk-test: Test a selected target. sel-dev: Select a device for disk-test. sel-lun: Select LUN # for disk-test. 5.1. Version command -------------------- To display the current FCode and Firmware version, simply type "version". Example: ok 0 > version QLogic QMIxxxx Host Adapter FCode(IBM): X Y Firmware version Z ok 0 > NOTE: Where X = FCode Version,Y = Date of FCode version release and Z = Firmware version xxxx = Model number 5.2. Selftest ------------- Note: It is recommended using a Loopback plug. This will insure that the external loopback test will be executed. To execute selftest, simply enter "selftest .". Example: ok 0 > selftest . nvram ok FCode Checksum OK Testing memory, pattern 0 - PASS Testing memory, pattern ffffffff - Passed Testing memory, pattern 55aa5555 - Passed Testing memory, pattern aaaa55aa - Passed Testing memory, pattern a55aa55a - Passed Testing memory, pattern 5b5a5a6a - Passed Testing memory, pattern ff00f0f0 - Passed Testing memory, pattern 1ff00f0e - Passed 10-bit Internal Loopback Test - Passed 1-bit Internal Loopback Test - Passed ok 0 > 5.3. ext-loopback-test command ------------------------------- The ext-loopback-test method allows the user to manually execute the external looback test. Selftest will skip this test if the Adapter device is attached to a Switch. The Diag Echo command is used instead of the loopback command if the topology is either F-port or FL-port (i.e. a Switch). The Diag Echo command is not supported by all FC Switches. Therefore, it is skipped during Selftest. Example: ext-looback-test Switch Diag Echo Loopback Test - Passed ok 0 > 5.4. show-children command --------------------------- Example: ok 0 > show-children 0 > show-children Adapter portID - 10d00 ************** Fabric Attached Devices ************** Dev# 0(0) PortID 10f9b Port WWN 21000011c6811815 LUN 0 DISK SEAGATE ST336854FC 0005 Dev# 1(1) PortID 10f9d Port WWN 21000011c6811456 LUN 0 DISK SEAGATE ST336854FC 0005 ok 0 > ok 0 > 5.5. disk-test command ----------------------- The disk-test was added as a diagnostic tool to allow the user to perform as simple, non-destructive, read/write data test to a selected target. To execute disk-test, follow these steps, below. 1. Select the Adapter device as described in section 3, above. 2. Execute show-children Pick a target (Dev#) and LUN from the listed devices. 3. Login to the target by typing: " sel-dev" Example: 7 sel-dev (will login to Dev# 7) 4. Select a LUN. by typing: " sel-lun" Example: 4d sel-lun (will select LUN 4d, hex) Note: You may skip this step if the LUN # =0, which is the default. 5. Execute disk-test by typing "disk-test". disk-test will perform a read-write-read-compare test to the selected target, 64 blocks (32k bytes) at a time. While it is running it will display the current disk block address. The test can be terminated by pressing any key. The disk-test command can also be used to locate a particular target, if there is an activity LED on the target. 5.6 sel-dev ------------------ Select a device for disk-test. 5.7 sel-lun ------------ sel-lun: Select LUN # for disk-test. ============================================================================== 6. Updating FCode on adapter ---------------------------- You can update the FCode using SANsurfer FC Adapter Manager or the SCLI application. Before flashing the FCode, the latest QLogic Adapter driver must be installed. Copy the multi-boot binary file I8ixxyyy.BIN. For procedures on updating FCode using the SANsurfer applications, see the FC HBA Manager Online Help and the SCLI User's Guide. ============================================================================== 7. Building a FC bootable FC Disk --------------------------------- Confirm FC target is attached in section 5.5 and insert 1st OS CD in the CDroM or Media tray: PowerPC Firmware Version EA340_030 SMS 1.7 (c) Copyright IBM Corp. 2000,2005 All rights reserved. -------------------------------------------------------------------------- Main Menu 1. Select Language 2. Setup Remote IPL (Initial Program Load) 3. Change SCSI Settings 4. Select Console 5. Select Boot Options -------------------------------------------------------------------------- Navigation Keys: ESC key = return to previous screen X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key: 5 PowerPC Firmware Version EA340_030 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. -------------------------------------------------------------------------- Multiboot 1. Select Install/Boot Device 2. Configure Boot Device Order 3. Multiboot Startup -------------------------------------------------------------------------- Navigation Keys: ESC key = return to previous screen X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:1 .------------------. | PLEASE WAIT.... | `------------------' PowerPC Firmware Version EA340_030 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. -------------------------------------------------------------------------- Select Device Type 1. Diskette 2. Tape 3. CD/DVD 4. IDE 5. Hard Drive 6. Network 7. List all Devices -------------------------------------------------------------------------- Navigation Keys: ESC key = return to previous screen X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:3 PowerPC Firmware Version EA340_030 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. -------------------------------------------------------------------------- Select Media Type 1. SCSI 2. SSA 3. SAN 4. SAS 5. SATA 6. USB 7. IDE 8. ISA 9. List All Devices -------------------------------------------------------------------------- Navigation Keys: ESC key = return to previous screen X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:6 .------------------. | PLEASE WAIT.... | `------------------' PowerPC Firmware Version EA340_030 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. -------------------------------------------------------------------------- Select Device Device Current Device Number Position Name 1. 2 USB CD-ROM ( loc=U78A5.001.WIH23F6-P1-T1-L1-L2-L3 ) -------------------------------------------------------------------------- Navigation Keys: ESC key = return to previous screen X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:1 PowerPC Firmware Version EA340_030 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. -------------------------------------------------------------------------- Select Task USB CD-ROM ( loc=U78A5.001.WIH23F6-P1-T1-L1-L2-L3 ) 1. Information 2. Normal Mode Boot 3. Service Mode Boot -------------------------------------------------------------------------- Navigation Keys: ESC key = return to previous screen X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:2 PowerPC Firmware Version EA340_030 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. -------------------------------------------------------------------------- Are you sure you want to exit System Management Services? 1. Yes 2. No -------------------------------------------------------------------------- Navigation Keys: X = eXit System Management Services -------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:1 ... Please refer to OS installation manual to complete the Installation process.. ................................................................................ Once the installation is completed: ---------------------------------- PowerPC Firmware Version EA320_046 SMS 1.7 (c) Copyright IBM Corp. 2000,2007 All rights reserved. ------------------------------------------------------------------------------- Main Menu 1. Select Language 2. Setup Remote IPL (Initial Program Load) 3. Change SCSI Settings 4. Select Console 5. Select Boot Options 6. Firmware Boot Side Options ------------------------------------------------------------------------------- Navigation Keys: X = eXit System Management Services ------------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key: 5 PowerPC Firmware Version EA320_046 SMS 1.7 (c) Copyright IBM Corp. 2000,2007 All rights reserved. ------------------------------------------------------------------------------- Multiboot 1. Select Install/Boot Device 2. Configure Boot Device Order 3. Multiboot Startup ------------------------------------------------------------------------------- Navigation keys: M = return to Main Menu ESC key = return to previous screen X = eXit System Management Services ------------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key: 1 PowerPC Firmware Version EA320_046 SMS 1.7 (c) Copyright IBM Corp. 2000,2007 All rights reserved. ------------------------------------------------------------------------------- Select Device Type 1. Diskette 2. Tape 3. CD/DVD 4. IDE 5. Hard Drive 6. Network 7. List all Devices ------------------------------------------------------------------------------- Navigation keys: M = return to Main Menu ESC key = return to previous screen X = eXit System Management Services ------------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key:7 PowerPC Firmware Version EA340_062 SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. ------------------------------------------------------------------------------- Select Device Device Current Device Number Position Name 1. 2 PORT - 1 IBM Host Ethernet Adapter ( loc=U78A5.001.WIH2EF5-P1-T6 ) 2. - PORT - 2 IBM Host Ethernet Adapter ( loc=U78A5.001.WIH2EF5-P1-T7 ) 3. 1 SAS 136 GB Harddisk, part=1 () ( loc=U78A5.001.WIH2EF5-P1-D1 ) 4. - SCSI 34 GB FC Harddisk, part=1 () ( loc=U78A5.001.WIH2EF5-P1-C12-T1-W21000011c6811815-L0 ) ------------------------------------------------------------------------------- Navigation keys: M = return to Main Menu ESC key = return to previous screen X = eXit System Management Services ------------------------------------------------------------------------------- Type menu item number and press Enter or select Navigation key: x (select FC target to boot) 8. Contacting QLogic Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods: Web: http://support.qlogic.com North America Contact Information Email: support@qlogic.com Phone: (952) 932-4040 Support contact information for other regions of the world is available at the QLogic website: http://support.qlogic.com © Copyright 2010. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners.