Windows: Installing the Hyperic Server and Agents as Windows Services

VMware recommends that you install both the Hyperic Server and all Hyperic Agents as Windows Services, and then start and stop them from the Service console. This section describes how to install both components. See Starting and Stopping the Hyperic Server and Agents for details about starting and stopping the Hyperic Server and Agents, particularly when starting the Hyperic Agent for the first time.

To install the Hyperic Server as a Windows Service:

  1. Login to the computer on which you installed Hyperic as the appropriate user, such as hyperic.

  2. Open a Command Prompt 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\bin:

    prompt> cd \opt\vmware\hyperic\server-4.6.X.X-EE\bin
  4. To install the Hyperic Server as a Windows Service:

    prompt> hq-server.exe -i 

    After a few status messages, you will see a Done. message when installation is complete.

    The command installs the Hyperic Server as an automatic Windows Service, which means that the server starts automatically when you start the Windows computer. You can change this behavior through the Windows Service control panel.

    Now, and subsequently, start (and stop) the Hyperic Server using the Windows Service control panel. The Hyperic Server is listed as Hyperic HQ Server.

  5. To uninstall the Windows service:

    prompt> hq-server.exe -u

    You will see a Removing 'Hyperic HQ Server' Service ... Done upon completion.

To install the Hyperic Agent as a Windows Service:

  1. Login to the computer on which you installed Hyperic as the appropriate user, such as hyperic.

  2. Start a Command Prompt window.

  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. Set it as a system environment variable; if you set it as a user environment variable, the Hyperic Agent aborts 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, such as \opt\vmware\hyperic\hyperic\agent-4.6.X.X-EE\bin:

    prompt> cd \opt\vmware\hyperic\agent-4.6.X.X-EE\bin
  5. To install the Hyperic Agent as a Windows service:

    prompt> hq-agent.bat install

    You see a Hyperic HQ Agent installed. message upon completion.

    The preceding command installs the Hyperic Agent as an automatic Windows Service, which means that the agent starts automatically when you start the Windows computer. You can change this behavior using the Windows Service control panel.

    If you are starting the Hyperic Agent for the first time, see the procedure for starting the Hyperic Agents for further instructions. Subsequently, start (and stop) the Hyperic Agent using the Windows Service control panel. The Hyperic Server is listed as Hyperic HQ Server.

  6. To remove (uninstall) the Windows service:

    prompt> hq-agent.bat remove

    You will see a Hyperic HQ Agent removed. message upon completion.