You can view all the executable capabilities that have been defined in Bamboo on the 'Executables' page. These include local server capabilities, local agent-specific capabilities and remote agent-specific capabilities. On this page:

Viewing and Configuring Executable Capabilities

To view and configure the Executable capabilities defined in Bamboo:

1. Click the 'Administration' link in the top navigation bar.
2. Click the 'Executables' link in the left navigation column. The Executables page will be displayed, showing the list of all the Executable capabilities defined in your Bamboo system.
   • To view a specific executable capability, click the specific executable's tab on the left. This will show you the agents and Jobs related to this executable capability, with which you can perform the following actions:
     • View more details about an agent with this executable capability — To do this, click the linked name of the agent in the Agent column. This will show you the complete list of capabilities and Jobs associated with that agent.
     • Edit the executable path of an agent with this executable capability — To do this, click the 'Edit' link in the Operations column for the agent you wish to configure.
     • Remove this executable capability from an agent — To do this, click the 'Delete' link in the Operations column for the agent that currently possesses this executable capability.
       Be aware that you can only remove a executable capability from all local agents, not from individual local agents. See the note below for more information.
     • View details about (and configure) an elastic image with this executable capability — To do this, click the linked name of the elastic image in the Elastic Image Configuration column.
     • Edit the configuration of a Job which relies on/requires this executable capability — To do this, click the linked name of the Job in the Plan column.
     • If you are currently viewing a Maven (2.x or later) executable capability, you can configure repository isolation for it by clicking the 'Edit Capability Configuration' link. Please refer to Configuring Repository Isolation for Maven Executables for more information.
   • To add a new executable as a local server capability, click the 'Add executable to server capabilities' link to navigate to the Server Capabilities page.

Screenshot above: 'Executables'

Notes

• Bamboo's automatic detection of executables — When you install the Bamboo server application or the Bamboo Remote Agent application on another machine, either of these applications will automatically look for existing executables installed on the same machine (based on a combination of the machine's environment variables and other conditions). A 'executable capability' will be created for each executable that that either of these Bamboo applications find.
  
  The environment variables and conditions that Bamboo uses to automatically detect and create executable capabilities are listed below. With the exception of the 'Command' executable, the paths for each automatically detected executable are based on the path 'string' values found within these environment variables.
  • Ant — the ANT_HOME environment variable
  • Maven — the MAVEN_HOME environment variable (Maven 1), M2_HOME or MAVEN2_HOME environment variable (Maven 2.x)
  • Grails — GRAILS_HOME environment variable
  • Command — the existence of the /bin/bash file
  • PHPUnit — the existence of the phpunit file anywhere within the machine's PATH environment variable value
• Local agents and executable capabilities — Since Bamboo automatically looks for executables installed on the same machine and creates a 'executable capability' for each executable installation it finds, all existing and subsequent local agents that you create will possess these executable capabilities. Hence, when you access the 'Executables' page and view these executable capabilities, all local agents will be grouped together in the 'All local agents' category and you will only be able to remove these executable capabilities from all local agents, not from individual local agents.

Related Topics

Configuring Capabilities