Configuring Bamboo on start-up

This page describes how to set Java properties and options on startup for Bamboo.

On this page:

Linux

To configure system properties in Linux installations

  1. From <bamboo-install>/bin, open setenv.sh.
  2. Find the section JVM_SUPPORT_RECOMMENDED_ARGS=
  3. Refer to the list of parameters below.

(info) Add all parameters in a space-separated list, inside the quotations.

Windows (starting from .bat file)

To configure system properties in Windows installations when starting from the .bat file

  1. From <bamboo-install>/bin, open setenv.bat.
  2. Find the section set JVM_SUPPORT_RECOMMENDED_ARGS=
  3. Refer to the list of parameters below.

(info) Add all parameters in a space-separated list, inside the quotations.

Windows service

There are two ways to configure system properties when starting Bamboo as a service, either via the command line or in the Windows registry.

Setting properties for Windows services from the command line

  1. Identify the name of the service that Bamboo is installed as in Windows (Control Panel > Administrative Tools > Services):


  2. Open a command prompt from Start > Run > type 'cmd' > Enter.
  3. Change directory to the bin directory of your Bamboo installation directory.
  4. Run:

    (info) In the above example, it would be tomcat7w //ES//Bamboo

  5. Click on the Java tab to see the list of current start-up options:
  6. Append any new option on its own new line by adding to the end of the existing Java Options. Refer to the list of parameters below.

Setting properties for Windows services using the Windows registry

In some versions of Windows, there is no option to add Java variables to the service. In these cases, you must add the properties by viewing the option list in the registry.

To set properties for Windows services using the Windows registry

  1. Go to Start > Run, and run "regedit32.exe".
  2. Find the Services entry:
    32-bit: HKEY_LOCAL_MACHINE >> SOFTWARE >> Apache Software Foundation >> Procrun 2.0 >> Bamboo
    64-bit: HKEY_LOCAL_MACHINE >> SOFTWARE >> Wow6432Node >> Apache Software Foundation >> Procrun 2.0 >> Bamboo
  3. To change existing properties, especially increasing Xmx memory, double-click the appropriate value.
  4. To change additional properties, double-click options.
  5. Refer to the list of parameters below. Enter each on a separate line.

Changing the Bamboo start port

  1. Stop Bamboo.
  2. Edit <Bamboo install directory>/conf/server.xml
  3. Update the following so that Connector port is set to the port value you require:

  4. Restart Bamboo.

List of startup parameters

Memory Property

Notes

Related Pages

-Xmx 
-Xms 
XX:MaxPermSize

These properties are pre-existing. See related pages for instructions.

Tuning the Java heap

-XX:+PrintGCTimeStamps -verbose:gc -Xloggc:gc.log -XX:+HeapDumpOnOutOfMemoryError

Set these for Garbage Collection tuning.

Tuning Java VM garbage collection

Was this helpful?

Thanks for your feedback!

6 Archived comments

  1. User avatar

    Adrian Hempel [Atlassian]

    If you change the HTTP port for Bamboo after running the Setup Wizard, you must also update the following settings, to reflect the change:

    • The Base URL of the Bamboo server
    • The URL in the command line used to start any Remote Agents (excluding Elastic Agents)
    26 Feb 2009
  2. User avatar

    Steven T. Snyder

    Under Linux it says "Refer to the list of parameters below.". There is no list of parameters on the current version of the page.

    27 Nov 2013
    1. User avatar

      Nathan Pye [Atlassian]

      Apologies, the link referred to a page in the JIRA space that had broken inclusions. I have added the relevant parameters to the bottom of this page.

      I hope that helps.

      28 Nov 2013
  3. User avatar

    Abhinav Mishra

    How can I change the default Bamboo port?

    (In conf/server.xml) If I change connector port for Catalina to 4045, I get errors from StandardServer that port 8007 is not available.

    Stuck with it.

    30 Jan 2014
    1. User avatar

      James Dumay [Atlassian]

      Abhinav Mishra, in conf/server.xml you need to change 8085 to the port that you wish to use

      30 Jan 2014
      1. User avatar

        Abhinav Mishra

        Well... finally figured it. It is safer to do default HTTP port change before starting the Bamboo for the first time.

        30 Jan 2014
Powered by Confluence and Scroll Viewport