MySource Matrix Developer

Public CVS Access

Web Repository browsing

Access to the GPL code in Matrix is now publicly available. A web-based interface to the CVS repository is provided at http://public-cvs.squiz.net/.

Automatic checkout script

A checkout script is available to install Matrix from a command-line invocation of CVS. This script runs under a Linux or a Mac environment and requires familiarity with using command line tools.

Instructions on how to use this script are given when running the script as follows:

$ sh checkout.sh

This script will check out MySource Matrix based on a version number you supply into a dirrectory named "mysource_matrix". Version numbers reflect release versions. They are named the same way: mysource_3-xx-y. For example, if you want Matrix 3.24.2, the version number will be mysource_3-24-2.

In order to check out a copy of MySource Matrix 3.24.2, please run the script as follows:

$ sh checkout.sh mysource_3-24-2

Matrix may be installed to a new directory (other than "mysource_matrix"). In order to do so, the directory name should be specified as a second argument to the script. For example:

$ sh checkout.sh mysource_3-24-2 test_checkout

...will check out a copy of MySource Matrix 3.24.2 to a directory named "test_checkout". The output of the script will be displayed as follows:

Checking out mysource matrix core ..
Checking out mysource matrix packages ..
Everything has been checked out into the test_checkout/ folder.
Please visit http://matrix.squiz.net/resources/installation/ for installation instructions.

Manual checkout process

There are multiple packages to check out if accessing the repository via a manual run of the cvs command. The core matrix code is available through the following cvs pserver identifier:

anonymous@public-cvs.squiz.net:/home/public/core

There is no password for the anonymous user.

Matrix Core

To check out the core matrix code, please run the following command:

cvs -d :pserver:anonymous:@public-cvs.squiz.net:/home/public/core checkout mysource_matrix

Fudge Package

The next package to check out is the "fudge" package. This package contains WYSIWYG and other core libraries and components. This package must be checked out to the mysource_matrix/fudge folder so before checking it out, please change to that directory:

cd mysource_matrix/fudge

The cvs root details for the "fudge" package is as follows (again through cvs pserver and no password):

anonymous@public-cvs.squiz.net:/home/public/fudge

The command to check out the "fudge" package is:

cvs -d :pserver:anonymous:@public-cvs.squiz.net:/home/public/fudge checkout .

Please note the trailing dot on the end of the above command which is required.

Non-core Packages

The final packages to check out are those which provide non-core Matrix assets. These must be checked out to the mysource_matrix/packages directory. Please change to this directory first:

cd mysource_matrix/packages

Each one is kept in a separate repository - currently we have the following packages available as GPL:

• bulkmail
• calendar
• cms
• data
  
• ecommerce
• filesystem
• funnelback
• google_maps
  
• import_tools
• ipb
• ldap
  
• news
• rest
  
• search
• sharepoint
• squid
• trim
• web_services

The cvs root for each package is in the format:

anonymous@public-cvs.squiz.net:/home/public/packages/PACKAGE_NAME

for example:

anonymous@public-cvs.squiz.net:/home/public/packages/bulkmail

The checkout command for each package is similar to that for the the "fudge" package. To check out the bulkmail package, please run the following command:

cvs -d :pserver:anonymous:@public-cvs.squiz.net:/home/public/packages/bulkmail checkout .

At a minimum, the cms package is required for basic Matrix functionality.

Next steps

A working version of MySource Matrix should now be available in the specified directory. Please visit the Matrix Installation Page for further instructions regarding initial system setup.