*******************************************************************************
**                 ***************** README *****************                **
*******************************************************************************

The files contained in the HP Advanced Server Management Package for VMware
ESX Server 2.5.x provide the user with multiple system management. The 
standard configuration would be to use the HP Systems Insight Manager (HP SIM)
software. For more information on HP SIM, see:  

http://h18013.www1.hp.com/products/servers/management/hpsim/index.html

KNOWN ISSUES:
============================================================================

The Floppy Drive is shown to be present under Storage in the System Management 
Homepage, even though there is no floppy drive in the server.


The HP Management Agents retrieve the Processor Utilization information for 
only Processor 0, even on a multi-processor system. 


Memory Board details page shows the status of some DIMMs as "Unknown 
Enumeration Value 0" on some HP ProLiant Systems.

INSTALLATION INSTRUCTIONS:
============================================================================

Note that you must always be logged on as username "root" for all of the
instructions in this document.

Once the VMware ESX Server 2.5.x system has been configured, log onto the console 
operating system. Change the working directory to the directory where this
file was unbundled (e.g. /home/vmware/hpmgmt). The installation script will
perform some basic checks and will guide you through the installation process.
In order to see VMware SNMP information you must enable the VMware SNMP sub-
agent. If the sub-agent is disabled, you may enable it in the SNMP
Configuration area under the Options tab in the MUI or by answering 'y' 
when prompted by the installation script. Some things you will want to consider
before you start the installation:

1.  Will you be using the HP SIM console? If so, you want to 
    allocate an IP address for the HP SIM console as you will
    need to provide it during the installation process. You must provide
    either the IP address or the fully qualified DNS name for the HP SIM
    console. This will be an additional "rocommunity" string in the 
    snmpd.conf file. The installation script will ask for this information
    or you can skip this step and modify "/etc/snmp/snmpd.conf" to the
    necessary information.

2.  Do you have other ProLiant or HP servers that you wish to manage? If
    so, you should layout what the SNMP community strings should be. The
    default is usually "public" but since everybody knows the default, this
    is not considered to be very secure. The snmpd.conf(5) man page has
    more information. In general, you need to know the "community strings"
    (e.g. public) and the IP address of the HP SIM console.

3.  Do you wish to enable the HPASM proactive e-mail package? If so, you
    need to install the sendmail(8) package. You will need to contact
    VMware to determine which version of sendmail(8) is compatible with
    VMware ESX Server 2.5.x.

Once you have the information to configure the SNMP and web enabled agent
interfaces, you can install the packages. To install, you must be logged
onto the console OS as user name "root". At the command prompt:

[root@myserver hpmgmt] ./installvm741.sh

You will be presented with the various installation options.


Automating the Installation:

To automate the installation of the agents, make a copy of the 
hpmgmt.conf.example file and rename it to hpmgmt.conf. This file contains
the configuration information for the hpasm package and vmware-snmp sub-
agent. Edit this file to fit your environment. Please see the example
file for complete details on the configuration settings. At a minimum, 
you should configure Local Read/Write community for snmp and the vmware snmp
subagent. When you are ready to install, run the script as follows:

[root@myserver hpmgmt] ./installvm741.sh --silent --inputfile hpmgmt.conf

This will start the installation process immediately--you will not be
prompted for confirmation. If you are missing information from your
configuration file, you may be prompted for it during installation.

To automate the configuration of the System Management Homepage, place
a copy of the smhpd.xml file with the desired settings into the same 
directory as the hpmgmt.sh script. When performing a silent install
this file will be copied to the appropriate directory. It is recommended
to use a file from a pre-existing installation rather than edit by hand.


VALIDATING INSTALLATION: 
============================================================================

You can run a few utilities to validate that the installation of the
package was successful.

snmpwalk localhost public enterprises | grep hp
       This command will list all the SNMP Management Information Block (MIB)
       items associated with "hp". These are the HP management items.


snmpwalk localhost public enterprises | grep 6876
       This command will list all the SNMP Management Information Block (MIB)
       items associated with the VMware ESX Server software. These are the 
       VMware management items. Note that once the system is rebooted, this
       command may no longer work if you have not enabled the VMware SNMP
       subagent to run at startup (automatic). If you want full monitoring
       of the system, you need to log onto the VMware console as previously
       described and enable automatic start of the VMware SNMP processes.

https://fully.qualified.name.com:2381
       Point your web browser to the fully qualified name of this server (or
       the IP address) and port 2381. Note that you MUST use the "https://"
       prefix and port ":2381" or this will not work. This will allow you
       to log into the Web Agent and view the status of the machine. The
       System Management Homepage uses OS accounts for authentication.


REMOVAL INSTRUCTIONS:
============================================================================

You need to change to the directory where this file is located. Then enter
the following command:

     ./installvm741.sh --uninstall 

This will remove all instances of the HP Advanced Management Software 
including the snmp stack (the snmp stack will not be removed on ESX 2.5.3). 
If you wish to continue monitoring your VMware installation through SNMP 
without the HP ProLiant Advanced Server Management software, you will need 
to re-install the SNMP packages from the VMware media. The VMware SNMP 
packages are located on the VMware media at:

     ./VMware/RPMS/ucd-snmp-{version}.i386.rpm
     ./VMware/RPMS/ucd-snmp-utils-{version}.i386.rpm


AGENT CONFIGURATION:
============================================================================

For complete details on configuring HP Insight Manager Agents, please see the
hpasm man page.


ACKNOWLEDGEMENTS:
============================================================================

This package contains additional 3rd-party software. By installing this
software you agree to the licensing terms for use of this software set forth
in the LICENSE file.


Copyright (c) 2005, 2006  Hewlett-Packard  Development  Company, L.P.


