CDash:Installation: Difference between revisions
Line 20: | Line 20: | ||
=== Stable Release === | === Stable Release === | ||
The '''current stable release of CDash is 2. | The '''current stable release of CDash is 2.6.0''' you can either download it as a zip archive | ||
* [ | * [https://github.com/Kitware/CDash/archive/v2.6.0.zip CDash-2.6.0.zip] | ||
* or as a tag from the [https://github.com/Kitware/CDash.git | * or as a tag from the [https://github.com/Kitware/CDash.git git repository]: | ||
git clone https://github.com/Kitware/CDash.git | git clone https://github.com/Kitware/CDash.git | ||
git checkout v2. | git checkout v2.6.0-prebuilt | ||
==== Previous versions of CDash ==== | ==== Previous versions of CDash ==== | ||
* '''2.4''': [http://public.kitware.com/Wiki/File:CDash-2-4-0.zip CDash-2.4.0.zip] or git checkout v2.4.0 | |||
* '''2.2''': [http://www.cdash.org/download/CDash-2.2.2.zip CDash-2.0.2.zip] or git checkout Release-2-2-2 | * '''2.2''': [http://www.cdash.org/download/CDash-2.2.2.zip CDash-2.0.2.zip] or git checkout Release-2-2-2 | ||
* '''2.0''': [http://www.cdash.org/download/CDash-2.0.2.zip CDash-2.0.2.zip] or git checkout Release-2-0-2 | * '''2.0''': [http://www.cdash.org/download/CDash-2.0.2.zip CDash-2.0.2.zip] or git checkout Release-2-0-2 | ||
Line 35: | Line 36: | ||
* '''1.0''': [http://www.cdash.org/download/CDash-1.0.zip CDash-1.0.zip] or git checkout Release-1-0-2 | * '''1.0''': [http://www.cdash.org/download/CDash-1.0.zip CDash-1.0.zip] or git checkout Release-1-0-2 | ||
* '''0.8''': [http://www.cdash.org/download/CDash-0.8.zip CDash-0.8.zip] or git checkout Release-0-8 | * '''0.8''': [http://www.cdash.org/download/CDash-0.8.zip CDash-0.8.zip] or git checkout Release-0-8 | ||
=== GIT Development version === | === GIT Development version === | ||
Revision as of 15:36, 20 November 2018
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:
- bcmath
- 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.6.0 you can either download it as a zip archive
- CDash-2.6.0.zip
- or as a tag from the git repository:
git clone https://github.com/Kitware/CDash.git git checkout v2.6.0-prebuilt
Previous versions of CDash
- 2.4: CDash-2.4.0.zip or git checkout v2.4.0
- 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:
- Create a symbolic link from
DocumentRoot
toCDash/public
. - Configure
DocumentRoot
to point directly toCDash/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