Changeset 178

Show
Ignore:
Timestamp:
07/15/10 19:55:05 (8 years ago)
Author:
depesz
Message:

add more info about requirements, and important notices about usage

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/omnipitr/doc/changes.pod

    r175 r178  
    11=head1 OmniPITR 
     2 
     3=head2 2010-07-15 
     4 
     5=over 
     6 
     7=item * Added "IMPORTANT NOTICES" part to documents for omnipitr programs with 
     8additional info that might not be obvious always. 
     9 
     10=item * Added information about reuiring at least gnu tar 1.20 (earlier version 
     11didn't have --transform option which is required by omnipitr-backup-slave) 
     12 
     13=back 
    214 
    315=head2 2010-06-30 
  • trunk/omnipitr/doc/install.pod

    r161 r178  
    4848=item * rsync 
    4949 
    50 =item * tar (it has to be GNU tar
     50=item * tar (it has to be GNU tar version 1.20 or newer
    5151 
    5252=back 
  • trunk/omnipitr/doc/omnipitr-archive.pod

    r156 r178  
    248248    archive_command='/.../omnipitr-archive -D /mnt/data/ -l /var/log/omnipitr/archive-^Y-^m-^d.log -dr gzip=rsync://slave/postgres/wal_archive/ -dr bzip2=backups@backupserver:/mnt/backups/wal_archive/ -dl /mnt/wal_archive/ -s /var/lib/postgres/.omnipitr/ "%p"' 
    249249 
     250=head2 IMPORTANT NOTICES 
     251 
     252=over 
     253 
     254=item * You need to provide state dir in case you have > 1 destination. This is 
     255crucial, as if you're using "-dr ... -db" - your number of destinations changes 
     256from 1 to 2 (depending on whether -db directory exists) - i.e. not all runs of 
     257I<omnipitr-archive> will catch lack of state-dir as error! 
     258 
     259=item * It is generally good to provide 2 destination - one used by slave system 
     260to keep warm standby, and another to be handy in case (for example) backup files 
     261get corrupted. This second set of xlogs should be cleared with cronjob that 
     262removes too old files. As for what is too old - 2x your backup schedule. I.e. if 
     263you're doing daily hot backups - you should keep 2 days worth of backup xlogs. 
     264 
     265=back 
     266 
    250267=head2 COPYRIGHT 
    251268 
  • trunk/omnipitr/doc/omnipitr-backup-master.pod

    r170 r178  
    306306    /.../omnipitr-backup-master -D /mnt/data/ -l /var/log/omnipitr/backup-^Y-^m-^d.log -dr bzip2=rsync://slave/postgres/backups/ -dr gzip=backups:/mnt/hotbackups/ -dl /mnt/backups/ -f "main-__FILETYPE__-^Y^m^d_^H^M^S.tar__CEXT__" 
    307307 
     308=head2 IMPORTANT NOTICES 
     309 
     310=over 
     311 
     312=item * It I<omnipitr-backup-master> will get stopped in B<hard> way (kill -9, 
     313or multiple ctrl-c - it is possible that it will leave database with backup mode 
     314still enabled. So, to prevent future problems with it, if you had to B<hard> 
     315stop it - remember to connect to postgresql and issue: 
     316 
     317    SELECT pg_stop_backup(); 
     318 
     319=back 
     320 
    308321=head2 COPYRIGHT 
    309322 
  • trunk/omnipitr/doc/omnipitr-backup-slave.pod

    r171 r178  
    287287    /.../omnipitr-backup-slave -D /mnt/data/ -l /var/log/omnipitr/backup-^Y-^m-^d.log -dr bzip2=rsync://slave/postgres/backups/ -dr gzip=backups:/mnt/hotbackups/ -dl /mnt/backups/ -f "main-__FILETYPE__-^Y^m^d_^H^M^S.tar__CEXT__" 
    288288 
     289=head2 IMPORTANT NOTICES 
     290 
     291=over 
     292 
     293=item * If you're using compressed source dir (wal archive) - 
     294I<omnipitr-backup-slave> has to uncompress all of xlogs before putting them in 
     295.tar.XX. This means that you should have enough free disk space for this purpose 
     296in the place where you create temporary directories. Alternarively - do not use 
     297compression for sending WAL segments to standby server - in this case - 
     298decompression will not be necessary. 
     299 
     300=item * I<omnipitr-backup-slave> compresses whole source directory - i.e. all 
     301files from there. This means that if you're using delay recovery (-w option to 
     302I<omnipitr-restore>) - there will be more files there, and backup will be 
     303larger. This is especially important if you're using compressed wal archive 
     304(please see note above) 
     305 
     306=back 
     307 
    289308=head2 COPYRIGHT 
    290309