3 Installation

Now, after we've prepared the system, it's time to start the installation.

3.1 Start

First switch to the temporary folder.

cd /tmp/

You have the choice between a standard setup with default settings...

./hyperic-hq-installer/setup.sh

...standard setups with usage of another database (PostgreSQL, Oracle or MySQL v4.x) than the built-in PostgreSQL database...

./hyperic-hq-installer/setup.sh -postgresql

./hyperic-hq-installer/setup.sh -oracle

./hyperic-hq-installer/setup.sh -mysql

(Note: If you want to set up Hyperic HQ with usage of another database have a look at http://support.hyperic.com/confluence/display/DOCSHQ30/Database+Preparation first! Support for MySQL v5.x is beta at the moment and will probably be fully supported in Hyperic HQ v3.2.x.)

...and a custom installation where you can adjust all and everything - that I chose for this setup (with default settings) to show you all available options.

./hyperic-hq-installer/setup.sh -full

3.2 Software Selection

You'll be asked which software you want to install - select server and agent.

1,3

Note: If you have a running HQ server and want to monitor other machines, you only need to install the HQ agent on them. It is available for all kinds of operating systems. Have a look at http://www.hyperic.com/downloads/dl-hq-oss.html#installer.

3.3 HQ Server Installdir

Next step we choose the default installation path for the HQ server (/home/hyperic/) - simply hit enter.

3.4 HQ Server / Webinterface HTTP Port

You'll be asked what port shall be used to access the webinterface (HTTP) - this port will also be used to communicate with the HQ agents. I chose the default port 7080 (simply hit enter).

Note: Have a look at step 2.5 if you haven't adjusted your firewall-settings yet.

3.5 HQ Server / Webinterface HTTPS Port

You'll be asked what port shall be used to access the webinterface (HTTPS) - this port will also be used to communicate with the HQ agents (encrypted). I chose the default port 7443 (simply hit enter).

Note: Have a look at step 2.5 if you haven't adjusted your firewall settings yet.

3.6 JNP Service

You'll be asked what port shall be used for the JNP service. I chose the default port 2099 (simply hit enter).

3.7 MBean Server

You'll be asked what port shall be used for the MBean server. I chose the default port 9093 (simply hit enter).

3.8 Webinterface Base URL

You'll be asked which URL shall be used to access the webinterface. I chose the default http://server1.example.com:7080/ (simply hit enter).

3.9 Email Address

You'll be asked for the email address that HQ will use as the sender. I chose the default hqadmin@example.com (simply hit enter).

3.10 Database

At this point you have to choose the backend database that the HQ server shall use. If you want to use another database than the built-in it's highly recommended that you read http://support.hyperic.com/confluence/display/DOCSHQ30/Database+Preparation first! I chose the default - the built-in PostgreSQL database (1).

3.11 Database Port

You'll be asked what port shall be used for the database. I chose the default port 9432 (simply hit enter).

3.12 Admin User Username

Choose a username for the admin user. I chose the default hqadmin (simply hit enter).

3.13 Admin User Password

Choose a password for the admin user - I chose hqadmin.

Keep in mind that you should choose a secure password in a production environment.

3.14 Admin User Email Address

You'll be asked to enter an email address for the admin user. I chose the default hqadmin@example.com (simply hit enter).

3.15 HQ Agent Installdir

Now we choose the default installation path for the HQ agent (/home/hyperic/) - simply hit enter.

Note: HQ server and HQ agent will be installed isolated from each other in one's subdirectories.

3.16 During The Installation

Now the HQ server and HQ agent are being installed with the settings you chose in the steps before. At a point the installation will be paused, and you are asked to open a second terminal, log in as root and execute a special script. So open a second terminal and enter:

su -
%rootpassword%
/tmp/hyperic-hq-installer/installer-3.1.4/data/hqdb/tune-os.sh

After that close the second terminal, return to the first terminal with the paused installation and hit enter to continue the installation process. After the installation finished, the install log has been saved to /tmp/hyperic-hq-installer/installer-3.1.4/hq-install.log.

4 HQ server Initial Start-Up

First you have to start the HQ server.

/home/hyperic/server-3.1.4/bin/hq-server.sh start

The initial startup should look like this:

Starting HQ server...
Initializing HQ server configuration...
Checking jboss jndi port...
Checking jboss mbean port...
Starting HQ built-in database...
HQ built-in database started.
Booting the HQ server...
HQ server booted.
Login to HQ at: http://127.0.0.1:7080/

Note: The first start will take more time as usual.

5 HQ Agent Initial Start-Up

After the HQ server has booted you have to start the agent.

/home/hyperic/agent-3.1.4/hq-agent.sh start

The initial startup should look like this:

Starting agent
- Unable to load agent token file. Generating a new one ... Done
- Invoking agent
- Starting agent process
Agent successfully started