Upgrading

Main Page > Administrator manual > Upgrading

Document in progress!

Preliminary considerations

This guide explains how to upgrade to ICA-AtoM 1.3. If you want to upgrade to an older release, please refer to the Qubit upgrading documentation. However, we strongly recommend our users to install the latest release because it is safer, faster and more stable and includes all kind of new features and enhancements.

Check requirements

Please refer to the Minimum requirements page to make sure that your system meets all the requirements.

Read the release notes

Now's the time to find out what has been changed in the new release, there are some new features, enhancements and bug fixes that may be of your interest.

Back up existing files and the database

Before proceeding with the upgrade, please make a full backup of all your data following our instructions: Data backup.

Unpack the new files

If you wish to install to the same directory as your previous version you must remove the old installation directory first. Moving the existing directory, rather than deleting it, preserves any digital objects, custom files or translations for transfer to the new version of the application. For example:

$ mv /var/www/icaatom /var/www/icaatom_old

Download the latest ICA-AtoM tarball and extract it in a new directory of your web root. For example, to extract the icaatom-1.3.0.tgz tarball to the /var/www/icaatom-1.3.0 directory, type:

$ tar xvzf icaatom-1.3.0.tgz -C /var/www

Now, please set the file and directory permissions as explained.

Run the installer

See Installation for instructions on running the web-based application installer. Remember to create a new database for this installation, you don't want to use the old one because the installer would erase all the data.

Copy the data

At this point, you should have an ICA-AtoM functional installation using the new fresh database. Now we are going to copy the contents of the old uploads directory as well as the database:

1. rsync is a robust directory sync solution that we can use to copy the contents of your old uploads directory to the new one, even when both directories are in the same machine:

   $ rsync -av /var/www/icaatom_old/uploads /var/www/icaatom/uploads

   Alternatively, you can just use cp:

   $ cp -r /var/www/icaatom_old/uploads /var/www/icaatom/uploads

2. Load the contents of your old database into the new one. There are different ways to do that, for example:

   $ mysqldump -u username -p old_database | mysql -u username -p new_database

Run the upgrade task

Change the current directory:

$ cd /var/www/icaatom

Now, run the upgrade-sql task:

$ php symfony tools:upgrade-sql

tools:sql-upgrade is the most critical step of this guide. If you get an error, please read our FAQ below to answer any question.

Migrate translations

TODO

Rebuild search index

Due to data changes during the upgrade process, you will need to rebuild the search index after upgrading:

$ php symfony search:populate QubitSearch

Clear cache

Clear your cache to remove any out-of-date data from the application,

$ php /var/www/icaatom/symfony cc

See Clear cache for more detailed instructions.

Test the upgrade

TODO

Frequently asked questions

Cache error

TODO

tools:sql-upgrade error

TODO

What else I can do?

TODO