Skip to end of metadata
Go to start of metadata
This page describes how to set Java properties and options on startup for Bamboo.

On this page:

To define parameters other than java_opts: Setting properties other than JAVA_OPTS when running Bamboo as a Windows Service

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 via Command Line

Setting Properties for Windows Services via Command Line
  1. Identify the name of the service that Bamboo is installed as in Windows ( Control Panel > Administrative Tools > Services ):


  2. Open the command window from Start >> Run >> type in 'cmd' >> Enter
  3. cd 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 via 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 via 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.

Remote Agents

To Configure System Properties in Remote agents,
  1. From <Remote Agent Home>/conf, open wrapper.cnf.
  2. Find the section The Bamboo Agent home configuration file
  3. Add another line wrapper.java.additional.X= passing as argument your system property.

(info) Please replace X with the next available digit in the sequence of additional index. Also note that the RAM can just be increased by editing the line wrapper.java.maxmemory=

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

 

 

  • No labels

6 Comments

  1. 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)
  2. Under Linux it says "Refer to the list of parameters below.". There is no list of parameters on the current version of the page.

    1. 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.

  3. 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.

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

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