Build Agent Installation Guide

Version 1 by Robin Shen
on Dec 24, 2009 09:11.


 
compared with
Current by Robin Shen
on Aug 18, 2010 02:09.


 
Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 1 changes. View first change.

 h3. Supported operating systems
  
 * Windows 2000/XP/Vista/7, 32 bit and 64 bit, x86 and IA 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
 * 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
  
 h3. Memory requirement
  
 * 64M minimum, 256M recommended
  
 h3. Installation Steps
  
 # 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.
 # Make sure you have JDK5 or JDK6 installed. For Sun JDK5, QuickBuild requires at least update 11. Download the appropriate JDK version from [http://java.sun.com] if needed.
 # 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.
 # Open a command prompt window, switch to folder _bin_ under the agent installation directory, and run command _agent.(bat|sh) console_ to start the agent. Please note:
 #* Make sure the user running the command has *full access rights* to the agent's installation directory.
 #* This command runs QuickBuild agent in console mode. Follow [this guide|Install As System Service] on how to install the agent as system service so that it auto-starts when machine reboots.
 #* By 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|sh)_.
  #* QuickBuild server will auto-detect IP address of the agent upon agent connection, and this is appropriate for most cases. In rare cases where auto-detected IP address does not work, you may configure the agent IP address to use by running _config.(sh|bat)_.
 #* You may optionally run _config.(sh|bat)_ to configure performance factor of the machine running the agent. The performance factor will be used by QuickBuild server to determine performance of the machine when distribute build loads.
 # 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.
 # 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:
 !active-nodes.png!