============================================================================= Multiboot Update for Qlogic System-X 4Gb FibreChannel HBAs ============================================================================= Multiboot Package Version MB2.50.05 NOTES: - A vendor-supplied readme file from Qlogic is attached to the end of this file. It is a general release document included for informational purposes only and may contain 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. - It is recommended that QLogic's BIOS to be disabled before performing the update in DOS (Update.bat). (C) Copyright International Business Machines Corporation 1999, 2013. All rights reserved. US Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Before using this information and the product it supports, please 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 applies to Qlogic System-X FibreChannel HBAs. 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_fc_4g-mb2.50.05_linux-sysx_32-64.bin - The executable update package o qlgc_fw_fc_4g-mb2.50.05_linux-sysx_32-64.chg - Change history o qlgc_fw_fc_4g-mb2.50.05_linux-sysx_32-64.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, follwing 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 FW/BIOS 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_fc_4g-mb2.50.05_linux-sysx_32-64.bin -s" at a command prompt. Extracting files 1) Type "./qlgc_fw_fc_4g-mb2.50.05_linux-sysx_32-64.bin -x ", where is the fully qualified path where you want to extract the files, at a command prompt. 2.2 Troubleshooting tips ------------------------ - The automated installation tools supress the responses generated by running the Update.sh script. If installation is not successful, try running the installation manually, per the instructions elsewhere in this readme. 3.0 Configuration information ______________________________ - None 4.0 Unattended Mode ____________________ To run this package in unattended mode, use the following command: qlgc_fw_fc_4g-mb2.50.05_linux-sysx_32-64.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 Web site: http://www.ibm.com/servers/eserver/serverproven/compat/us/indexsp.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. (Qlogic-supplied Readme begins here...) ************************************************************************************ QLogic FC BIOS Readme File QLogic Corporation All rights reserved Table of Contents 1. Package Contents 2. Supported Adapters/Controllers 3. Supported Operating Systems 4. Installing the Software 5. Additional Notes 6. Contacting Support 1. Package Contents The following files are applicable for FC 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. * q2xxxyyy.bin - Combined boot code file for the firmware, FCode, UEFI, and BIOS. * Readme.txt - Contains details for BIOS configuration (This file). * ReleaseNotes.txt - Release notes for BIOS. 2. Supported Adapters/Controllers * 2400 Series Adapters (use qlx246x package) * 2500 Series Adapters (use qlx256x package) 3. Supported Operating Systems Please check the downloads section for your adapter model at www.qlogic.com or your OEM downloads site for a list of compatible operating systems. 4. Installing the Software * Insert the FC adapter in the system. * Boot to DOS. * Run the update script at the command prompt: C:\>update.bat This script program updates the BIOS image on the adapter. * Reboot the system. NOTE: You can also use QCC_GUI/CLI to flash the Multi-boot image. 4.1 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 FC 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 * Scan Fibre Channel Devices * Fibre Disk Utility * Loopback Data Test * Select Adapter * Exit Fast!UTIL 4.1.1 Configuration Settings The following topics show and describe the configuration settings for the FC adapter. * Adapter Settings * Selectable Boot Settings * Restore Default Settings * Raw NVRAM Data * Advanced Adapter Settings 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. * 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. NOTE: This option is not available for QLE2x0 HBAs. * Adapter Hard Loop ID (Enabled/Disabled: Default - Disabled) This setting forces the adapter to attempt to use the ID specified in the Hard Loop ID setting. * Hard Loop ID (0 - 125: Default - 0) If the Adapter Hard Loop ID setting is enabled, the adapter attempts to use the ID specified in this setting. NOTE: This option is not available for QLE2x0 HBAs. * Spin Up Delay (Enabled/Disabled: Default - Disabled) When this bit is set, the BIOS waits up to two minutes to find the first drive. * Connection Options (0/1/2: Default - 2) This setting defines the type of connection: 0 – Loop only 1 - point-to-point only 2 - loop preferred otherwise point-to-point NOTE: This option is not available for QLE2x0 HBAs. * Fibre Channel Tape Support (Enabled/Disabled: Default - Enabled) This setting enables FCP-2 recovery. NOTE: This option is not available for QLE2x0 HBAs. * Data Rate (0/1/2/3/4: Default - 2) This setting determines the data rate: 0 - Adapter runs at 1 Gb/s.(Not supported for 2500 series adapters) 1 - Adapter runs at 2 Gb/s. 2 - Adapter auto-negotiates and determines the data rate. 3 - Adapter runs at 4 Gb/s. 4 - Adapter runs at 8 Gb/s.(Not supported for 2400 series adapters) NOTE: This option is not available for QLE2x0 HBAs. Selectable Boot Settings ------------------------ The Configuration Settings menus provide access to the Selectable Boot Settings option. If you enable the Host 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 Host 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 QLE256x adapter or up to seven alternate boot devices. Restore Default Settings ------------------------- The Restore Defaults option from the Configuration Settings menu restores the BIOS settings back to default. 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. NOTE: This option is not available for QLE2x0 HBAs. Advanced Adapter Settings ------------------------- These options are not available for QLE2x0 HBAs. From the Configuration Settings menu in Fast!UTIL, select Advanced Adapter Settings. The following paragraphs describe the default settings for the FC 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. Note: For 4G (1-16, default-16) * 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 LIP Reset (Yes/No: Default - No) This setting determines the type of loop initialization process (LIP) reset used when the operating system initiates a bus reset routine: Yes - The driver initiates a global LIP reset to reset the target devices. No - The driver initiates a global LIP reset with full login. * Enable LIP Full Login (Yes/No: Default - Yes) This setting instructs the ISP chip to re-login to all ports after any LIP. * 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. Note: If you used an FC RAID target in a Cluster Environment, you should enable the Enable Target Reset = Enabled (Advanced Adapter Settings). * 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. * EV Controller Order (Enabled/Disabled: Default - Disabled) This setting enables BIOS compatibility with older HP (G3) systems such as the ML370G3, DL360G3, and DL380G3. When disabled system boots to QLogic Controller first. When enabled, system only boots when QLogic is set as the first controller in the system BIOS\Boot Controller Order. 4.1.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. 4.1.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 (most targets do not support this feature.) * Select a disk device CAUTION! Performing a low-level format destroys all data on the disk. 4.1.4 Loopback Data Test This option allows you to perform Loopback tests. You can select one of the following Loopback tests: * External Loopback Data Test * Internal 1 bit Interface Loopback Data Test * Internal 10 bit Interface Loopback Data Test NOTE: When running an external Loopback data test, make sure that the FC loop is up or a Loopback plug is attached to the adapter before starting the test. If your adapter is attached to a fabric switch port, you must set the adapter and Switch ports to run in Arbitrated Loop mode. 4.1.5 Select Adapter If you have a multi-port or multiple FC adapters in your system, use this option to select and then configure or view the settings of a specific adapter port or adapter. 4.1.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. 4.1.7 FlasUtil Command Line Options 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. * Use /I option if the update utility, FlasUtil, does not detect your Fibre Channel adapter. 5. Additional Notes Setting Up a Target to Boot from SAN ------------------------------------ To use the Fast!UTIL BIOS configuration utility to set up a target to boot from SAN, follow these steps: 1. Connect fiber cable to the switch with target attached. 2. Configure both host and target in the same zone. 3. Power on the server. 4. At the QLogic BIOS banner, press the Ctrl+Q or Alt+Q keys to enter Fast!UTIL. 5. Select Scan Fiber Devices, and confirm that BIOS detects the target. 6. Press the Esc key, select Configuration Settings, and then select Selectable Boot Settings. 7. Select Primary Port Name LUN, and then press the ENTER key to select the correct target. 8. Change Selectable Boot to Enable. 9. To save the changes, press the Esc key. 10. Select Configuration Settings, and then select Adapter Settings. 11. Change the Host Adapter BIOS option to Enable (default=Disable). 12. To save the changes, press the Esc key. 13. To reboot the system, press Esc. 14. Confirm that the target BIOS is enabled and that it detects the correct target. 15. Set the SAN disk as the first boot disk in server's boot order. 16. Boot to DVD or a PXE server, and then proceed with the OS installation. NOTE: * QLogic recommends that you remove the local disk (SAS drive) before OS installation. * If the OS does not recognize the SAN disk, the driver or DDkit is required. * If the OS fails to create the partition, use a disk tool such as Diskpart to clean the partition prior to OS installation. * Solaris x86 QLA driver supports booting from the Primary location only. 6. Contacting Support Please feel free to contact QLogic Support at http://support.qlogic.com for further assistance. (c) Copyright 2013. 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. ************************************************************************************ QLogic Driver Readme File QLogic Corporation All rights reserved Table of Contents 1. Package Contents 2. Supported Adapters/Controllers 3. Supported Operating Systems 4. Installing the Driver 5. Additional Notes 6. Contacting Support 1. Package Contents The following list describes the files included in the UEFI driver package: * I2xyzzzz.bin - Combined binary file, which includes the binaries for FCode, EFI driver, and BIOS. * 2500.bin or 2400.bin - RISC firmware file. If this file is not provided, the firmware is included in the q2xyzzzz.bin file. * EfiUtilx64.EFI - UEFI Utility to update the UEFI driver, firmware, and NVRAM. * QL25XX.DRV - Auxiliary driver file used for updating the HBA. * UPDATE.NSH - UEFI script file used to update the HBA on an UEFI system. * EFI\EFICFG.PDF - HBA Configuration and Diagnostic PDF. * EFI\EFIUTIL.PDF - HBA EfiUtilx64 Utility PDF. NOTES: * All bin, uefi, and nsh files are required to update the HBA on an UEFI system. 2. Supported Adapters * QLx24xx * QLE25xx * QMI25xx * QMI35xx 3. Supported Operating Systems The UEFI driver has been tested with the following operating systems: * Linux x64 * Windows 2008 x64 4. Installing the Driver To install/update the UEFI Driver and RISC Firmware on all HBAs: 4.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. 4.2. Connect the USB device to the UEFI based system with the FC HBAs. 4.3. At the system's UEFI shell prompt, perform a "map -r" command to map the USB device file system. You can check the mapping as follows: map -b 4.4. Locate the USB device and change to that device. For example, if the USB device is mapped to fs9 after the map -r: fs9: The UEFI shell prompt should change as follows: fs9:\> 4.5. Run the update.nsh script to update the UEFI driver and RISC Firmware. For example: fs9:> update.nsh Update.nsh will call efiutil.efi to update all of the HBAs. 4.6. Reboot the system to make the Driver/Firmware changes take effect. NOTES: To update NVRAM or perform other manual EfiUtil flash functions, refer to efiutil.pdf. 5. Additional Notes 5.2. Supported Features The UEFI driver supports the following features: * UEFI Specification 1.10, 2.1 * UEFI protocols: SCSI Pass Thru, Block IO, Driver Diagnostics, Driver Configuration, Component Name * 382 targets * 2047 LUNs per target * Fabric and arbitrated loop topologies * Boot from SAN 5.3 Supported Computer Systems The UEFI driver supports the following systems: * x64 based systems 5.1 Adapter Configuration Refer to the EFICFG.PDF file to configure the HBA parameters. 6. Contacting Support Please feel free to contact QLogic Support at http://support.qlogic.com for further assistance. (c) Copyright 2013. 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. ************************************************************************************ Qlogic FCode Driver Readme File QLogic Corporation. All rights reserved. Table of Contents ----------------- 1. Package Contents 2. Supported Adapters/Controllers 3. Supported Operating Systems 4. Installing the Driver 5. Additional Notes 6. Contacting Support 1. Package Contents ------------------- The following list describes the files included in the FCode driver package: * I24xxxxx.BIN - Combined binary file, which includes the 2400 binaries for BIOS, FCode, UEFI driver, and ASIC firmware * I25xxxxx.BIN - Combined binary file, which includes the 2500 binaries for BIOS, FCode, UEFI driver, and ASIC firmware * I8Ixxxxx.BIN - Combined binary file, which includes the 8100 binaries for BIOS, FCode, UEFI driver, and ASIC firmware * FC_FcodeReadme_PPC.txt - Readme File (This file) * FC81_FcodeRelease.txt - 8100 Fcode release history * FC25_FcodeRelease.txt - 2500 Fcode release history * isp8001.ibm.fc - 8100 FCoE Fcode Driver binary * isp2500.ibm.fc - 2500 FC Fcode Driver binary * isp2400.ibm.fc - 2400 FC Fcode Driver binary 2. Supported Adapters/Controllers ---------------------------------- * 2400 Series Fibre Channel adapters * 2500 Series Fibre Channel adapters * 8100 Series Converged Network Adapters 3. Supported Operating Systems ------------------------------- This FCode supports IBM AIX 7.1 and 6.1 This FCode supports Linux RHEL 5.7 and 6.2 Power This FCode supports Linux SLES 11 SP2 Power 4. Installing the Driver (Bootcode) ----------------------------------- This section contains: * 4.2 Updating the Bootcode * 4.1 Adapter Configuration 4.2 Updating the Bootcode ------------------------- To update the Bootcode: 1. Insert the adapter into a DOS capable system. 2. Boot to DOS, extract the MB package to folder. 3. Run the update script at the command prompt: C:\>update.bat This script program updates the entire flash image on the adapter using QLflash, a native DOS utility. 4. Reboot the system. NOTES: You can also update the bootcode image on an IBM PPC Linux system using the QCC GUI/CLI application. Before flashing the Bootcode, the latest Linux driver should be installed. Copy the multi-boot binary file hldxxxxx.BIN on to PPC Linux System. For procedures on updating Flash using the QCC GUI/CLI applications, see the FC HBA Manager Online Help and QCC User's Guide. 4.2 Adapter Configuration -------------------------- This section contains: * 4.2.1. Selecting the FC/FCoE Function on IBM machines * 4.2.2. Setting and viewing NVRAM Parameters * 4.2.3. Diagnostic Commands 4.2.1. Selecting the FC/FCoE Function on IBM machines ----------------------------------------------------- This section contains: * 4.2.1.1 Getting to the OK prompt on IBM PSeies machines * 4.2.1.2 Getting to the OK prompt on IBM Blade machines * 4.2.1.3 Selecting the FC device from the OK prompt * 4.2.1.4 Exit OK Prompt Prior to setting Fibre Channel HBA NVRAM parameters or executing Diagnostic commands,the device must be selected. To select the device, you must first get ^ M to the to the SMS menu and then to the OpenFirmware(OF) ok prompt, as described below. 4.2.1.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,2010 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,2010 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 > 4.2.1.2. Getting to the OK prompt on IBM Blade machines ------------------------------------------------------- Open Telnet session to Chassis ystem>console -T blade[x] x= slot number ... ....... PowerPC Firmware Version EA340_062 SMS 1.7 (c) Copyright IBM Corp. 2000,2010 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" 4.2.1.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 HBA's device number and path into the dev and select-dev commands. When the HBA 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 NOTE: Issuing an incorrect command will cause the device instance to be lost. Therefore, subsequent commands will result in errors being returned from Open Firmware. If an incorrect command is issued, "unknown word" will be returned. It will then be necessary to issue the "unselelect-dev" command and then re-select the device as shown in Section 3.3, above. 4.2.1.4 Exit OK Prompt ---------------------- 0> reset-all (Reboot the server to SMS) or 0 > dev /packages/gui obe (Launch SMS) 4.2.2. Setting and viewing NVRAM Parameters ------------------------------------------- This section contains: * 4.2.2.1 Setting and viewing Fibre Channel connection mode (FC HBAs only) * 4.2.2.2 Setting and viewing Fibre Channel data rate (FC HBAs only) * 4.2.2.3 Setting and viewing login-retry-count * 4.2.2.4 Setting and viewing link-down-timeout * 4.2.2.5 Setting and viewing port-down-retry-count * 4.2.2.6 Setting and viewing max-frame-size * 4.2.2.7 Setting and viewing boot-wait-time * 4.2.2.8 Restoring NVRAM Parameter Defaults * 4.2.2.9 Setting and viewing FCF VLAN-ID (FCoE CNAs only) * 4.2.2.10 Setting and viewing MAC Address Mode (FCoE CNAs only) * 4.11 Setting and viewing the EDC Configuration To list all NVRAM and Diagnostic Commands: type "show-commands" at ok prompt. ok 0 > show-commands NVRAM Parameter commands show-settings set-connection-mode (FC HBAs only) set-data-rate (FC HBAs only) set-mac-am (FCoE CNAs only) set-vlan-id (FCoE CNAs only) set-edc-config set-login-count set-link-timeout set-port-down-count set-max-frame-size set-boot-wait-time restore-default-settings Diag Commands version beacon (not supported) selftest ext-loopback-test show-children show-fcfs (FCoE CNAs only) disk-test sel-dev sel-lun See Readme file for details To show the current value of all of the NVRAM parameters, as well as the version, serial number, and HBA WWN, type "show-settings". Example: ======== ok 0 > show-settings 0 > QLogic QMIXXXX Host Adapter FCode(IBM): X Y Firmware version Z Product-ID: QLogic 2-port 8Gb Fibre Channel Adapter for IBM BladeCenter QMI2562 Serial# RFC0906G05564 node-wwn 2000001b 32897c3d port-wwn 2100001b 32897c3d Current Adapter Connection Mode: Point-to-point only Current Adapter Data Rate: Auto-negotiated 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) Current boot-wait-time: DISABLED NOTE: Where X = FCode Version,Y = Date of FCode version release and Z = Firmware version XXXx = Model number 4.2.2.1. Setting and viewing Fibre Channel connection mode (FC HBAs only) -------------------------------------------------------------------------- Note: Must issue reset-all when any change is made to FCode parameters. To change or view the current host adapter Fibre Channel connection mode, type "set-connection-mode". Example: ok 0 > set-connection-mode Current HBA connection mode: 2 - Loop preferred, otherwise point-to-point Do you want to change it? (y/n) y Choose HBA Connection Mode: 0 - Loop Only (not supported) 1 - Point-to-point only 2 - Loop preferred, otherwise point-to-point Enter: 2 Current HBA connection mode: 2 - Loop preferred, otherwise point-to-point NOTE: This should be set to: 1 - P2P only 4.2.2.2 Setting and viewing Fibre Channel data rate (FC HBAs only) ------------------------------------------------------------------- To change or view the current host adapter Fibre Channel data rate, type: "set-data-rate". Example: ok 0 > set-data-rate Current HBA Data Rate: Auto-Negotiated Do you want to change it? (y/n) y Choose Data Rate: 1 - 2 Gb/sec 2 - Auto-negotiated 3 - 4 Gb/sec 4 - 8 Gb/sec (not supported for QMI2572) Enter: 2 Current HBA Data Rate: Auto-Negotiated 4.2.2.3 Setting and viewing login-retry-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.2.4 Setting and viewing link-down-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.2.2.5 Setting and viewing port-down-retry-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.2.2.6. 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.2.2.7 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-65535 (decimal): 360 Current boot-wait-time: 360 seconds (this example sets it to 6 minutes) Example 2: {0} ok set-boot-wait-time Current boot-wait-time: 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.2.2.8 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 HBA Connection Mode: Loop preferred, otherwise point-to-point Current HBA Data Rate: Auto-negotiated 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 > 4.2.2.9 Setting and viewing FCF VLAN-ID (FCoE CNAs only) ---------------------------------------------------------------------------- The set-vlan-id command allows the user to change the default FCF VLAN-ID, which is normally equal to 1002, (0x3eb). Example: {0} ok set-vlan-id Current FCF VLAN-ID: 3ea(1002) Do you want to change it? (y/n) y FCF VLAN-ID: Enter 0-ffff hex: 3eb Current FCF VLAN-ID: 3eb(1003) 4.2.2.10 Setting and viewing the MAC Address Mode (FCoE CNAs only) ----------------------------------------------------------------------------- The set-mac-am command allows the user to specify the MAC Address Mode. Example: {0} ok set-mac-am Current Adapter MAC Address Mode: FPMA only Do you want to change it? (y/n) y Choose Adapter MAC Address Mode: 0 - FCF Selected 1 - SPMA only 2 - FPMA only 3 - SPMA prefered 4 - FPMA prefered enter: 4 Current Adapter MAC Address Mode: FPMA prefered 4.2.2.11 Setting and viewing the EDC Configuration --------------------------------------------------- The set-edc-config command allows the user to specify the EDC Configuration. On the Guppy QMI2582 Mezz card, the user can specify one of two different EDC Firmware images to be loaded, depending on the switch installed. Eitner: Brocade FCSM(44X1920) or Qlogic FCSM(44X1905)/IPTM(44X1907) Example: {0} ok set-edc-config Current EDC FW Image: Brocade FCSM(44X1920) EDC FW Update on next reset: None Do you want to change it? (y/n) y Choose EDC FW Image: 0 - Clear EDC Update-bits 1 - Set EDC Update-bit for Qlogic FCSM(44X1905)/IPTM(44X1907) 2 - Set EDC Update-bit for Brocade FCSM(44X1920) enter: 1 Current EDC FW Image: Brocade FCSM(44X1920) EDC FW Update on next reset: Qlogic FCSM(44X1905)/IPTM(44X1907) {0} ok If the "EDC FW Update on next reset" is set, the specified Firmware will be loaded at probe-time during the next system reset. 4.2.3. Diagnostic Commands -------------------------- This section contains: * 4.2.3.1 Version command * 4.2.3.2 Selftest * 4.2.3.3 ext-loopback-test command * 4.2.3.4 Show-children command * 4.2.3.5 show-fcfs command (FCoE CNAs only) * 4.2.3.6 disk-test command To execute any of the diagnostic commands, first select the device as described in section 4.2.1, above. Then enter the command. 4.2.3.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 4.2.3.3. 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 > 4.2.3.4. 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 HBA 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 > 4.2.3.5. 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 > 4.2.3.6. show-fcfs command (FCoE CNAs only) -------------------------------------------------------------- The show-fcfs command will show all FCFs currently attached to the CNA. Example: {0} ok show-fcfs FCF# 0 FCF VLAN-ID: 3ea FCF-MAC=000deca41dc0 FCF Ad FC-MAP= efc00 FCF Switch-Name=2001000deca41dc1 FCF Fabric-Name=100000c0dd09988f Common Features=3300 R_A_TOV=2710(10000) E_D_TOV=7d0(2000) 4.2.3.7. 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 HBA 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. Additional Notes ------------------- This section contains: * 5.1 Supported Features * 5.2 Notes * 5.3 Building a bootable disk 5.1. Supported Features ------------------------ * 2048 Target ID Support * 8192 LUN/Target Support * Boot from Fabric and Local Loop on IBM Pseries machines. * Boot using P2P only on IBM Blade machines. * 1,2 or 4 Gb/sec data rate support for 4Gb HBAs * 2,4 or 8 Gb/sec data rate support for 8Gb HBAs * 10 Gb/sec data rate support for FCoE 8100 CNAs * Auto NVRAM/VPD backup/recovery for 8Gb HBAs and FCoE 8100 CNAs 5.2. 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. All Converged Network Adapters (CNAs) do not allow changing the connection mode or the data-rate. They are fixed at 'Fabric' and '10Gb'. 5.3. Building a bootable 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,2010 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,2010 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,2010 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,2010 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,2010 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,2010 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,2010 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 At this point, if you are installing SLES or RHEL, you will see the yaboot starting message and then the 'boot:' prompt. If installing RHEL, enter: boot: linux dd askmethod ... Insert DDkit CD when asked Refer to RH's Installation for the rest of installation method. If installing SLES, enter: boot: install driverupdate=1 .... Insert DDKit CD when asked Refer to SLES's Installation manual for more details information. Once the installation is completed: ---------------------------------- PowerPC Firmware Version EA320_046 SMS 1.7 (c) Copyright IBM Corp. 2000,2010 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,2010 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,2010 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,2010 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) 6. Contacting QLogic -------------------- For further assisance, contact QLogic Technical Support at: http://support.qlogic.com (c) Copyright 2013. All rights reserved worldwide. QLogic and the QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners.