MySource Matrix Resources

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.

Content Tools

Main Content

Upgrading MySource Matrix from v3.28.1 to v3.28.2

Introduction

This guide will help you upgrade an existing MySource Matrix version 3.28.1 installation to version 3.28.2.

This upgrade requires you to have access to:

  • update the MySource Matrix source code
  • edit the MySource Matrix configuration files

This guide assumes that your MySource Matrix installation is located at /home/websites/mysource_matrix. Please change any commands to the appropriate location if your installation is located elsewhere.

Backup

Before starting any upgrade, always backup your MySource Matrix installation. See the MySource Matrix backup management guide for information on how to backup your MySource Matrix system.

Disable Rollback

At this point, you need to ensure that rollback is disabled before continuing. For help with disabling rollback, see the MySource Matrix rollback management guide.

Get the New Source Code

Now, you need to update the MySource Matrix source code. You can find out how to download the latest stable version of MySource Matrix on the installation page.

Once you have downloaded the source code, you need to replace the existing code with the newer version. This will not reset any configuration options or remove any content from your system.

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 
$ cd /home/websites
$ mv mysource_matrix mysource_matrix_3-28-1
$ tar -xzvf new_source.tar.gz
$ cd mysource_matrix
$ cp -pr /home/websites/mysource_matrix_3-28-1/data .
$ cp -pr /home/websites/mysource_matrix_3-28-1/core/lib/DAL/Oven core/lib/DAL
$ cp -pr /home/websites/mysource_matrix_3-28-1/core/lib/DAL/QueryStore core/lib/DAL

Full System Upgrade

Now, the system's installation scripts should be run to ensure the asset types and language translations are up to date.

$ 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

Regenerate the SOAP Server WSDL File

Enhancements have been made to the Web Services package to hide the parameters of functions that are not enabled in a SOAP server's WSDL file. Previously, this file would display parameters based on the SOAP API services that were enabled on the SOAP Server. For example, if you had enabled the SOAP API Asset service on the SOAP server, the parameters of every function within that service would appear in the WSDL file, regardless of whether or not the functions were enabled on the service. This not only cluttered the WSDL with unnecessary parameters but also allowed users to view the parameters required for functions that were not being used.

If you have a SOAP configuration in your system, you will need to regenerate the WSDL file on the Details screen of the SOAP server before these changes will be committed.

Re-enable Rollback

If you needed to disable rollback at the beginning of this upgrade, you may now re-enable it. For help with enabling rollback, see the MySource Matrix rollback management guide.

Upgrade Complete

The upgrade of your MySource Matrix system from version 3.28.1 to 3.28.2 is now complete.