mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve wording of upgrade section.

Browse Source
This commit is contained in:
Bruce Momjian 2002-08-22 15:31:07 +00:00
parent 0f1112923c
commit 5530b0c666
2 changed files with 30 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/FAQ
View File

@ -1,7 +1,7 @@
Frequently Asked Questions (FAQ) for PostgreSQL Frequently Asked Questions (FAQ) for PostgreSQL
Last updated: Tue Jul 30 11:05:09 EDT 2002 Last updated: Thu Aug 22 11:30:58 EDT 2002
Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us) Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
@ -53,7 +53,8 @@
3.7) What debugging features are available? 3.7) What debugging features are available?
3.8) Why do I get "Sorry, too many clients" when trying to connect? 3.8) Why do I get "Sorry, too many clients" when trying to connect?
3.9) What are the pg_sorttempNNN.NN files in my database directory? 3.9) What are the pg_sorttempNNN.NN files in my database directory?
3.10) Why do I need to do a dump and restore to upgrade PostgreSQL? 3.10) Why do I need to do a dump and restore to upgrade PostgreSQL
releases?
Operational Questions Operational Questions
@ -602,23 +603,20 @@
a backend crashes during a sort. If you have no backends running at a backend crashes during a sort. If you have no backends running at
the time, it is safe to delete the pg_tempNNN.NN files. the time, it is safe to delete the pg_tempNNN.NN files.
3.10) Why do I need to do a dump and restore to upgrade PostgreSQL? 3.10) Why do I need to do a dump and restore to upgrade between major
PostgreSQL releases?
The PostgreSQL team tries very heard to maintain compatability across The PostgreSQL team makes only small changes between minor releases,
minor releases. So upgrading from 7.2 to 7.2.1 does not require a dump so upgrading from 7.2 to 7.2.1 does not require a dump and restore.
a restore. However, new features are continuously being adding and However, major releases often change the internal format of system
sometimes this requires new fields to be added to system tables. tables and data files. These changes are often complex, so we don't
maintain backward compatability for data files. A dump outputs data in
a generic format that can then be loaded in using the new internal
format.
These changes may be across many tables and so maintaining backward In releases where the on-disk format does not change, the pg_upgrade
compatability would be quite difficult. Thus, restoring from a dump is script can be used to upgrade without a dump/restore. The release
required to make everything work. notes mention whether pg_upgrade is available for the release.
Note that the actual on-disk file format does not change very often, a
feature the pg_upgrade script uses quite successfully. There the dump
is used create the necessary information in the system tables. The
data files are then just copied across. This method is not as
guarenteed as the dump/restore method but when it works it can make
upgrades very efficient.
_________________________________________________________________ _________________________________________________________________
Operational Questions Operational Questions

33
doc/src/FAQ/FAQ.html
View File

@ -14,7 +14,7 @@
alink="#0000ff"> alink="#0000ff">
<H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1> <H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1>
<P>Last updated: Tue Jul 30 11:05:09 EDT 2002</P> <P>Last updated: Thu Aug 22 11:30:58 EDT 2002</P>
<P>Current maintainer: Bruce Momjian (<A href= <P>Current maintainer: Bruce Momjian (<A href=
"mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</A>)<BR> "mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</A>)<BR>
@ -82,7 +82,7 @@
<A href="#3.9">3.9</A>) What are the <I>pg_sorttempNNN.NN</I> <A href="#3.9">3.9</A>) What are the <I>pg_sorttempNNN.NN</I>
files in my database directory?<BR> files in my database directory?<BR>
<A href="#3.10">3.10</A>) Why do I need to do a dump and restore <A href="#3.10">3.10</A>) Why do I need to do a dump and restore
to upgrade PostgreSQL?<BR> to upgrade PostgreSQL releases?<BR>
<H2 align="center">Operational Questions</H2> <H2 align="center">Operational Questions</H2>
@ -786,24 +786,21 @@
running at the time, it is safe to delete the pg_tempNNN.NN running at the time, it is safe to delete the pg_tempNNN.NN
files.</P> files.</P>
<H4><A name="3.10">3.10</A>) Why do I need to do a dump and restore <H4><A name="3.10">3.10</A>) Why do I need to do a dump and restore
to upgrade PostgreSQL?</H4> to upgrade between major PostgreSQL releases?</H4>
<P>The PostgreSQL team tries very heard to maintain compatability across <P>The PostgreSQL team makes only small changes between minor releases,
minor releases. So upgrading from 7.2 to 7.2.1 does not require a dump a so upgrading from 7.2 to 7.2.1 does not require a dump and restore.
restore. However, new features are continuously being adding and However, major releases often change the internal format of system
sometimes this requires new fields to be added to system tables. tables and data files. These changes are often complex, so we don't
maintain backward compatability for data files. A dump outputs data
in a generic format that can then be loaded in using the new internal
format.
<P>These changes may be across many tables and so maintaining backward <P>In releases where the on-disk format does not change, the
compatability would be quite difficult. Thus, restoring from a dump is <i>pg_upgrade</i> script can be used to upgrade without a dump/restore.
required to make everything work. The release notes mention whether <i>pg_upgrade</i> is available for the
release.
<P>Note that the actual on-disk file format does not change very often,
a feature the pg_upgrade script uses quite successfully. There the dump
is used create the necessary information in the system tables. The data
files are then just copied across. This method is not as guarenteed as
the dump/restore method but when it works it can make upgrades very
efficient.
<HR> <HR>