User Agent Installation Guide

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

Memory requirement

  • 16M minimum, 64M recommended

Installation Steps

  1. Make sure QuickBuild server is up and running, login to QuickBuild using your own account (the account who wants to run user agent on his/her desktop), and navigate to My tab, click the the link download user agent to download user agent of desired platform. Please note that this link will not be available if the account do not have permission to run user agent. Extract downloaded file into the directory where the user agent should be installed.
  2. Make sure you have JDK5 or JDK6 installed. For Sun JDK5, QuickBuild requires at least update 11. Download the appropriate JDK version from 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 to path of the java command.
  4. 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 the user agent in console mode. Follow this guide on how to install the agent as system service so that it auto-starts when machine reboots.
    • By default, the user agent will run on port 8821. If this port is used by other process, you can change the port number to an unused port by running 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.
  5. If user agent starts and connects to server correctly, you will see My Agent tab is displaying information of the user agent by logging to QuickBuild using your account:


Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.