MySource Matrix has been superseded by Squiz Matrix. This site will remain available for archival purposes only; it is not intended as a current source of Matrix information. For all the latest on Matrix, including documentation and release information, visit the Squiz Matrix site.
Site Search
Content Tools
Main Content
Standard Minor Version Upgrade Guide
Backup
No matter how small the upgrade is, always backup your system before starting. See the MySource Matrix backup management guide for information on how to backup your MySource Matrix system.
Getting the New Source Code
The first thing you need to do is update the MySource Matrix source code. You can find out how to download the latest stable version of MySource Matrix on the installation page, or you can download older versions from the downloads page.
Once you have downloaded the source code, you need extract the source code over the top of your existing installation. This will not reset any configuration options or remove any content from your system.
The commands required differ slightly depending on whether you are upgrading a PHP 4-based version (up to 3.16.x), or a PHP 5-based version (3.18.x onward). The latter requires more commands, to preserve baked (cached) system database queries that exist in these versions.
These steps assume MySource Matrix is installed at /home/websites/mysource_matrix and that a tar.gz archive with the new source code exists within /home/websites
Versions up to 3.16.x
$ cd /home/websites $ tar -xzvf new_source.tar.gz
Versions from 3.18.x onwards
$ cd /home/websites $ mv mysource_matrix mysource_matrix_3-x-y $ tar -xzvf new_source.tar.gz $ cd mysource_matrix $ cp -r /home/websites/mysource_matrix_3-x-y/data . $ cp -r /home/websites/mysource_matrix_3-x-y/core/lib/DAL/Oven core/lib/DAL $ cp -r /home/websites/mysource_matrix_3-x-y/core/lib/DAL/QueryStore core/lib/DAL
Run the Upgrade Scripts
There are three scripts that are used during the MySource Matrix installation procedure that are also used during upgrading.
$ cd /home/websites/mysource_matrix $ php install/step_02.php /home/websites/mysource_matrix $ php install/compile_locale.php /home/websites/mysource_matrix $ php install/step_03.php /home/websites/mysource_matrix $ php install/compile_locale.php /home/websites/mysource_matrix
Fix File System Permissions
Some directories of MySource Matrix require read and write permission for the user that the Apache web server is run as. All other directories should be read-only for the Apache user.
The example below assumes your Apache web server is running as the user "apache" and with the group "apache" and that you own all the files in /home/websites/mysource_matrix.
$ chmod -R 755 /home/websites/mysource_matrix $ cd /home/websites/mysource_matrix $ chown -R apache:apache data cache $ chmod -R g+w data cache
Upgrade Complete
Your minor version upgrade is now complete. Log out of the administration interface to ensure all changes have taken effect.