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.
Unix:
% $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:
Unix:
% $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