********************************************************************** Release Notes for OSA IPMI device driver Copyright (c) 2003-2004 OSA Technologies Inc, an Avocent Company All rights reserved. Date Created : October 7, 2003 Date Modified : December 5, 2005 ********************************************************************** ====================================================================== CONTENTS ====================================================================== 1.0 Overview 2.0 Linux driver installation 3.0 VMware ESX driver installation 4.0 Change log 5.0 Web Sites and Support Phone Number 6.0 Trademarks and Notices 7.0 Disclaimer ====================================================================== 1.0 Overview ====================================================================== 1.1 Driver Version Linux 2.3.5 1.2 Supported Operating System - 32bit RedHat Enterprise Linux 2.1 AS - 32bit RedHat Enterprise Linux 3 AS/WS/ES - 64bit RedHat Enterprise Linux 3 AS for EM64T and AMD64 - 32bit RedHat Enterprise Linux 4 AS/WS/ES - 64bit RedHat Enterprise Linux 4 AS/WS/ES for EM64T and AMD64 - 32bit SUSE Linux 8.2 - 64bit SUSE Linux 8.2 for AMD Opteron - 32bit SUSE Linux Enterprise Server 8.0 (up to sp4) - 64bit SUSE Linux Enterprise Server 8.0 for AMD Opteron - 64bit SUSE Linux Enterprise Server 9.0 for EM64T and AMD64 - VMware ESX 2.5.x 1.3 Known Issues 1) While installing the driver rpm on 32bit and AMD64bit version of SUSE Linux Enterprise Server (SLES) 8.0, you will get the error message of running kernel configuration is different from the kernel source configuration and thus the driver installation is failing. [Solution] Basically the SLES8.0 running kernel is 2.4.19-64GB-SMP, but the kernel source code is configured for 2.4.19-4GB by default which doesn't have symmetric multi-processing support turned on and High Memory Support is set to 4GB instead of 64GB. Here are the steps to fix this problem. - Run 'rpm -e osa_ipmi' to uninstall OSA IPMI device driver - Change directory to the Linux kernel source top directory, e.g. /usr/src/Linux. - Type 'make menuconfig' - Set the "symmetric multi-processing support" option on under "Processor type and features". - Set "High Memory Support" to 64GB under "Processor Type and features" - Save the setting before exit. - Run 'make dep' to update kernel source - Re-install the OSA IPMI device driver 2) The following message appears while trying to install the osa_ipmidrvr module: Warning: loading /lib/modules/2.4.19-SMP/misc/osa_ipmidrvr.o will taint the kernel: non-GPL license - Proprietary. Copyright 2003-2004 OSA Technologies Inc., an Avocent Company, San Jose, USA. See http://www.tux.org/lkml/#export-tainted for information about tainted modules Module osa_ipmidrvr loaded, with warnings OSA IPMI device driver is covered under OSA End User License Agreement( OSA_EULA.txt) and the shim layer (shimOS.c) which we provide source code along with the package is also covered by (OSA_EULA.txt). Please review the OSA_EULA.txt under /usr/osa/osa_ipmi-2.2.1-1 directory. If you don't accept the agreement or you are not covered by this agreement, please uninstall the OSA IPMI device driver package. This warning message should appear whenever the OSA IPMI device driver is loaded. The warning indicates that our IPMI driver module is not governed by the GPL license - it is not open source. It is covered by OSA End User License Agreement (EULA). In all other respects the driver should work as expected on your system. This warning message should have NO impact on performance or functionality of our driver. 3) For the users working on 32bit SUSE 8.2 whose gcc version is 3.3 20030226 (pre-release) the driver rpm script will complain about the gcc version mismatch and refuse to install the driver. [Solution] You can manually add '-f' option to insmod command in /sbin/ipmi_load script to force the kernel to load the ipmi driver. However, be aware that the '-f' option will cause tainted kernel warning. ====================================================================== 2.0 Linux driver installation ====================================================================== 2.1 Manifest for Linux driver This package contains the following files. build_osadrv -a script to build IPMI 32bit/64bit Linux driver ipmi-i386-redhat.o -the 32bit pre-compiled driver core object file for Redhat Linux ipmi-i386-redhat4smp.o -the 32bit pre-compiled driver core object file for Redhat Linux 4 smp kernel ipmi-i386-redhat4up.o -the 32bit pre-compiled driver core object file for Redhat Linux 4 up kernel ipmi-i386-redhat4up1smp.o -the 32bit pre-compiled driver core object file for Redhat Linux 4 update 1 smp kernel ipmi-i386-redhat4up1up.o -the 32bit pre-compiled driver core object file for Redhat Linux 4 update 1 up kernel ipmi-i386-redhatas21.o -the 32bit pre-compiled driver core object file for Redhat Enterprise Linux 2.1 AS ipmi-i386-redhatup3.o -the 32bit pre-compiled driver core object file for Redhat Enterprise Linux 3 update 3 ipmi-i386-redhatup4.o -the 32bit pre-compiled driver core object file for Redhat Enterprise Linux 3 update 4 ipmi-i386-redhatup5.o -the 32bit pre-compiled driver core object file for Redhat Enterprise Linux 3 update 5 ipmi-i386-suse.o -the 32bit pre-compiled driver core object file for SUSE Linux ipmi-i386-suse82.o -the 32bit pre-compiled driver core object file for SUSE Linux 8.2 ipmi-i386-suse8sp3.o -the 32bit pre-compiled driver core object file for SUSE Linux 8 with Service Pack 3 applied ipmi-i386-suse9.o -the 32bit pre-compiled driver core object file for SUSE Linux Enterprise Server 9 ipmi-i386-vmesx.o -the 32bit pre-compiled driver core object file for Vmware ESX server ipmi-x86_64-redhat.o -the 64bit pre-compiled driver core object file for Redhat Linux ipmi-x86_64-redhat4smp.o -the 64bit pre-compiled driver core object file for Redhat Linux 4 smp kernel ipmi-x86_64-redhat4up.o -the 64bit pre-compiled driver core object file for Redhat Linux 4 up kernel ipmi-x86_64-redhat4up1smp.o -the 64bit pre-compiled driver core object file for Redhat Linux 4 update 1 smp kernel ipmi-x86_64-redhat4up1up.o -the 64bit pre-compiled driver core object file for Redhat Linux 4 update 1 up kernel ipmi-x86_64-redhatup3.o -the 64bit pre-compiled driver core object file for Redhat Enterprise Linux 3 update 3 ipmi-x86_64-redhatup4.o -the 64bit pre-compiled driver core object file for Redhat Enterprise Linux 3 update 4 ipmi-x86_64-redhatup5.o -the 64bit pre-compiled driver core object file for Redhat Enterprise Linux 3 update 5 ipmi-x86_64-suse.o -the 64bit pre-compiled driver core object file for SUSE Linux ipmi-x86_64-suse82.o -the 64bit pre-compiled driver core object file for SUSE Linux 8.2 ipmi-x86_64-suse8sp3.o -the 64bit pre-compiled driver core object file for SUSE Linux 8 with Service Pack 3 applied ipmi-x86_64-suse9.o -the 64bit pre-compiled driver core object file for SUSE Linux Enterprise Server 9 libraw-i386-redhat.so -the 32bit IPMI driver library for Redhat Linux libraw-i386-suse.so -the 32bit IPMI driver library for SUSE Linux libraw-i386-suse9.so -the 32bit IPMI driver library for SUSE Linux Enterprise Server 9 libraw-i386-vmesx.so -the 32bit IPMI driver library for Vmware ESX server libraw-x86_64-redhat.so -the 64bit IPMI driver library for Redhat Linux libraw-x86_64-suse.so -the 64bit IPMI driver library for SUSE Linux libraw-x86_64-suse9.so -the 64bit IPMI driver library for SUSE Linux Enterprise Server 9 make.shim -makefile for "shim" layer README -this file shimOS.c -the source of Linux "shim" layer 2.2 legal and license information OSA IPMI driver is written as a kernel loadable module. It has two pieces. One piece contains a shim layer which deals with all kernel dependencies, e.g. kernel version and configuration for UP or SMP etc.. We provide source code for our shim layer. A second piece is a pre-compiled binary object file ipmi-xxx.o. It contains proprietary logic for all IPMI implementations. During driver installation, the shim code will be compiled and linked with the pre-compiled ipmi-xxx.o file to generate a final driver module, osa_ipmidrvr.o (or osa_ipmidrvr.ko), and install under /lib/modules/kernel-version/misc directory. 2.3 Driver Building and Installation To install the driver, launch a Linux shell and type: "rpm -i osa_ipmi-x.x.x-x.i386.rpm", it will build and install the driver module on your system. If you want to rebuild the driver, change to /usr/osa/osa_ipmi-x.x.x-x and launch a Linux shell and type: "sh build_osadrv". Building Environments: 1) Please install the necessary source code packages on your system. Recommended directory: /usr/src; 2) Make sure you have gcc 3.2 available. Also remember to upgrade your binutils package (for as/ld/nm and company) if necessary. [Note] 1) For the users working on 32bit SUSE 8.2 whose gcc version is 3.3 20030226 (pre-release), insmod does not work without '-f' option. Please manually add '-f' option to insmod command in /sbin/ipmi_load script for the force loading. However, the '-f' option will cause tainted kernel warning. 2) Other gcc version may cause the same problem. 2.4 Driver uninstallation To uninstall the driver, launch a Linux shell and type: "rpm -e osa_ipmi-x.x.x-x" or "rpm -e osa_ipmi" 2.5 Linux Kernel Upgrade If you upgrade your Linux kernel, we strongly recommend you to uninstall, recompile/re-install the OSA IPMI device driver. Please refer to above section for building environments and steps to rebuild and install the driver. 2.6 Loading driver with /sbin/ipmi_load The driver will read SMBIOS record 38 (see Appendix C1 of IPMI 1.5 spec) and probe the default interface exists. 2.7 Unloading driver with /sbin/ipmi_unload To manually unload the ipmi driver, run '/sbin/ipmi_unload' from Lunix shell. 2.8 Have driver working on two or more identical platforms without re-compiling To move already compiled IPMI driver onto other identical machines, Please build the driver on one machine and then copy the following files to the target machines: /sbin/ipmi_load /sbin/ipmi_unload /lib/libraw.so /lib/modules//extra/osa_ipmidrvr.ko (or osa_ipmidrvr.o) /etc/rc.d/rc.modules (for redhat) /etc/rc.d/boot.local (for SLES) ====================================================================== 3.0 VMware ESX driver installation ====================================================================== 3.1 To install OSA IPMI driver on VMware ESX server 1) In the LILO Boot Menu, choose "ESX" to boot into VMware ESX Server. 2) Press Alt-F2 to login. 3) Make sure gcc is installed. You can verify this by issuing command "rpm -qi gcc". If gcc is not installed, you can find the gcc-x.x-x.x.x.i386.rpm package in VMware ESX CD. 4) Install OSA IPMI driver by typing "rpm -i osa_ipmi-x.x.x-x.i386.rpm", it will build and install the driver module on your system. If you want to rebuild the driver, change to /usr/osa/osa_ipmi-x.x.x-x and type: "sh build_osadrv". 5) Ignore the warning message (please refer to section 1.3-2), the driver should now be functioning. 6) To uninstall the driver, type: "rpm -e osa_ipmi-x.x.x-x" or "rpm -e osa_ipmi". ====================================================================== 4.0 Change log ====================================================================== Linux * version 2.3.5 on Dec-05-2005 * - added support for 32bit SLES 8 sp3 and sp4. - added support for 32bit / 64bit SLES 10. - formal support for RHEL4 up1. -------------------------------------------------------------------- Linux * version 2.3.4 on Sept-06-2005 * - fixed OSA driver 2.3.3-1 uses rc.local instead of init scripts. (Fixed Defect 291568) - fixed kernel error message when RSA card disabling miniBMC. -------------------------------------------------------------------- Linux * version 2.3.3-1 on Jul-05-2005 * - fixed driver installation logic under RHEL4. Now driver installation is based on which type of kernel (smp or up) it is being built, instead of building 'up' objects for 'smp' kernel and causing kernel spinlock bug. (Fixed defect 282144) -------------------------------------------------------------------- Linux * version 2.3.2 on April-21-2005 * - added support for 32bit RedHat Enterprise Linux 4 AS/WS/ES 64bit RedHat Enterprise Linux 4 AS/WS/ES - fixed system hang on x366(Zeus) during device driver installation. - support for VMware ESX 2.5 -------------------------------------------------------------------- Linux * version 2.2.2-1 on Oct-29-2004 * - add support for > SUSE Linux Enterprise Server 9 for EM64T/AMD64 > Red Hat Enterprise Linux 3 AS (update 3) for EM64T/AMD64 - add support for 32bit user application calling 64bit IPMI device driver - remove debug message in /var/log/messages while connecting to IPMI device driver -------------------------------------------------------------------- Linux * version 2.2.1 on Sep-29-2004 * - add explanation of tainted kernel warning messages because of proprietary license under known issue section. - add support for 32bit RedHat Enterprise Linux 2.1 AS - add support for SLES8.0 SP3 (32bit and 64bit) - fix build script, build_osadrv, not identifying gcc version 3.x properly - remove kernel debug message in /var/log/messages when driver module is loaded and unloaded by Linux - modify libraw.so to set the response data length to 0 when the completion code is not 0x00. -------------------------------------------------------------------- Linux * version 2.2.1.0 on Aug-25-2004 * - change installation messages - add OSA_EULA.txt - remove the proprietary statements in the shimOS.c -------------------------------------------------------------------- Linux * version 2.2.1.0 on July-29-2004 * - added installation and un-installation program for Netware driver - added end user license agreement during Netware driver installation - renamed ipmi.nlm to osaipmi.nlm on Netware - fixed loading OSA IPMI driver twice on Netware - fixed limitations on rspLen <= 128 in sendCommand function. - fixed tainted kernel messages during Linux driver installation -------------------------------------------------------------------- Linux * version 2.02 for Netware 6.5 on June-02-2004 * - new driver support for Netware 6.5 - added installation and un-installation program - added end user license agreement during installation - renamed ipmi.nlm to osaipmi.nlm - fixed loading OSA IPMI driver twice -------------------------------------------------------------------- Linux * version 2.2.1 * - change driver name from ipmidrvr to osa_ipmidrvr - fixed limitations on rspLen <= 128 in sendCommand function. This fix is applied on drivers for all supported OS. - added rpm source package. - fixed tainted kernel messages during Linux driver installation - added driver support of 64bit Redhat Enterprise Linux 3 for AMD Opteron processor - included IPMI driver library as part of the Linux driver installation. The libraw.so will be installed under /lib directory. -------------------------------------------------------------------- ====================================================================== 5.0 Web Sites and Support Phone Number ====================================================================== 5.1 IBM Support Web Site: http://www.pc.ibm.com/support 5.2 IBM eServer xSeries Web Site: http://www.ibm.com/eserver/xseries 5.3 If you have any questions about this update, or problems applying the update, go to the following Help Center World Telephone Numbers and URL: http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html ====================================================================== 6.0 Trademarks and Notices ====================================================================== 6.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: - IBM - xSeries - eServer 6.2 The following terms are trademarks of the Red Hat Corporation in the United States or other countries or both: - Red Hat 6.3 The following terms are trademarks of SuSE, Inc. in the United States and SuSE AG in Germany or other countries: - SuSE 6.4 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.