Hyperic Installation and Startup Process

About this page...

This page lists required and optional steps for a new installation of the Hyperic Server and Hyperic Agent. Steps that are not required for all installations are marked "Optional" or "As Necessary".

For upgrade options and instruction see Hyperic Upgrade Processes.

Note: If you obtain vFabric Hyperic as part of vFabric Suite (previously known as "vFabric Platform"), first complete the license activation and installation procedures in Getting Started with vFabric Suite. Then follow procedures in this document to set up your environment for vFabric Hyperic and complete any remaining Hyperic-specific installation and configuration tasks.

Step 1 – Obtain Hyperic Installer

See Select and Download an Installer for instructions.

Step 2 – Set Up Hyperic Database

If you are installing Hyperic for production use, configure an external Hyperic database before installing Hyperic Server. In large environments, set up the Hyperic database on a dedicated platform.

Follow the instructions for the database you use:

For information about Hyperic database requirements and recommendations, see:

Step 3 - Set Up Hyperic Server

  1. Before installing the server:

  2. Install Hyperic Server.

  3. Install License (vFabric Hyperic only).

  4. Start the Hyperic Server.

    • Follow the instructions that apply to your environment:

      • If you installed the Hyperic Server from the VMware yum repository to an RHEL VM, the Hyperic Server is configured to start automatically each time the VM starts up. If you installed the Hyperic Server for a downloaded RPM, following these steps to start the Hyperic Server as a daemon:

        1. Log in to the Hyperic Server host as root.

        2. Open a terminal window and run the /etc/init.d/hyperic-hq-server script with the start parameter:

          /etc/init.d/hyperic-hq-server start 

      • On Unix-Like platforms, to start the Hyperic Server as a daemon:

        1. Open a command shell.

        2. Change directory to ServerHome/bin, and enter:

          hq-server.sh start 

      • On Windows platforms, to install the Hyperic Server Windows service and start the service:

        1. Open a terminal window.

        2. Change directory to ServerHome\bin and enter:

          hq-server.bat install 
          hq-server.bat start 

      • The script will display startup information on stdout, then detach and run in the background.

  5. Verify that the Hyperic Server started successfully.

    • Verify that the Hyperic Server started successfully by pointing your web browser to the Hyperic user interface.

    • After the Hyperic Server starts up, which may take a moment or so, display the Hyperic user interface at the following URL, replacing "ServerHostName" with the server's hostname (or "localhost" from the server host). Replace "7080" with the appropriate port number if you configured the server to listen on a different port.


    • The Hyperic Dashboard should appear. Note that there will not be any resources in inventory until you start a Hyperic Agent.

    • If the Hyperic Dashboard does not appear, check server.log and boostrap.log in ServerHome/logs/ for information about server startup status.

Sensitive Data Best Practices

In this version of Hyperic, the Hyperic installer writes some sensitive data to installation log files. After successfully installing Hyperic Server, delete InstallerHome/logs/hq-install.log and hq-install.log.verbose, or the whole the exploded installer.

Step 4 - Set Up the Hyperic Agent

  1. Before installing the agent, or if you have already installed the agent, before starting it for the first time:

  2. Install the agent, following the instructions for the desired installation method:

  3. Install database drivers for Hyperic HQ .

    • In Hyperic HQ, the plugins packaged with the Hyperic Agent for MSSQL, Oracle, Informix, DB2, and Sybase do not include the database vendor's JDBC plugin. (The database plugins in vFabric Hyperic include the JDBC drivers.) After installing Hyperic HQ you must download and install the vendor-provided JDBC drivers for these plugins to work. Install drivers in:


  4. Configure Hyperic Agent in properties file (As necessary).

  5. Start the Hyperic Agent for the first time.

    1. Make sure that the Hyperic Server is running.

    2. Follow the instructions that apply to your environment:

  6. Import discovered resources.

Step 5 - Next Steps for New Installations

If your Hyperic database runs on Oracle, see:

If your Hyperic database runs on MySQL, see:

If you are implement a large deployment, see:

For information about establishing your monitoring environment see vFabric Hyperic Administration for instructions on setting up:

  • Resource groups and applications

  • Users and roles in (vFabric Hyperic only)

  • Alerts for resources and resource types

  • Configurable alert notification types

  • Resource auto-discover options