Build Agent Installation Guide

You are viewing an old version (v. 27) of this page.
The latest version is v. 36, last edited on Dec 24, 2009 (view differences | )
<< View previous version | view page history | view next version >>

Supported operating systems

  • Windows 2000/XP/Vista, 32 bit and 64 bit, x86 architecture
  • Linux, 32 bit and 64 bit, x86 architecture and PowerPC architecture
  • Mac OS X, 32 bit and 64 bit
  • Solaris, 32 bit and 64 bit, Sparc and X86 architecture
  • FreeBSD, 32 bit and 64 bit, x86 architecture
  • AIX, 32 bit and 64 bit, PowerPC architecture
  • HP-UX, 32 bit and 64 bit, IA and PARISC 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, click the the link download build agent to download build agent of desired platform. Extract downloaded file into the directory where the build agent should be installed.
  2. Make sure you have Sun JDK5 or JDK6 installed. For JDK5, QuickBuild requires at least JDK5 update 11. 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. For Windows platform, run bin/agent.bat to start the agent; for Unix platforms, run command bin/agent.sh console to start the agent.
    • During the start up, the agent will contact the server. If the server is down, the agent will wait until the server is up and running, and then it continue its start up process.
    • Be default, the build agent will run on port 8811. If this port is used by other process, you can change the port number to an unused port by running the command config.bat (for Windows) or config.sh (for Unix).
    • This command runs QuickBuild agent in console mode. Follow this guide on how to install the agent as system service so that it auto-starts when machine reboots.
  5. 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 [Configuring Build Grid] for how to authorize build agents to join grid.
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.