From: Bruce Momjian <bruce@momjian.us>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org, "Thomas F. O'Connell" <tf@o.ptimized.com>
Subject: Re: 14.4 If You Are Upgrading - Suggested Improvements
Date: Fri, 26 Jan 2007 20:27:37 -0500 (EST)
Message-ID: <200701270127.l0R1Rbr15403@momjian.us> (raw)
In-Reply-To: <200701270151.05085.peter_e@gmx.net>
Peter Eisentraut wrote:
> Bruce Momjian wrote:
> > I have updated the installation documentation to clarify major vs.
> > minor releases; patch attached and applied. I always suspected we
> > were unclear on this. Comments welcome. I am not inclined to
> > backpatch this to 8.2.X because it might be too significant a change.
> > URL of new text:
>
> I think this is too weak:
>
> """
> If you are upgrading from the same major version, the new version can
> use your current data files, so a backup and restore is optional. If
> you wish to avoid the backup/restore, merely skip those steps below.
> """
>
> You write the backup/restore for minor versions is "optional", but when
> would you make use of this option and why would users "wish" or not
> wish to skip the steps? The fact is, the backup and restore is not
> optional, it is just unnecessary, and there is no question about
> whether to skip the rest or not.
OK, I was unsure if we wanted to encourage minor release folks to still
do a backup in case there is a problem.
Updated text:
The internal data storage format typically changes in every major
release of <productname>PostgreSQL</>. Therefore, if you are upgrading
an existing installation that does not have a version number of
<quote>&majorversion;.x</quote>, you must back up and restore your
data. If you are upgrading from the same major version, the new version
can use your current data files so you should skip the backup and
restore steps below because they are unnecessary.
Thanks.
--
Bruce Momjian bruce@momjian.us
EnterpriseDB http://www.enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
Attachments:/rtmp/diff (text/x-diff, 1.1K) download
Index: doc/src/sgml/installation.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v
retrieving revision 1.276
diff -c -c -r1.276 installation.sgml
*** doc/src/sgml/installation.sgml 26 Jan 2007 22:52:50 -0000 1.276
--- doc/src/sgml/installation.sgml 27 Jan 2007 01:23:43 -0000
***************
*** 386,393 ****
an existing installation that does not have a version number of
<quote>&majorversion;.x</quote>, you must back up and restore your
data. If you are upgrading from the same major version, the new version
! can use your current data files, so a backup and restore is optional.
! If you wish to avoid the backup/restore, merely skip those steps below.
</para>
<procedure>
--- 386,393 ----
an existing installation that does not have a version number of
<quote>&majorversion;.x</quote>, you must back up and restore your
data. If you are upgrading from the same major version, the new version
! can use your current data files so you should skip the backup and
! restore steps below.
</para>
<procedure>
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, peter_e@gmx.net, tf@o.ptimized.com
Subject: Re: 14.4 If You Are Upgrading - Suggested Improvements
In-Reply-To: <200701270127.l0R1Rbr15403@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox