Installing RHQ

Prerequisites
Running The Installer

Prerequisites

Make sure you meet the following prerequisite requirements prior to attempting to install RHQ.

Operating System
RHQ server and agent are supported on Linux and Windows with the amd64, i686 and ia64 architectures. We support other platforms that support JDK 5, but native support must be disabled which will impact some of the functionality of the RHQ agent.

Synchronize Machine Clocks

You must make sure that all platforms to be imported into your environment must have their clocks in sync with each other and with the RHQ Server. If the times are off, measurements, availabilities and graphs will be skewed and problems will occur when you attempt to import resources into your inventory. Read about NTP if you are unfamiliar with how you can do this.

Java
RHQ requires Sun's JDK 5 in order to run both the server and the agent (other vendor implementations of Java 5, like JRockit, may also work). Sun's JDK 5 must be installed on each machine that will be monitored with an agent as well as the machine that will house the RHQ server.
After downloading and installing the JDK, make sure that you have the JAVA_HOME environment variable set to point to the install location. This environment variable will tell the RHQ server and the RHQ agent where to locate the JDK.

Database
In order to run RHQ, you will need to install an external database. PostgreSQL and Oracle are supported. See The Database below for setting up your particular database.

PostgreSQL versions 8.2.4+ are supported.
Oracle version 10g is supported.

Running The Installer

Unzip the binary server distribution. Avoid unzipping it to a long path on windows where path length restrictions can cause problems.
On non-windows platforms make the scripts executable
```
chmod +x bin/*.sh jbossas/bin/*.sh
```
Copy the database specific client JARs into jbossas/server/default/lib/
Run the RHQ Server in foreground (bin/rhq-server.[bat,sh] console)) or background (bin/rhq-server.[bat,sh] start))
Point your browser at http://localhost:7080/ – This will display the RHQ Server Installer web application.
Click the "Click here to continue the installation" link
The installer will first ask you for the startup property settings. Once you save them, the installer will connect to your database and install the RHQ Server DB schema automatically. If you already have a RHQ Server schema installed in that database (e.g. from a previous RHQ installation), the installer will attempt to upgrade it to the latest schema version. If any errors occur during the DB schema installation, go to the logs directory and look at the logs found there.
You have the choice of using the basic installer or the advanced installer.
If your SMTP server is not on the same machine as the RHQ server, you need to use the advanced installer screen to set the SMTP server address. Otherwise email alerts will not work.
1. Basic Installation
  The Basic Installation simply reduces the number of settings you can modify during the installation process. All of the available settings can be modified at a later time by editing the <rhq-server-home>\bin\rhq-server.properties.
  For a typical installation, the default values can be used.

1. Advanced Installation
  To use the Advanced Installation, check the "Show Advanced Settings" checkbox.

Note that if you changed any startup property that requires a restart, you must restart the RHQ Server in order for the changes to take effect.

After you have clicked "Install RHQ Server" you will see the flashing green bar. The green blocks will bounce around until the install is finished. When this is done, a link will appear below the green blocks, replacing the "Starting up, please wait ..." message. Clicking this link will lead you to the RHQ login page. The login of the initial user is "rhqadmin" witht he same password "rhqadmin".

Some browsers - most notably Safari - will not lead you to the login page, but let you stay on this last page. If this happens to you, press the refresh button of your browser and click the link again afterwards.