Agent Startup Properties

Added by Ekaterina Ivanova, last edited by Ekaterina Ivanova on Dec 03, 2008  (view change)
Search
Searching TeamCity 4.x Documentation
Table of Contents

In TeamCity a build agent contains two processes:

  • Agent Launcher — Java process that launch the agent process itself
  • Agent — main process for a Build Agent; runs as a child process for the agent launcher

Whether you run a build agent via the agent.bat|sh script or as a Windows service, at first the agent launcher starts and then it starts the agent.
For both processes you can customize the final agent behavior by specifying system properties and variables to run with.

Agent Launcher Properties

Build Agent Is Run Via Script

Before you run the <Agent Home>\bin\agent.bat|sh script, set the TEAMCITY_LAUNCHER_OPTS environment variable.

Build Agent Is Run As Service

In the <Agent Home>\launcher\conf\wrapper.conf file, add the following lines (one per option, the N number should increase): 

wrapper.java.additional.<N>

Please ensure to re-number all the lines after the inserted ones.

Agent Properties

Build Agent Is Run Via Script

Before you run the <Agent Home>\bin\agent.bat|sh script, set the following environment variables:

  • TEAMCITY_AGENT_MEM_OPTS — Set agent memory options (JVM options)
  • TEAMCITY_AGENT_OPTS — additional agent JVM options

Build Agent Is Run As Service

In the <Agent Home>\launcher\conf\wrapper.conf file, add the following lines (one per option): 

wrapper.app.parameter.<N>

  • You should add additional lines before the following line in the wrapper.conf file: 
    wrapper.app.parameter.N=jetbrains.buildServer.agent.AgentMain
  • Please ensure to re-number all the lines after the inserted ones.



See Also:

Labels