View Source

h2. Prerequisites
QuickBuild utilizes the Mercurial command (hg) to interact with remote Mercurial repository. If this command is not in system path, you will need to specify location of the command by configuring Mercurial plugin as below:
!hg-plugin.png!

Further more, Mercurial command (hg) location can be specified on a per-node basis by following below steps:
# Open Mercurial plugin setting page and define the Bazaar path property as:
{code}
${node.getAttribute("hgPath")}
{code}
# For each node that does not have Bazaar on system path, define the user attribute _hgPath_ to point to the actual Mercurial path like below:
!hg-path.png!

*NOTE:* example above is just for demonstration, you can use any other user attribute name instead of _hgPath_.

h2. Creating a Mercurial Repository
You may refer to [this page|Scm Support Overview] on how to add a repository.
h3. Supported URL prefixes
Currently, below URL prefixes are supported:

* \[local/filesystem/path]
* \[file://local/filesystem/path]
* \[http://host\[:port]/path]
* \[https://host\[:port]/path]
* \[ssh://host\[:port]/path]

If *https* is used, and your credential need password, you need first add the credential manually to the nodes which you want check out code to.
If *ssh based* URL is used, please use public key without password for authorization and you need not specify the password when you create the repository. You can reference your SSH manual on how to create public key without password.