User Agent Installation Guide

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

compared with

Current by Robin Shen
on Aug 18, 2010 02:10.

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

		* 16M minimum, 64M recommended

		h3. Installation Steps

		# 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\|Other Permissions#allow user agent]. Extract downloaded file into the directory where the user 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 the user 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 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.
		# 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:
		!useragent-up-running.png!