FILE NAME:	cmhp.o

TITLE:		Compaq Memory Hot Plug (cmhp) Module

VERSION:	1.0

LANGUAGE:	English

CATEGORY:	Software Solutions

DIVISIONS:	Enterprise Servers

PRODUCTS AFFECTED: 
		ProLiant DL760 G2 Server
		ProLiant DL740 Server

OPERATING SYSTEM:  
                Red Hat 7.3 Professional
                Red Hat 2.1 Advanced Server
                Red Hat 2.1 ES
                SuSE Linux Enterprise Server 7 (32-bit)

PREREQUISITES:  Pentium based computer (32-bit)
                128MB RAM minimum
                Latest system ROM
		mem_hotadd-<version>-<dist>-<arch>.rpm (VM patch)
		ham-<version>.src.rpm (HAM)

                Note: Please visit the following URL to upgrade the ROM
                        http://www.hp.com/support/files/

EFFECTIVE DATE: 01/30/03	

SUPERSEDES:	None

DESCRIPTION:	This module provides the lowlevel hardware driver support for
                memory hot plug functionality, ECC support, and CIM memory 			monitoring interface on the servers mentioned in the 
                PRODUCTS AFFECTED section of this document.

ENHANCEMENTS/FIXES:
		None	


Table of Contents
=================
  Introduction
  Packaging
  Device Nodes
  Status Information
  System Setup 

Introduction
============

This module provides ECC and CIM memory monitoring support for the affected
server in much the same way as the cpqasm and cpqevt do for other Proliant
server.  This document is intended to cover the Memory Hot Plug functionality
that cmhp provides. Therefore refer to "man hpasm" for more information 
about the ECC and CIM support.

The hardware in the affected systems provide functionality to add and swap
memory without taking the server down.  You do not need this driver for those
functions to work.  However, you do need this module for the added memory to be
accessible by the OS.  On a hot add event, the hardware generates a signal to 
the cmhp module and then cmhp notifies the OS that more memory is available
for use.  

Unfortunately, the current 2.4 base kernels do not have the functionality 
needed to make use of the new memory.  In order to provide this feature sooner,
HP provides a Virtual Memory kernel patch for selected Linux releases and 
a Hot Add Memory (HAM) driver as open source projects. The "Hot-Add VM patch"
and "Hot Add Memory Driver" can be found at:

http://www.hp.com/linux

Follow the direction included with each package for proper system setup.

Packaging
=========
The cmhp module is packaged in the hpasm package.

Device Nodes
============
The cmhp device, /dev/ham and /dev/cpqhealth/cmhp, will be created 
by the startup script after loading the hpasm package.

Status Information
==================
Hardware status can be collected using CIM.

System Setup
============
1. Install one of the operating systems list above. 
2. Install the kernel source RPM.
3. Install the VM Hot-Add patch. The VM Hot-Add patch can be obtained from 
     http://www.hp.com/linux.
   Please read the documentation that comes with the RPM. It contains the 
   instructions to configure and build the hot-add kernel. 

4. Install the HAM driver src RPM. The HAM src RPM can be obtained from 
     http://www.hp.com/linux.
   This package will install the driver, startup/shutdown init scripts
   and attempt to load the driver.  Please look at the following Documentation
   for detailed installation instructions.

5. Install the hpasm rpm. 
    # rpm -ihv hpasm-<version>.<distribution>.i386.rpm

   This will install and load the cmhp module.

Memory can now be hot added to the system.

NOTES
=====

Hewlett-Packard Company, Copyright 2003.  All rights reserved.

Product names mentioned herein may be trademarks and/or registered trademarks
of their respective companies.
