Add docs for new WAL-G commands #756
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
g0djan
requested changes
Sep 5, 2020
PostgreSQL.md
Outdated
| With [reverse delta unpack](#reverse-delta-unpack) turned on, you also can turn on redundant archives skipping. | ||
| Since this feature involves both backup creation and restore process, in order to fully enable it you need to do two things: | ||
|
|
||
| 1. Optional, but recommended. [Enable rating tar ball composer](#rating-composer-mode) for `backup-push`. |
There was a problem hiding this comment.
Not recommended, just explain advantages and disadvantages.
| 2. Enable redundant backup archives skipping during backup-fetch. Do one of the following: | ||
|
|
||
| * set the `WALG_USE_REVERSE_UNPACK` and `WALG_SKIP_REDUNDANT_TARS` environment variables | ||
| * add the `--reverse-unpack` and `--skip-redundant-tars` flags |
There was a problem hiding this comment.
Does it work without --reverse-unpack?
There was a problem hiding this comment.
It will technically work but it won't skip any tarballs so it will be useless
PostgreSQL.md
Outdated
| @@ -152,6 +170,19 @@ If backup is pushed from replication slave, WAL-G will control timeline of the s | |||
|
|
|||
| ``backup-push`` can also be run with the ``--permanent`` flag, which will mark the backup as permanent and prevent it from being removed when running ``delete``. | |||
|
|
|||
| #### Rating composer mode | |||
|
|
|||
| In the rating composer mode, WAL-G places files with similar updates frequencies in the same tarballs during backup creation. This is the recommended option to use in pair with `backup-fetch` [redundant archives skipping](#redundant-archives-skipping). Be aware that although rating composer allows saving more data, it may result in slower backup creation compared to the default tarball composer. | |||
There was a problem hiding this comment.
Removed recommended 9653426
g0djan
approved these changes
Sep 7, 2020
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add docs for redundant archives skipping, rating composer, wal-verify and wal-show