IBM Advanced System Management Drivers for Linux version 1.12 CONTENTS -------- 1.0 Overview 2.0 Change History 3.0 System Management Device Driver Installation Instructions 4.0 Kernel and Remote Mouse/Keyboard Configuration Notes 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 2 RPM files: - ibmasm-src-suse-WRPxxxA.rpm - ibmasm-src-redhat-WRPxxxA.rpm where xxx is the version of the source rpm that you are installing. These RPM files will build and install Linux device drivers for the following IBM hardware: - Advanced System Management PCI Adapter card and its associated Shared Serial Port (Remote Mouse / Keyboard available if the Adapter firmware supports those functions) - Advanced System Management Processor, which is part of the planar board on specific models of Netfinity and IBM eServer xSeries servers (Remote Mouse / Keyboard available if the Adapter firmware supports those functions) - Automatic Server Restart (ASR) which is built onto the planar board of specific models of xSeries servers - Remote Supervisor Adapter, which is an option on specific models of xSeries servers (Remote Mouse / Keyboard available if the Adapter firmware supports those functions) Only the "boxed set" versions of Linux are supported: 1) Red Hat Advanced Server, version 2.1 - Specific kernel versions tested 2.4.9-e.3 2.4.9-e.3smp 2) SuSE Linux Enterprise Server, version 7 - Specific kernel versions tested 2.4.7-4GB 2.4.7-64GB-SMP 3) Red Hat, version 7.3 - Specific kernel versions tested 2.4.18-3 2.4.18-3smp 4) SuSE, version 8.0 - Specific kernel versions tested 2.4.18-4GB 2.4.18-64GB-SMP 5) Red Hat, version 7.2 - Specific kernel versions tested 2.4.7-10 2.4.7-10smp 6) SuSE, version 7.3 - Specific kernel versions tested 2.4.10-4GB 2.4.10-64GB-SMP 7) Red Hat, version 7.1 - Specific kernel versions tested 2.4.2-2 2.4.2-2smp 8) SuSE, version 7.2 - Specific kernel versions tested 2.4.4-4GB 2.4.4-64GB-SMP 9) Red Hat, version 6.2 - Specific kernel version tested 2.2.14-5 2.0 Change History ------------------- 2.1 Driver version 1.12 The device driver will not load if the h/w is not present. Added "Alt F2" support for remote control. The device driver RPM can now be removed if it fails to build. 2.2 Driver version 1.11 Changed installation to build modules in a single pass and to support precompiled kernel modules. See section 3 for revised installation instructions. 2.3 Driver versions 1.08 - 1.10 Added additional remote Mouse/Keyboard support. 2.4 Driver version 1.07 Added support for future xSeries servers. 2.5 Driver versions 1.05 - 1.06 Added OS shutdown support for xSeries servers running the Remote Supervisor Adapter. 3.0 System Management Device Driver Installation Instructions -------------------------------------------------------------- 3.1 Distributions with precompiled ASM kernel modules already installed To install the source rpm for SuSE, execute the following command: rpm -ivh ibmasm-src-suse-WRPxxxA.rpm where xxx is the version of the source RPM that you are installing. NOTE: If you wish to upgrade the kernel modules with new modules built by this RPM, then rename the kernel modules located in the /lib/modules/`uname -r`/kernel/drivers/char/ibmasm directory by changing to that directory and executing the following two commands: mv ibmasm.o ibmasm.orig mv ibmser.o ibmser.orig Should you decide later on to go back to using the original modules, the following command will remove the new modules and restore the originals. rpm -e ibmasm-src-[redhat/suse] 3.2 Distributions without precompiled ASM kernel modules already installed This version of ibmasm-src-[redhat|suse] installs all of the necessary files in a single pass. You do not need to install the binary rpm on the machine that you used to install the source rpm. The system that the source rpm file is to be run on must have Linux development/build capability with the Linux kernel source installed and properly configured for your hardware. If you intend to use the Remote Mouse / Keyboard capabilities in an XWindow environment then you will also need the X development (xdevel) headers and libraries. See section 4.0 for specifics. The source rpm file (ibmasm-src-[redhat/suse]) contains the open source code for the IBM Advanced System Management device drivers for Linux. The file is designed for installation using the Red Hat RPM "build" system. Executing the RPM utility against ibmasm-src-[redhat/suse] the will build and install Linux drivers that are customized for the Linux kernel version of the machine running the RPM utility. This process also generates a binary rpm file that can be installed on any machine running the same Linux kernel and having the same hardware configuration. The following steps must be executed in order to build and install the Linux Advanced System Management drivers. 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 ibmasm rpm -e ibmasm-src-[redhat/suse] To install the source rpm for SuSE, execute the following command: rpm -ivh ibmasm-src-suse-WRPxxxA.rpm where xxx is the version of the source RPM that you are installing. To install the source rpm for Redhat, execute the following command: rpm -ivh ibmasm-src-redhat-WRPxxxA.rpm where xxx is the version of the source RPM that you are installing. To install the source rpm for Redhat version 6.2, execute the following commands: ln -s /usr/src/linux /lib/modules/`uname -r`/build rpm -ivh ibmasm-src-redhat-WRPxxxA.rpm where xxx is the version of the source RPM that you are installing. This RPM will uncompress and untar the archive into the /usr/local/ibmasm directory, copy the drivers, shared library, and all configuration files to their appropriate locations, clean up (remove files that are no longer required) and load the device drivers. The drivers will be configured to start at boot-time, and to stop at reboot or shutdown. 3.3 Installing the ibmasm binary RPM (not normally required). The source RPM creates a binary rpm in the /usr/local/ibmasm directory that may be used to install the device driver on other machines. This would be used in situations where there a many identical servers. To install the binary RPM, execute the following commands after copying the binary RPM to the target system: ls -l ibmasm*.rpm (to see the version number) rpm -ivh ibmasm-1.0-y.y.i386.rpm where y.y is the version of the binary RPM that you are installing. This RPM will uncompress and untar the archive into the /usr/local/ibmasm directory, copy the drivers, shared library, and all configuration files to their appropriate locations, clean up (remove files that are no longer required) and load the device drivers. The drivers will be configured to start at boot-time, and to stop at reboot or shutdown. 3.4 Un-installing the ibmasm RPMS. To uninstall the binary rpm, execute the following command: rpm -e ibmasm To uninstall the source rpm, execute the following command: rpm -e ibmasm-src-[redhat/suse] 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.5 Utility Programs. There are two useful utility programs installed by the RPM. ibmspup is a small script that loads ibmasm.o (the service processor device driver) and ibmser.o (the shared serial port driver). The ibmspup script creates /dev/ibmasm which is the device file for the Advanced System Management hardware and /dev/ibmser which allows the Shared Serial Port featured on the ASM PCI card to be used by communication programs such as minicom. 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 Kernel Configuration Notes ------------------------------ Note: You will not normally need to configure the kernel sources if you installed them during your initial Linux installation or if the. device drivers have been included in the kernel build. To ensure that you have the correct kernel sources installed, you may need to execute the following commands, according to the distribution that you're running. For Red Hat: rpm -qa | grep kernel Sample result (NOTE: Results will vary with different kernel versions): kernel-headers-2.4.2-2 kernel-source-2.4.2-2 kernel-smp-2.4.2-2 kernel-2.4.2-2 Make sure that kernel-headers and kernel-source rpm packages are present and that they match your kernel version number. Once you have the appropriate kernel sources installed you will need to configure them. Execute the following commands: cd /lib/modules/`uname -r`/build make mrproper Execute one of the following commands based on your hardware configuration (again, the exact file names may vary): cp -f configs/kernel-2.4.2-i586.config arch/i386/defconfig cp -f configs/kernel-2.4.2-i586-smp.config arch/i386/defconfig cp -f configs/kernel-2.4.2-i686-enterprise.config arch/i386/defconfig make oldconfig make dep For SuSE: rpm -qa | grep kernel Sample result (NOTE: Results will vary with different kernel versions): kernel-source-2.4.4-SuSE17 SuSE is configured with the Yast tool. Use it install the appropriate kernel source files. After installation configure the kernel sources by executing the following commands: cd /lib/modules/`uname -r`/build cp -f /boot/vmlinuz.version.h /lib/modules/`uname -r`/build/include/linux/version.h cp -f /boot/vmlinuz.config /lib/modules/`uname -r`/build/.config make cloneconfig make dep make menuconfig When menuconfig completes the menuconfig Main Menu will appear. From the Main Menu select exit and then save the new kernel configuration. The Remote Mouse / Keyboard functions can be built with both text-based Virtual Terminal and with X Window System support if your development system has the appropriate X development header files and libraries installed. These files are typically installed if you select the development system options during OS installation. The semi-graphic mode that SuSE uses at boot time causes trouble with Remote Mouse / Keyboard operation. Delete the line "vga = 788" from the /etc/lilo.conf file, run lilo and reboot the system. NOTE: The semi-graphic mode mentioned above is evident when the SuSE penguin or other graphic elements are displayed in what appears to be a text mode screen. 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.