Build Agent Installation Guide

Added by Robin Shine, last edited by Robin Shine on Dec 30, 2008  (view change)
QuickBuild 2.0 Documentation

Supported operating systems

  • Windows 2000/XP/Vista 32 bit, x86 architecture
  • Linux 32 bit, x86 architecture
  • Mac OSX 32 bit
  • More operating systems will be supported in the formal 2.0 release

Memory requirement

  • 512M minimum, 1G 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 the build agent package to the machine where you want to install the build agent.
  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 other platforms, change to the bin directory, and run the following command to start the agent: 
    ./agent.sh console

    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.
    NOTE:

    • This will run QuickBuild agent in console mode. To stop the agent, just close the console window (on Windows platforms) or press Ctrl-C (on platforms other than Windows).
    • To install QuickBuild as NT service on Windows platforms, just run service-install.bat. After the script finishes, you will find a service named QuickBuild Build Agent in the service control panel. To uninstall the service, just run service_uninstall.bat.
    • To install QuickBuild as a daemon process on non-Windows platforms, just run command: 
      ./agent.sh start

      The daemon process can be stopped by running the command:

      ./agent.sh stop
    • 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 editing the file conf/node.properties.
  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.

Labels

 
(None)