Agents > click agent name
The contents of this page depend on whether the agent is connected or disconnected from the server.
Connected Agent
| Option |
Description |
| 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 CPU rank 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.
 |
- 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.
| 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 its 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 its 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.
|
Disconnected Agent
| Option |
Description |
| 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.
 | 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. |
See Also: