Basic GTM Journaling

From VistApedia
Jump to: navigation, search

Here are the most basic instructions to turn on and use journaling. I suggest you do this for any database files that are not throw-away.

-- Turn on before image journaling:

$gtm_dist/mupip set -journal="enable,on,before" -file mumps.dat

-- Recover a database file using the journal:

$gtm_dist/mupip journal -recover -backward mumps.mjl

-- Create a new journal file (the old journal file has a name of the form mumps.mjl_yyyydddhhmmss where ddd is the day of the year, e.g., today, June 24, 2009, is day 175):

$gtm_dist/mupip set -journal="on,before" -file mumps.dat

This assumes that the database file is mumps.dat and the journal file is mumps.mjl. GT.M doesn't restrict the name, and databases can be multiple regions. But these three commands are the most basic. Please use them so that you don't need a rundown to recover your database after a system crash.

-- Backup database (creates a new journal file; substitute backup directory for /tmp/ in the following):

$gtm_dist/mupip backup "*" /tmp/

You should periodically review journal file usage and archive/delete previous generation journal files.

If you need anything more sophisticated, please go through the self-paced exercises in the GT.M Acculturation Workshop.