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. You can get details about the configuration file from:

http://confluence.public.thoughtworks.org/display/CCNET/Configuring+the+Server

This is an example of a ccnet.config file that uses the Dimensions plug-in:

<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.