Updating your LORIS

We recommend upgrading to the most recent LORIS release.

See additional notes at bottom for Imaging projects

The LORIS team provides support (on a best-effort basis via the Loris-dev mailing list) for the last 2 releases of LORIS (including minor releases), and does not support pre-release development branches.

If you are a developer working on a development branch, note that the master branch reflects the last stable release.

Update your LORIS in a few steps:

Important If you are upgrading from multiple versions, e.g 20.0 to 21.0, you must first upgrade to each minor release (e.g. 20.1, 20.2, 20.3) in between, before upgrading to the next major release.

Consult the Release notes for the Upgrade Process specific to each release. Back up your database and code customizations before beginning. The typical steps are:

• Update your dependencies
• Apply the Release Patch to the database
• Run any upgrade scripts provided
• Update or merge custom code to work with the new release, if necessary
• Update data to match type/column modifications, if necessary

Upgrade tips

• Clear both your Browser cache and cached templates rm -f /var/www/loris/smarty/templates_c/* - note _c (i.e. do not clear smarty/templates/)
• Ensure your admin user has all available permissions:

INSERT IGNORE INTO `user_perm_rel` (userID, permID) SELECT DISTINCT 1, permID FROM permissions;

• Good to note: Pull requests tagged with Caveat for Existing Projects mean that there may be changes to your data after upgrading.
• It may help to update tables to utf8 character set:

    ALTER TABLE users CONVERT TO CHARACTER SET utf8;

Imaging projects

Update your Loris-MRI code to the latest Loris-MRI release and carefully review the Loris-MRI release notes for changes to the imaging pipeline scripts, config files and tables, and follow all recommended steps for Existing Projects.