Hyperic HQ on OpenSolaris and MySQL

Internetnews ran this article on how the open source system management space is heating up. It discusses Groundwork, Zenoss and Hyperic, three examples in a growing field of players that also includes Nagios and Ganglia. As these tools expand their capabilities from basic system monitoring into application management, they are increasing the pressure on well established vendors.

Hyperic, for example, has plugins for Glassfish and MySQL, among many others. I downloaded the Hyperic HQ Open Source Edition 4.0.1 (the no-JRE, platform independent tarball) and tried it on OpenSolaris.

Robert Lor has already documented how to install the Hyperic Server on PostgreSQL, so I decided to use it with MySQL instead. Pretty simple to set up. I used MySQL 5.0, via the SUNWmysql5 package from the OpenSolaris repository (if you want step-by-step instructions on how to get MySQL on OpenSolaris, see here).

The database configuration for Hyperic is well documented here. Once the database part is done, set JAVA_HOME to the location of your Java runtime (for example, to the default of /usr/java), and run setup.sh -mysql. If you only want to deploy the agent component, just download the corresponding tarball and run hq-agent.sh start. I have included the full output of these commands at the end of this blog entry.

As the agent was started, it detected the system information automatically, and updated the inventory at the server. Here's a screen shot of the web management console, on port 7080 by default:

I was able to drill down into charts for network and cpu utilization as well. Very nice. It's good to know that, if you use Hyperic, you can add OpenSolaris to your infrastructure and manage it the same way. Now, if we can only get it to report "OpenSolaris" instead of "Solaris 11". Time to file and RFE!

Here's the output of HQ Server installation. I only installed the Server in this step. The tarball (hyperic-hq-installer-4.0.1-905-noJRE.tgz) was uncompressed and untared in the /Apps/Hyperic directory.

hugo@hugo_osol:/Apps/Hyperic/hyperic-hq-installer$ ./setup.sh -mysql
Initializing Hyperic HQ 4.0.1 Installation...
Loading taskdefs...
Taskdefs loaded
Choose which software to install:
1: Hyperic HQ Server
2: Hyperic HQ Agent
You may enter multiple choices, separated by commas.
HQ server installation path [default '/home/hyperic']:
Enter the JDBC connection URL for the MySQL 5.x database [default 'jdbc:mysql://localhost:3306/HQ']:

Enter the username to use to connect to the database:
Enter the password to use to connect to the database:
Loading install configuration...
Install configuration loaded.
Preparing to install...
Validating server install configuration...
Checking server webapp port...
Checking server secure webapp port...
Checking server JRMP port...
Checking server JNP port...
Checking database permissions...
Verifying admin user properties
Validating server DB configuration...
Installing the server...
Unpacking server to: /Apps/Hyperic/server-4.0.1...
Creating server configuration files...
Copying binaries and libraries to server installation...
Copying server configuration file...
Copying server control file...
Copying server binaries...
Copying server libs...
Setting up server database...
Setting permissions on server binaries...
Fixing line endings on text files...
Installation Complete:
Server successfully installed to: /Apps/Hyperic/server-4.0.1

You can now start your HQ server by running this command:

/Apps/Hyperic/server-4.0.1/bin/hq-server.sh start

Note that the first time the HQ server starts up it may take several minutes
to initialize. Subsequent startups will be much faster.

Once the HQ server reports that it has successfully started, you can log in
to your HQ server at:

username: hqadmin
password: hqadmin

To change your password, log in to the HQ server, click the "Administration"
link, choose "List Users", then click on the "hqadmin" user.

Setup completed.
A copy of the output shown above has been saved to:

And here's the output of the Agent installation, from the hyperic-hq-agent-4.0.1-905-noJRE.tgz tarball. Also placed in the /Apps/Hyperic directory:

hugo@hugo_osol:/Apps/Hyperic/hyperic-hq-agent-4.0.1/bin$ ./hq-agent.sh start
-n Starting HQ Agent...
Removed stale pid file: /Apps/Hyperic/hyperic-hq-agent-4.0.1/wrapper/sbin/../../ wrapper/hq-agent.pid

[ Running agent setup ]
What is the HQ server IP address:
Should Agent communications to HQ always be secure [default=no]:
What is the HQ server port [default=7080]:
- Testing insecure connection ... Success
What is your HQ login [default=hqadmin]:
What is your HQ password:
What IP should HQ use to contact the agent [default=]:
What port should HQ use to contact the agent [default=2144]:
- Received temporary auth token from agent
- Registering agent with HQ
- HQ gave us the following agent token
- Informing agent of new HQ server
- Validating
- Successfully setup agent


Hyperic doesn't seem to support shared-IP zones very well. On my system with 6 zones I am only able to start Hyperic in one zone at a time. I am wondering if you tried a multiple zone-based installation and encountered this error as well ? Otherwise it's a really nice tool.

Posted by Jeroen on November 27, 2008 at 12:48 PM EST #

Post a Comment:
Comments are closed for this entry.

I am a member of Sun's ISV Engineering organization, collaborating with ISVs and Open Source communities to advance the Solaris platform.


« February 2016