Installation Overview

Installing Hyperic HQ: An Overview

Do you need instructions for installing in a Windows environment or a non-Windows environment?

Upgrading? See the instructions in the Upgrade Guide.

This page provides an installation overview and enumerates the requirements for these HQ components:

Also please consult the list of supported browsers.

HQ can be installed and run in five easy steps (which are expanded on in the OS-specific instructions linked to above):

  1. Download HQ.
  2. Unpack the HQ package.
  3. Install the HQ Agent and HQ Server.
  4. Start the HQ Server.
  5. Start the HQ Agent.

The Full Installation Guide provides everything you need to know about deploying HQ into your IT infrastructure.

Hyperic HQ Server Requirements

System

  • 1 GHz or higher Pentium 4, or equivalent (2 x 2.4GHz Pentium Xeon or equivalent recommended)
  • 1 GB RAM (4 or more GB recommended)
  • 1-5 GB Free Disk Space
  • Supported Operating System:
    • Linux
    • Windows XP or 2003 Server
    • Solaris 8 or higher
    • HP-UX

Database

HQ Server installs configured to run on its own built-in database by default. However, for large installations, having a separate database running on a remote host is recommended. See the Database Preparation Guide for details on how to configure your database.

  • PostgreSQL 8 or higher
  • Oracle 9i or 10g
  • MySQL 5.0 or higher (Hyperic HQ 3.1 or higher)

X Windows

On non-Windows platforms, HQ Server requires some of the X libraries to create charts and other graphics in the user interface. Specifically libXp.so.6 must be installed on the system.
On some new enterprise Linux distributions (such as RedHat ES 4 and CentOS 4), this library is in the xorg-x11-deprecated-libs RPM. For Debian, you need to install the libxp6, libxt6, libxtst6, and libx11-6 packages. In most other distributions, it is either in the XFree86-libs RPM or the xorg-x11-libs RPM.
On Fedora Core 5 (and possibly later distributions from RedHat), the libXp.so library has been split out to its own package. Therefore you must make sure to install the libXp rpm.

No X Libraries

If your HQ installation has broken graphs and errors on many pages, this is likely the problem. Carefully review the X libraries installed on your system. If you are getting an error like the following on most of your pages in HQ, this is your problem.

java.lang.NoClassDefFoundError
    at net.hyperic.hq.ui.taglib.NavMapTag._getResourceTree(NavMapTag.java:252)
    at net.hyperic.hq.ui.taglib.NavMapTag.doStartTag(NavMapTag.java:160)
    ..etc..

back to top

Hyperic HQ Agent Requirements

System

  • 500 MHz Celeron or higher, or equivalent
  • 256 MB RAM
  • 500 MB Free Disk Space
  • Supported Operating System
    • Linux
    • Windows XP or 2003 Server
    • Solaris 8 or higher
    • Mac OS X
    • HP-UX
    • AIX
    • FreeBSD

back to top

Requirements Common to the HQ Server and Agent

Java Runtime Environment

Both HQ Server and Agent come with bundled a JRE that is recommended for use. However, it is sometimes preferable to use a JRE (or JDK) that may already be installed on the system.

  • JRE or JDK 1.4 or 1.5

back to top

Supported Browsers

HQ supports Firefox 1.5.x and 2.0.x, Safari, and Internet Explorer 6 and 7 browsers. Firefox is HQ's recommended browser.

back to top

Next Steps
Related Information
Return to Documentation Overview.

Labels

 
(None)
System Monitoring Software
SourceForge.net Logo