Installation Overview
Installing Hyperic 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 Hyperic 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):
- Download HQ.
- Unpack the HQ package.
- Install the HQ Agent and HQ Server.
- Start the HQ Server.
- Start the HQ Agent.
See the requirements for these HQ components:
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.
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 Preparing HQ's Database for details on how to configure your database.
- PostgreSQL 8 or higher
- Oracle 9i or 10g
- MySQL 5.0.45 or higher
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..
|
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
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
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
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.
|
Next Steps Get HQ up and running as quickly as possible. |
Related Information |