IBM USB Advanced System Management Drivers for Linux version 1.10 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.10-2.src.rpm - ibmusbasm-1.10-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 Only the "boxed set" versions of Linux are supported. See Section 3 for details. The ibmusbasm rpm requires the libusb library to be installed. If your distribution does not include/install libusb please reference Section 4 for installation instructions for libusb. 2.0 Change History ------------------- 2.1 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. 2.2 Driver version 1.09 Added Installation instructions to this readme for libusb and ibmusbasm on a Redhat system (see section 4.0). 2.3 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. 2.4 Driver version 1.07 Fixed a timing problem in RegisterForReverseHeartBeat. 2.5 Driver version 1.06 Fixed a reset recovery problem in the device driver. The device driver would not communicate with the SP adapter after a reset. 2.6 Driver version 1.05 Fixed a reset recovery problem in the shared object. The shared object would not communicate with the device driver after a reset. Fixed a VPD versioning problem. 3.0 System Management Device Driver Installation Instructions --------------------------------------------------------------- 3.1 Supported versions: 3.1.1) Red Hat, version 7.3 3.1.2) SuSE, version 8.0 3.1.3) Red Hat, Advanced Server version 2.1 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 on a Redhat distribution. ----------------------------------------------------------------------- 4.1 Get/download version 1.6 (or later) of the libusb source rpm. (e.g. libusb-0.1.6-1.src.rpm) 4.2 From the directory that the libusb rpm resides, Issue the following commands: 4.2.1) rpm --rebuild --nodeps libusb-0.1.6-1.src.rpm 4.2.2) cd /usr/src/redhat/RPMS/i386 4.2.3) rpm -ivh libusb-0.1.6-1.i386.rpm 4.2.4) rpm -ivh libusb-devel-0.1.6-1.i386.rpm 4.2.5) cd /usr/lib 4.2.6) ln -s libusb-0.1.so.4 libusb.so 4.2.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.