db/pgbackrest
1
0
Fork 0
mirror of https://github.com/pgbackrest/pgbackrest.git synced 2025-01-18 04:58:51 +02:00
Code Issues Releases Activity

Updated readme.

Browse Source
This commit is contained in:
David Steele 2014-09-15 19:00:40 -04:00
parent f86674da02
commit 1125397aae
1 changed files with 11 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@ -4,42 +4,13 @@ Simple Postgres Backup and Restore
## recognition
Put something here, there are people to recognize!
Primary recognition goes to Stephen Frost for all his valuable advice a criticism during the development of BackRest. It's a far better piece of software than it would have been without him. Any mistakes should be blamed on me alone.
## planned for next release
* Capture SDTERR in file functions - start with file_list_get() - IN PROGRESS.
## feature backlog
* Move backups to be removed to temp before deleting.
* Async archive-get.
* Threading for archive-get and archive-put.
* Add configurable sleep to archiver process to reduce ssh connections.
* Fix bug where .backup files written into old directories can cause the archive process to error.
* Default restore.conf is written to each backup (with everything commented out).
* Able to set timeout on ssh connection in config file.
## required perl modules
* Net::OpenSSH
* Digest::SHA
* IO::Compress::Gzip
* IO::Uncompress::Gunzip
* JSON
* Moose (Not using many features here, just use standard Perl object syntax?)
* IPC::System::Simple (only used in DB object - should convert this to DBD::Pg)
Resonate (http://www.resonateinsights.com) also contributed to the development of BackRest and allowed me to install early (but well tested) versions as their primary Postgres backup solution. Works so far!
## release notes
### v0.30: ???
### v0.30: core restructuring and unit testing
* Complete rewrite of BackRest::File module to use a custom protocol for remote operations and Perl native GZIP and SHA operations. Compression is performed in threads rather than forked processes.
@ -47,17 +18,19 @@ Put something here, there are people to recognize!
* Removed dependency on Storable and replaced with a custom ini file implementation.
### v0.19: Improved error reporting/handling
* Numerous other changes that can only be identified with a diff.
### v0.19: improved error reporting/handling
* Working on improving error handling in the file object. This is not complete, but works well enough to find a few errors that have been causing us problems (notably, find is occasionally failing building the archive async manifest when system is under load).
* Found and squashed a nasty bug where file_copy was defaulted to ignore errors. There was also an issue in file_exists that was causing the test to fail when the file actually did exist. Together they could have resulted in a corrupt backup with no errors, though it is very unlikely.
### v0.18: Return soft error from archive-get when file is missing
### v0.18: return soft error from archive-get when file is missing
* The archive-get function returns a 1 when the archive file is missing to differentiate from hard errors (ssh connection failure, file copy error, etc.) This lets Postgres know that that the archive stream has terminated normally. However, this does not take into account possible holes in the archive stream.
### v0.17: Warn when archive directories cannot be deleted
### v0.17: warn when archive directories cannot be deleted
* If an archive directory which should be empty could not be deleted backrest was throwing an error. There's a good fix for that coming, but for the time being it has been changed to a warning so processing can continue. This was impacting backups as sometimes the final archive file would not get pushed if the first archive file had been in a different directory (plus some bad luck).
@ -65,13 +38,13 @@ Put something here, there are people to recognize!
* Added RequestTTY=yes to ssh sesssions. Hoping this will prevent random lockups.
### v0.15: Added archive-get
### v0.15: added archive-get
* Added archive-get functionality to aid in restores.
* Added option to force a checkpoint when starting the backup (start_fast=y).
### v0.11: Minor fixes
### v0.11: minor fixes
Tweaking a few settings after running backups for about a month.
@ -79,7 +52,7 @@ Tweaking a few settings after running backups for about a month.
* Changed lock file conflicts on backup and expire commands to ERROR. They were set to DEBUG due to a copy-and-paste from the archive locks.
### v0.10: Backup and archiving are functional
### v0.10: backup and archiving are functional
This version has been put into production at Resonate, so it does work, but there are a number of major caveats.