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
* 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
h3. Memory requirement
* 512M minimum, 1G 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.
{warning}
If install build agent on Unix platforms, please make sure the GNU compatible tar command is used to extract QuickBuild tar.gz file since it contains paths longer than 100 characters.
{warning}
# 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 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 other platforms, change to the _bin_ directory, and run the following command to start the agent:
{code}
./agent.sh console
{code}
{warning}
For Solaris platform: If quickbuild complains about missing the file _libm.so.2_, please just create the file _libm.so.2_ by doing _ln -s /usr/lib/libm.so.1 /usr/lib/libm.so.2_
{warning}
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:
{code}
./agent.sh start
{code}
The daemon process can be stopped by running the command:
{code}
./agent.sh stop
{code}
#* 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_.
# 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.
* Windows 2000/XP/Vista, 32 bit and 64 bit, x86 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
h3. Memory requirement
* 512M minimum, 1G 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.
{warning}
If install build agent on Unix platforms, please make sure the GNU compatible tar command is used to extract QuickBuild tar.gz file since it contains paths longer than 100 characters.
{warning}
# 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 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 other platforms, change to the _bin_ directory, and run the following command to start the agent:
{code}
./agent.sh console
{code}
{warning}
For Solaris platform: If quickbuild complains about missing the file _libm.so.2_, please just create the file _libm.so.2_ by doing _ln -s /usr/lib/libm.so.1 /usr/lib/libm.so.2_
{warning}
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:
{code}
./agent.sh start
{code}
The daemon process can be stopped by running the command:
{code}
./agent.sh stop
{code}
#* 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_.
# 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.