Install Hyperic Agent RPM

About this page...

This page has instructions for installing Hyperic Agent 4.6 from an RPM from the VMware YUM repository.

Before running the installer, see Hyperic Installation and Startup Process for information about where agent installation fits in the implementation process.

About Hyperic Agent RPM

The name of the vFabric Hyperic Agent RPM package is vfabric-hyperic-agent.noarch. Note that the agent in the RPM does not include a JRE. Agent hosts must have the J2RE virtual package installed. A Sun 1.6 JRE is required. The RPM:

  • Creates the user and group named "hyperic" if they do not exist.

  • Sets the home directory of the hyperic user to /opt/hyperic.

  • Installs the agent files into /opt/hyperic/hyperic-hqee-agent.

  • Installs an init script to /etc/init.d/hyperic-hqee-agent.

  • Adds init script to chkconfig and sets it to "on" for runlevels 2, 3, 4, and 5.

Open firewall port on Hyperic Agent, if necessary

If iptables (a host-based firewall tool typically enabled by default on Redhat and Fedora installations) is configured, you may need to open up the Hyperic Agent's listen port for communication from the Hyperic Server, using a command similar to:

`/sbin/iptables -ARH-Firewall-1-INPUT -p tcp --dport 2144 -j ACCEPT` 

If SELinux is enabled, dditional configuration may be required.

Step 1 - Install vFabric Repository RPM

In this step you install the vFabric Repository RPM on the RHEL VM where you will install the Hyperic Server. This RPM allows you to browse the vFabric repository.

vFabric RPM repositories are located on

Following the instructions for you version of vFabric Suite:

Instructions for 5.0 and 5.1 Repositories

  • vfabric-5-2-repo — vFabric component RPMs that are certified for vFabric Platform 5.

  • vfabric-5.1-repo-5.1-1 — vFabric component RPMs that are certified for vFabric Suite 5.1.

  • vfabric-all-repo — vFabric component RPMs for customers who have not bought a vFabric 5 Standard or Advanced license, and more recently released versions of vFabric components that may not necessarily be certified to work with those of vFabric 5 or vFabric 5.1. (Note: This respository is deprecated in vFabric Suite 5.2}

If you have a vFabric Standard or Advanced license, plan to install only RPMs that are certified for vFabric 5 or 5.1, then install vfabric-5-repo-5-2 or vfabric-5.1-repo-5.1-1, as appropriate. If you do not have a vFabric Standard or Advanced license, or want to install a maintenance release that was not certified for vFabric 5 or vFabric 5.1, install vfabric-all-repo.

To install the 5.0, 5.1, or the vfabric-all-repo repository:

  1. Log in to the RHEL VM as the root user (or as a user with sudo privileges).

  2. Open a terminal window.

  3. Install the desired repository RPMs. Note that the URLs of the RPMs vary depending on whether the version of RHEL you use.

    • For RHEL 5:

      rpm -Uvh
      \\ to install the vFabric 5 repository RPM
      rpm -Uvh
      \\ to install the vFabric 5.1 repository RPM
      rpm -Uvh
      \\ to install the "all-repo" repository RPM
    • For RHEL 6:

      rpm -Uvh \\ to install the vFabric 5 repository RPM
      rpm -Uvh \\ to install the "all-repo" repository RPM

Use sudo to run the preceding commands if you are not logged in as root.

Searching the RPM repository

You can use the yum search vfabric command to list of vFabric components that you can install from the VMware repository. For example:

yum search vfabric
======================================== Matched: vfabric =========================================
vfabric-eula.noarch : VMware vFabric 5.1 End User License Agreement
vfabric-gemfire.noarch : VMware vFabric GemFire
vfabric-hyperic-agent.noarch : VMware vFabric Hyperic Agent
vfabric-hyperic-server.x86_64 : VMware vFabric Hyperic Server
vfabric-insight-agent.noarch : com.springsource.insight.dist.vfabric:agent-rpm
vfabric-insight-dashboard.noarch : com.springsource.insight.dist.vfabric:dashboard-rpm
vfabric-rabbitmq-java-client-bin.noarch : The RabbitMQ Java Client Library
vfabric-rabbitmq-server.x86_64 : The RabbitMQ server
vfabric-sqlfire.noarch : VMware vFabric SQLFire
vfabric-tc-server-standard.noarch : VMware vFabric tc Server Standard
vfabric-web-server.x86_64 : VMware vFabric Web Server

Instructions for 5.2 Repository

To install the vFabric 5.2 repository:

  1. On the RHEL computer, start a terminal either as the root user or as an unprivileged user who has sudo privileges.

  2. Install the vFabric repository RPM using the following wget command, passing it the appropriate URL. The URL differs depending on the version of RHEL you are using.

    • Note: Run the entire wget command on a single line. Include the | sh at the end, or the RPM installation will not work.

    • For RHEL 5:

      wget -q -O - | sh
    • For RHEL 6:

      wget -q -O - | sh
    • If necessary, use sudo to run the preceding commands if you are not logged in as the root user. For example:

      sudo wget -q -O - | sh

The command performs the following tasks:

  1. Imports the vFabric GNU Privacy Guard (GPG) key.

  2. Installs the vFabric 5.2 repository RPM.

  3. Launches the VMware End User License Agreement (EULA) acceptance and repository configuration script.

  4. Outputs the EULA for you to read; you must answer yes to accept the terms and continue.

Step 2 - Install Agent RPM

To install and configure the Hyperic Agent from a downloaded RPM:

  1. On the platform the agent will manage, use yum to install the agent

    yum install vfabric-hyperic-agent 

  2. If you have not already done so, install a JDK or JRE on the platform.

  3. As the root user, edit the /etc/init.d/hyperic-hqee-agent file, setting the HQ_JAVA_HOME to home directory of the JDK or JRE you want the agent to use.