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

MySource Matrix Requirements

Introduction

What platform do you need if you are considering installing MySource Matrix?

MySource Matrix is an open source content management system (CMS) written in PHP. This page lists the software requirements of MySource Matrix.

Operating System

In general, MySource Matrix requires a UNIX like operating system for the web server, but can be run on any operating system that supports the software packages outlined below.

You are free to choose any preferred operating system, however, the following operating systems have been tested and used for either development or production systems by Squiz:

  • Red Hat Enterprise Linux (RHEL) 5
  • CentOS 5

Software

PHP

Version 4.0.0 and later

Support for PHP 5.3

Version 3.22.2 and later

Support for the new JS API Asset in the Web Services Package requires PHP 5.2.0 or later, which is preconfigured for JSON support, or the PEAR package requirement below. PHP 5.3 is not supported.

Version 3.18.x and later
The following additional compile time options are required for the TRIM, Sharepoint and Web Services modules.

PHP requires the following compile time options:

  • enable-soap

MySource Matrix version 3.18.x and later requires PHP version 5.1.6 or later. PHP 5.3 is not supported.

PHP 5.1.6 was chosen as a baseline due to it being the version of PHP that is packaged with Red Hat Enterprise Linux (RHEL) version 5. This baseline will be reviewed upon the release of RHEL version 6.
Version 3.16.x and earlier

MySource Matrix version 3.16.x and below requires PHP version 4.4 or greater.

PHP requires the following compile time options:

  • enable-bcmath
  • enable-gd-native-ttf
  • enable-inline-optimization
  • enable-mbstring
  • enable-memory-limit
  • enable-shmop
  • enable-sockets
  • enable-wddx
  • with-curl
  • with-gd
  • with-jpeg-dir
  • with-ldap
  • with-openssl
  • with-pear
  • with-pgsql
  • with-png
  • with-pspell

Note: Some of these options may require external libraries to be installed. For example, the --with-pspell option requires the Aspell libraries and at least one Aspell dictionary installed. The --with-curl option requires the libcurl package installed.

PEAR

MySource Matrix makes use of PEAR packages to provide some functionality. The following PEAR packages are required by MySource Matrix.

  • DB
  • Archive_Tar
  • Mail
  • Mail_Mime
  • XML_HTMLSax
  • XML_Parser
  • Text_Diff

The following additional PEAR packages are required for the SSV modules.

  • Mail_Queue
  • HTTP_Request
  • HTTP_Client
  • Net_URL
  • Image_Graph
  • Image_Color
  • Image_Canvas
  • Numbers_Roman
  • Numbers_Words

Please refer below for any specific module versions required for your Matrix installation.

Version 3.28.0 and later

The Set Twitter Status Trigger Action which were added to this release requires the I18N_UnicodeNormalizer PEAR package, version 1.0.0 to be installed.

Version 3.24.1 and later

The asset locking and cache storage enhancements using Memcache which were added to this release requires the memcache PECL module, version 2.0.0 to be installed.

Version 3.22.2 and later

Support for the new JS API Asset in the Web Services Package requires the Services_JSON PEAR package, version 1.0.0. Alternatively the PHP version specified for this release can be used.

Version 3.20.0 and later

MySource Matrix version 3.20.0 and later requires the following PEAR module versions (or later):

  • HTTP_Client 1.1.1 (minimum), 1.2.1 (tested and recommended)
  • Net_URL 1.0.15

Version 3.18.11 and later

Please note that HTTP_Client 1.2.1 is not supported in installations of MySource Matrix 3.18.11 and later. HTTP_Client 1.1.1 is recommended for such installations. HTTP_Client 1.2.1 is supported in our MySource Matrix 3.20.x releases.

Version 3.18.0 and later

MySource Matrix version 3.18.0 and later requires the following PEAR module:

  • MDB2 (with corresponding driver, pgsql or oci8)

Prior versions

If you are using MySource Matrix version older than 3.14.5 and 3.16.1, it is recommended that you use Mail_Queue version 1.1.3 instead of the latest 1.2.1 (as of 23 Oct 2007)

Web Server

MySource Matrix is currently only supported on the Apache web server. Version 1.3.33 and 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 Apache2 as your web server, it must be compiled with the Apache MPM prefork module or PHP will not work correctly.

Database

MySource Matrix uses a database as its primary data store. MySource Matrix supports both the PostgreSQL open source database and Oracle.

PostgreSQL

MySource Matrix supports PostgreSQL version 7.4.x or greater. PostgreSQL 8.3.x is only supported by MySource Matrix 3.18.1 or later.

PostgreSQL 8.x versions have significant performance benefits and are strongly recommended over 7.x versions.

It is recommended that Solaris deployments running PostgreSQL should be running Solaris 10. Find out more about PostgreSQL on Solaris.

Oracle

MySource Matrix supports versions 9i (9.2.0.1 and greater) 10g and 11g (Release 1) of the Oracle database.

Oracle 10g is the recommended minimum version for Solaris installations.

Third-Party Tools

Some third-party tools are required to support extended functionality in Matrix. These tools must be sourced independently, installed 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:

For MySource Matrix 3.24.x and later:

  • IP Board 3.0.2 (tested version) - If the IPB Package is being deployed to bridge between Matrix and the forums, this version of IP Board is now compatible with the IPB Package code in this version of Matrix.

For MySource Matrix 3.22.x and later:

  • PayPal supporting code and certificates - the PPCrypto.php file and PayPal certificates to secure transactions between Matrix and PayPal are required if implementing E-Commerce using this gateway type. References to this third-party code are configured in the PayPal Gateway rather than "External Tools Configuration". Further details are available on the PayPal website

For MySource Matrix 3.20.x and later:

  • antiword 0.37 - search indexing for Word files document text.
  • ClamAV anti-virus module 0.94.2 or F-Prot Antivirus for Linux 4.6.7 - virus scanning of uploaded File assets is performed on the server when configured
  • Convert Word to HTML 1.01 - converts Word files for Matrix. This is a Windows executable which must be configured to upload to a Matrix system directory for use with the "Word Import Tool Converter" and "Structured File Import Tool".
  • getID3 1.7.9 - media metadata extraction support in the FLV File, MP3 File and Video File assets.
  • HTML Tidy for Linux (release date 6 Nov 2007) - HTML cleaning for WYSIWYG containers.
  • JPEG Metadata Toolkit 1.11 - image metadata extraction
  • markdown 1.0.1m - converts text written in markdown format into HTML (markdown is a content type option for bodycopies)
  • markdownify 2.0.0 alpha - converts HTML into markdown format
  • pdftohtml 0.36 - search indexing for PDF document text.

Web Browser

To use all of the editing functionality of MySource Matrix you must use one of the following supported web browsers:

  • Internet Explorer 6 or greater (Windows)
  • Firefox 1.5 or greater (Windows, Mac OS X, Linux)
  • Safari 3.0 or greater (Windows, Mac OS X)

Some components of the MySource Matrix administration interface require that your web browser have access to the Java Runtime Environment (JRE) 1.5+ (the latest version of which can be downloaded from http://www.java.com/getjava/).