Installing Hyperic HQ

Upgrading See the Upgrade Guide for documentation on upgrading HQ.

HQ can be installed and run in five easy steps:

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.

For details on each step, consult the Windows installation instructions or non-Windows installation instructions.

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

This page enumerates the requirements for the HQ Server and the HQ agent and requirements common to them both.

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

X Window

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

Common Requirements

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

System Time Synchronization

Common Problem This is the number one most common problem when unexpected metric behavior is seen in HQ (i.e. no metrics being collected).

It is very important the system time on your HQ Server be synchronized with the system time on all of your HQ Agents. The agent puts a timestamp on each metric and the server uses that information when processing the metric. Hyperic highly recommends and encourages the use of NTP or similar software to keep everything in sync.

Archive Utilities

All HQ bundles are archived with GNU Tar and GNU Zip so it is recommended that GNU Tar and GNU Zip be used to unpack the bundles. There is an additional Windows bundle that is simply a .zip to make it easier to access on Windows platforms that may not have a tar compatible utility.

Solaris Platforms Unpacking HQ bundles with Solaris Tar will result in warnings that look like the following. It is necessary to use GNU Tar to avoid these warnings and to successfully unpack the bundle. tar: ././@LongLink: typeflag 'L' not recognized, converting to regular file.

• GNU Tar
• GNU Zip
• Winzip

Back to top

Return to [Documentation Overview].