Commit Graph

241 Commits

Author SHA1 Message Date
Peter Eisentraut 0f763503ff Spellchecking and such 2006-10-23 18:10:32 +00:00
Neil Conway bfc6e9c970 Make some incremental improvements and fixes to the documentation on
Continuous Archiving. Plenty of editorial work remains...
2006-10-12 19:38:08 +00:00
Bruce Momjian 5d52ad9dc8 Update recovery documentation.
Simon Riggs
2006-10-02 22:33:02 +00:00
Neil Conway f7ea4eeed6 Document how to use psql's --single-transaction option to rollback restoring
an SQL dump if an error occurs. Along the way, make some improvements and
copy-edits to the surrounding text. Patch from Simon Riggs, additional
fixes by Neil Conway.
2006-09-19 19:04:51 +00:00
Neil Conway 48fe137425 Minor additions and typo fixes for the backup documentation. Patch from
Simon Riggs, minor editorialization by Neil Conway.
2006-09-19 15:18:41 +00:00
Bruce Momjian 32cebaecff Remove emacs info from footer of SGML files. 2006-09-16 00:30:20 +00:00
Bruce Momjian 5e550acbc4 Document Warm Standby for High Availability
Includes sample standby script.

Simon Riggs
2006-09-15 22:02:21 +00:00
Bruce Momjian 075c0caa90 Document WAL recovery now uses checkpoints.
Simon Riggs
2006-09-15 21:55:07 +00:00
Tom Lane e8ea9e9587 Implement archive_timeout feature to force xlog file switches to occur no more
than N seconds apart.  This allows a simple, if not very high performance,
means of guaranteeing that a PITR archive is no more than N seconds behind
real time.  Also make pg_current_xlog_location return the WAL Write pointer,
add pg_current_xlog_insert_location to return the Insert pointer, and fix
pg_xlogfile_name_offset to return its results as a two-element record instead
of a smashed-together string, as per recent discussion.

Simon Riggs
2006-08-17 23:04:10 +00:00
Tom Lane 704ddaaa09 Add support for forcing a switch to a new xlog file; cause such a switch
to happen automatically during pg_stop_backup().  Add some functions for
interrogating the current xlog insertion point and for easily extracting
WAL filenames from the hex WAL locations displayed by pg_stop_backup
and friends.  Simon Riggs with some editorialization by Tom Lane.
2006-08-06 03:53:44 +00:00
Peter Eisentraut 5266f221a2 Merge postmaster and postgres command into just postgres. postmaster
symlink is kept for now for compatibility.  To call single-user mode, use
postgres --single.
2006-06-18 15:38:37 +00:00
Bruce Momjian efe3de07e9 Removes or minimizes some documentation mentions of backward
compatibility for release 7.2 and earlier.  I have not altered any
mentions of release 7.3 or later.  The release notes were not modified,
so the changes are still documented, just not in the main docs.
2006-04-23 03:39:52 +00:00
Bruce Momjian 497b5ad928 Make $PostgreSQL CVS tags consistent for SGML files. 2006-03-10 19:10:50 +00:00
Bruce Momjian 43e9bab94a Rename Online Backup to Continuous Archiving. 2006-03-03 22:02:08 +00:00
Bruce Momjian eb8f9cc066 Mention that the archive history file has the wal start/stop file names. 2006-02-24 14:03:01 +00:00
Tom Lane 2a8d3d83ef R-tree is dead ... long live GiST. 2005-11-07 17:36:47 +00:00
Peter Eisentraut 39dfbe5791 Spellchecking run, final cleanups 2005-11-04 23:14:02 +00:00
Tom Lane 4a309defb4 Add info about using rsync to make base backups. Per report from
Jeff Frost, it may be necessary to ignore specific exit codes.
2005-10-26 20:42:35 +00:00
Tom Lane c3a7b0577b Add a note about GNU tar's propensity to complain if a file changes
while tar is copying it.  This behavior is unhelpful when taking a base
backup.  Per gripe from Pallav Kalva back in April.
2005-10-22 22:09:49 +00:00
Tom Lane f72a342fb7 Copy-editing for recent documentation changes relevant to WAL,
full_page_writes, etc.
2005-10-22 21:56:07 +00:00
Alvaro Herrera 1b5cd6dcdc Fix typo. 2005-10-15 01:15:33 +00:00
Bruce Momjian 165565cd94 Some additional doc changes based around compression of page images in
WAL and the interaction of the new full_page_writes parameter with PITR.

The too-small WAL first sect1 has been merged with the one following
sect1 for clarity.

Some minor comments have been made in the WAL config section also.

Passes SGML make and proofread for typos.
Files changed:
patching file doc/src/sgml/backup.sgml
patching file doc/src/sgml/config.sgml
patching file doc/src/sgml/wal.sgml

Simon Riggs
2005-10-13 17:32:42 +00:00
Tom Lane fbcbc5d06f Force a checkpoint before committing a CREATE DATABASE command. This
should fix the recent reports of "index is not a btree" failures,
as well as preventing a more obscure race condition involving changes
to a template database just after copying it with CREATE DATABASE.
2005-06-25 22:47:29 +00:00
Tom Lane 7a28de2052 pg_dump can now dump large objects even in plain-text output mode, by
using the recently added lo_create() function.  The restore logic in
pg_restore is greatly simplified as well, since there's no need anymore
to try to adjust database references to match a new set of blob OIDs.
2005-06-21 20:45:44 +00:00
Tom Lane 6f7fc0bade Cause initdb to create a third standard database "postgres", which
unlike template0 and template1 does not have any special status in
terms of backend functionality.  However, all external utilities such
as createuser and createdb now connect to "postgres" instead of
template1, and the documentation is changed to encourage people to use
"postgres" instead of template1 as a play area.  This should fix some
longstanding gotchas involving unexpected propagation of database
objects by createdb (when you used template1 without understanding
the implications), as well as ameliorating the problem that CREATE
DATABASE is unhappy if anyone else is connected to template1.
Patch by Dave Page, minor editing by Tom Lane.  All per recent
pghackers discussions.
2005-06-21 04:02:34 +00:00
Tom Lane f0e7f9e30b Update text that stated GiST indexes aren't WAL-logged. 2005-06-20 13:52:17 +00:00
Bruce Momjian dd39dd232f Update PITR wording, per Simon. 2005-04-19 01:39:50 +00:00
Bruce Momjian 01979d1bd5 Update PITR setence to mention WAL and file system dump. 2005-04-18 17:40:40 +00:00
Bruce Momjian 68d2f9283d Add description that WAL files used during backup have to be archived
before you are done.
2005-04-18 13:11:04 +00:00
Bruce Momjian d755688f24 Update PITR mention of which WAL files are needed. 2005-04-18 01:29:00 +00:00
Bruce Momjian 18b985055d Clarify name of file to be checked for PITR expiring. 2005-04-17 03:05:19 +00:00
Tom Lane 87ba04eeaf Add note about risks involved in replaying CREATE TABLESPACE commands
from WAL.  A couple other grammatical improvements too.
2005-03-23 19:38:53 +00:00
Bruce Momjian 28d150d8e9 Update file system snapshot docs. 2005-03-17 15:38:46 +00:00
Bruce Momjian 118bf5bc22 Mention tablespaces as a problem for using file system snapshots. 2005-03-17 05:10:11 +00:00
Bruce Momjian ca2d08579e Document use of rsync for file system backups.
Tino Wildenhain
2005-03-17 05:03:37 +00:00
Bruce Momjian 93aa22fc8e Please find enclosed a patch, per Dennis Bj<C3><B6>rklund, that uses -f
for input files rather than <.  This makes error messages, &c. more
expressive.

David Fetter
2005-02-25 04:56:01 +00:00
Bruce Momjian 1ced129aa3 More < and > cleanups converted to ampersands. 2005-01-22 22:56:36 +00:00
Tom Lane 7737d01ece More minor updates and copy-editing. 2004-12-28 19:08:58 +00:00
Peter Eisentraut 5ec30faee6 Spell checker run 2004-12-13 18:05:10 +00:00
Tom Lane b9d8ea278b Some further editorial adjustment of PITR recovery procedure description. 2004-11-17 18:29:02 +00:00
Neil Conway ec7a6bd9a2 Replace "--" and "---" with "&mdash;" as appropriate, for better-looking
output.
2004-11-15 06:32:15 +00:00
Neil Conway 1c7a47cea4 Improvements to the PITR docs. Initial patch from Gavin Sherry, additional
improvements by Neil Conway.
2004-11-14 06:10:12 +00:00
Tom Lane cd6ecf6829 Recommend that archive_command be coded to not overwrite existing files.
Add explicit documentation of the recovery configuration settings.  Other
minor improvements in the PITR docs.  Simon Riggs, some editorialization
by Tom Lane.
2004-11-08 18:01:28 +00:00
Neil Conway 1817706fba Add a note suggesting that users should use the newer version of pg_dump
to perform upgrades, and cleanup some nearby text. Patch from Robert
Treat, editorializing by Neil Conway.
2004-09-30 10:30:10 +00:00
Tom Lane 50742aed68 Add WAL logging for CREATE/DROP DATABASE and CREATE/DROP TABLESPACE.
Fix TablespaceCreateDbspace() to be able to create a dummy directory
in place of a dropped tablespace's symlink.  This eliminates the open
problem of a PANIC during WAL replay when a replayed action attempts
to touch a file in a since-deleted tablespace.  It also makes for a
significant improvement in the usability of PITR replay.
2004-08-29 21:08:48 +00:00
Tom Lane 8e953e6fbb Update admin guide's discussion of WAL to match present reality. 2004-08-08 04:34:43 +00:00
Bruce Momjian ff2c8950fe Update pitr docs to mention inclusive/exclusive xid specification 2004-08-07 18:07:46 +00:00
Bruce Momjian 752089ea41 Fix markup. 2004-08-07 12:21:25 +00:00
Bruce Momjian a1c2ed7b02 Mention that transactions can complete in a different numeric order, for
PITR recovery.
2004-08-07 03:21:11 +00:00
Tom Lane 8515efa128 Add some notes about unimplemented aspects of PITR backup/recovery. 2004-08-04 17:37:09 +00:00
Tom Lane 59ff484894 Preliminary documentation for PITR. 2004-08-03 23:42:59 +00:00
Tom Lane 58c41712d5 Add functions pg_start_backup, pg_stop_backup to create backup label
and history files as per recent discussion.  While at it, remove
pg_terminate_backend, since we have decided we do not have time during
this release cycle to address the reliability concerns it creates.
Split the 'Miscellaneous Functions' documentation section into
'System Information Functions' and 'System Administration Functions',
which hopefully will draw the eyes of those looking for such things.
2004-08-03 20:32:36 +00:00
Neil Conway 2ff4e44043 Improvements to the backup & restore documentation. 2004-04-22 07:02:36 +00:00
Neil Conway 80ec228389 Refer to GUC variables using <xref> tags rather than <varname> tags,
where appropriate. Add "id" and "xreflabel" tags to the descriptions
of the GUC variables to facilitate this. Also make a few minor docs
cleanups.
2004-03-09 16:57:47 +00:00
Neil Conway afcc6fbb60 Remove a caveat from the "backup" documentation: pg_dump now does a
better job of handling dependencies between database objects.
2004-02-17 23:56:07 +00:00
Neil Conway 9c8d5f0be1 Add a few more <xref> tags to the SGML docs, where appropriate. Original
patch from Michael Glaesemann, additional changes by Neil Conway.
2004-02-17 09:07:16 +00:00
Tom Lane 391c3811a2 Rename SortMem and VacuumMem to work_mem and maintenance_work_mem.
Make btree index creation and initial validation of foreign-key constraints
use maintenance_work_mem rather than work_mem as their memory limit.
Add some code to guc.c to allow these variables to be referenced by their
old names in SHOW and SET commands, for backwards compatibility.
2004-02-03 17:34:04 +00:00
Tom Lane 163edee632 Improve discussion of consistent-snapshot backup technique. Haphazard
editing of this text had left nearly contradictory statements in
adjacent paragraphs ...
2004-01-19 20:12:30 +00:00
Neil Conway 024f3fa52f Minor documentation improvements. 2004-01-11 05:46:58 +00:00
PostgreSQL Daemon 969685ad44 $Header: -> $PostgreSQL Changes ... 2003-11-29 19:52:15 +00:00
Peter Eisentraut 1d27de4cf4 Random copy-editing. 2003-11-04 09:55:39 +00:00
Peter Eisentraut c326d8f4f2 Add/edit index entries. 2003-08-31 17:32:24 +00:00
Tom Lane 1b68704482 Fix broken markup. 2003-08-17 22:05:13 +00:00
Bruce Momjian 3297804e14 Add mention of sort_mem in the restore docs. 2003-08-17 03:14:26 +00:00
Tom Lane eb06e6d182 Improve description of restoring pg_dumpall backups, per gripe from
Havard Eidnes.
2003-08-01 01:01:52 +00:00
Peter Eisentraut d258ba01ec Another big editing pass for consistent content and presentation. 2003-03-24 14:32:51 +00:00
Bruce Momjian 29c18bca50 Add mention of ANALYZE after object restore. 2003-03-18 00:02:11 +00:00
Peter Eisentraut 1b342df00a Merge documentation updates from 7.3 branch. 2002-11-11 20:14:04 +00:00
Tom Lane a92df3a208 Fix example of doing a restore. 2002-10-21 02:11:37 +00:00
Peter Eisentraut 651a639b8b proof-reading 2001-11-28 20:49:10 +00:00
Thomas G. Lockhart 2475e87481 Deprecate 'current' for date/time input.
Fix up references to "PostgreSQL" rather than "Postgres". Was roughly
 evenly split between the two before. ref/ files not yet done.
2001-11-21 05:53:41 +00:00
Tom Lane 8cf87ac393 Fix some typos. 2001-11-18 22:27:00 +00:00
Tom Lane 0ad017fc64 Update various obsolete remarks about VACUUM. 2001-11-18 22:17:30 +00:00
Peter Eisentraut 3c879e3738 Add some more index entries. 2001-11-12 19:19:39 +00:00
Bruce Momjian c4566933b1 Change some 7.2 mentions to version macro. 2001-10-04 04:46:43 +00:00
Bruce Momjian 735594ff08 Update docs for 7.2 mention where appropriate. 2001-10-01 17:46:46 +00:00
Tatsuo Ishii 35d3c85ac0 The usage of kill is incorrect (lacks "data"). Anyway we should use
pg_ctl instead.
2001-09-10 07:17:01 +00:00
Tatsuo Ishii acb66fc5bf Fix typo. split does not produce ".". 2001-09-10 07:11:28 +00:00
Peter Eisentraut d07454f559 Markup additions and spell check. (covers Admin Guide) 2001-09-09 23:52:12 +00:00
Tom Lane 2589735da0 Replace implementation of pg_log as a relation accessed through the
buffer manager with 'pg_clog', a specialized access method modeled
on pg_xlog.  This simplifies startup (don't need to play games to
open pg_log; among other things, OverrideTransactionSystem goes away),
should improve performance a little, and opens the door to recycling
commit log space by removing no-longer-needed segments of the commit
log.  Actual recycling is not there yet, but I felt I should commit
this part separately since it'd still be useful if we chose not to
do transaction ID wraparound.
2001-08-25 18:52:43 +00:00
Tatsuo Ishii 1e59edd298 Fix typo. pg_dump -B --> pg_dump -b 2001-08-16 04:30:41 +00:00
Tatsuo Ishii 21af10acb8 Fix typo. createdb -t --> createdb -T 2001-07-06 02:01:35 +00:00
Peter Eisentraut a6677f0f9e Change "indices" to "indexes", per OED. 2001-05-17 21:50:18 +00:00
Peter Eisentraut f000ffd28e Add -U and -W options to pg_dump and friends to support non-interactive
specification of username (like in psql).  pg_dumpall now works with
password authentication.
2001-05-17 21:12:49 +00:00
Peter Eisentraut 1088e72054 Add note about saving large objects during upgrade. 2001-03-19 16:19:26 +00:00
Peter Eisentraut 2736ad31dc Fix markup. 2001-03-14 22:20:02 +00:00
Philip Warner 704d7fa800 Document changed features of pg_dump, including:
- Large Object dumps
- Compressed custom format
- Requirement to use template0 when creating DB
2001-03-13 14:08:18 +00:00
Bruce Momjian 7c1959cbd9 Fix typo 2000-12-10 20:47:34 +00:00
Peter Eisentraut 72ad5fe15c Add `id' attributes to all `chapter' and `sect1' tags, to generate useful
names for the HTML files (e.g., not x4856.htm).
2000-09-29 20:21:34 +00:00
Peter Eisentraut 8004bcf00e Update installation instructions to new realities. Combined into one file.
Improved automation of INSTALL file generation.
2000-07-21 00:44:13 +00:00
Peter Eisentraut a164213219 New and revised material for Admin guide, re backup & restore and database
management
2000-06-30 16:14:21 +00:00