Using pg upgrade on Ubuntu/Debian

From PostgreSQL wiki

(Difference between revisions)
Jump to: navigation, search
(Where do I get PostgreSQL 9.2?)
(Where do I get PostgreSQL 9.2?)
Line 71: Line 71:
 
  sudo apt-get install postgresql-<span style="color:red">9.2</span> postgresql-contrib-<span style="color:red">9.2</span> postgresql-server-dev-<span style="color:red">9.2</span>
 
  sudo apt-get install postgresql-<span style="color:red">9.2</span> postgresql-contrib-<span style="color:red">9.2</span> postgresql-server-dev-<span style="color:red">9.2</span>
  
'''Warning:''' Support for the current major version in the PPA may be dropped earlier when a new major version is released. Be prepared to upgrade to the next major version when the older is no longer supported.
+
'''Warning:''' Support for the current major version in the PPA may be dropped when a new major version is released. If you want to use this PPA, be prepared to always upgrade to the newest major version soon after it's released.

Revision as of 12:31, 26 October 2012

Instructions for how to convert/upgrade a PostgreSQL database cluster using pg_upgrade on Ubuntu or Debian. For the sake of example, I'm upgrading from version 9.1 to 9.2, but it should work with any version. Replace any version numbers on the command lines.

Contents

WARNING!

These instructions are experimental!

  • This way of upgrading is not yet supported by Ubuntu upstream. Do it at your own risk. I have tested this on Ubuntu 12.04.
  • PostgreSQL 9.2 is still a testing release (currently at RC 1). Do not run it in production!

When in doubt, use the old but slower pg_upgradecluster method.

Prerequisites

First you need to install relevant packages: postgresql-VER and postgresql-server-dev-VER. If you're using contrib extensions, you also need postgresql-contrib-VER, and possibly other modules like postgresql-plpython-VER...

sudo apt-get install postgresql-9.1 postgresql-contrib-9.1 postgresql-server-dev-9.1 \
                     postgresql-9.2 postgresql-contrib-9.2 postgresql-server-dev-9.2

By default, Ubuntu creates a database cluster named "main" with each installed version. We will use these. Verify that these are configured:

# sudo pg_lsclusters
Version Cluster   Port Status Owner    Data directory                     Log file
9.1     main      5432 down   postgres /var/lib/postgresql/9.1/main       /var/log/postgresql/postgresql-9.1-main.log
9.2     main      5433 down   postgres /var/lib/postgresql/9.2/main       /var/log/postgresql/postgresql-9.2-main.log

Upgrading

First you need to stop the relevant database clusters. To stop all clusters, run:

sudo /etc/init.d/postgresql stop

(If you don't want to stop all clusters, you can also use pg_ctlcluster to manage them one by one)

Do the upgrade... (For extra performance, you can use the --link option to pg_upgrade; please read pg_upgrade documentation first)

cd /tmp
sudo -H -u postgres /usr/lib/postgresql/9.2/bin/pg_upgrade \
   -b /usr/lib/postgresql/9.1/bin \
   -B /usr/lib/postgresql/9.2/bin \
   -d /var/lib/postgresql/9.1/main \
   -D /var/lib/postgresql/9.2/main \
   -o '-c config_file=/etc/postgresql/9.1/main/postgresql.conf' \
   -O '-c config_file=/etc/postgresql/9.2/main/postgresql.conf -F'

See if it worked...

sudo pg_ctlcluster 9.2 main start
sudo -u postgres psql --cluster 9.2/main
postgres=# select version();
PostgreSQL 9.2rc1 on x86_64-unknown-linux-gnu, compiled by gcc (Ubuntu/Linaro 4.6.3-1ubuntu5) 4.6.3, 64-bit
postgres=# \l+
... list of databases ...

What next

Don't forget to merge your configuration changes in postgresql.conf, pg_hba.conf and other files.

If you upgraded from 9.0 or earlier and you're using contrib modules or other addons, it is recommended to migrate them to proper extensions. For example:

CREATE EXTENSION hstore SCHEMA public FROM unpackaged;

Troubleshooting

New cluster database "XXX" is not empty

The new cluster version already contains some data. For example, if you want to delete all data in the 9.2 version cluster, run:

pg_dropcluster 9.2 main
pg_createcluster 9.2 main

Where do I get PostgreSQL 9.2?

On Ubuntu, you can simply install 9.2 from the semi-official "PPA" repository:

sudo apt-get install python-software-properties
sudo apt-add-repository ppa:pitti/postgresql
sudo apt-get update
sudo apt-get install postgresql-9.2 postgresql-contrib-9.2 postgresql-server-dev-9.2

Warning: Support for the current major version in the PPA may be dropped when a new major version is released. If you want to use this PPA, be prepared to always upgrade to the newest major version soon after it's released.

Personal tools