missing --redo-only in docs for preparing an incremental backup with innobackupex

[Alexey Kopytov]

http://www.percona.com/doc/percona-xtrabackup/innobackupex/incremental_backups_innobackupex.html#preparing-an-incremental-backup-with-innobackupex says that:

"
Then, the first incremental backup can be applied to the base backup, by issuing:

innobackupex --apply-log BASE-DIR --incremental-dir=INCREMENTAL-DIR-1
"

However, that command should have the --redo-only option is well, as it's required to apply an incremental backup, and the corresponding xtrabackup option (--apply-log-only) is mentioned in the xtrabackup binary docs: http://www.percona.com/doc/percona-xtrabackup/xtrabackup_bin/incremental_backups.html?id=percona-xtrabackup:xtrabackup:incremental#preparing-the-incremental-backups

[Gregor Hoffleit (flight)]

How about the second incremental backup (and any subsequent)? Doesn't it also need a "--redo-only"?

Currently, the "--redo-only" is missing from the command line suggested for applying subsequent backups ("incremental_backups_innobackupex.html"):

"Repeat the procedure with the second one:

innobackupex --apply-log BASE-DIR --incremental-dir=INCREMENTAL-DIR-2
If the “completed OK!” message was shown, the final data will be in the base backup directory, BASE-DIR.

You can use this procedure to add more increments to the base, as long as you do it in the chronological order that the backups were done. If you omit this order, the backup will be useless. If you have doubts about the order that they must be applied, you can check the file xtrabackup_checkpoints at the directory of each one, as shown in the beginning of this section."

I would have thought this this was the full procedure for preparing a backup from a full and several incremental backups:

innobackupex --apply-log --redo-only BASE-DIR
innobackupex --apply-log --redo-only BASE-DIR --incremental-dir=INCREMENTAL-DIR-1
innobackupex --apply-log --redo-only BASE-DIR --incremental-dir=INCREMENTAL-DIR-2
...
innobackupex --apply-log --redo-only BASE-DIR --incremental-dir=INCREMENTAL-DIR-x
innobackupex --apply-log BASE-DIR"

Is this true? Then "incremental_backups_innobackupex.html" should be changed accordingly.

[Alexey Kopytov (akopytov)]

Good question. --redo-only should be used when applying all incremental backups except the last one. I will report it as a separate bug.

[Alexey Kopytov (akopytov)]

Bug #1071146.

[Shahriyar Rzayev (rzayev-sehriyar)]

Percona now uses JIRA for bug reports so this bug report is migrated to: https://jira.percona.com/browse/PXB-1146