Skip to content

Commit

Permalink
PXB-3115 Document a limitation about PXB backups with MS(upstream) wh…
Browse files Browse the repository at this point in the history
…en pagetracking is enabled (#157)

modified:   docs/page-tracking.md
  • Loading branch information
alina-derkach-oaza authored Aug 21, 2023
1 parent 66a4e18 commit 39d21b9
Showing 1 changed file with 7 additions and 3 deletions.
10 changes: 7 additions & 3 deletions docs/page-tracking.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,16 +56,20 @@ The examples of creating full and incremental backups using the `--page-tracking
After enabling the functionality, the next incremental backup finds changed
pages using page tracking.

The first full backup using page tracking, Percona XtraBackup may have a delay. The following is an example of the message:
### Limitations

??? example "Expected output"
1. When creating the first full backup using page tracking, Percona XtraBackup may have a delay. The following is an example of the message:

```{.text .no-copy}
xtrabackup: pagetracking: Sleeping for 1 second, waiting for checkpoint lsn 17852922 /
to reach to page tracking start lsn 21353759
```

Enable page tracking before creating the first backup to avoid this delay. This method ensures that the page tracking log sequence number (LSN) is higher than the checkpoint LSN of the server.
Enable page tracking before creating the first backup to avoid this delay. This method ensures that the page tracking log sequence number (LSN) is higher than the checkpoint LSN of the server.

2. If an Oracle MySQL Server uses page tracking and runs `LOCK=EXCLUSIVE` and `ALGORITHM=INPLACE` DDL operations, Percona XtraBackup may take an inconsistent backup. Oracle MySQL Server does not write these DDL operations (Oracle MySQL [bug 106163](https://bugs.mysql.com/bug.php?id=106163)) to the redo log, and Percona XtraBackup only detects the inconsistency during the `--prepare` phase.

This bug does not influence Percona XtraBackup taking backup of Percona Server for MySQL because the bug is fixed in Percona Server for MySQL 8.0.27.

## Start page tracking manually

Expand Down

0 comments on commit 39d21b9

Please sign in to comment.