This page last changed on Apr 01, 2005 by mroberts.

Various aspects of the CruiseControl.NET Server are configured in the application configuration file. The name of this file depends on how you are running the server:

  • If you are running the Console Application, the application config file is called ccnet.exe.config.
  • If you are running the Windows Service Application, the application config file is called ccservice.exe.config

For most installations the default settings in this file will be appropriate.

This file is a standard .NET application config file. Parts of it that are specific to CruiseControl.NET are as follows:

XSL File configuration

The <xslFiles> section defines what xsl files are included for transforming the build file for reporting behaviour within the server. If you want to include extra xsl files (for example if you have your own build behaviours), then add them here.

Remoting Configuration

The CruiseControl.NET Server can open a remoting server port so that other applications in the CCNet suite can communicate with it (CCTray, Web Dashboard). By default CCNet listens on port 21234, but this can be changed under the <system.runtime.remoting> section.

 You'll need to change this value if you want to run multiple CruiseControl.NET servers on 1 machine

Logging configuration

Logging of the Server activities (not the build logs themselves) is implemented using .NET Tracing, and this is configurable in the <system.diagnostics> section of the application config file. In this section you can change log level (the <switches> section), and where log data is sent to (the <trace> section).

If you are using a LogFileTraceListener in the <trace> section, then you can configure the server log file name there. This same file name should be set as the value for the ServerLogFilePath key in the <appSettings> section. This value is used when remote applications request to see the server log file. The number of lines returned from the end of the server log file to the remote application is specified by the ServerLogFileLines value.
Note that with some log levels certain potentially sensitive details may be logged, including source control passwords. Make sure you check your log file and set the log level appropriately.

Service Specific Settings

If you are running the console application, you have the option of passing in various arguments on the command line. If however you are using the Service application you can't do this, but there are extra options you can set in the <appSettings> section of the config file, as follows:
key Equivalent startup parameter in The Server Console Application
ccnet.config config
remoting remoting
Document generated by Confluence on Jun 26, 2005 17:22