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 taking a long time and/or 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.
   4. CDash 1.4: new indexes for the database have been added. The indexes touch the test and coverage tables and might take a long time to upgrade, just be patient and check the backup/cdash.log file to see the current progress of the update. On a 50GB database the upgrade took about 2 hours.
9. Note: Some web browsers are having issue when upgrading (some javascript variables not passed correctly), in that case you can perform individual updates:

 http://yourURLtoCDash/backwardCompatibilityTools.php?upgrade-1-4=1

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.6

New features

• Support for persistent login
• Better database compression
• New graphs and reports
• Improved coverage visualization
• Better CTest communication
• Expected submission time based on historic average
• Faster load of the main dashboard page
• Improved navigation links
• Remote build management (beta)

Bugs fixed

• 0009174 tracing regressions
• 0009276 Postgres does not like the build warnings with '\\' in them
• 0010106 Marking "new" test failures on dashboard "view-failed-only" page.
• 0008735 add ability to get email for missing builds on sites you do not own
• 0008126 Improve Morale
• 0009991 show which failures are new
• 0010027 Feature Request: Compression of test output in the database
• 0008341 itkrobot doesn't trigger message
• 0010071 Empty iphone project page
• 0009790 URL into Trac svn browser wrong
• 0008854 Sort columns in "Manage Coverage Page"
• 0009279 Allow --username for subversion
• 0008171 Display longer history for a single build
• 0008036 Filter out submissions based on IP address
• 0007670 Delta on tests is nice but can mask actual status change.
• 0008965 identify builds that my commit first appear in
• 0007731 Graph of warnings and errors over time
• 0009933 Configurable Tracker URL
• 0007398 groups have "issues"
• 0009928 Updated file count is always 0 for new submissions
• 0008585 Maintainer page
• 0008271 Activity graph
• 0009848 "Edit subscription" should have a project-selection combo box
• 0009820 Links/navigation are partly confusing
• 0008367 Warnings and Errors are set to zero by default
• 0009138 Project names with chars that must be escaped generate incorrect URLs
• 0009295 "Time spent per project" only tracks last build
• 0008948 Update.xml parsing should classify updated/modified/conflicting based on xpath
• 0008736 better looking coverage
• 0009856 "Dashboard" doesn't take me to dashboard for the project
• 0009823 Build summary page should link to pieces
• 0009855 Unsubscribing as project admin
• 0009857 list of "Show public projects" not sorted
• 0009034 Please add a "Show Coverage Percentage Graph" link to the buildSummary page for coverage builds
• 0009669 Coverage page sorting is slow
• 0008425 Flot doesn't work with IE 8 beta
• 0008204 submission should not process files
• 0009891 Build::GetIdFromName() doesn't check projectid for subproject
• 0009890 Deleting project doesn't delete subprojects and labels
• 0009818 Description is escaped for project
• 0009815 projects not sorted on "My CDash" page
• 0009794 CDash "forgets" me very fast...
• 0009788 Dynamic Anyalsis truncated
• 0009063 Display expected submission time based on historical average for expected builds that have not submitted yet
• 0009706 Non-anonymous LDAP authentication (e.g. for Active Directory) - feature request and example implementation
• 0009677 MySQL with STRICT_TRANS_TABLES fails
• 0009668 Cannot move builds from index page on Chrome
• 0009644 Only test timings after last database upgrade are shown
• 0009338 Showing updates files does not work with PostgreSQL
• 0009630 r1964 broke CDash when using PostgreSQL
• 0009322 Show changes in test results
• 0009154 build errors not issuing emails
• 0009522 Persistent login
• 0009359 Unable to invite users
• 0009277 Database update is always needed
• 0009340 Production mode shouldn't display install.php
• 0009120 CDash generates wrong diff URLs for ViewVC (at least on NITRC.org)
• 0009296 Passed test should not have "error" table background
• 0009294 Processor information of build host is not parsed correctly
• 0009266 Cannot remove Site
• 0008957 Remember me login
• 0008931 Need a way to "unclaim" a site that no longer submits
• 0008881 Improve support for white spaces to NamedMeasurement with type text/string and/or text/plain types

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
• Support for labels on builds, tests, coverage files
  • use CVS CMake/CTest and set target, test or source file property LABELS
• 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