Product SiteDocumentation Site

2.5. Upgrading

This chapter explains how to upgrade an existing MantisBT installation.
Start by Performing the steps described in Section 2.3, “Pre-installation / upgrade tasks” above.
  1. Put the site down for maintenance
    cp mantis_offline.php.sample mantis_offline.php
    This will prevent users from using the system while the upgrade is in progress.
  2. Always Backup your code, data and config files before upgrading !
    This includes your Mantis directory, your attachments, and your database. Refer to Section 2.10, “Backups” for details.
  3. Copy the configuration files
    To preserve your system settings, you should copy the files listed below to subdirectory config of the new directory. You might have to copy as well other custom files such as logo, favicon, css, etc.
    config_inc.php, the Custom Strings File (custom_strings_inc.php by default, see Section 7.1, “Strings / Translations”), custom_constants_inc.php and custom_functions_inc.php
  4. Execute the upgrade script. From your web browser, access
    where mantisbt-NEW is the name of the directory where the new release was extracted
  5. Provide required information for the upgrade
    • high-privileged database account
      Additional privileges required: INDEX, CREATE, ALTER, and DROP
      If this account is not specified, the database user will be used.
  6. Click the Install/Upgrade Database button
  7. At the end of the upgrade, review and correct any warnings or errors.

Upgrading large databases

When processing large databases from versions older than 1.2, the upgrade script may fail during the conversion of date fields, leaving the system in an inconsistent (i.e. partially updated) state.
In this case, you should simply restart the upgrade process, which will resume where it left off. Note that you may have to repeat this several times, until normal completion.
Reference: MantisBT issue 12735.