diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml index ef43d6877f3..c50f2deb49a 100644 --- a/doc/src/sgml/backup.sgml +++ b/doc/src/sgml/backup.sgml @@ -1,5 +1,5 @@ Backup and Restore @@ -615,8 +615,10 @@ archive_command = 'test ! -f .../%f && cp %p .../%f' Note that although WAL archiving will allow you to restore any modifications made to the data in your PostgreSQL database it will not restore changes made to configuration files (that is, - postgresql.conf, pg_hba.conf and + postgresql.conf, pg_hba.conf and pg_ident.conf) after the initial base backup. + You may wish to keep the configuration files in a location that will + be backed up by your regular filesystem backup procedures. @@ -638,11 +640,11 @@ archive_command = 'test ! -f .../%f && cp %p .../%f' SELECT pg_start_backup('label'); where label is any string you want to use to uniquely - identify this backup operation. pg_start_backup creates - a backup label file, called backup_label, - in the cluster directory with information about your backup. - One good practice is to use the full path where you intend to put the - backup dump file as. + identify this backup operation. (One good practice is to use the + full path where you intend to put the backup dump file.) + pg_start_backup creates a backup label file, + called backup_label, in the cluster directory with + information about your backup. @@ -762,19 +764,25 @@ SELECT pg_stop_backup(); - Stop the postmaster, if it's running. If you have the space to do so, - copy the cluster data directory and any tablespaces to a temporary - location so that you can reference them later. Note that this will + Stop the postmaster, if it's running. + + + + + If you have the space to do so, + copy the whole cluster data directory and any tablespaces to a temporary + location in case you need them later. Note that this precaution will require that you have enough free space on your system to hold two copies of your existing database. If you do not have enough space, - you need at the least to backup the pg_xlog directory in - the cluster data directory as it may contain logs which were not archived - before the system went down. + you need at the least to copy the contents of the pg_xlog + subdirectory of the cluster data directory, as it may contain logs which + were not archived before the system went down. - + + - Next, clean out all existing files under the cluster data directory and - under the root directories of any tablespaces you are using. + Clean out all existing files and subdirectories under the cluster data + directory and under the root directories of any tablespaces you are using. @@ -797,7 +805,7 @@ SELECT pg_stop_backup(); - If you had unarchived WAL segment files that you saved in step 1, + If you had unarchived WAL segment files that you saved in step 2, copy them into pg_xlog/. (It is best to copy them, not move them, so that you still have the unmodified files if a problem occurs and you have to start over.)