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

About this task

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:




    sh start


    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.



    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 vRealize 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 vRealize 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 vRealize 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 vRealize 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 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 vRealize Hyperic agent.


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

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