Workspace updater


Version 2.0 of MAT introduced an entirely new internal structure for workspaces. The MAT 2.0 workspace engine will not work on workspaces created with previous versions of MAT. You can use this tool to create a 2.0-compliant copy of your pre-2.0 workspaces.

This new workspace must be a copy. You cannot convert your existing workspace to a 2.0-compliant workspace; while we've tested this utility, there's always the possibility that something will go wrong or some data will get lost, and we don't want to overwrite your existing data. Note, however, that once you create your copy, the two workspaces will be completely distinct; except in grave circumstances, you should archive your old workspace as a precaution and work only with the new workspace using MAT 2.0.



% $MAT_PKG_HOME/bin/MATUpdateWorkspace1To2

Windows native:

> %MAT_PKG_HOME%\bin\MATUpdateWorkspace1To2.cmd

Usage: MATUpdateWorkspace1To2 [options] old_workspace new_workspace initial_user

old_workspace: a pre-2.0 MAT workspace directory
new_workspace: a location for your 2.0-compliant workspace copy. This directory must not already exist.
initial_user: a user to register as the first user for your workspace

Note that 2.0 workspaces require all operations to be attributed to a user, so you must declare at least one user when you create a 2.0 workspace. This user does not need to match your login name (or any name, for that matter), but it's probably less confusing if you use login names.

This tool copies over all files, and records their proper status, as well as creating any custom folders which your task requires.


MATUpdateWorkspace1To2 makes the common options available.


Let's say you have a pre-2.0 workspace in /data/myworkspace, and you want to create a 2.0-compliant workspace in /data/2point0/myworkspace, and you want your first user to be user1:


% $MAT_PKG_HOME/bin/MATUpdateWorkspace1To2 /data/myworkspace /data/2point0/myworkspace user1

Windows native:

> %MAT_PKG_HOME%\bin\MATUpdateWorkspace1To2.cmd C:\data\myworkspace C:\data\2point0\myworkspace user1