About the Agent Launcher and Agent Startup

About this page...

This page describes the Hyperic Agent launcher and the agent startup process. For information about:

What Happens When an Agent Starts Up

A Hyperic Agent needs to know how to connect to the Hyperic Server, and the Hyperic Server needs to know how to connect to the Hyperic Agent — each component needs the IP address and listen port (and other connection properties) to use to establish a connection with the other. As described in About Agent Configuration you can define the connection properties interactively at first agent startup, or in the agent's agent.properties file.

When you start a Hyperic Agent:

  1. The agent checks to see if there is a /data directory that contains the Hyperic Server's connection properties.

    • At first startup, the /data directory will not exist — it is created after the first successful connection between agent and server is established.

    • If the agent finds the connection properties, it tries to connect to the Hyperic Server - see step 5 below.

  2. If the agent did not find the /data directory, it looks for an agent.properties file in a hidden directory named .hq in the home directory of the user that runs the agent.

    • This directory will not exist unless you have previously created it. This location for the properties file is supported to ensure configuration data is not lost in the event that the complete agent installation is overwritten in an upgrade.

    • If the agent finds the connection properties, it tries to connect to the Hyperic Server - see step 5 below.

  3. If the agent did not find the agent-server connection properties in an agent.properties file in the hidden /.hq directory, it looks at the agent.properties file in its /conf directory.

    • If the agent finds the connection properties, it tries to connect to the Hyperic Server - see step 5 below.

  4. If the agent did not find connection properties in the agent.properties file in its /conf directory, it prompts for the properties to be supplied interactively in the command shell.

  5. Upon obtaining the agent-server connection properties, the agent attempts to connect to the Hyperic Server.

  6. Once communications between agent and server have been succesfully established:

    • The agent saves the Hyperic Server connection settings in AgentHome/data.

    • The Hyperic Server saves the Hyperic Agent's connection settings in the Hyperic database.