Agent Details

Agent summary

Status

This field shows date and time that the agent was connected and enabled/disabled to the TeamCity Server. Use the link to toggle the authorized and enabled/disabled status of an agent.

Details

This field shows the agent's name, host name and IP address, port number, operating system, agent's Agents and current version number.

Running build

This field displays information about the running build. Use the build status link to view build results. See Build Results Home Page page description.

Misc.

• Clean sources: Click to enforce deleting old sources from the agent before checking out the sources for the next build to be preformed by this agent. See Clean Checkout.

• Open Remote Desktop:

  Click the link to open remote desktop on the current agent.

  note

  • This link is available for connected build agents running on the Windows operating system. For a disconnected agents with Windows OS, the link is available, if TeamCity already got information about agent's OS.

  • The RDP client should be installed and registered on the agent.

• Reboot Agent Machine:

  Click to send the reboot signal to the agent machine. This feature is enabled for users who have the specific "Reboot build agent machines" permissions.

  note

  To enable the feature, it is recommended to set teamcity.agent.reboot.command property in the buildagent.properties configuration file, thus provide proper reboot command (OS-specific) for the particular agent to ensure it will be rebooted correctly.

Compatible configurations

Current run configuration policy

Displays whether the build agent will run all compatible build configurations or only the build configurations selected from a list. Administrators can set this option using the drop-down list, while users will see the run configuration policy's status and a list of build configurations it will run.

Compatible configurations

This column shows the list of build configurations compatible with this build agent. Click a build configuration name to open Build Configuration Home Page. The number in parenthesis is the number of compatible configurations.

Incompatible configurations

This column shows the list of build configurations that are not compatible with the current build agent, and the reason of incompatibility. Click a build configuration name to open Build Configuration Home Page. The number in parenthesis is the number of incompatible configurations.

all/none hyperlinks

These links are available if the run selected configurations option is selected. For details, see Run Configuration Policy

Build runners

This tab displays information about the build runners that are supported by this agent.

System properties

Use this tab to view the list of properties that can be used for defining build configuration requirements. For more information on system properties and using them see: Properties of a Build Configuration.

Environment variables

Use this tab to view the following kinds of environment variables:

• defined in the configuration file of the agent

• defined by the operating system and agent runtime Refer to the Properties of a Build Configuration page for more information on environmental variables and using them.

Agent summary

Status

This field shows the date and time that the agent was disconnected and enabled/disabled. Use the link to toggle the enabled/disabled status of an agent.

Remove agent

Click the button to remove disconnected agent manually.

tip

By default, a disconnected agent is removed automatically in 2 weeks after disconnection.

Details

This field shows the agent's name, host name and IP address, port number and operating system.

Clean sources

Click the button to enforce deleting sources from the agent before checking out sources for the next projects built on this agent. See Clean Checkout.