IBM USB Advanced System Management Drivers for Linux version 1.14 CONTENTS -------- 1.0 Overview 2.0 Change History 3.0 System Management Device Driver Installation Instructions 4.0 Installing libusb on a Redhat system 5.0 Web Sites and Support Phone Number 6.0 Trademarks and Notices 7.0 Disclaimer 1.0 Overview ------------- This README.TXT file is associated with the following RPM files: - ibmusbasm-1.14-2.src.rpm - ibmusbasm-1.14-2.i386.rpm These RPM files will build and install the Linux device driver and/or support software for the following IBM hardware: - Advanced System Management USB Adapter card Note 1: The ibmusbasm rpm requires the libusb and libusb-devel packages to be installed. If your distribution does not include/install the 2 packages please reference Section 4 for installation instructions. Note 2: If you have GCC compiler version 2.96, you should update it to version 3.xx. 2.0 Change History ------------------- - Driver version 1.14 Issue fixed: can't install the driver when RPM version <= 4.04 - Driver version 1.13 Issue fixed: no warning message when gcc library not being installed - Driver version 1.12 Issues fixed: the missing Buildlog file; warning message during installation on SLES9; no warning message when libusb-devel rpm not being installed. - Driver version 1.11 Fixed a return code value, CloseSPDriver now returns RC_INVALID_HANDLE rather than RC_CLOSE_FAILED when invalid handle passed to it. - Driver version 1.10 Added Multi-node support to ibmasm. Added reset event support to ibmasm (5.2.16 event). Modified signal registration, now uses signal() instead of sigaction(). Modified ibmasm so that it links to libusb symbols dynamically. Updated section 4 of this readme to correct a documentation error for installiing libusb. - Driver version 1.09 Added Installation instructions to this readme for libusb and ibmusbasm on a Redhat system (see section 4.0). - Driver version 1.08 Added a delay when initializing the device driver after a Service Processor reset which allows the adapter to complete initalizing before the device driver loads. - Driver version 1.07 Fixed a timing problem in RegisterForReverseHeartBeat. 3.0 System Management Device Driver Installation Instructions --------------------------------------------------------------- 3.1 Supported versions: 3.1.1) Red Hat, version 7.3 3.1.2) SuSE8.0, SLES8 with service pack 3 or above 3.1.3) Red Hat, Advanced Server version 2.1/3.0 3.2 USB Service Processor RPM installation. No configuration is necessary. The USB Service Processor hardware must be installed and the USB cable connected. The RPM will detect the hardware and install the appropriate software. To install the RPM execute the following command: rpm -ivh ibmusbasm-1.XX.i386.rpm NOTE: If this is an upgrade to an existing Advanced System Management driver, then the previously installed driver packages must first be removed. Depending upon your system's configuration, you may see messages about missing files when running the "rpm -e" commands. You may safely ignore those messages. Type the following two commands at a shell prompt to remove the old driver source and binaries: rpm -e ibmusbasm or for a Red Hat system possibly rpm -e ibmasm rpm -e ibmasm-src-redhat or for a SuSE system possibly rpm -e ibmasm rpm -e ibmasm-src-suse 3.3 Un-installing the ibmusbasm RPMS. To uninstall the binary rpm, execute the following command: rpm -e ibmusbasm RPM will unload the drivers, and remove all ibmasm-related files from your system. It is recommended that you uninstall the drivers with -e before installing a new version, rather than upgrading with RPM's upgrade (-U) switch. 3.4 Utility Programs. There are two useful utility programs installed by the RPM. ibmspup is a small script that loads ibmasm (the service processor device driver). Note that these modules will not load if you do not have the supported hardware installed. ibmspdown unloads the modules. You must have root priveledges to run these utilities. 4.0 Installing libusb and libusb-devel ----------------------------------------------------------------------- 4.1 Get/download version 0.1.6 (or later) of the libusb /libusb-devel rpms (e.g. you might get them from RedHat Enterprise Linux Advanced Server 3.0 cds). 4.2 If you get the binary rpms (e.g. libusb-0.1.6-1.i386.rpm, libusb-devel-0.1.6-1.i386.rpm) Issue the following commands to install: 4.2.1) rpm -ivh libusb-0.1.6-1.i386.rpm 4.2.2) cd /usr/lib 4.2.3) ln -s libusb-0.1.so.4 libusb.so 4.2.4) ldconfig 4.2.5) rpm -ivh libusb-devel-0.1.6-1.i386.rpm 4.3 If you get the source rpm (e.g. libusb-0.1.6-1.src.rpm) From the directory that the libusb rpm resides, Issue the following commands: 4.3.1) rpm --rebuild --nodeps libusb-0.1.6-1.src.rpm 4.3.2) cd /usr/src/redhat/RPMS/i386 (For Suse: cd /usr/src/packages/RPMS/i386) 4.3.3) rpm -ivh libusb-0.1.6-1.i386.rpm 4.3.4) rpm -ivh libusb-devel-0.1.6-1.i386.rpm 4.3.5) cd /usr/lib 4.3.6) ln -s libusb-0.1.so.4 libusb.so 4.3.7) ldconfig 5.0 WEB Sites and Support Phone Number --------------------------------------- 5.1 IBM Support Web Site: http://www.pc.ibm.com/support 5.2 IBM Marketing eServer xSeries Web Site: http://www.pc.ibm.com/us/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 URL: http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html 6.0 Trademarks and Notices --------------------------- The following terms are trademarks of the Red Hat Corporation in the United States or other countries or both: Red Hat The following terms are trademarks of SuSE, Inc. in the United States and SuSE AG in Germany or other countries: SuSE The following terms are trademarks of Linus Torvalds in the United States or other countries or both: Linux 7.0 Disclaimer --------------- 7.1 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. 7.2 Note to 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.