Difference between revisions of "CDash:Installation"

From KitwarePublic
Jump to navigationJump to search
(Replaced content with " < CDash Main Page CDash is a [http://en.wikipedia.org/wiki/LAMP_%28software_bundle%29 LAMP] application, running on [http://www.apache.org/ Apache] using [htt...")
Tag: Replaced
 
(One intermediate revision by the same user not shown)
Line 2: Line 2:


CDash is a [http://en.wikipedia.org/wiki/LAMP_%28software_bundle%29 LAMP] application, running on [http://www.apache.org/ Apache] using [http://www.php.net/ PHP] to access a [http://www.mysql.com/ MySQL] or [http://www.postgresql.org PostgreSQL] database.
CDash is a [http://en.wikipedia.org/wiki/LAMP_%28software_bundle%29 LAMP] application, running on [http://www.apache.org/ Apache] using [http://www.php.net/ PHP] to access a [http://www.mysql.com/ MySQL] or [http://www.postgresql.org PostgreSQL] database.
== System Requirements ==


CDash requires:
Please visit [https://github.com/Kitware/CDash our GitHub repository] for download links and installation instructions.
*  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.4.0''' you can either download it as a zip archive
* [http://public.kitware.com/Wiki/File:CDash-2-4-0.zip CDash-2.4.0.zip]
* or as a tag from the [https://github.com/Kitware/CDash.git GIT] repository:
  git clone https://github.com/Kitware/CDash.git
  git checkout v2.4.0-prebuilt
 
==== Previous versions of CDash ====
* '''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
* '''1.8''': [http://www.cdash.org/download/CDash-1.8.2.zip CDash-1.8.2.zip] or git checkout Release-1-8-2
* '''1.6''': [http://www.cdash.org/download/CDash-1.6.4.zip CDash-1.6.4.zip] or git checkout Release-1-6-4
* '''1.4''': [http://www.cdash.org/download/CDash-1.4.1.zip CDash-1.4.2.zip] or git checkout Release-1-4-2
* '''1.2''': [http://www.cdash.org/download/CDash-1.2.1.zip CDash-1.2.1.zip] or git checkout Release-1-2-1
* '''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
 
=== GIT Development version ===
 
CDash uses [https://getcomposer.org/ composer] and [https://www.npmjs.com/ npm] to manage its 3rd party dependencies.
 
We provide two developments branches, <code>master</code> and <code>prebuilt</code>.  If you're working with the <code>master</code> branch, then you have to run composer & npm yourself.  The <code>prebuilt</code> branch has these dependencies already downloaded for you.
 
==== master ====
 
Use the <code>master</code> 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 <code>prebuilt</code> 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 <code>CDash/config/config.local.php</code> 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 <code>public</code> subdirectory should be exposed to the web.  There are two main ways to accomplish this:
 
# Create a symbolic link from <code>DocumentRoot</code> to <code>CDash/public</code>.
# Configure <code>DocumentRoot</code> to point directly to <code>CDash/public</code>.
 
See [[CDash:Upgrade#Repository_Reorganization_Aftermath|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

Latest revision as of 14:40, 25 September 2020

< CDash Main Page

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

Please visit our GitHub repository for download links and installation instructions.