AccuRev Configuration
 | Note: The AccuRev source control block is available in CCNet 1.3 and later. |
Typical / Minimal Configuration
For most uses the following is all you'll need in your ccnet.config:
<sourcecontrol type="accurev"> <autoGetSource>true</autoGetSource> </sourcecontrol>
This will:
- monitor AccuRev for any changes in the workspace located at the project working directory
- retrieve the lastest source from AccuRev when any changes are detected
- apply a label to (i.e., make a snapshot of) the built files at the end of each successful build
Full Configuration
<sourcecontrol type="accurev"> <autoGetSource>true</autoGetSource> <executable>accurev.exe</executable> <homeDir>.</homeDir> <labelOnSuccess>false</labelOnSuccess> <login>false</login> <password>banana</password> <principal>joe_user</principal> <timeout units="minutes">10</timeout> <workspace>.</workspace> </sourcecontrol>
| Element | Description | Type | Required | Default |
|---|---|---|---|---|
| autoGetSource | Specifies whether the current version of the source should be retrieved from AccuRev. | bool | no | false |
| executable | Specifies the path to the AccuRev command line tool. You should only have to include this element if the tool isn't in your path. By default, the AccuRev client installation process names it accurev.exe and puts it in C:\Program Files\AccuRev\bin. | string | no | accurev.exe |
| homeDir | Specifies the location of the AccuRev home directory. The pathname can be either absolute or relative to the project artifact directory. If not specified, AccuRev will follow its rules for determining the location. The home directory itself is always named ".accurev". | string | no | none |
| labelOnSuccess | Specifies whether or not CCNet should create an AccuRev snapshot when the build is successful. If set to true, CCNet will create a snapshot of the workspace's basis stream as of the starting time of the build, naming it according to the build label. | bool | no | false |
| login | Specifies whether or not CCNet should log in to AccuRev using the specified principal and password. If set to true, the principal and password elements are required, and CCNet will use them to log in to AccuRev before executing any AccuRev commands. | bool | no | false |
| password | Specifies the password for the AccuRev "principal" (userid). | string | only if login=true | none |
| principal | Specifies the AccuRev "principal" (userid) to run under. If not specified, AccuRev will follow its rules for determining the principal. | string | only if login=true | none |
| timeout | Sets the timeout period for the source control operation. See Timeout Configuration for details. | Timeout | no | 10 minutes |
| workspace | Specifies the location on disk of the AccuRev workspace that CCNet monitors for changes. The pathname can be either absolute or relative to the project working directory, and must identify the top-level directory of the workspace. Note that this is not the same as the workspace name - AccuRev will determine the workspace name from the disk pathname. | string | no | project working directory |
| issueUrlBuilder | Converts the comment (or parts from it) into an url pointing to the issue for this build. See Issue Builder for more details | Group | N/A |
false |
Known Issues
CruiseControl.NET doesn't see my changes
AccuRev depends on the clocks of the server and its clients ticking together. Make sure the clock of your build server is synchronized to the clock of your AccuRev server. See CCNET-271 for details on a similar problem with Rational ClearCase.
AccuRev says I'm "unknown" or "not authenticated"
AccuRev needs to know the userid that owns the workspace, and stores that information in files in the AccuRev home directory, which defaults to %HOMEDRIVE%%HOMEPATH%\.accurev. If there isn't any such directory, or if CCNet is running under a userid that isn't an AccuRev user, AccuRev will not be able to function correctly and the accurev info command may report that the user is unknown or not authenticated. You can use the homeDir element to force AccuRev to look for the .accurev directory in a particular location, such as the project's artifact directory.
