5.0

38 vFabric Platform
38 Installing vFabric Platform
Post-Installation Instructions for Hyperic Agent
The yum installation of Hyperic Agent configured your RHEL VM so that Hyperic Agent starts automatically when the VM is
booted; in particular, it created a /etc/init.d/hyperic-hqee-agent init script.
Before you can start the Hyperic Agent, however, you must configure it so it can find the Hyperic Server to which you want it to
connect. The following procedure describes how to do this, and then how to start the Agent manually. Subsequently, the Agent
will start automatically each time you boot up the VM.
Procedure
1. If you have not already done so, install a JDK or JRE (version 1.5 or 1.6) onto the RHEL VM on which you installed
Hyperic Agent.
2. As the root user, log in to the RHEL VM on which you installed Hyperic Agent and edit the /etc/init.d/hyperic-
hqee-agent file, setting the HQ_JAVA_HOME to home directory of the JDK or JRE you want the agent to use.
3. Edit the /opt/hyperic/hyperic-hqee-agent/conf/agent.properties file to specify how the Hyperic
agent communicates with the server.
Important: Although there are many properties you can set in this file, this procedure describes only the minimum required
for the agent to communicate with your Hyperic Server.
Uncomment the properties that begin with agent.setup, such as agent.setup.camIP, then set the values of each
property as follows:
• agent.setup.camIP: The address or hostname of the Hyperic Server.
• agent.setup.camPort: The default value is the standard Hyperic listen port.
• agent.setup.camSSLPort: The default value is the standard SSL Hyperic listen port.
• agent.setup.camSecure: Whether you require that the agent use secure communications when contacting Hyperic
Server. The default value is "yes" (use SSL).
• agent.setup.camLogin: The username the agent should use when connecting to the server. If you change the value
from the default value ("hqadmin"), make sure that the user account is properly configured on the Hyperic Server.
• agent.setup.camPword: The password the agent should use, along with the username above, when connecting to
the server. Make sure that the password is the one configured in Hyperic for the user account.
• agent.setup.agentIP: The IP address or hostname that the Hyperic Server uses to contact the Agent. If you leave
the default setting (*default*), the Hyperic Agent will detect an IP address on the platform and choose it as its listen
address.
• agent.setup.agentPort: The listen port that the Hyperic uses when it contacts the agent. If you leave the default
setting (*default*), the Hyperic Agent will use the default listen port (either 7080 or 7443) as its listen address. If that
port is unavailable, the agent will detect a free port and choose it as its listen port.
• agent.setup.resetupTokens: Specifies whether the agent, at first startup after installation, will create a new
token to use to authenticate with the server each time it starts up. Regenerating a token is useful if the Agent cannot
connect to the server because the token has been deleted or corrupted.
• agent.setup.acceptUnverifiedCertificate: Controls whether or not a Hyperic Agent (version 4.6 or later)
issues a warning when the Hyperic Server presents an SSL certificate that is not in the agent's keystore and is either self-
signed or signed by a different CA than the one that signed the agent's SSL certificate.
For example:
agent.setup.camIP=10.111.222.333