Build Agent Installation Guide

Supported operating systems

• Windows 2000/XP/Vista/7, Windows server 2003/2008, 32 bit and 64 bit, x86 and IA architecture
• Linux, 32 bit and 64 bit, x86, PowerPC and S/390 architecture
• Mac OS X, 32 bit and 64 bit
• Solaris, 32 bit and 64 bit, Sparc and x86 architecture
• AIX, 32 bit and 64 bit, PowerPC architecture
• HP-UX, 32 bit and 64 bit, IA and PARISC architecture
• FreeBSD, 32 bit and 64 bit, x86 architecture

Memory requirement

• 64M minimum, 256M recommended

Installation Steps

1. Make sure QuickBuild server is up and running, login to QuickBuild as administrator and navigate to Grid tab, follow the download build agent link to download the build agent. Extract downloaded file into the directory where the build agent should be installed. Make sure the user running user agent has full access rights to the installation directory.
2. Make sure you have JDK5 or JDK6 installed. For Sun JDK5, QuickBuild requires at least update 19. Download the appropriate JDK version from http://java.sun.com if needed.
3. Make sure the java command exists in the system path; if not, you will need to modify the file conf/wrapper.conf under the build agent's installation directory, and point the entry wrapper.java.command to path of the java command.
4. Run <agent install dir>/bin/config.(bat|sh) to configure build agent properties such as service name, IP address, port number, SSL setting, etc.
5. Open a command prompt window, switch to folder <agent install dir>/bin, and run command agent.(bat|sh) console to start the agent.
6. After the agent starts up, it may complain with the message "This build agent is not authorized to join the grid". Upon this, you need to login to QuickBuild server and authorize the agent to join the grid. Refer to Working with Build Grid for how to authorize build agents to join grid.
7. If the build agent is connected to QuickBuild server correctly, you will see its entry in active node list of the build grid like below by logging in as administrator:
   

Follow this guide on how to install the agent as system service so that it auto-starts when machine reboots. You may need to install multiple build agents on the same machine if the machine is power, since each agent can only run one build. In case multiple agents are installed on the same machine, it is important to run <agent install dir>/bin/config.(bat|sh) to configure different service name and port for these agents.