Personal tools
You are here: Home Software Development Continuous Integration TeamCity Howto Install a TeamCity v6.5.1 Windows Build Agent

Howto Install a TeamCity v6.5.1 Windows Build Agent

This how-to describes installing a TeamCity Build Agent on a Windows 2008 R2 server appliance. The following pre-requisites and assumptions are made:

  • the machine is running Windows 2008 R2
  • IPv4/IPv6 is configured
  • the team city server is installed and operational

 

Download the Windows MSI

The Windows build agent installation MSI can be downloaded from the TeamCity server. Click on the link 'MS Windows Installer':

 

 TeamCity v6.5.1 Windows Build Agent 2011-06-20_102708 Web Browser.png

Save the file to disk:

TeamCity v6.5.1 Windows Build Agent 2011-06-20_103702 Save MSI.png

Run the executable:

TeamCity v6.5.1 Windows Build Agent 2011-06-20_104143 Run MSI.png

Create a service account

The build agent will be configured to run as a specific user account. This account needs to be created manually. Given some of the Windows build steps, adding this account to the Administrators group is a pragmatic thing to do.

TeamCity v6.5.1 Windows Build Agent 2011-06-20_104944 New User.png

Installation

 

TeamCity v6.5.1 Windows Build Agent 2011-06-20_104153 Welcome.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_104159 License Agreement.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_104205 Choose Components.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_104211 Choose Install Location.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_104226 Installing Details.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_104722 Properties.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_104726 Properties Saved.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_104739 Select Service Account.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_105008 Enter Service Account.png
TeamCity v6.5.1 Windows Build Agent 2011-06-20_105114 Completed.png

Authorise the Agent

The build agent should be communicating with the TeamCity build server and appearing in the unauthorised agents list. Click on the 'Unauthorized' link:

TeamCity v6.5.1 Build Agent - Disconnected.png
Enter a reason for authorising the agent
TeamCity v6.5.1 Build Agent - Authorise Agent.png
Verify the agent is authorised and connected by  viewing it in the 'Connected' tab:
TeamCity v6.5.1 Build Agent - Connected.png

Windows Firewall

TODO: Describe rules (outgoing 8111, and incoming 9090)

Links

Document Actions