Instrumenting a Mercurial Repository
We assume that the repository already exists and is accessible. The mercurial example configuration files can be found under the hg directory in scmloop.zip.
1. Check hgrc file under .hg directory (hidden directory at the root of repository) of the Mercurial repository. If there is an already existing one, append content of the provided hgrc file to the original one (with a preferred editor), otherwise copy it to .hg dir.
2. Set your repositoryId property for the project where this repository used: [codebeamer] repositoryId = 266 # (number!) ....
3. Create a new file called hgrc-Codebeamer.
4. Write this in the file:
#DO NOT MODIFY THIS FILE UNLESS YOU KNOW WHAT YOU ARE DOING
[web]
allow_push = *
allow_read = *
[hooks]
changegroup = "${hookDirectory}/changegroup-hook" hg_post_receive
pretxnchangegroup = "${hookDirectory}/changegroup-hook" hg_pre_update
[extensions]
# enables the strip command
mq =
[ui]
merge = internal:merge
[web]
allow_push = *
allow_read = *
[hooks]
changegroup = "${hookDirectory}/changegroup-hook" hg_post_receive
pretxnchangegroup = "${hookDirectory}/changegroup-hook" hg_pre_update
[extensions]
# enables the strip command
mq =
[ui]
merge = internal:merge
5. In hgrc-codebeamer replace all occurrences of the string ${hookDirectory}}} with the absolute path of the directory where you copied the scripts to..
6. Copy the changegroup-hook(.bat) scripts from hg/<operating_system> (in scmloop.zip) to the .hg directory of the mercurial repository being served.
7. Replace the string ${scmloop}}} with the actual path of the scmloop script.
8. On Linux/Unix systems it must be ensured (eg. using command chmod) that the scripts are executable.
9. (Optional) In hgrc-codebeamer set your host name as it was registered in Codebeamer. This value will be the hostname of the machine where the Mercurial run by default. [codebeamer] host = myscmhost ....
10. (Optional) In hgrc-codebeamer set cburl property in the hgrc file according to the settings of your Codebeamer commit url : [codebeamer] cburl = http://mycbhost ....
11. (Optional) Check and set proxyhost, proxyport, proxyuser, password properties in the hgrc file according to the settings of your network like: [codebeamer] proxyhost = myproxy proxyport = 81 proxyuser = myproxyuser password = v3ght # put password here in a base64 encoded form ....
Online tool can be used for base64 encoding like http://www.motobit.com/util/base64-decoder-encoder.asp
 |
(Optional) To ignore Codebeamer accessibility errors set the ignore flag (false by default): [codebeamer]...ignore = true.
|