NAME

pmx-pg-migrate - A utility for transferring data from PostgreSQL 7.x to PostgreSQL 8.x.


SYNOPSIS

pmx-pg-migrate [options]


DESCRIPTION

As of version 5.5, PureMessage includes an improved version of PostgreSQL. If you are upgrading to version 5.5 or later from a previous version of PureMessage, the new version of PostgreSQL will be added to your installation, but it will be disabled by default.

To begin using PureMessage with PostrgeSQL 8.x, you must first transfer your data from the old version of PostgreSQL to the new version of PostgreSQL using pmx-pg-migrate.

Before starting the migration, stop PureMessage, and ensure that your PureMessage database server has the minimum shared memory allocation (as described in the 'Tuning PostgreSQL for PureMessage 5.x' article in Sophos's online Knowledgebase).

Ensure that you have sufficient disk space to create a backup of your data before performing the migration. The data stored in a temporary directory that is created during the migration (/opt/pmx/home/ by default).

The time required for a migration will vary, according to the size of your database.

Following the migration, you must run pmx-pg-switch to configure PureMessage to use the new version of PostgreSQL. you must run the pmx-pg-switch command as the root user.


OPTIONS

--tmpdir
The location of the temporary directory where PostgreSQL data will be stored during the migration. The default is /opt/pmx/home/.


SEE ALSO

the pmx-pg-switch manpage


COPYRIGHT

Copyright (C) 2000-2008 Sophos Group. All rights reserved. Sophos and PureMessage are trademarks of Sophos Plc and Sophos Group.