******************************************************************************* *************** HP SNMP Agents README ****************** ******************************************************************************* The files contained in the HP Advanced Server Management Package for VMware ESX 4.0 provides 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: =============================================================================== 1. In the System Management Homepage, IDE controller information is not populated for a DL385 G5. 2. In the System Management Homepage, disk drive information for Intel Serial ATA is not populated. 3. In the System Management Homepage, SA P212 Controller information is not displayed in the Storage information box for a ProLiant Server. 4. In the System Management Homepage, it has been observed that information that was initially displayed sometimes disappears. 5. In the System Management Homepage, Intel SATA Controller drive information is not displayed for the BL490c G6. 6. Information for the HP Embedded SATA controller and disk drive information is not seen in the Storage information box on the System Management Homepage. 7. The request for the System Management Homepage may timeout when the ESX host is creating Virtual Machines. 8. cmafcad agent stops on systems configured with Emulex FC HBAs. 9. Information on the Self Test Results tab for the Management Processor sometimes disappears. 10. When performing reset, enable or disable of alerts of the Integrated Lights Out (iLO) operations available in the System Management Homepage, it may be observed that there are error messages seen on the console. INSTALLATION INSTRUCTIONS: =============================================================================== IMPORTANT: This release supports the HP Insight Manager Agents on ESX 4.0 only. If HP Insight Manager Agents bulletin already exists on this host, this release uninstalls the older versions of agents before installing the new Insight Manager Agents. Note that the user must always be logged on with administrator privileges for all of the instructions in this document. =============================================================================== Installing and configuring HP SNMP agents on ESX 4.0: =============================================================================== INSTALLATION: =============================================================================== Copy the install package, hpmgmt-8.3.1-vmware4x.tgz, to a local folder on an ESX 4.0 system (e.g. /home). From a command window on ESX host: Navigate to the directory where the files are copied and unzip the tar file: tar -xvzf hpmgmt-8.3.1-vmware4x.tgz Navigate into the directory hpmgmt/831. Install the HP SNMP agents with following command: ./install831vibs.sh Two installation options are available. Manual Installation: To manually install the agents, use --install option. Automated (Silent) Installation: To automate the installation of the agents, make a copy of the hpmgmt.conf.example file located in the local install folder and rename the copy to hpmgmt.conf. This file contains the installation information for the hp-snmp-agents package and firewall port configurations (for ESX 4.x). Edit this file to customize for the installation environment. Please see the example file located in the local install folder for complete details on the installation settings. At a minimum, Local Read/Write community for snmp agent should be configured. When ready to install, run the script as follows: ./install831vibs.sh --silent --inputfile hpmgmt.conf This will start the installation process immediately -- no prompts for confirmation will be requested. If information is missing from the configuration file, the missing information may be prompted for 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 configurevm831.sh script (located in /opt/hp/hp-agents-config folder). 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. After successful installation, output similar to the following is displayed in the command window: ------------------------------------------------------------------------------- HP Insight Manager Agent 8.3.1-xx Installer for VMware ESX Server Target System is VMware ESX 4.0.0 build-xxxxxx Server: ProLiant DL380 G6 Installing HP SNMP Agent bulletin [hp-classic-mgmt-solution-831] ....OK =============================================================================== NOTE: New snmpd.conf entries were added to the top of /etc/snmp/snmpd.conf =============================================================================== snmpd is started Enabling port for hpim service (2381) in the firewall....OK Enabling port for HP System Management (2301) in the firewall....OK Enabling snmpd service in the firewall....OK Enabling port [280] for adding the HP SIM Certificate in SMH....OK Stopping System Management Homepage:....OK Starting HP Insight Manager agents:....OK Starting System Management Homepage:....OK Stopping SNMP stack: Stopping snmpd:....OK Starting SNMP stack: Starting snmpd:....OK ********************************************************** * System Management Homepage installed successfully with * * default configuration values. To change the default * * configuration values, type the following command at * * the root prompt: * * * * /opt/hp/hpsmh/sbin/smhconfig * * * ********************************************************** Please read the License Agreement for this software at /opt/hp/hp-health/hp-health.license By not removing this package, you are accepting the terms of the "License for HP Value Added Software". HP Insight Manager agents have been configured successfully! HP SNMP agents are installed and configured Reboot the system to make the changes effective. ------------------------------------------------------------------------------- After above successful configuration message is displayed, reboot the ESX host with the reboot command. The results of the VIB installation can be found in the vib_bulletin_update.log file located in the local install folder. The results of the configuration of the agents can be found in hpmgmtlog file located at /opt/hp/hp-agents-config folder. VALIDATING INSTALLATION: =============================================================================== To validate the successful installation of the HP SNMP agents components package, several utilities can be run: From a command shell verify the components by running the following commands: To verify hpilo driver status, type: service hp-ilo status To verify HP SNMP agents, type: service hp-snmp-agents status snmpwalk -v 1 localhost -c public enterprises | grep hp This command will list all SNMP Management Information Block (MIB) items associated with "hp". These are the HP management items. NOTE: The entry "rocommunity public 127.0.0.1" must be in snmpd.conf for this command to display data. https://fully.qualified.name.com:2381 Point the web browser to the fully qualified name of this server (or the IP address) and port 2381. Note that https:// prefix and port ":2381" must be used or this will not work. This will allow logon into the System Management Homepage and view the status of the machine. The System Management Homepage uses OS accounts for authentication. Verify that the Management Processor section is seen on the homepage Click on Integrated Lights-Out 2 to get detailed "Management Processor Integrated Lights-Out 2" information. REMOVAL INSTRUCTIONS: =============================================================================== Uninstalling HP SNMP agents: From a command window on the ESX host Navigate to the original install folder (e.g. /home/hpmgmt/831). From the original install folder, uninstall HP SNMP agents with following command: ./install831vibs.sh --uninstall This will remove all instances of the HP Advanced Management Software except the SNMP stack. The firewall ports for the `hpim' service, port 280 and port 2301, will be disabled during uninstall of the agents. A warning is displayed because the `snmpd` service remains enabled in the firewall. If no other program is using the `snmpd` service behind the firewall, then the `snmpd` service can be disabled in the firewall by using the command "esxcfg-firewall --disableservice snmpd". After successful uninstallation, output similar to the following is displayed in the command window: ------------------------------------------------------------------------------- HP Insight Manager Agent 8.3.1-xx Installer for VMware ESX Server Target System is VMware ESX 4.0.0 build-xxxxxx Server: ProLiant DL380 G6 This script will now attempt to unconfigure the HP Insight Manager Agents. Do you wish to continue (y/n) y Stopping HP Insight Manager agents: Stopping hp-snmp-agents: [ OK ] Stopping hp-health: [ OK ] Stopping System Management Homepage: [ OK ] Stopping SNMP stack: Stopping snmpd: [ OK ] Disabling port for hpim service (2381) in the firewall [ OK ] Disabling port for HP System Insight Manager (2301) in the firewall [ OK ] Disabling port for the SIM Certificate in SHM [280] in the firewall [ OK ] WARNING: snmpd service has been enabled in the firewall. Disable this service using the command "esxcfg-firewall --disableservice snmpd" if no other program is using it HP Insight Manager agents have been unconfigured successfully! Uninstalling bulletin [hp-classic-mgmt-solution-v831] ... ....OK SNMPD Operations using System Management Homepage - SNMP Configuration Page =============================================================================== To be able to perform the operations of start, stop, and reset of the snpmd daemon from the SNMP Configuration Page, the user must comment out the line "Defaults requiretty" in the file /etc/sudoers. Please see man sudoers for details about the 'requiretty' flag. AGENT CONFIGURATION: =============================================================================== 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. Find the HBA driver version number. (See Additional notes below) 2. Download the libraries for the driver loaded in the vmkernel from the following links: (see additional notes below to determine which driver has been loaded in the vmkernel) Link for Emulex libraries: http://www.emulex.com/vmware/support/index.jsp Link for QLogic libraries: http://support.qlogic.com/support/oem_product_detail_vmware.asp 3. Stop the 'hpsmhd' and 'hp-snmp-agents' agents by issuing the commands from the service console, 'service hpsmhd stop' and 'service hp-snmp-agents stop' NOTE: you must be logged in as a user having administrative privileges. 4. Install the libraries which were downloaded in step 2 using the install script present in those packages. 5. First start the 'hpsmhd' service using the command 'service hpsmhd start'. 6. Then, start the 'hp-snmp-agents' service using the command 'service hp-snmp-agents start'. Additional notes: To find the version number of the HBA driver that is being using in the ESX system, the information can be found in /proc/vmware/version. Here is an example of QLogic and Emulex entries in the version file: QLogic: qla2300_707 build 96281: 7.07.04.01.3vmw Emulex: lpfcdd_732 build 96281: 7.3.2_vmw10 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) 2009 Hewlett-Packard Development Company, L.P.