The RHQ Server and Agent are supported on Linux and Windows operating systems, and on x86_64, i686, and ia64 architectures. We support other platforms that support Java 6, but native support must be disabled; however, this limits functionality of the RHQ Agent.
Support for 64-bit is limited to Linux on x86_64; RHQ is supported on other 64-bit platforms only when the OS is in 32-bit compatibility mode.
Clocks on RHQ Servers and Agents need to be in synchronized; to keep them synchronized, a tool such as NTP is highly suggested.
RHQ requires Java 6 or higher in order to run both the RHQ Server and the RHQ Agent; either a JRE or a JDK can be used. Java must be installed on all machines monitored with an Agent, as well as on the machines hosting RHQ Servers. On Linux systems, OpenJDK, Sun Java, or JRockit should all work. GNU libgcj is not supported. On other OS's, use the recommended Java 6 implementation.
After downloading and installing the latest JRE or JDK, set the JAVA_HOME environment variable to its installation directory. Try to avoid spaces in your Java installation path there. Alternatively, you can set the RHQ_SERVER_JAVA_HOME environment variable for Servers or the RHQ_AGENT_JAVA_HOME environment variable for Agents.
RHQ 3 and below also supported Java 5. RHQ 4 and later no longer supports Java 5.
In order to run RHQ, an external database must be installed.
RHQ is distributed with a Java embedded database called "H2", so if you are just running RHQ to test it out and play with it, you can use that and not install an external database. But this Embedded H2 database is to be considered only for demoing and testing purposes. For production systems, you will need to install an external database.
The supported databases are:
After installing the database, make note of the JDBC URL, username and password for the database. This information is required during the RHQ Server installation.
Postgres versions 8.2.4 and higher are supported. Instructions for installing and configuring your Postgres instance can be found here.
Oracle versions 10g and 11g are supported. Instructions for installing and configuring your Oracle instance can be found here.
The release contains experimental support for other databases; these are not considered production ready and are to be for demoing and testing purposes only. The only supported databases for production RHQ installations are Oracle and PostgreSQL.
The experimental, unsupported databases are: