Customer Portal
1.4 Upgrading TestRail
This topic explains how to upgrade an existing TestRail installation to a new version. Please follow these steps to upgrade your TestRail installation:
1. Backup
It is strongly recommended to make a backup of your TestRail installation files and TestRail database before upgrading to a newer version. In case there's a problem with the upgrade, a backup is the only way to roll back the changes and revert to your previous (working) installation. We recommend making backups of your TestRail installation and database regularly, and especially before upgrading to a newer version.
2. Replace installation files
To upgrade your TestRail installation, upload and extract the TestRail installation
files to your web server and copy the files of the new TestRail version over your existing
installation files. You can just replace all files, as files that are unique to your installation
(e.g. the config.php file) aren't part of the
installation archive.
3. Upgrading the database
Some, but not all, TestRail upgrades also need to upgrade the TestRail database. If a database upgrade is required, TestRail will automatically redirect you to the database upgrade screen when you access TestRail with your web browser. Only administrators can upgrade the database and all other users won't be able to access TestRail until the database upgrade has been completed.
After completing the database upgrade (if a database upgrade was required by the new TestRail version you just installed), your updated TestRail installation is ready to use.
