Windows Services

This section will list important information w.r.t Windows Service installation on AnthillPro. All documentation within this wiki was taken directly from the 3.8 documentation.

Server Installation

For newer versions of Windows, you will need to execute an Administrator Command Prompt to install as a Windows Service. This can be done by right clicking cmd.exe and selecting "Run As Administrator."

Perform the normal install as outlined in documentation
  • Install as Windows service (optional)
  • Type Y to install as Windows service.
  • Enter the unique service name and hit ENTER. (Default is ah3server)
  • Enter the user account for the service and hit ENTER. (Default is LOCALSYSTEM)
  • Note that when installing as a service, AnthillPro only captures the value for the PATH variable. The values captured at installation will always be used, even if you later make changes.

Manual Service Installation

For newer versions of Windows, you will need to execute an Administrator Command Prompt to install as a Windows Service. This can be done by right clicking cmd.exe and selecting "Run As Administrator."

  • Run ah3server.cmd install uniqueservicename (located in the %SERVER_HOME%\bin\service directory).
  • Provide the service name and account information.

Agent Installation

For newer versions of Windows, you will need to execute an Administrator Command Prompt to install as a Windows Service. This can be done by right clicking cmd.exe and selecting "Run As Administrator."

Perform the normal install as outlined in documentation
  • Install as Windows service (optional)
  • Type Y to install as Windows service.
  • Enter the unique service name and hit ENTER. (Default is ah3server)
  • Enter the user account for the service and hit ENTER. (Default is LOCALSYSTEM)
  • Note that when installing as a service, AnthillPro only captures the value for the PATH variable. The values captured at installation will always be used, even if you later make changes.

Manual Service Installation

For newer versions of Windows, you will need to execute an Administrator Command Prompt to install as a Windows Service. This can be done by right clicking cmd.exe and selecting "Run As Administrator."

  • Run ah3agent.cmd install uniqueservicename (located in the %AGENT_HOME%\bin\service directory).
  • Provide the service name and account information.

Issues Warranting a Service Re-installation

There are some issues that will change over time during the use of anthillpro, such as adding new programs to the machine to make it more diverse in what the agent can do. If such a thing should happen, you will need to uninstall & reinstall the windows service for the new changes to be picked up. This can include such things as:

  • PATH variable change on the agent
  • Performance Tuning of the agent (such as memory modification or change in the JAVA_HOME, etc.)
  • Environment Variable change on the agent.



We do NOT recommend directly modifying the registry if any changes need made, and instead rely on our installation & removal scripts for modifying Windows Services. This is because we will generate certain keys during the installation of the service. The keys lie at the hive:

64-bit:  HKEY_LOCAL_MACHINE\SOFTWARE\Urbancode\Anthill3\%AGENT_SERVICE_NAME%

Sample Pictures

The images below show all the keys wrote into the registry during the installation of the Windows Service.

Parameters Key

HKEY_LOCAL_MACHINE\SOFTWARE\Urbancode\Anthill3\%AGENT_SERVICE_NAME%\Parameters

ws parameters.gif


Java Key

HKEY_LOCAL_MACHINE\SOFTWARE\Urbancode\Anthill3\%AGENT_SERVICE_NAME%\Parameters\Java

ws java.gif


Start Key

HKEY_LOCAL_MACHINE\SOFTWARE\Urbancode\Anthill3\%AGENT_SERVICE_NAME%\Parameters\Start

ws start.gif


Stop Key

HKEY_LOCAL_MACHINE\SOFTWARE\Urbancode\Anthill3\%AGENT_SERVICE_NAME%\Parameters\Stop

ws stop.gif


Log Key

HKEY_LOCAL_MACHINE\SOFTWARE\Urbancode\Anthill3\%AGENT_SERVICE_NAME%\Parameters\Log

ws log.gif