Agent Installation Guide

You are viewing an old version (v. 3) of this page.
The latest version is v. 36, last edited on Dec 24, 2009 (view differences | )
<< View previous version | view page history | view next version >>

Supported operating systems

  • Windows 2000/XP/Vista 32 bit, x86 architecture
  • Linux 32 bit, x86 architecture
  • Mac OSX 32 bit
  • More operating systems will be supported in the formal 2.0 release

Memory requirement

  • 512M minimum, 1G recommended

Installation Steps

  1. Make sure you have JDK 1.5 installed. Go to http://java.sun.com/ for JDK 1.5 download, if you didn't install it yet.
  2. Make sure the environment variable JAVA_HOME is defined for the user running QuickBuild server, and takes value of the JDK home directory (the directory containing bin, lib,...).
  3. Download QuickBuild2 distribution from http://quickbuild.pmease.com, select the latest build for project PMEase.QuickBuild2 and download proper distribution for your operation system.
  4. Edit file conf/node.properties and specify server node address for property server.
  5. Unzip the downloaded file into the selected installation directory.
  6. For windows platform, run bin/quickbuild.bat to start the agent; for other platforms, change to the bin directory, and run below command to start the agent:
    ./quickbuild.sh console
    

    During startup, the agent will contact the server. If the server is down, the agent will wait until the server is up and running, and then continue its startup process.
    NOTE:

    • This will run QuickBuild agent in console mode. To close 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, then you will find a service named QuickBuild 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:
      ./quickbuild.sh start
      

      The daemon process can be stopped by running below command:

      ./quickbuild.sh stop
      
    • Be default, QuickBuild will run on port 8080. If this port is used by other process, you can change to use a un-used port by editing the file conf/node.properties.
  7. After the agent starts up, check the server to see if the build grid contains the newly started agent node.
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.