IBM High IOPS Driver and Utilities for Red Hat Enterprise Linux 6 Supported Adapters 43nm and 34nm Cards (require minimum 2.x software packages) ----------------------------------------------------------- - IBM 160GB High IOPS SS Class SSD PCIe Adapter, Option 46M0877, (FRU) 81Y4523 - IBM 320GB High IOPS SD Class SSD PCIe Adapter, Option 46M0878, (FRU) 81Y4521 - IBM 320GB High IOPS MS Class SSD PCIe Adapter, Option 46M0898, (FRU) 81Y4525 - 320GB High IOPS SLC Adapter for IBM System x, Option 81Y4535, (FRU) 81Y4536 - 640GB High IOPS MLC Adapter for IBM System x, Option 81Y4531, (FRU) 81Y4532 - 640GB High IOPS MLC Duo Adapter for IBM System x, Option 81Y4519, (FRU) 81Y4518 - 640GB High IOPS SLC Duo Adapter for IBM System x, Option 81Y4539, (FRU) 81Y4540 - 1.28TB High IOPS MLC Duo Adapter for IBM System x, Option 81Y4527, (FRU) 81Y4528 51nm Cards (require minimum 1.2x software packages) --------------------------------------------------- - IBM 160GB High IOPS SS Class SSD PCIe Adapter, Option 46M0877, (FRU) 46M0886 - IBM 320GB High IOPS MS Class SSD PCIe Adapter, Option 46M0898, (FRU) 46M0899 - IBM 320GB High IOPS SD Class SSD PCIe Adapter, Option 46M0878, (FRU) 46M0887 - 640GB High IOPS MLC Duo Adapter for IBM System x, Option 81Y4519, (FRU) 68Y7382 Supported 64-bit RHEL 6.x Kernels: - 2.6.32-71.el6.x86_64 - 2.6.32-131.0.15.el6.x86_64 - 2.6.32-220.el6.x86_64 (C) Copyright International Business Machines Corporation 1999, 2011. 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 Usage information 4.0 Unattended mode 5.0 Web site and support phone number 6.0 Notices and trademarks 7.0 Disclaimer 1.0 Overview _____________ 1.1 This package contains the IBM High IOPS SSD PCIe Adapter driver, and other associated utilities, for Red Hat Enterprise Linux 6. 1.2 Limitations: - Only 64-bit Linux installations are supported. - Version 2.3.10 and later of the driver software, including ioMemory VSL, are not backward-compatible with any driver version earlier than 2.3.10. When you install version 2.3.10 or later, you cannot revert to any driver version before 2.3.10. 1.3 Problems fixed: - See change history 1.4 Level of Recommendations and Prerequisites for the update: - The server must have at least the recommended amount of memory for the adapter used. See the IBM HIGH IOPS User Guide for Linux for more details. 1.5 Dependencies: - None 1.6 Update Contents o ibm_dd_highiop_ssd-2.3.10_rhel6_x86-64.zip - Installation packages o ibm_dd_highiop_ssd-2.3.10_rhel6_x86-64.chg - Change history 2.0 Installation and setup instructions ________________________________________ Important Considerations when Upgrading Software, or Adding a New High IOPS Adapter to an existing server --------------------------------------------------------------------------- Legacy hardware can be upgraded to the latest generation of software and it's very important to understand the impact and long term implications these updates may have on the operating environment. Multiple High IOPS adapters are installed in a single system: --------------------------------------------------------------------------- When multiple High IOPS Adapters are installed in the same server, all devices must operate with the same version of software. High IOPS adapters require matching firmware, drivers and utilities. This is a very important consideration when adding a new High IOPS Adapter that mixes 43nm to 34nm cards with 51nm cards. The previous version of High IOPS software (1.2.x is not compatible with 43nm and 34nm High IOPS cards and require 2.x software or higher. The 51nm cards can be upgraded to version 2.3.10 software following the instructions in the user guide. Upgrading from version 1.2.x or 2.2.3 software to 2.3.10: --------------------------------------------------------------------------- Upgrading Legacy adapters from 1.2.x software to version 2.3.10 offers a number of significant changes and improvements, however there are some important considerations. When performing an upgrade from 1.2.x to 2.3.10, you must perform driver update to the 2.x software followed by a firmware update. The device driver name has also changed from fio-driver (version 1.2.x) to iomemory-vsl (2.x and above). The firmware upgrade process updates and modifies important hardware settings that are not compatible with 1.2.x or 2.2.3 versions of software. Once updated, the card cannot be black-leveled to the previous versions of software. Please see the "change history" documentation for a complete list of new features, enhancements, and fixes. Replacing a failed legacy High IOPS card and "mandatory" update requirements: --------------------------------------------------------------------------- As the supply of legacy adapters diminishes from inventory, it becomes more likely that warranty replacement cards will transition to the newer versions of the High IOPS adapters. Replacement High IOPS cards and may require firmware updates to support the new or existing cards in the server. Any situation when mixing the flash NAND technology occurs, the minimum version of software supported by the latest generation of hardware prevails. A mandatory upgrade of software is required to support the latest generation of hardware with backward compatibility to legacy cards in the server. Change History's Update Recommendations: --------------------------------------------------------------------------- Change histories files provide an ongoing list of changes to a series of software compatible with a family of hardware. Please review the change histories using the following guidelines as to how IBM recommends or suggests updates to code levels at the website below: http://www.ibm.com/support/entry/portal/docdisplay?brand=5000008&lndocid=HELP-FIX Installation ============ For Upgrade Installations: -------------------------- When upgrading a previous version of High IOPS software to version 2.3.10, the previous version of software must be uninstalled. After the uninstall completes, follow the New Installation procedures below, then upgrade the adapters firmware to match the device driver. See the uninstallation instructions below or consult the Linux User Guide for more information and detailed instructions that may affect your operating environment. For New Installations: ---------------------- The IBM HIGH IOPS driver distribution includes four mandatory packages: iomemory-vsl, fio-util, fio-common, and fio-sysvinit. The remaining items are optional packages. Pick the driver RPM which matches your currently running kernel. You can determine your kernel by typing 'uname -a' in a console. Install the four mandatory RPMs, and any of the optional RPMs as follows: $ rpm -ivh iomemory-vsl-2.6.32-71.el6.x86_64-2.3.10.110-1.0.el6.x86_64.rpm \ fio-util-2.3.10.110-1.0.el6.x86_64 \ fio-common-2.3.10.110-1.0.el6.x86_64.rpm \ fio-sysvinit-2.3.10.110-1.0.el6.x86_64.rpm \ libfio-dev-3.1.4.111-1.0.x86_64.rpm \ fio-snmp-agentx-3.1.4.111-1.0.x86_64.rpm \ fio-remote-util-3.1.4.111-1.0.x86_64.rpm \ iomemory-vsl-2.3.10.110-1.0.src.rpm \ fio-firmware-highiops-107053-1.0.noarch.rpm \ NOTE: This command can be entered on one line, but is broken up here for clarity. Loading the Driver ------------------ After all of the desired RPM sets are installed, the VSL driver can be manually loaded using the following command: $ modprobe iomemory-vsl Driver loading will happen on boot for most distributions. If the driver fails to autoload on the next reboot, or for finer control over driver loading and unloading please see the HIGH IOPS Linux Users Guide for details on how to setup the init script. Upgrading High IOPS adapter Firmware ------------------------------------ After installing the 2.3.10 device drivers and software, status messagess on High IOPS adapters will display similar to below mixed in with other device information from the fio-status CLI command output. The IOPS Management Application will show the device status to be "Minimal Mode".: fctx Status unknown: Driver is in MINIMAL MODE: Firmware is out of date. Update Firmware. To upgrade new adapters, run the following command: fio-update-iodrive Please see the user guide for additional update instructions. Uninstallation -------------- First, quiesce all activity to the High IOPS adapter, then detach each device from the operating system with the following command: $ fio-detach Unload the VSL driver as follows: $ modprobe -r iomemory-vsl Next remove all RPMs that were installed during installation. The list of installed RPMs can easily be found by issuing the following commands: $ rpm -qa | grep fio $ rpm -qa | grep libfio $ rpm -qa | grep iomemory Use RPM to remove all of the packages reported. For example: $ rpm -e libfio fio-util fio-firmware-highiops fio-snmp-agentx With versions 2.3.10 of the ioMemory VSL, you must specify the kernel version of the package you are uninstalling. Run this command to find the installed driver packages: $ rpm -qa | grep -i iomemory Sample output: iomemory-vsl-2.6.32-71.el6.x86_64 Uninstall the ioMemory VSL by running a command similar to this example (specify the kernel version of the driver you wish to uninstall): $ rpm -e iomemory-vsl-2.6.32-71.el6.x86_64 SNMP Agent Configuration ------------------------ For detailed instructions on configuring SNMP please see the IBM HIGH IOPS Linux Users Guide, Appendix B. 3.0 Usage information ______________________ To open the IBM High IOPS Management graphical application, open the installed browser to the following URL: http://localhost:9051/ Detailed usage information can be found in the following guides: - IBM High IOPS Management Application User Guide for ioMemory VSL 2.3.10 - IBM ioMemory VSL 2.3.10 User Guide for Linux - IBM ioMemory VSL 2.3.10 Release Notes - IBM High IOPS Adapter Hardware Installation Guide for ioMemory VSL 2.3.10 3.0 Usage information ______________________ To open the IBM High IOPS Management graphical application, open the installed browser to the following URL: http://localhost:9051/ Detailed usage information can be found in the following guides: - IBM_High_IOPS_Management_Application_User_Guide_for_ioMemory_VSL_3_1_1.pdf - IBM_ioMemoryVSL_2.3.10_UserGuide-Linux.pdf - IBM_ioMemoryVSL_2.3.10_ReleaseNotes.pdf - IBMHighIOPSAdapter_HardwareInstallationGuide-ioMemory_VSL_2.3.10.pdf 4.0 Unattended Mode ____________________ The IBM HIGH IOPS driver and supporting packages are all RPM based. Automated installation through any standard method (kickstart, yum repositories, etc) is supported. 5.0 Web Sites and Support Phone Number ______________________________________ o You can find support and downloads for IBM products from the IBM Support Web site: Main Support Site: http://www.ibm.com/support/ IBM High IOPS Downloads: http://www.ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5083174 You can find up to date support information and downloads specific to the High IOPS adapters by searching for "High IOPS" from the main support page. o For the latest compatibility information, see the IBM ServerProven Web site: http://www.ibm.com/servers/eserver/serverproven/compat/us/ 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 __________________________ This product may contain program code or packages ("code") licensed by third parties, as well as code licensed by IBM. For non-IBM Code, the third parties, not IBM, are the licensors. Your use of the non-IBM code is governed by the terms of the license accompanying that code, as identified in the attached files. You acknowledge that you have read and agree to the license agreements contained in these files. If you do not agree to the terms of these third party license agreements, you may not use the accompanying code. IBM is a registered trademark of International Business Machines Corporation in the United States and other countries. Fusion-io is a registered trademark of Fusion-io, in the United States. 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.