User Agent Installation Guide

Version 1 by Robin Shen
on Jun 27, 2009 03:38.

 
compared with
Current by Robin Shen
on Dec 24, 2009 08:58.

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

View page history


There are 5 changes. View first change.

 h3. 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
  * Windows 2000/XP/Vista/7, 32 bit and 64 bit, x86 and IA architecture
 * Linux, 32 bit and 64 bit, x86 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
  * 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 account and navigate to _My_ tab, click the the link _download user agent_ to download user agent of desired platform. Extract downloaded file into the directory where the user agent should be installed.
 # 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.
  # 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.
 # 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 8821. If this port is used by other process, you can change the port number to an unused port by running command _config.bat_ (for Windows), or _config.sh_ (for Unix).
 #* 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.
 # If you changed your user name/password at QuickBuild server, you will need to specify the correct credentials for the user agent by running _config.bat_ (for Windows), or _config.sh_ (for Unix).
  # For Windows platform, run _bin/agent.bat_ to start the agent; for Unix platforms, run command _bin/agent.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_ (for Windows), or _config.sh_ (for Unix).
 # 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!