From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1QkeI0-0004lR-Kv for garchives@archives.gentoo.org; Sat, 23 Jul 2011 15:38:52 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id B9DF821C263; Sat, 23 Jul 2011 15:38:45 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 7CC9221C263 for ; Sat, 23 Jul 2011 15:38:45 +0000 (UTC) Received: from pelican.gentoo.org (unknown [66.219.59.40]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id EF3041B4032 for ; Sat, 23 Jul 2011 15:38:44 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by pelican.gentoo.org (Postfix) with ESMTP id 0573C8003D for ; Sat, 23 Jul 2011 15:38:44 +0000 (UTC) From: "Aaron Swenson" To: gentoo-commits@lists.gentoo.org Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Aaron Swenson" Message-ID: <1535baabb6f75bb0681884623b8c4932da3c81f2.titanofold@gentoo> Subject: [gentoo-commits] proj/pgsql-patches:documentation commit in: / X-VCS-Repository: proj/pgsql-patches X-VCS-Files: postgresql.xml X-VCS-Directories: / X-VCS-Committer: titanofold X-VCS-Committer-Name: Aaron Swenson X-VCS-Revision: 1535baabb6f75bb0681884623b8c4932da3c81f2 Date: Sat, 23 Jul 2011 15:38:44 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: X-Archives-Hash: 3326601b74986257b104b2e44440497a commit: 1535baabb6f75bb0681884623b8c4932da3c81f2 Author: Aaron W. Swenson gentoo org> AuthorDate: Thu Jul 21 23:05:45 2011 +0000 Commit: Aaron Swenson gentoo org> CommitDate: Thu Jul 21 23:05:45 2011 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=3Dproj/pgsql-patches= .git;a=3Dcommit;h=3D1535baab Revised --- postgresql.xml | 96 ++++++++++++++++++++++++++++----------------------= ------ 1 files changed, 48 insertions(+), 48 deletions(-) diff --git a/postgresql.xml b/postgresql.xml index 784789d..d07ca9a 100644 --- a/postgresql.xml +++ b/postgresql.xml @@ -264,9 +264,9 @@ ebuilds to the new ones. =20 -Flipping the 'pg-intdatetime' or the 'pg_legacytimestamp' will required = you to -do a dump and restore if any of your databases utilize timestamps. The t= wo -methods are incompatible with each other. +Flipping the 'pg-intdatetime' or the 'pg_legacytimestamp' will require y= ou to do +a dump and restore if any of your databases utilize timestamps. The two = methods +are incompatible with each other. =20 @@ -292,7 +292,7 @@ You may receive a notice regarding that any of the ab= ove packages are blocked by any or all of the following packages: dev-db/postgresql-libs, dev-db/postgresql-client, dev-db/libpq or dev-db/postgresql. These packa= ges are not maintained and obsoleted. Refer to the section on migration for how to handle this situation. +link=3D"#oldmigration">migration for how to handle this situation.

=20 @@ -336,8 +336,8 @@ PGDATA=3D"/etc/postgresql-9.0/" DATA_DIR=3D"/var/lib/postgresql/9.0/data" =20 # Additional options to pass to initdb. -# See 'man initdb' for available options. -#PG_INITDB_OPTS=3D"--locale=3Den_US.UTF-8" +# See 'man initdb' for available options. +PG_INITDB_OPTS=3D"--locale=3Den_US.UTF-8" =20 @@ -427,7 +427,7 @@ To finish the installation: =20

This will create the database cluster and store all the related server f= iles -into DATA_DIR. +into PGDATA and DATA_DIR.

=20 @@ -656,6 +656,47 @@ dev-db/postgresql-docs, dev-db/postgresql-base and d= ev-db/postgresql-server. =20 +
+Post-9.0 Migration + + +

+pg_upgrade, a new utility that comes along with 9.0 and later, si= mplifies +the migration process rather drastically. +

+ +

+However, there are two caveats with using pg_upgrade. Firstly, it does n= ot +support configuration files being in a different directory than where th= e data +is stored. This can be resolved by using symbolic links. Lastly, you can= only +use it to migrate from a database from 8.3 or newer. If you have an olde= r +database you will need to follow the Pre-9.0 Migrat= ion +instructions. +

+ +
+(Stop the servers you're going to migrate from and to.)
+# /etc/init.d/postgresql-8.4 stop
+# /etc/init.d/postgresql-9.0 stop
+# ln -s /etc/postgresql-8.4/*.conf /var/lib/postgresql/8.4/data/
+# ln -s /etc/postgresql-9.0/*.conf /var/lib/postgresql/9.0/data/
+
+(Change the method of 'postgres' to trust on local connections)=

+# nano -w /etc/postgresql-8.4/pg_hba.conf
+# nano -w /etc/postgresql-9.0/pg_hba.conf
+# pg_upgrade -u postgres \
+  -d /var/lib/postgresql/8.4/data -D /var/lib/postgresql/9.0 \
+  -b /usr/lib/postgresql-8.4/bin -B /usr/lib/postgresql-9.0/bin
+(Perform the tasks pg_upgrade tells you to.)
+
+(Remove the symbolic links  we created earlier.)
+# rm /var/lib/postgresql/8.4/data/*.conf
+# rm /var/lib/postgresql/9.0/data/*.conf
+# /etc/init.d/postgresql-9.0 start
+
+ + +
Pre-9.0 Migration: With the New Ebuilds @@ -724,47 +765,6 @@ server that contains precisely the same data, bit fo= r bit, as the old server. =20
-
-Post-9.0 Migration - - -

-pg_upgrade, a new utility that comes along with 9.0 and later, si= mplifies -the migration process rather drastically. -

- -

-However, there are two caveats with using pg_upgrade. Firstly, it does n= ot -support configuration files being in a different directory than where th= e data -is stored. This can be resolved by using symbolic links. Lastly, you can= only -use it to migrate from a database from 8.3 or newer. If you have an olde= r -database you will need to follow the Pre-9.0 Migrat= ion -instructions. -

- -
-(Stop the servers you're going to migrate from and to.)
-# /etc/init.d/postgresql-8.4 stop
-# /etc/init.d/postgresql-9.0 stop
-# ln -s /etc/postgresql-8.4/*.conf /var/lib/postgresql/8.4/data/
-# ln -s /etc/postgresql-9.0/*.conf /var/lib/postgresql/9.0/data/
-
-(Change the method of 'postgres' to trust on local connections)=

-# nano -w /etc/postgresql-8.4/pg_hba.conf
-# nano -w /etc/postgresql-9.0/pg_hba.conf
-# pg_upgrade -u postgres \
-  -d /var/lib/postgresql/8.4/data -D /var/lib/postgresql/9.0 \
-  -b /usr/lib/postgresql-8.4/bin -B /usr/lib/postgresql-9.0/bin
-(Perform the tasks pg_upgrade tells you to.)
-
-(Remove the symbolic links  we created earlier.)
-# rm /var/lib/postgresql/8.4/data/*.conf
-# rm /var/lib/postgresql/9.0/data/*.conf
-# /etc/init.d/postgresql-9.0 start
-
- - -
Pre-9.0 Migration: From the Obsolete Ebuilds