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

The files contained in the HP Advanced Server Management Package for VMware
ESX Server 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 link to storage controllers that do not have any disk drives attached 
might not be displayed in the System Management Homepage.


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


During the configuration of System Management Homepage using "hpSMHSetup.pl", 
the Import Option is disabled in the Trusted Certificates screen.


Help page does not exist for NIC section in System Management Homepage.


If you access the SAN Storage System in System Management Homepage through the 
Storage System link under External Storage Connections and try to refresh it by
clicking on the link "Home->Storage->{Storage System Name}" in the navigation 
bar, it will show a blank page.


After installation of the Insight Management Agents, /var/spool/compaq/cma.log
file might show the following error messages:

"ERROR:bad OID length -1 max=128, cmanicd.c 128"
"cmastdeqd[18515]:systemId:(null) subsystemId: CPQ0101"
"ERROR: Failed to scan dir /sys/bus/pci/devices: port_map.c,225"
"Shutting down SAS agent (cmasasd): Failed to open Registry"
"cmahealthd[13664]: ERROR: Failed to open /dev/cpqhealth/crom"
"cmahealthd[13664]: CheckForResMemChange:  IOCTL ERROR 0xffffffff"
"sh: line 1: /bin/mail: No such file or directory"

These error messages do not affect the functionality of the agents and can
safely be ignored.


System Management Homepage(SMH) might show 'connection-timeout' error message 
if we try to refresh it a couple of times quickly. You might have to restart 
the hpmshd service to be able to login to SMH again. This usually happens when
iLo/iLO2 is being reset and the SMH is refreshed.


The hpsmhd service might show the following error messages while restarting it
after a 'connection-timeout' error is displayed by the SMH, but still the 
hpsmhd service will be restarted successfully:

"Problem receiving data: Connection reset by peer (104)
Connected to 127.0.0.1:2301....
sent /proxy/reconnect...counter=1, status=104 
*** GOT PORT 2301...i=0 **** "


The System Management Homepage may display the DIMM information incorrectly
after a memory board containing the DIMMs is hot-added on DL580 G3 or ML570 G3.


The UID turn ON/OFF buttons may be displayed in System Management Homepage even
when the UID is in the blinking state(while accessing the iLO remote console) 
on servers having iLO.


The iLO2 reset message may not be displayed in the service console for
DL580 G4 and ML570 G4 servers.


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

IMPORTANT: The 7.9.0 HP Insight Manager Agents support only ESX 3.0.x versions.

From the 7.9.0 release onwards, the upgrade of HP Insight Manager Agents is 
not supported. Please uninstall the older versions of agents before 
installing the 7.9.0 Insight Manager Agents.

Note that you must always be logged on as a user having administrator
privileges for all of the instructions in this document.

Once the VMware ESX Server system has been installed and 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.

On ESX 3.0.x:
-------------
You must enable the firewall port for the `hpim' service (2381) for accessing 
the System Management Homepage. The `snmpd' service should be enabled in the 
firewall for the Insight Manager agents to communicate properly with the hp 
Systems Insight Manager. Port 280 should be enabled in the firewall for 
adding the HP Systems Insight Manager certificate in SMH. These ports can be 
enabled by using the "esxcfg-firewall" command in the service console, or by 
answering 'y' when prompted by the installation script.

Note:
For adding the HP Systems Insight Manager (HPSIM) certificate in SMH, in
addition to opening the port 280 in the firewall, the DNS name of HPSIM Server
should be specified in the /etc/hosts file of ESX host.

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.

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 a user having administrator privileges. At the 
command prompt:

[root@myserver 790] ./installvm790.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 firewall port 
configurations (for ESX 3.0.x). 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 agent. When you are ready to install, run the script as follows:

[root@myserver 790] ./installvm790.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 installvm790.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 -v 1 localhost -c 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 -v 1 localhost -c 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 the installvm790.sh script is 
located. Then enter the following command:

    [root@myserver 790] ./installvm790.sh --uninstall 

This will remove all instances of the HP Advanced Management Software 
except the snmp stack.

The firewall port for the `hpim' service and port 280 will be disabled during
uninstall of the agents. The `snmpd' service can be disabled in the firewall 
by using the command "esxcfg-firewall --disableservice snmpd".

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

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


For the storage agents to display the correct information for the Qlogic and
Emulex HBAs, the libraries corresponding to the Qlogic and Emulex driver
versions have to be installed on the ESX Service Console.
Please ensure that you run through these instructions ONLY if you do not see a
link for either the HBA or the target drives in the System Management Homepage.

The following steps guide you through the installation for the corresponding
libraries -
1. Download the libraries for the driver loaded in the vmkernel from the
following links:
        Link for Emulex libraries - http://www.emulex.com/ts/docoem/vmware/index.html
        Link for Qlogic libraries - http://support.qlogic.com/support/oem_product_detail_vmware.asp
2. Stop the 'hpsmhd' and 'hpasm' agents by issuing the commands,
'service hpsmhd stop' and 'service hpasm stop' from the service console
(you must be logged in as a user having administrative privileges).
3. Remove the older corresponding libraries from the '/opt/compaq/storage/bin'
directory. ('libdfc.so' for Emulex, and 'libqlsdm.so' for Qlogic).
4. Install the libraries which were downloaded in step 1 using the install
script present in those packages.
5. For the Qlogic libraries you might have to rename the library file. Use the
following command to rename the library file -
        'mv /usr/lib/libqlsdm-ia32.so /usr/lib/libqlsdm.so'
5. Restart the 'hpsmhd' service first using the command 'service hpsmhd start'.
Then, start the 'hpasm' service using the command 'service hpasm start'.


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, 2007  Hewlett-Packard  Development  Company, L.P.


