If you wish to build plans on your server and remote agents using a Mercurial repository, you need to specify the location of the Mercurial hg client application for your Bamboo server and for each remote agent using Mercurial. These locations are set by specifying:
- a mandatory local server Mercurial capability for your Bamboo server and
- agent-specific remote Mercurial capabilities for each of your remote agents using Mercurial.
Shared capabilities are inherited by all applicable agents, that is, (shared) local server capabilities are inherited by all local agents, and shared remote capabilities are inherited by all remote agents. Note, however, that the value of a shared capability will be overridden by the value of an agent-specific capability of the same name (if one exists).
An agent-specific capability is a capability that applies to one agent only. Note that the value of an agent-specific capability will override the value of a shared capability of the same name (if one exists).
Configuring a New Local Server Mercurial Capability
To configure a new local server Mercurial capability:
- Click the 'Administration' link in the top navigation bar.
- Click the 'Server Capabilities' link in the left navigation column.
- The 'Server Capabilities' screen will be displayed, showing a list of all local server capabilities currently defined in your Bamboo system.
- Locate the 'Add Capability' section at the bottom of the screen (see screenshot below).
- In the 'Capability Type' field, select 'Mercurial'.
- In the 'Executable' field, select 'Mercurial'.
- In the 'Path' field, provide a full path (or make sure it is on the system PATH) to the
hg client application for your server.
- Click the 'Add' button.
Configuring a New Agent-Specific Remote Mercurial Capability
To configure a new agent-specific remote Mercurial capability:
- Navigate to the desired agent, as described on Viewing an Agent.
- The 'Agent Capabilities' screen will be displayed, showing a list of shared capabilities and agent-specific capabilities for your chosen agent. Click the 'Add Capability' link in the top-right of the 'Agent-Specific Capabilities' section.
- The 'Add Capability' page will be displayed (see screenshot below).
- In the 'Capability Type' field, select 'Mercurial'.
- In the 'Executable' field, select 'Mercurial'.
- In the 'Path' field, provide a full path (or make sure it's on the system PATH) to the
hg client application for your remote agent.
- Click the 'Add' button.

Screenshot: Adding a new Mercurial capability
Notes
Configuring Capabilities