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