FILE NAME: ham-1.0-1.src.rpm TITLE: Hot Add Memory (HAM) Driver VERSION: 1.0 REVISION: 1 LANGUAGE: English CATEGORY: Software - System Management DIVISIONS: Industry Standard Servers (ISS) PRODUCTS AFFECTED: ProLiant DL760 G2 ProLiant DL740 OPERATING SYSTEM: Red Hat 2.1 Advanced Server SuSE Linux Enterprise Server 7 (32-bit) PREREQUISITES: Proliant DL 760 G2 or Proliant DL 740 Latest HP system ROM mem_hotadd-.arch>.rpm Note: Please visit the following URL to upgrade the ROM http://www.hp.com/support/files/ EFFECTIVE DATE: 04/11/03 ELECTRONIC DISTRIBUTION ALLOWED: YES SUPERSEDES: None DESCRIPTION: This RPM Package contains the Hot Add Memory (HAM) Linux driver for use with HP Servers (with Memory Hotadd capability) mentioned in the PRODUCTS AFFECTED section of this document. ENHANCEMENTS/FIXES: None Table of Contents ================= Introduction Packaging Installing Source RPM Package Uninstall Device Nodes Status Information Hot Add Failures Limitations Notes Introduction ============ The ham (Hot Add Memory) driver, along with the mem_hotadd kernel patch and the hardware specific memory hotplug driver, provides Hot Add Memory support for the Linux system. The ham driver acts as a conduit between the underlying hardware specific memory hot-plug controller driver and the Kernel Virtual Memory (with mem_hotadd patches). This file describes the Linux ham driver for the HP Servers mentioned in the PRODUCTS AFFECTED section. The ham driver needs the mem_hotadd-..rpm to be installed in order to build and load. Please install the mem_hotadd package before installing this driver. After installation additional information can be found in the files located at: For Red Hat: /usr/share/doc/ham-/README For SuSE: /usr/share/doc/packages/ham/README Packaging ========= The driver is released in a source RPM format. The file name for the package is ham-.src.rpm and is dependent on the following :- * The system should be booted with the kernel with mem_hotadd patches. * The kernel source code (with mem_hotadd patches) should be present. If you have not setup the kernel source tree with the mem_hotadd patches, please refer to the mem_hotadd package documentation for more details. Installing Source RPM Package ============================= This step assumes that you are running a kernel with mem_hotadd patches and have set up a kernel tree with mem_hotadd patches at /usr/src/linux-, where is the version number of the booted kernel with mem_hotadd patches. 1. Install the source RPM package. # rpm -ivh ham-.src.rpm 2. Build the binary RPM for the ham driver. Red Hat Installation: # cd /usr/src/redhat # rpmbuild -bb SPECS/ham.spec SuSE Installation: # cd /usr/src/packages # rpm -bb SPECS/ham.spec If you get an error during the build process, please make sure that you have installed the mem_hotadd patch correctly. 4. Install the new RPM package. This installs the ham driver. # rpm -ivh RPMS/i386/ham-.i386.rpm If an older version of ham already exists, please use the "update" command as shown below. # rpm -uvh RPMS/i386/ham-.i386.rpm The ham.o driver will be installed in the following path: /lib/modules//kernel/misc/ham.o Installing the ham binary RPM will install the ham driver and startup/shutdown init scripts. The driver will also be loaded at the end of the installation. 5. You can now reboot your server. Upon reboot the ham driver should be loaded. To verify that the ham driver is loaded use the following command. # lsmod If ham is listed then the ham driver is loaded. Uninstall ========= The ham package can be uninstalled by rpm -e ham The ham driver will be unloaded and all files installed as part of the ham package will be removed. Device Nodes ============ The major device number for the accessing the ham driver through a ham device is generated automatically. The ham device, /dev/ham, will be created by the startup script after loading the ham driver. Status Information ================== The ham driver the following external interface to obtain the status of hot-added memory regions. /proc/ham/status The output is in the following format where, ID : Index of the memory region START : Start address SIZE : Size in bytes FLAGS : READ/WRITE, READ or WRITE STATUS : ENABLED/FAILED Hot Add Failures ================ Successful integration of the hot-added memory to the system depends on available system resources at the time of hotadd. Sometimes, due to insufficient system resources, the hot-add operation can fail. In such case, the /proc/ham/status will show the memory region as "FAILED". The /opt/compaq/ham/ham_integrate tool can be used to attempt re-integration of all memory regions that failed to hot-add. This program is not guaranteed to succeed as any memory hot-add operation is dependent on the available system resources. However, this program can be used multiple times to attempt re-integration. Limitations =========== This release supports hot adding 256 and 512 MB DIMMs. Hot addition of 1 GB DIMMs will be supported in the next release. Notes ===== * The ham driver should only be loaded using the startup/shutdown scripts in /etc/init.d. Loading the ham driver directly (visa insmod) is not recommended. * The device major number for the ham device is generated automatically upon loading of the ham driver. The ham startup script creates appropriate devices files (/dev entries) after loading the ham driver. Users are advised not to remove/rename the device files. * The ham driver is tied to the kernel booted at the time of ham driver installation. If the kernel is changed/recompiled, the ham driver needs to be reinstalled. In that case, the following steps are to be followed :- - Boot with the modified kernel (with mem_hotadd patch) - Uninstall the ham package (refer Uninstall section above) - Recreate and install ham binary RPM package (refer Install section above) It is not necessary to install the src RPM package again. Copyright 2003, Hewlett-Packard company. All rights reserved. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.