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.



