4 Start The HQ Server

First you have to start the HQ server:

/home/hyperic/server-3.1.0/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 Start The HQ Agent

After the HQ server booted you have to start the agent:

/home/hyperic/agent-3.1.0/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

6 Configure The HQ Agent

The HQ agent needs some information for the cooperation with the HQ server. You will be asked for it straight after the HQ agent started for the first time.

6.1 HQ Server IP Address

You will be asked to enter the ip adress for the HQ server. In this case, where the HQ server and the HQ agent are installed on the same machine, it's localhost:

127.0.0.1

6.2 SSL Communication

You will be asked if you want encrypted communication between the HQ Agent and the HQ server. In this case it's not needed, but remember to enable the SSL communication if you set up an HQ agent that will communicate to the HQ server across the internet.

So hit enter to choose default=no.

6.3 HQ Server Port

You will be asked for the port that the HQ agent has to use to communicate with the HQ server. If you haven't changed it, it is the default port 7080 (tcp).

So hit enter to choose default=7080.

Be sure, that the firewall on the HQ server host, or a special device that is connected to the host, is not blocking port 7080 (tcp) or 7443 (tcp). Otherwise you'll have to open them.

6.4 Access Data

You will be asked to enter the proper username and password that the HQ agent will need to communicate with the HQ server. We use the default values for this setup.

So hit enter to choose the default username (hqadmin) and next enter the default password:

hqadmin

Be sure that you change these settings if you use this system in a production environment and have HQ agents communicating across the internet.

6.5 HQ Agent IP Address

You will be asked to enter the ip address that the HQ server has to use to communicate with the HQ agent. In this case it's localhost:

127.0.0.1

So hit enter to choose the default.

6.6 HQ Agent Port

You will be asked for the port that the HQ server has to use to communicate with the HQ agent. If you haven't changed it, it is the default port 2144 (tcp).

So hit enter to choose default=2144.

Be sure, that the firewall on the HQ agent host, or a special device that is connected to the host, is not blocking port 2144 (tcp) for incomming traffic. Otherwise you'll have to open it.

6.7 Configuration Completion

Now, after you entered all needed information, the HQ agent will register itself at the host.

It should look like this:

- Received temporary auth token from agent
- Registering agent with HQ
- HQ gave us the following agent token 1187275261550-13485140805726178-3666098505737167114
- Informing agent of new HQ server
- Validating
- Successfully setup agent