Bamboo installation guide for Windows

• • Bamboo home directory— This is the directory where Bamboo will store its configuration data. If the directory you specify doesn't exist, Bamboo will create the directory when it launches. The default is:

    C:/Documents and Settings/<current-user>/Bamboo-home
    

Download and install Bamboo for Windows (ZIP Archive)

1. Download Bamboo for Windows. Bamboo for Windows is available for download from the Bamboo Download Center. Choose the ZIP Archive (.zip) download (click the 'Show all' link to show the 'ZIP Archive' download link).

2. Extract the files from the ZIP Archive to a Bamboo installation directory of your choice. By default, the root directory in your zip file is named "Bamboo".

   Warning: Some unzip programs cause errors

   Some archive-extract programs cause errors when unzipping the Bamboo archive file. We highly recommend that you use the free 7Zip archive-extract program (if in doubt, download the '32-bit .exe' version).

   
   
   

3. Set up your Bamboo home directory — this is the directory where Bamboo will store its root configuration data. To do this, edit the file named bamboo-init.properties in the Bamboo/webapp/WEB-INF/classesdirectory. In this file, insert the property "bamboo.home", with an absolute path to your Bamboo home directory. Your file should look something like this:

   bamboo.home=C:/test/bamboo-home
   

   Alternatively, you can specify an environment variable 'BAMBOO_HOME' which specifies the absolute path to your {BAMBOO_HOME} directory. Bamboo will check if an environment variable is defined.

4. If you are going to use Bamboo remote agents, set the following in the bamboo-init.properties file in the <Bamboo installation directory>/webapp/WEB-INF/classesdirectory:

   bamboo.jms.broker.uri=tcp://localhost:54663
   

   • Replace 'localhost' with the real host name or IP address of your Bamboo server.
   • If port number 54663 is already in use, specify a different port number.

2. Launch Bamboo

There are two ways you can launch Bamboo on Windows:

Launch via the Start Menu

If you have used the 'Windows Installer' to install Bamboo, you can start Bamboo via the Start Menu in Windows (generally under the 'Bamboo' folder by default). The following options will be available in your Start Menu:

• Bamboo Continuous Integration Server Uninstaller — uninstalls Bamboo from your computer
• Install Service — installs Bamboo as a Windows service (note, this will not start Bamboo)
• Remove Service — removes the Bamboo Windows service, if you have previously installed it (note, Bamboo will not be uninstalled from your computer)
• Start in Console — starts Bamboo in a Windows console
• Start Service — starts your installed Bamboo Windows service
• Stop Service — stops your installed Bamboo Windows service

You can run Bamboo in two modes, either in a Windows console or as a Windows service:

• To run Bamboo in a Windows console, click the Start in Console option.

• To run Bamboo as a Windows service, click the Install service option. After the service is installed, click Start Service. Once you have installed Bamboo as a service, Bamboo will start up automatically every time Windows restarts.
  
  

  Running Bamboo as a service

  • Changing the user running the Bamboo service — The default behaviour in Windows is to start the service under the SYSTEM user when Bamboo starts up. You can change this behaviour from the Services console available via the Control Panel. Please note, you may need to uninstall the service and re-install it again, if you have just upgraded or re-installed Bamboo.
  • Running Bamboo as a service in Windows Vista — Bamboo ships with a service wrapper in Windows and by default, the wrapper installs itself as the NT SYSTEM user. However, in Vista the temporary directory System Variable is not available to untrusted apps. In order to run Bamboo as service in Vista, you must run Bamboo as a non-system user — see Running Bamboo service on Windows as the local user for further instructions.

Launch via batch file

You can start Bamboo via the batch files that are shipped with Bamboo. If you have installed Bamboo via the ZIP Archive, you will need to use the batch files to start Bamboo. You can find the following batch files in your installation directory:

• BambooConsole.bat — this starts Bamboo in a Windows console.
• InstallAsService.bat — this installs Bamboo as a Windows service. Note that this will not start Bamboo.
• StartBamboo.bat — this starts your installed Bamboo Windows service.
• StopBamboo.bat — this stops your installed Bamboo Windows service
• UninstallService.bat — this un-installs the Bamboo Windows service from your machine. Note that your Bamboo installation still remains.

You can run Bamboo in two modes, either in a Windows console or as a Windows service:

• To run Bamboo in a Windows console, run BambooConsole.bat

• To run Bamboo as a Windows service, run InstallAsService.bat. After the service is installed, run StartBamboo.bat. Once you have installed Bamboo as a service, Bamboo will start up automatically every time Windows restarts.

  Running Bamboo as a service

  • Changing the user running the Bamboo service — The default behaviour in Windows is to start the service under the SYSTEM user when Bamboo starts up. You can change this behaviour from the Services console available via the Control Panel. Please note, you may need to uninstall the service and re-install it again, if you have just upgraded or re-installed Bamboo.
  • Running Bamboo as a service in Windows Vista — Bamboo ships with a service wrapper in Windows and by default, the wrapper installs itself as the NT SYSTEM user. However, in Vista the temporary directory System Variable is not available to untrusted apps. In order to run Bamboo as service in Vista, you must run Bamboo as a non-system user — see Running Bamboo service on Windows as the local user for further instructions.

3. Configure Bamboo

Access your running Bamboo instance by going to your web browser and entering the address http://localhost:8085/. Configure Bamboo using the Setup Wizard that is displayed. Read Running the Setup Wizard for further instructions.