*******************************************************************************
**                 ***************** 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

WHAT'S NEW:
============================================================================

- VMFS disk usage is now reported
- System Management Homepage
	The System Management homepage is now a separate package.  SMH uses
	system accounts for authentication.
- New command line syntax for installation

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

Any device assigned to the service console must not share its legacy IRQ
with the iLO controller.

ProLiant DL585: By default the service console NIC and the iLO controller
	        share an IRQ.  Assign the 2nd on-board NIC to the service
	        console instead.
ProLiant DL740: The USB and iLO controllers, share IRQs.  Consider moving
	        the iLO controller to IRQ 12
Other ProLiant Servers may have similar conflicts.  If you experience problems
installing or starting the Lights-Out agents (hprsm) check for IRQ conflicts.
IRQ reassignments can be made in the RBSU.


Due to a known issue with ESX Server 2.5, running the Insight Manager storage
agents may cause the service console to freeze periodically.  If you experience
this problem it is recommended to disable the storage agents from running.  This
issue will be addressed in a future update to ESX Server.  To disable storage
agents from running, run the hpasm reconfigure task and answer "No" when asked
if you require the storage agents support:

%> service hpasm reconfigure


The management agents may not detect MSA1000 or MSA1500 when using version 
6.07 of the QLogic driver packaged with ESX Server 2.5.  Please obtain a new 
driver from (availability currently unknown). Please contact VMware for current status.

The System Management Homepage may not respond to requests immediately after starting.
Please wait a few minutes before attempting to connect to SMH.  If SMH does not respond,
login to the service console directly or through iLO. SMH uses the kernel's random number
generator as part of it's security mechanisms. Due to the nature of ESX Server, most of 
the 'environmental noise' from IRQs and device drivers used to generate random numbers is
masked from the service console. This can cause SMH to stall while waiting on the random
number generator.  Logging in at the keyboard or through iLO should generate enough 
activity for the random number generator.  Please contact VMware for current status.



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 enabled 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 compatable 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] ./installvm720.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 enviroment.  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] ./installvm720.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 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.  The 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:

     ./installvm720.sh --uninstall 

This will remove all instances of the HP Advanced Management Software
including the snmp stack.  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  Hewlett-Packard  Development  Company, L.P.


