Requirements for Matrix 5.2 - 5.3
Please note that the requirements on this page are for Squiz Matrix version 5.2 and 5.3 only.
Web Browser Support
The Squiz Matrix Admin and Edit Mode editing interfaces support the following desktop web browsers and browser versions:
|Mozilla Firefox||Internet Explorer||Safari||Google Chrome|
Squiz Matrix only supports out of the box (native) installations and configurations of desktop web browsers and browser versions. For example, Squiz Matrix does not support Internet Explorer 'emulation' configurations where later versions are configured to act like older versions e.g. IE8 is told (via local and/or server side controls) to act like IE7.
The 'Toggle Source View' feature available in the Edit+ Editor for Squiz Matrix provides advanced HTML editing (line numbers, colour coding, code formatting, code folding, auto indenting, edit in new window) and has limited support for Internet Explorer. These advanced editing features fall back to standard code editing (with basic formatting) in IE8.
Some features and tools of the edit interfaces in Squiz Matrix rely on native browser features to function. Therefore, some features as outlined in this manual may not be supported for all of the web browsers listed above.
Squiz Matrix makes use of browser cookies to identify authenticated users. Your web browser must have cookies enabled in order to access the editing and administration interfaces of Squiz Matrix.
Squiz Matrix requires a UNIX-like operating system for the web server. The following operating systems are endorsed and recommended for use with Squiz Matrix:
- Red Hat Enterprise Linux 6
- Scientific Linux 6
While these operating systems are recommended and officially supported by Squiz, Squiz Matrix can potentially be run on any operating system that supports the software packages outlined below.
You can verify the program requirements of a Squiz Matrix installation against your server configuration using the system's check_requirements.php script. This script is located in the install directory of your system and will notify you of any third-party applications, PHP extensions and/or PEAR packages that are required on your installation.
Squiz Matrix supports PHP version 5.4 and 5.6.
The following PHP extensions are required:
- pdo_pgsql or oci8
When using the Suhosin patch on your PHP installation, you will need to adjust the default configuration settings, as follows:
- the suhosin.session.encrypt setting must be disabled.
- the suhosin.request.max_varname_length setting should be set to 200.
- and the suhosin.post.max_name_length setting should be set to 200.
Squiz Matrix makes use of PEAR packages to provide some functionality. The following PEAR packages are required:
Squiz Matrix is supported on the Apache web server. Version 1.3.33 or higher or 2.0.40 or higher is required. For more information on Apache 2 support, please read the PHP compatibility notes.
If you are using Apache 2 as your web server, it must be compiled with the Apache MPM prefork module or PHP will not work correctly.
Alternatively, Squiz Matrix also offers support on a Nginx web server. For more information on installing Nginx, please refer to the Beginner's Guide.
If you choose to use Nginx as your web server, we recommend utilising the OpenResty bundle, which includes many popular and useful Nginx plug-ins.
Squiz Matrix supports:
- PostgreSQL versions 9.2, 9.3, 9.4
- Oracle versions 11.1 & 11.2
Squiz Matrix supports UTF-8 character encoding only.
Some third-party tools are required to support extended functionality in Squiz Matrix. These tools must be sourced independently, installed on the server and referenced from the "External Tools Configuration" screen in System Configuration.
The following versions have been tested and are minimum requirements for the following functionality:
HTML Tidy for Linux (release date 6 Nov 2007) is required to clean HTML content for WYSIWYG containers and provide accessibility checking.
Please note that this tool is not applicable if you are using the Edit+ Editor.
Virus checking of file uploads requires the ClamAV anti-virus module version 0.94.2 or F-Prot Antivirus for Linux version 4.6.7.
Microsoft Word Conversion
Convert Word to HTML version 1.01 is required to import Microsoft Word documents into Squiz Matrix as structured page navigation. This is a Windows executable which must be configured to upload to a Squiz Matrix system directory for use with the "Word Import Tool Converter" and "Structured File Import Tool".
File Keyword Indexing
File keyword indexing support for PDF and MS Word documents requires Apache Tika version 1.8 and version 6 or later of Java installed on the server.
Image Metadata Extraction
Image metadata extraction support for Image assets requires ExifTool version 9.90.
getID3 Metata Extraction
The getID3 metadata extraction tool for FLV File, MP3 File and Video File assets requires getID3 version 1.7.9.
The Markdown bodycopy content type requires markdown version 1.0.1m and markdownify version 2.0.0 alpha.
The PPCrypto.php file and PayPal certificates are required to secure transactions between Squiz Matrix and PayPal if implementing E-Commerce using the PayPal gateway type. References to this third-party code are configured in the PayPal Payment Gateway rather than "External Tools Configuration". Further details are available on the PayPal website.
Please note that the above requirements are only applicable to the Paypal Payment Gateway asset type. The PayPal Express Checkout and PayPal Payflow Pro assets do not require these configurations.
In order for Squiz Matrix to provide federated access management, the SimpleSAMLphp application must be correctly configured and installed on the same server as your Squiz Matrix installation. Please refer to the SimpleSAMLphp Installation Guide for more information.
Recommended Squiz Matrix Stack
Squiz recommends and endorses the following stack to be the most optimal for stability, performance and security.
|Operating System||Scientific Linux 6.x/Red Hat Enterprise Linux 6.x|
|Application Server||php-fpm 5.4|
|Database Server||PostgreSQL 9.2|
|In-Memory Cache||Memcache & Redis|
|PHP OpCode Cache||Zend Opcache|
Please note that the details of the recommended Squiz Matrix stack above may change, subject to the results of future reviews, tests and endorsements from Squiz.
Squiz Matrix Operating System Support Statement
Each minor release of Squiz Matrix is supported on the major version of the Operating System (OS) it was originally released on until either the OS vendor ceases support for the OS or 36 months elapse since that Minor release of Squiz Matrix was released.
For most OSs', security and maintenance fix updates are only provided for the latest minor version of that OS, so users will need to update their OS installation to the latest minor version of the OS to continue receiving security and maintenance fixes for the entirety of the supported period.
Squiz Matrix updates may also require packages additional to those provided by the OS and these will be indicated in the release notes for each version of Squiz Matrix.
For example, Squiz Matrix 5.3 was released in November 2015 and is fully supported until November 2018. At release, it was tested and certified on Red Hat Enterprise Linux version 6, which is supported by Red Hat until November 30, 2020.
This means users can build a server with Squiz Matrix 5.3 and Red Hat Enterprise Linux 6 today, and retain that server as a fully supported configuration simply by applying OS package and Squiz Matrix updates until November 2018.