Installing FUSE HQ: An Overview

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

This page provides an overview of the requirements for an HQ installation. Installing FUSE HQ: The Complete Guide provides everything you need to know about deploying HQ into your IT infrastructure.

Upgrading HQ? See the instructions in the Upgrade Guide.

Procedural overview for installing HQ:
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.

See the requirements for these HQ components:

• HQ Server requirements
• HQ Agent requirements
• Requirements common to Agent and Server

Also please consult the list of supported browsers.

If you have any comments or suggestions for this help page, please submit them at the bottom of the page by clicking Add Comment.

FUSE 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 Preparing HQ's Database for details on how to configure your database.

• PostgreSQL 8 or higher
• Oracle 9i or 10g
• MySQL 5.0 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

FUSE 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

Return to Documentation Overview.