pg_migrator
-----------
Version 8.4


What it Does
------------

pg_migrator allows data stored in Postgres data files to be migrated
to a later Postgres major version without the dump/reload of data
typically required for major version upgrades, e.g. 8.3.7 -> 8.4.1.
It is not required for minor version upgrades, e.g. 8.4.1 -> 8.4.5.


Limitations
-----------

Currently pg_migrator only supports upgrades from 8.3.X to 8.4.X.
Only PostgreSQL 8.4 RC1 or later can be used;  8.4 Beta cannot.

pg_migrator will not work if:

	o  a user column is of data type tsquery
	o  a user column is of data type 'name' and is not the first column

pg_migrator will require a table rebuild if:

	o  a user column is of data type tsvector

pg_migrator will require a reindex if:

	o  an index is of type hash or gin
	o  an index uses bpchar_pattern_ops

Also, the default datetime storage format changed to integer in Postgres
8.4.  pg_migrator will check that the datetime storage format used by
the old and new clusters match.

For Windows users, note that due to different integer datetimes settings
used by the one-click installer and the MSI installer, it is only
possible to upgrade from version 8.3 of the one-click distribution to
version 8.4 of the one-click distribution. It is not possible to upgrade
from the MSI installer to the one-click installer.

All failure, rebuild, and reindex cases will be reported by pg_migrator
if they affect your installation;  post-migration scripts to rebuild
tables and indexes will be automatically generated.  


Installation
------------

See the INSTALL file for detailed installation instructions.  For
deployment testing, create a schema-only copy of the old cluster, insert
dummy data, and migrate that.


Help
----

The pg_migrator web site is http://pgfoundry.org/projects/pg-migrator/.
To submit a bug report or get assistance, email 
pg-migrator-general@pgfoundry.org.  The most current pg_migrator release
is at http://pgfoundry.org/frs/?group_id=1000235.


Additional Files
----------------
CHANGES		release changes
DEVELOPERS	information for pg_migrator developers
IMPLEMENATION	implentation details
INSTALL		installation instructions
LICENSE		pg_migrator license
README		this file
TODO		TODO items
