CDash:Installation

< CDash Main Page

CDash is a LAMP application, running on Apache using PHP to access a MySQL or PostgreSQL database.

System Requirements

CDash requires:

• A web server (Apache, NGINX, IIS) with PHP (5.5.9+) and SSL enabled.
• Access to a MySQL (5.x+) or PostgreSQL (8.3+) database server.

PHP needs to have the following modules enabled:

• cURL (for site statistics)
• GD (for regression tests)
• mbstring
• pdo-mysql or pdo-postgresql
• XSL

Downloading CDash

Stable Release

The current stable release of CDash is 2.4.0 you can either download it as a zip archive

• CDash-2.4.0.zip
• or from the GIT repository 'prebuilt' branch:

 git clone https://github.com/Kitware/CDash.git
 git checkout v2.4.0-prebuilt

Previous versions of CDash

• 2.2: CDash-2.0.2.zip or git checkout Release-2-2-2
• 2.0: CDash-2.0.2.zip or git checkout Release-2-0-2
• 1.8: CDash-1.8.2.zip or git checkout Release-1-8-2
• 1.6: CDash-1.6.4.zip or git checkout Release-1-6-4
• 1.4: CDash-1.4.2.zip or git checkout Release-1-4-2
• 1.2: CDash-1.2.1.zip or git checkout Release-1-2-1
• 1.0: CDash-1.0.zip or git checkout Release-1-0-2
• 0.8: CDash-0.8.zip or git checkout Release-0-8

GIT Development version

CDash uses composer and npm to manage its 3rd party dependencies.

We provide two developments branches, master and prebuilt. If you're working with the master branch, then you have to run composer & npm yourself. The prebuilt branch has these dependencies already downloaded for you.

master

Use the master branch if you'd like to modify CDash or contribute to its development.

git clone https://github.com/Kitware/CDash.git CDash
git checkout master
curl -sS https://getcomposer.org/installer | php 
php composer.phar install
npm install
node_modules/.bin/gulp

prebuilt

The prebuilt branch is a good choice if you'd like to use new features in CDash on a production server.

git clone https://github.com/Kitware/CDash.git CDash
git checkout prebuilt

Configuring CDash

Create CDash/config/config.local.php and specify the following database settings.

   // Hostname of the database server or name of unix socket
   $CDASH_DB_HOST = 'localhost';
   // Login for database access
   $CDASH_DB_LOGIN = 'root';
   // Port for the database (leave empty to use default)
   $CDASH_DB_PORT = ;
   // Password for database access
   $CDASH_DB_PASS = ;
   // Name of the database
   $CDASH_DB_NAME = 'cdash';
   // Database type
   $CDASH_DB_TYPE = 'mysql';
   // Must be one of host, unix_socket
   $CDASH_DB_CONNECTION_TYPE = 'host';

This allows CDash to connect to your database server.

CDash can create a new database for you if you are using MySQL. For Postgres, you have to create the new database yourself.

See CDash:Configuration for information about more configuration options.

Installing CDash

Only CDash's public subdirectory should be exposed to the web. There are two main ways to accomplish this:

1. Create a symbolic link from DocumentRoot to CDash/public.
2. Configure DocumentRoot to point directly to CDash/public.

See Repository Reorganization Aftermath for more details and information.

Permissions

The web server user needs to have write access to the following directories:

• CDash/backup
• CDash/log
• CDash/public/rss
• CDash/public/upload