Starting and Stopping the Hyperic Server and Agents

This section describes how to control the Hyperic Server and Agents, specifically starting and stopping them.

On Unix platforms, you always use shell scripts to start and stop the Hyperic Server and Hyperic Agent. On Windows, it is recommended that you first install both the server and agents as Windows Services, and subsequently use the Windows Services console to start and stop them. Using the Windows Services console, you can also specify whether the Hyperic Server and Agent should start automatically when the operating system itself starts. The section below describes how to install the server and agents as Windows services.

Depending on how you have configured all the components of tc Server (tc Runtime, Hyperic Server and Hyperic Agents), you might run the commands to start and stop the Hyperic Agent and Server on the same computer or on different computers.

Note

This section provides basic information about starting and stopping the Hyperic Server and Agent, just enough to get you up and running. For additional detailed information, see "Configure and Run the Hyperic Server" and "Configure and Run the Hyperic Agent" in vFabric Hyperic Installation and Configuration.

Unix: Starting and Stopping the Hyperic Server and Agent

To start and stop the Hyperic Server:

  1. Login to the computer on which you installed Hyperic Server as the appropriate user, such as hyperic. On Unix, if you have disabled interactive login, login as the root user and use su - hyperic to become the user.

  2. Open a new terminal window.

  3. Change to the HQ_SERVER_INSTALL_DIR/bin directory, where HQ_SERVER_INSTALL_DIR refers to the directory in which you installed the Hyperic Server, such as /opt/vmware/hyperic/server-4.6.X.X-EE. For example:

    prompt$ cd /opt/vmware/hyperic/server-4.6.X.X-EE/bin
  4. To start the Hyperic Server:

    prompt$ ./hq-server.sh start

    The script displays Starting HQ Server... and then the shell/Command Prompt on success.

  5. To stop the Hyperic Server:

    prompt$ ./hq-server.sh stop

    The server is fully stopped when you see the message Stopped HQ Server.

See the HQ_SERVER_INSTALL_DIR/logs/server.log for details about the starting or stopping of the Hyperic Server.

To start and stop the Hyperic Agent:

  1. Login to the computer on which you installed Hyperic Agent as the appropriate user, such as hyperic. On Unix, if you have disabled interactive login, login as the root user and use su - hyperic to become the user.

  2. Start a new terminal window.

  3. Change to the HQ_AGENT_INSTALL_DIR/bin directory, where HQ_AGENT_INSTALL_DIR refers to the directory in which you installed the Hyperic Agent, such as /opt/vmware/hyperic/agent-4.6.X.X-EE. For example:

    prompt$ cd /opt/vmware/hyperic/agent-4.6.X.X-EE/bin
  4. To start the Hyperic Agent, execute the following command:

    prompt$ ./hq-agent.sh start

    The script displays Starting HQ Agent... and then the shell/Command Prompt on success.

    Important

    The first time you start the agent, the script requests information about the Hyperic Server to which it will communicate; this is a one-time event and subsequent starts of the agent do not require this input. For more information about these prompts, see the table in "Configure Agent - Server Communication Interactively" under "Configure and Run the Hyperic Agent" in vFabric Hyperic Installation Guide.

  5. To stop the Hyperic Agent, execute the following command:

    prompt$ ./hq-agent.sh stop

    The agent is fully stopped when you see the message Stopped HQ Agent.

See the HQ_AGENT_INSTALL_DIR/log/agent.log for details about the starting or stopping of the Hyperic Agent.

Windows: Starting and Stopping the Hyperic Server and Agent

To start and stop the Hyperic Server:

  1. If you have not already done so, install the Hyperic Server as a Windows Service, as described in Installing the Hyperic Server and Agents as Windows Services.

  2. Start (and stop) the Hyperic Server using the Windows Service control panel. The Hyperic Server is listed as Hyperic HQ Server.

See the HQ_SERVER_INSTALL_DIR\logs\server.log for details about the starting or stopping of the Hyperic Server.

To start and stop the Hyperic Agent:

  1. If you have not already done so, install the Hyperic Agent as a Windows Service, as described in Installing the Hyperic Server and Agents as Windows Services.

  2. If this is the first time you start the Hyperic Agent after installing it, start a Command Prompt window and continue with this procedure.

    Otherwise, use the Windows Service console to start (and stop) the Hyperic Agent. The Hyperic Agent is listed as the Hyperic HQ Agent.

  3. If you have not already done so, set the HQ_JAVA_HOME system environment variable to point to the location of your JDK or JRE. Note that you are required to set it as a system environment variable; if you set it as a user environment variable, the Hyperic Agent will abort on startup.

  4. Change to the HQ_AGENT_INSTALL_DIR\bin directory, where HQ_AGENT_INSTALL_DIR refers to the directory in which you installed the Hyperic Agent, for example \opt\vmware\hyperic\agent-4.6.X.X-EE. For example:

    prompt> cd \opt\vmware\hyperic\agent-4.6.X.X-EE\bin 
  5. The first time you start the Hyperic Agent, you must start it from the command line:

    prompt> hq-agent.bat start 

    The command requests information about the Hyperic Server to which it will communicate; this is a one-time event and subsequent starts of the Hyperic Agent do not require this input. For more information about these prompts, see the table in "Configure Agent - Server Communication Interactively" under "Configure and Run the Hyperic Agent" in vFabric Hyperic Installation Guide.

  6. Subsequently, start (and stop) the Hyperic Agent using the Windows Service console. The Hyperic Agent is listed as the Hyperic HQ Agent.

See the HQ_AGENT_INSTALL_DIR\log\agent.log for details about the starting or stopping of the Hyperic Agent.