Integrating CruiseControl.NET

To integrate CruiseControl.NET with Dimensions follow the procedure below.

Integrating CruiseControl.NET with Dimensions:

1. Copy the following Dimensions plug-in DLLs to the CruiseControl.Net server folder in the CruiseControl.Net installation, typically located in:

C:\Program Files\CruiseControl.NET\server

- CruiseControl.NET 1.5:

%DM_ROOT%\prog\CCNET1.5\CCNET.DMCruise.Plugin.dll

%DM_ROOT%\prog\Serena.CM.WinModel.dll

%DM_ROOT%\prog\Serena.CM.WinModel.Interfaces.dll

%DM_ROOT%\prog\Serena.Common.Util.Logger.dll

- CruiseControl.NET 1.4 and earlier:

%DM_ROOT%\prog\CCNET.DMCruise.Plugin.dll

%DM_ROOT%\prog\Serena.CM.WinModel.dll

%DM_ROOT%\prog\Serena.CM.WinModel.Interfaces.dll

%DM_ROOT%\prog\Serena.Common.Util.Logger.dll

The DLLs are available after you install the desktop client with the Visual Studio integration plug-in.

2. Configure the ccnet.config XML file, which is located in the same directory as the server application.

This is an example of a ccnet.config file that uses the Dimensions plugin:

<cruisecontrol>

<project name="FileCollector">

<webURL>http://localhost/ccnet/</webURL>

<triggers>

<intervalTrigger seconds="60" />

</triggers>

<modificationDelaySeconds>10</modificationDelaySeconds>

<sourcecontrol type="dmcruise" autoGetSource="true">

<username>dmsys</username>

<password>password</password>

<server>servername</server>

<databaseName>qlarius_cm</databaseName>

<connectionDSN>DIM10</connectionDSN>

<project>FILECOLLECTOR</project>

<workingDirectory>c:\workspace\cruisecontrol projects\FileCollector\</workingDirectory>

<cleanCopy>false</cleanCopy>

</sourcecontrol>

<tasks>

<nant>

<executable>c:\program files\nant\bin\nant.exe</executable>

<baseDirectory>c:\workspace\cruisecontrol projects\FileCollector</baseDirectory>

<buildArgs></buildArgs>

<buildFile>FileCollector.build</buildFile>

<targetList>

<target>run</target>

</targetList>

<buildTimeoutSeconds>300</buildTimeoutSeconds>

</nant>

</tasks>

<publishers>

<merge>

<files>

<file>C:\workspace\FileCollector\build\test\unit-test-results.xml</file>

</files>

</merge>

<xmllogger />

</publishers>

</project>

</cruisecontrol>

In the <sourcecontrol> block configure the following parameters:

- type: specifies the Dimensions plug-in, dmcruise.

- autoGetSource: allows the Dimensions CruiseControl.NET plug in to fetch code from the Dimensions repository. Should always be set to ’T’ (true).

- username: specifies a Dimensions user ID.

- password: specifies the password for the Dimensions user ID.

- server: specifies the location of the server where Dimensions is installed.

- database: specifies the name of a base database on the server.

- connection: specifies the database connection string.

- project: specifies the name of a project or stream.

- workingDirectory: specifies a work area for the project or stream.

- cleanCopy: specifies whether the Get and Update commands overwrite locally modified files. Use true or false.

3. To start the CruiseControl.NET server, open a command prompt and type:

ccnet

NOTE Make sure that the CruiseControl.NET server folder is on the path environment variable.

The server status is saved in a log file that you can view in the Web Dashboard.