Configure JREs for Hyperic Components

About this page...

This page has information about how to configure Hyperic components to use a particular JRE.

It is not generally necessary to configure the location of the JREs used by the Hyperic Server or Hyperic Agents. For more information, see About Hyperic JREs below.

If you do need to configure the location of the JRE for a Hyperic component, define the environment or system variable, as described below, and restart the system before starting the Hyperic component.

About Hyperic JREs

Both Hyperic Server and Hyperic Agents require a JRE. Some Hyperic installers include a JRE; they are called platform-specific. Installers without a JRE are called platform-independent. Depending on your environment and the installation package you use, you may need to define the location of the JRE for the server or your agents.

  • You do not need to configure the location of the JRE when you do a platform-specific server install on a machine with no JRE.

  • You do need to configure the location of the JRE when you:

    • Install the Hyperic Server (or the Hyperic Agent) with a platform-independent installer,

    • Install the Hyperic Server (or the Hyperic Agent) with a platform-specific installer on a machine that has its own JRE that you prefer to use.

    • Install a Hyperic Agent from an RPM. Agent RPMs do not include a JRE.

How Hyperic Server Resolves its JRE on any Platform

On both Unix-Like and Windows platforms, Hyperic Server resolves the JRE to use in this order:

  1. HQ_JAVA_HOME environment variable

  2. embedded JRE

  3. JAVA_HOME environment variable

The Hyperic Agent has resolves its JRE differently than the Hyperic Server does, and differently depending on platform type. For more information, see the appropriate section:

Hyperic Agent JRE on Unix

The Hyperic Agent installer, like the server installer, is available with or without a JRE. If you do a platform-specific agent install on a machine without an existing JRE, you do not need to explicitly configure the location of the JRE to use.

You should configure the JRE location with the HQ_JAVA_HOME environment variable if you do a platform-independent agent install, or a platform-specific install on a Unix machine that already has a JRE that you prefer to use.

How a Hyperic Agent Resolves its JRE on Unix

On Unix-like platforms, Hyperic Agent resolves the JRE to use in this order:

  1. HQ_JAVA_HOME environment variable

  2. Embedded JRE

  3. JAVA_HOME

Hyperic Agent JRE on Windows

The Hyperic Agent installer, like the server installer, is available with or without a JRE.

You should configure the JRE location with the HQ_JAVA_HOME system variable if you do a platform-independent agent install on Windows, or a platform-specific install on a Windows machine that already has a JRE that you prefer to use.

How a Hyperic Agent Resolves its JRE on Windows

On Windows platforms, Hyperic Agent resolves the JRE to use in this order:

  1. HQ_JAVA_HOME system variable (not an environment variable)

  2. Embedded JRE

To define a system variable, use:

My Computer > Properties > Advanced > Environment Variables > System variables > New