The agent configuration dialog appears in the shell when you launch a vCenter Hyperic agent that lacks the configuration values that specify the location of the vCenter Hyperic server. The dialog queries for the address and port of the vCenter Hyperic server, and other connection-related data.

The agent configuration dialog appears in these cases:

The first time you start an agent, if you have not supplied the properties in agent.profile.

When you start an agent for which saved server connection data is corrupt or has been removed.

When you run the agent launcher with the setup option, which causes the agent to prompt for new connection property settings.

You can also run the agent launcher to re-run the configuration dialog.

1

Open a terminal window on the platform on which the agent is installed.

2

Navigate to the AgentHome/bin directory.

3

Run the agent launcher using the start or setup option:

Platform

Command

UNIX-like

sh hq-agent.sh start

Windows

Install the Windows service for the agent, then start it:sh hq-agent.bat install sh hq-agent.bat start

4

Respond to the prompts, noting the following as you move through the process.

Prompt

Description

What is the HQ server IP address Enter the listen address of your Hyperic Server.

The server must be running. If the server is on the same machine as the agent, you can type localhost. If there is a firewall blocking traffic from the agent to the server, specify the address of the firewall.

Should Agent communications to HQ always be secure [default=yes].

Accept the default to configure vCenter Hyperic to use SSL for agent-to-server communication. It is good security practice to configure SSL, and is required if you configured unidirectional communications. To configure vCenter Hyperic to use plain HTTP for agent-to-server communication, type no.

What IP should HQ use to contact the agent [default=n.n.n.n]

The prompt shows the first IP address that the agent detects on the host. You can specify another IP address on the host. If a firewall is blocking traffic from the server to the agent, type the IP address of the firewall, and configure the firewall to forward traffic intended for the vCenter Hyperic agent to the listen address of the agent host.

What port should HQ use to contact the agent [default=2144]

Specify the agent port for the vCenter Hyperic server to use when it initiates contact with the agent. Specify the port that the agent binds to at startup, which by default is 2144. If you have previously edited agent.properties to define a different listen port, using the agent.listenPort property, specify that value. If there is a firewall blocking traffic from the server to the agent, configure the device to forward traffic on TCP port 2144 to the vCenter Hyperic agent.

The vCenter Hyperic agent initiates a connection to the vCenter Hyperic server and the server verifies that it can communicate with the agent.

The vCenter Hyperic agent discovers the platform and supported products running on it.