https://public.kitware.com/Wiki/index.php?title=CDash:Configuration&feed=atom&action=historyCDash:Configuration - Revision history2024-03-29T02:17:28ZRevision history for this page on the wikiMediaWiki 1.38.6https://public.kitware.com/Wiki/index.php?title=CDash:Configuration&diff=61955&oldid=prevZack at 14:05, 30 August 20172017-08-30T14:05:53Z<p></p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 14:05, 30 August 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1">Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">[[CDash | < CDash Main Page]]</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>The system configuration is stored in <tt>.../CDash/config/config.php</tt>, however it's recommended to create a '''config.local.php''' in the same directory that contains '''''only''''' the variables you wish to change. Doing so will prevent any changes you make from being overwritten when CDash is upgraded and config.php is re-created.</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>The system configuration is stored in <tt>.../CDash/config/config.php</tt>, however it's recommended to create a '''config.local.php''' in the same directory that contains '''''only''''' the variables you wish to change. Doing so will prevent any changes you make from being overwritten when CDash is upgraded and config.php is re-created.</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
</table>Zackhttps://public.kitware.com/Wiki/index.php?title=CDash:Configuration&diff=61954&oldid=prevZack: Created page with "The system configuration is stored in <tt>.../CDash/config/config.php</tt>, however it's recommended to create a '''config.local.php''' in the same directory that contains '''..."2017-08-30T14:05:26Z<p>Created page with "The system configuration is stored in <tt>.../CDash/config/config.php</tt>, however it's recommended to create a '''config.local.php''' in the same directory that contains '''..."</p>
<p><b>New page</b></p><div>The system configuration is stored in <tt>.../CDash/config/config.php</tt>, however it's recommended to create a '''config.local.php''' in the same directory that contains '''''only''''' the variables you wish to change. Doing so will prevent any changes you make from being overwritten when CDash is upgraded and config.php is re-created.<br />
<br />
Please note that CDash will read the config.php file first, and then config.local.php. Any variables that are changed in config.local.php will take precedence.<br />
<br />
'''WARNING: If creating the config.local.php from config.php make sure you DELETE any text after the 'DO NOT EDIT AFTER THIS LINE' otherwise your configuration file will be referencing each other. Ideally config.local.php should contain ONLY the variables you have modified.'''<br />
<br />
= SQL Database =<br />
If you are running the MySQL database on the same server as the Apache web server the defaults should work with no changes:<br />
<br />
// Hostname of the MySQL database <br />
$CDASH_DB_HOST = 'localhost';<br />
<br />
// Login for MySQL database access<br />
$CDASH_DB_LOGIN = 'root';<br />
<br />
// Password for MySQL database access<br />
$CDASH_DB_PASS = '';<br />
<br />
// Name of the MySQL database<br />
$CDASH_DB_NAME = 'cdash';<br />
If your MySQL (>= v5) server is set to ''strict'' mode, CDash will not work! The reason is that in strict mode, integer columns will not accept the empty string "" as 0 (zero). "" is what the CDash forms currently return for unchecked checkboxes. You'll have to remove the setting <code>STRICT_TRANS_TABLES</code> from the global sql mode parameter. You can query the current setting like this: <code>SELECT @@global.sql_mode;</code><br />
<br />
For more information and more specific settings see the [http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html MySQL sql mode documentation].<br />
<br />
If you have just installed MySQL don't forget to start it:<br />
<br />
rcmysql start<br />
<br />
= PostgreSQL Database =<br />
If you are running the PostgreSQL database read the previous MySQL section about configuring the database access.<br />
You will also need to tell CDash to use PostgreSQL driver:<br />
<br />
// Database type (empty means mysql)<br />
$CDASH_DB_TYPE = 'pgsql';<br />
<br />
Here is list of packages necessary on ubuntu<br />
<br />
sudo apt-get install php-pear<br />
sudo pecl install pdo <br />
sudo apt-get install php5-dev<br />
sudo pecl install pdo<br />
sudo pecl install pdo_pgsql<br />
<br />
= Email =<br />
You should probably edit the default email addresses:<br />
<br />
// Default from email<br />
$CDASH_EMAILADMIN = 'admin@cdash.org';<br />
$CDASH_EMAIL_FROM = 'admin@cdash.org';<br />
$CDASH_EMAIL_REPLY = 'noreply@cdash.org';<br />
<br />
= LDAP =<br />
As of CDash 1.4, authentication to an LDAP database can be performed.<br />
This requires the ldap module for php. The variables to define:<br />
<br />
$CDASH_USE_LDAP='1'; // turn this to 1 for LDAP authentication<br />
$CDASH_LDAP_HOSTNAME='localhost'; // hostname of the LDAP server<br />
$CDASH_LDAP_BASEDN='ou=people,dc=organization,dc=com'; // Base DN<br />
$CDASH_LDAP_PROTOCOL_VERSION='3'; // LDAP protocol version<br />
<br />
Note that the administrator (first user to install CDash) is always stored in the database.<br />
<br />
= Backup directory =<br />
The backup/log directory by default is placed in <tt>.../CDash/backup</tt>, this must be made writable by the account that you run Apache under (typically wwwrun or www-data), you can move the directory via:<br />
<br />
// Backup directory<br />
$CDASH_BACKUP_DIRECTORY = 'backup';<br />
<br />
= Removing registration =<br />
<br />
The registration can be disabled globally from CDash.<br />
<br />
// Doesn't provide registration links<br />
$CDASH_NO_REGISTRATION = '1';<br />
<br />
= Cookie expiration time =<br />
As of CDash 1.2 the login cookie time can be set in the config.php. The default is set to 1 hour.<br />
<br />
// Duration of the cookie session (in seconds)<br />
$CDASH_COOKIE_EXPIRATION_TIME = '3600'<br />
<br />
This allows the browser to remember the login/password of the user.<br />
'''On a public computer it is recommended to always log out'''<br />
<br />
= Google Maps =<br />
'''As of February of 2014, these links no longer work and I couldn't figure out where to point them. A workaround is just to insert the empty string instead of a key.'''<br />
<br />
CDash can use [http://code.google.com/apis/maps/ Google maps] to display the location of submission sites. CDash comes with Kitware's key code which won't work for your site's URL. Every site that uses Google maps requires its own [http://code.google.com/apis/maps/signup.html Google maps key] which you should obtain from Google (it's free), use this style URL when applying for a key:<br />
<br />
http://mysite.org/CDash<br />
<br />
Paste your newly obtained key in place of Kitware's:<br />
<br />
$CDASH_GOOGLE_MAP_API_KEY['localhost'] = 'paste key here';<br />
<br />
You may also add multiple keys (wighout the http://) and they will get matched by ''$_SERVER['HTTP_HOST']''<br />
<br />
$CDASH_GOOGLE_MAP_API_KEY['www.vtk.org'] = 'paste key here';<br />
$CDASH_GOOGLE_MAP_API_KEY['www.cdash.org'] = 'paste another key here';<br />
<br />
If your submission machines use private IP addresses you can add default location information, e.g. for all machines in the 192.x.x.x network (use http://maps.google.com to obtain your location):<br />
<br />
$CDASH_DEFAULT_IP_LOCATIONS[] = array("IP" => "192.*","latitude" => "42.6612","longitude" => "-73.7689");<br />
<br />
Sometimes site location are misreported (e.g. the ISP's location is used), you can override these:<br />
<br />
$CDASH_DEFAULT_IP_LOCATIONS[] = array("IP" => "76.65.240.*","latitude" => "43.667","longitude" => "-79.417");<br />
<br />
You'll probably want to replace the defaults that are present.<br />
<br />
Note: If you use the 192.x.x.x address range ensure you update the location information before submitting from any machines in this subnet, as the location is stored in the database on first submission from a site (but can be subsequently edited from the admin web pages).<br />
<br />
= Google Analytics =<br />
CDash can use [http://www.google.com/analytics/ Google analytics] to monitor site usage. CDash's main <tt>index.php</tt> contains a reference to a default Kitware Google analytics code:<br />
<br />
$CDASH_DEFAULT_GOOGLE_ANALYTICS='UA-701656-6';<br />
<br />
When you configure each project you will have the opportunity to set a per-project Google analytics code.<br />
See [[CDash:Administration#Adding_Google_Analytics | Adding GoogleAnalytics]] for more information.<br />
<br />
= RSS directory =<br />
Ensure that the <tt>.../CDash/rss</tt> (and <tt>.../CDash/backup</tt>) directory is writable by the user account that Apache runs under (typically wwwrun).<br />
<br />
= Production Mode =<br />
In order to disable the installation script, especially when the database is not accessible. You should turn on the option:<br />
<br />
$CDASH_PRODUCTION_MODE = true;<br />
<br />
in your config.local.php</div>Zack