CDash:Upgrade

< CDash Main Page

This page explains how to upgrade CDash. CDash upgrade mechanism allows users to upgrade CDash at any point in time, even if they are using the current SVN development of CDash.

Upgrading CDash

1. It is recommended that you backup the CDash database.
2. Backup your configuration file: CDash/config.php
3. Replace your current CDash directory with the latest version. An in place "svn upgrade" may not be sufficient.
4. Restore the configuration parameters: the config.php file may change from one revision to the other, make sure you are not replacing the config.php file but are actually replacing the parameters inside the file.
5. Navigate your browser to your CDash page. (eg. http://localhost/CDash)
   1. Note the version number on the main page. It should correctly match the new version that you are upgrading to.
   2. The following message may appear: "The current database shema doesn't match the version of CDash you are running, upgrade your database structure in the Administration panel of CDash." This is a helpful reminder to perform the following steps:
6. Login to CDash as administrator.
7. In the ‘Administration’ section, click on ‘[CDash Maintenance]’
8. Click on ‘Upgrade CDash’: This process might take some time depending on the size of your database, do not close your browser.
   1. Progress messages may appear while CDash performs the upgrade.
   2. If the upgrade process takes too long you can check in the backup/cdash.log file to see where the process is failing.
   3. It has been reporting that on some systems the spinning icon never turns into a checkmark. Please check the cdash.log for the "Upgrade done." string if you feel that the upgrade takes too long.

Backing up CDash

CDash stores all the information (except logs) in the database, so it's important to backup your database before any CDash upgrade.

MySQL

There are a couple a ways to backup a MySQL database. The easiest way is to use the mysqldump command.

Example to backup the cdash database:

 mysqldump -r cdashbackup.sql cdash

If you are using exclusively MyISAM tables you can copy the CDash directory in your MySQL data directory. Note that you need to shutdown the MySQL before doing the copy since, no file can be touched during the copy.

PostGreSQL

Similarly to MySQL, PostGreSQL has a pg_dump utility.

Example to backup the cdash database:

 pg_dump -U postgreSQLuser cdash > cdashbackup.sql

Change logs

CDash 1.4

New features

• New XML parsing using SAX parsing instead of DOM (memory efficient)
• Introduction of models (MVC framework)
• Nightly testing of CDash itself
  • http://www.cdash.org/CDash/index.php?project=CDash
• Support for subprojects (CMake/CTest CVS is required)
  • http://trilinos-dev.sandia.gov/cdash/index.php?project=Trilinos
• Support for filters
  • allows showing just error builds, or builds from multiple days, or both
  • create hyperlink to filter results and bookmark it
  • example showing error builds from 3 days ago until now:
  • http://trilinos-dev.sandia.gov/cdash/index.php?project=Trilinos&display=project&filtercount=2&showfilters=1&filtercombine=and&field1=builderrors/number&compare1=42&value1=0&field2=buildstarttime/date&compare2=83&value2=3%20days%20ago
• Improved navigation
• Improved database indexing
• Improved email reporting
• Added email for coverage
• Improved column sorting

Bug Fixes

• 0008670 Failed tests shown in orange instead of red
• 0008643 New Email summary lines
• 0008117 disallow public registration
• 0008663 Sorting 'Dynamic Analysis' field 'Labels'
• 0008708 Add config.local.php
• 0008662 'Coverage' fields 'passed', 'failed', and 'Labels' are not sorting
• 0008638 'Dynamic Analsysis' columns can not be sorted

• 0006631 Logos that are too big (tall)
• 0007736 Root directory in websvn URL must have trailing slash for websvn paths to be generated correctly
• 0007771 Nightly changes should store previous revision
• 0008103 Timing test did not fail
• 0008127 Prevent spamming
• 0007920 ViewChanges crashes ViewCVS on newly created files
• 0007570 Test submission silently fails when test output is quite large.
• 0008616 Sending subproject email address regression lists in XML and updating CDash email lists
• 0008615 Sorting the 'Min' columns is not a numeric sort.
• 0008191 pdo_query() does not work if it is not MySQL
• 0008469 Coverage broken in SVN
• 0008462 Only 412 test results shown
• 0008740 NotRun/Fail/Pass tests reports don't report what they should report
• 0007713 Upgrading Database should now use previous version
• 0007884 Ask CDash not to fill IP addresses
• 0008679 XML Parsing problem should send email
• 0008783 Email Preference not greyed out on subscription page when ""Email Broken Submission"" is unchecked
• 0007724 Configure warnings and errors should trigger email
• 0008810 When Editing a project, createProject.php get an error calling fopen."
• 0008119 use admin email address as sender address in password emails
• 0008610 content of coverage differs to Coverage.xml
• 0007855 CDash sends duplicate emails for the same build
• 0008760 build failures not being sent out for all dashboard reported build errors
• 0008730 Not sending out email notifications for failed configure?
• 0008592 Main project/subproject page should be able to filter only Nightly tests
• 0008645 Coverage testing link times out
• 0008318 viewUpdate.php with PosgreSQL fails
• 0008368 XAMPP flaws
• 0007908 Make possible to sort Code Coverage rows by submission time
• 0008468 Help not closable on small screen
• 0008484 Configure log field is too small
• 0006468 go to a bug reference from a commit log
• 0007778 User can register with the same email address
• 0008460 Upgrade to jquery 1.3
• 0007861 Upgrade from 1.0.2 to 1.2.1 breaks Groups
• 0007907 Time units missing in detailed test report
• 0008125 multiple users can share the same email address
• 0008451 Coverage should be sorted by status by default
• 0008448 cannot set CVS/SVN ViewerURL - CDash SVN trunk
• 0008287 Project name should be trimmed
• 0008254 User subscription public project
• 0008160 Performance issue when submiting test
• 0007916 Check that backup and rss directories are writable
• 0008202 Project logo not displayed with PostgreSQL
• 0008118 password recovery email seems to be bad html
• 0008113 Wrong SQL query leads to not storing results
• 0008084 Database name cannot contain minus (-)
• 0007848 CDash admin privileges lacking some key actions
• 0007847 Admin/users account can become permanently inaccessible
• 0007853 Builds sent from differnt sites can clobber each other
• 0007582 Charset encoding issues
• 0007806 MySQL error creating build groups
• 0007871 Installation check for php5-gd
• 0007805 The same image can't have multiple roles for a given test

CDash 1.2

New features

• 0006801 Test Failure History Graph
• 0007556 ViewSite page should list the users who claimed a site
• 0007499 Summarize busytime by site
• 0007204 Error summary page
• 0007537 Feature request: loggerhead support
• 0007116 Add functionality to send email to all site claimers
• 0007124 Add warning and minutes column to the cfg-column
• 0006943 Feature Request: Use Time, Pass/Fail graphs for navigation
• 0007209 add a user or group of users from the admin file without a file upload
• 0007266 seeking ViewVC support in CDash
• 0007420 Support for WebSVN
• 0006606 Support for other databases
• 0007068 Support for multiple repositories update
• 0007212 Password recovery
• 0007063 Support <Measurement> tags containing HTML
• 0006646 Compressing notes
• 0007019 Email notification of nigthly builds
• 0006466 Email when an expected nightly does not show up.
• 0007636 +- reporting on the coverage

Bugs fixed

• 0007573 Only builds from default groups show when All is selected in Global Move.
• 0007535 Tests are not sorted by build time
• 0007497 email should be sent when an expected nightly does not show up
• 0007532 Claim sites list is slow to generate and unsorted
• 0007504 <DartMeasurement> output is not SQL-escaped
• 0006492 There are no options to define "broken"
• 0007458 add_coverage produce SQL error
• 0007019 email notification of nigthly builds
• 0006842 make browser back button and the date forward/backward buttons smarter
• 0007210 time error hides number summary of test time
• 0007368 Detail in build warning/error emails
• 0007246 test summary page shows previous days builds
• 0007422 Configuration option to request full email in manage project roles
• 0007051 Timing tests have too many false positives
• 0006996 Cannot view graphs
• 0007252 OS Name and Version not displayed in viewSite
• 0007405 Number of files covered unsatisfactorily is wrong
• 0007293 CDash doesn't show all modified and conflicted files
• 0006841 show number of new errors rather than total number of errors
• 0007299 cdash install issues
• 0007262 Email always sent for experimental builds
• 0007247 URL encoding in CTestConfig
• 0007188 CDash: buildSummary.php reports update time when no update has been made
• 0007211 Better visualization of the code coverage (more prominent indication of uncovered line)
• 0007135 Timing test statistics should not sample timing value for a failing test
• 0007112 Login information not saved
• 0007113 Cannot directly link to pages in protected projects
• 0007064 CDash: CDash content of coverage differs to Coverage.xml
• 0007066 Documentation link
• 0007053 CDash loses my identity and getting it back requires manually going back to CDash start page.
• 0007052 Redirect user to login page when private project is not accessible
• 0007017 Help screen cannot be dismissed if browser window is small
• 0007021 Parse cvs/svn/git commit comments and make URL expressions clickable hyperlinks
• 0007018 Output from test is truncated
• 0007654 Coverage file are truncated
• 0007573 Only builds from default groups show when All is selected in Global Move.
• 0006492 There are no options to define "broken"
• 0007535 Tests are not sorted by build time
• 0007667 Submitting using a custom track/group name partially fails when contains a dash
• 0007668 Broken image link on database upgrade
• 0007648 Commit ordering issue in Nightly Changes page of VTK Cdash (1.0.3)
• 0007639 Build group description required by MySQL but not set by PHP build group commands

CDash 1.0.2

Bugs fixed

• 0007016 Create Group does not work under Opera and IE
• Email submission not working for individual users
• Several cosmetic fixes

CDash 1.0

Bugs fixed

• 0006384 Detecting timing defects
• 0006371 Having the number of nightly changes on the main page
• 0006497 Method to mark compile warnings, compile errors, and test failures with "fix in progress" or "fixed"
• 0006508 Test Results information is incomplete for itk
• 0006894 Wrong number of dynamic analysis defects
• 0006878 Support for timestamp CTest 2.6
• 0006612 Bad BuildTimeGraph on buildSummary page for continuous build
• 0006843 Support of different cvs/svn/web viewers
• 0006582 CVS Link to a version 1.1 file is invalid
• 0006664 Incorrect timing and detail report on viewTest page
• 0006832 Previous Build Incorrect
• 0006807 RSS feed with private project
• 0006797 Previous build on build summary page
• 0006805 Warning when backup and rss directory are not writable
• 0006798 Warning message when browsing coverage
• 0006772 Warnings when searching for emails on manageProjectRoles page
• 0006472 Add ability to remove bogus builds
• 0006601 Project administrator cannot remove an expected build if it is not submitting
• 0006471 Add a quick way to upload a cvs/svn user to password file for email notification
• 0006715 PROJECT pulldown under DASHBOARD pulldown
• 0006602 Sort by any column on the viewTest and testSummary pages
• 0006681 Fisheye URL support
• 0006653 Mouse-over build groups
• 0006655 Project logo hyperlink
• 0006942: Show Test Time Graph does not toggle in Internet Explorer
• 0006939: Separate lists of failing tests from list of passing tests

Database modification

• Added ‘description’ to table buildgroup
• Added cvsviewertype to table project
• Added index siteid in table site2user
• Added index starttime in table build
• Added index name in table test (this might take some time to run)
• Added crc32 with index in table coveragefile
• Compressing coverage (this might take some time to run)
• Add support for timestatus in build2test table