How to Set up Hyperic HQ on Ubuntu 7.

Step-by-Step Guide

1. 1

   Step 1: Install Hyperic HQ.

   You are not allowed to install Hyperic HQ as root, and the installer does not auto-create the install drive.
   
   So you have to create it yourself and change the owner to your username: sudo mkdir /home/hyperic followed by sudo chown %yourusername%:%yourusername% /home/hyperic Note:
   The installdir can be any directory you want, however be sure that you are permitted to write to it. ,, 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://sourceforge.net/projects/hyperic-hq.,, If you don't know your server, choose your local machine: localhost, When asked for an installation path, to choose the default, hit enter.
   
   Note:
   HQ server and HQ agent will be installed isolated from each other in different subdirectories.,,,,, So if you want to cast a glance on it later you have to copy it to another directory.,, 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. ,, Generating a new one ...
   
   Done
   - Invoking agent
   - Starting agent process Agent successfully started , In this case, where the HQ server and the HQ agent are installed on the same machine, it's localhost:
   127.0.0.1, 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.
   
   Hit enter to choose default=no., If you haven't changed it, it is the default port 7080 (tcp).
   
   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., We use the default values for this setup.
   
   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., In this case it's localhost:
   127.0.0.1.
   
   Hit enter to choose the default., If you haven't changed it, it is the default port 2144 (tcp).
   
   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 incoming traffic.
   
   Otherwise you'll have to open it., It should look like this:
   - Received temporary authority 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 ,
2. 2

   Step 2: Run the installer: ./hyperic-hq-installer/setup.sh

3. 3

   Step 3: Select the software you wish to install.

4. 4

   Step 4: Hit enter to choose the default installation path for the HQ Server.

5. 5

   Step 5: Enter the name of the name or ip of the smtp-server that HQ will use to send email messages.

6. 6

   Step 6: Install the HQ Agent.

7. 7

   Step 7: Open a second terminal and login as root and wait to be prompted to execute a script.

8. 8

   Step 8: Execute the following script sudo /tmp/hyperic-hq-installer/installer-3.1.0/data/hqdb/tune-os.sh

9. 9

   Step 9: Close the second terminal when finished and return to the first terminal with paused installation.

10. 10

    Step 10: Hit enter to complete the installation process.

11. 11

    Step 11: Check that the install-log has been saved to /tmp/hyperic-hq-installer/installer-3.1.0/hq-install.log Note: Keep in mind that /tmp/ will be deleted if you shut down or reboot the system.

12. 12

    Step 12: Start The HQ Server with the following command /home/hyperic/server-3.1.0/bin/hq-server.sh start

13. 13

    Step 13: The initial startup should look like this: Starting HQ server... Initializing HQ server configuration...

14. 14

    Step 14: Login to HQ at: http://127.0.0.1:7080/ Note: The first start will take more time as usual.

15. 15

    Step 15: Start The HQ Agent with the following command / 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.

16. 16

    Step 16: Enter the IP address for the HQ server.

17. 17

    Step 17: Determine if you want encrypted communication between the HQ Agent and the HQ server using SSL.

18. 18

    Step 18: Review the HQ Server Port.

19. 19

    Step 19: Enter the proper username and password that the HQ agent will need to communicate with the HQ server.

20. 20

    Step 20: Enter the IP address that the HQ server has to use to communicate with the HQ agent.

21. 21

    Step 21: Enter the port that the HQ server has to use to communicate with the HQ agent.

22. 22

    Step 22: Confirm the agent registered itself with the host.

23. 23

    Step 23: Access the HQ Server with a browser of your choice at http://127.0.0.1:7080 on the host-system

24. 24

    Step 24: or using another computer

25. 25

    Step 25: at http://%hostip%:7080.

Detailed Guide

About the Author