Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/.linkspector.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,3 +11,10 @@ ignorePatterns:
- pattern: "#mysql_alerts$"
- pattern: "#postgresql_alerts$"
- pattern: "#proxysql_alerts$"
- pattern: "^https://www\\.zmanda\\.com/zrm-community/?$"

replacementPatterns:
- pattern: "\\{\\{vers\\}\\}"
replacement: "9.7"
- pattern: "\\{\\{ps\\}\\}"
replacement: "8.4"
2 changes: 1 addition & 1 deletion docs/accelerate-backup-process.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ the `FLUSH TABLES WITH READ LOCK`. Note that Percona XtraBackup will use
[Backup locks] where available as a lightweight alternative to `FLUSH TABLES WITH READ
LOCK`.

Percona XtraBackup uses these locks automatically to copy non-InnoDB data to avoid blocking Data manipulation language (DML) queries that modify InnoDB tables. Find more information in [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/backup-locks.html)
Percona XtraBackup uses these locks automatically to copy non-InnoDB data to avoid blocking Data manipulation language (DML) queries that modify InnoDB tables. Find more information in [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/backup-locks.html)

!!! note

Expand Down
4 changes: 2 additions & 2 deletions docs/apt-download-deb.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@ The following example downloads Percona XtraBackup {{release}} release package f
1. Use `wget` to download the `DEB` package:

```shell
wget https://downloads.percona.com/downloads/Percona-XtraBackup-{{vers}}/Percona-XtraBackup-{{release}}/binary/debian/jammy/x86_64/percona-xtrabackup-97_{{release}}-1.jammy_amd64.deb
wget https://downloads.percona.com/downloads/Percona-XtraBackup-{{vers}}/Percona-XtraBackup-{{release}}/binary/debian/jammy/x86_64/percona-xtrabackup-97_{{deb}}-1.jammy_amd64.deb
```

2. Install Percona XtraBackup by using `dpkg`:

```shell
sudo dpkg -i percona-xtrabackup-97_{{release}}-1.jammy_amd64.deb
sudo dpkg -i percona-xtrabackup-97_{{deb}}-1.jammy_amd64.deb
```

## Common dependencies
Expand Down
2 changes: 1 addition & 1 deletion docs/apt-repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Ready-to-use packages are available from the Percona XtraBackup software
repositories and the [Percona Software Downloads :octicons-link-external-16:](https://www.percona.com/downloads).

Specific information on the supported platforms, products, and versions is
described in [Percona Release Lifecycle Overview].
described in [Percona Release Lifecycle Overview :octicons-link-external-16:](https://www.percona.com/release-lifecycle-overview/).

## Install Percona XtraBackup through percona-release

Expand Down
18 changes: 6 additions & 12 deletions docs/download-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,23 +5,17 @@
Do the following steps to select the software:

1. Open [Software Downloads :octicons-link-external-16:](https://www.percona.com/downloads)
2. Locate the Percona Software, for example, Percona XtraBackup
3. In `Select Product`, select which product, for example, Percona XtraBackup {{vers}}
4. In `Select Product Version`, select the version, for example, PERCONA-XTRABACKUP-{{release}}
5. In `Select Platform`, select the operating system, for example, RED HAT ENTERPRISE LINUX / CENTOS/ ORACLE LINUX 9

The easiest method is to download all packages.
2. Select a product, for example, Percona XtraBackup and click install.
3. In `Product Group`, select which product, for example, Percona XtraBackup {{vers}}
4. In `Version`, select the version, for example, Percona-XtraBackup-{{release}}
5. In `Platform`, select the operating system, for example, RED HAT ENTERPRISE LINUX / CENTOS/ ORACLE LINUX 9

## Download to a local computer

In `Package Download Options`, select a specific package or choose the `DOWNLOAD ALL PACKAGES` button. This action downloads the selected packages to the local computer.
In `Package Download Options`, select a specific package and click `Download`. This action downloads the selected packages to the local computer.

## Download to another computer

In `Package Download Options`, you can do either of the following:

* Select a specific package and right-click on the arrow next to `DOWNLOAD`, and in the drop-down menu, choose `Copy Link Address`

* Select `DOWNLOAD ALL PACKAGES` and right-click on the arrow, and in the drop-down menu, choose `Copy Link Address`
In `Package Download Options`, select a specific package and right-click on the `DOWNLOAD`, and in the drop-down menu, choose `Copy Link Address`

Paste the link in your terminal prompt to download the selected package.
6 changes: 3 additions & 3 deletions docs/encrypted-innodb-tablespace-backups.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ Percona XtraBackup supports the following keyring components:

* [keyring_vault](#keyring_vault-configuration)
* [keyring_file](#keyring_file-configuration)
* [Key Management Interoperability Protocol (KMIP) :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/using-kmip.html?h=kmip)
* [Amazon Key Management Service (AWS KMS) :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/using-amz-kms.html)
* [Key Management Interoperability Protocol (KMIP) :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/using-kmip.html?h=kmip)
* [Amazon Key Management Service (AWS KMS) :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/using-amz-kms.html)

Percona XtraBackup {{vers}} and later versions support only component versions of the security features.

Expand Down Expand Up @@ -65,7 +65,7 @@ The `component_keyring_vault.cnf` file uses JSON format:
}
```

For information on configuring the keyring vault component on the MySQL server, see [Use the keyring vault component :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/use-keyring-vault-component.html).
For information on configuring the keyring vault component on the MySQL server, see [Use the keyring vault component :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/use-keyring-vault-component.html).

#### keyring_file configuration

Expand Down
2 changes: 1 addition & 1 deletion docs/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ To support simultaneous compression and streaming, Percona XtraBackup uses the x

## XtraDB

Percona XtraDB is an enhanced version of the InnoDB storage engine, designed to better scale on modern hardware. Percona XtraDB includes features which are useful in a high performance environment. It is fully backward-compatible, and is a drop-in replacement for the standard InnoDB storage engine. For more information, see [The Percona XtraDB Storage Engine :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/percona-xtradb.html).
Percona XtraDB is an enhanced version of the InnoDB storage engine, designed to better scale on modern hardware. Percona XtraDB includes features which are useful in a high performance environment. It is fully backward-compatible, and is a drop-in replacement for the standard InnoDB storage engine. For more information, see [The Percona XtraDB Storage Engine :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/percona-xtradb.html).

## Zstandard (ZSTD)

Expand Down
1 change: 0 additions & 1 deletion docs/index-contents.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,6 @@
- [Install Percona XtraBackup {{vers}} using downloaded RPM packages](yum-download-rpm.md)
- [Install using downloaded DEB packages](apt-download-deb.md)
- [Install with the Percona-release Tool on Debian-based Systems](apt-repo.md)
- [lock-ddl-per-table option improvements](lock-options.md)
- [LRU dump backup](lru-dump-backup.md)
- [Make backups in replication environments](make-backup-in-replication-env.md)
- [Next steps](quickstart-next-steps.md)
Expand Down
4 changes: 2 additions & 2 deletions docs/quickstart-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,8 @@ This guide will help you get started quickly, but there's a lot more to learn ab

To take a backup of Percona Server for MySQL, run Percona Server for MySQL in a Docker container and create a database, and a table.

* [Start Percona Server in a Docker container :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/quickstart-docker.html)
* [Create a database and table in Percona Server :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/quickstart-docker.html#create-a-database)
* [Start Percona Server in a Docker container :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/quickstart-docker.html)
* [Create a database and table in Percona Server :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/quickstart-docker.html#create-a-database)

### Limitations

Expand Down
2 changes: 1 addition & 1 deletion docs/work-with-apparmor.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ The Linux Security Module implements mandatory access controls (MAC) with AppArm

Percona XtraBackup does not have a profile and is not confined by AppArmor.

For a list of common AppArmor commands, see [Percona Server for MySQL - AppArmor :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/apparmor.html).
For a list of common AppArmor commands, see [Percona Server for MySQL - AppArmor :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/apparmor.html).

## Develop a profile

Expand Down
12 changes: 6 additions & 6 deletions docs/xtrabackup-option-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ The number of attempts to acquire metadata locks.

Usage: `--backup-locks`

This option controls if [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/backup-locks.html) are used instead of `FLUSH TABLES
This option controls if [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/backup-locks.html) are used instead of `FLUSH TABLES
WITH READ LOCK` on the backup stage. The option has no effect when the server does not support backup locks. This option is enabled by default,
disable with [`--no-backup-locks`](#no-backup-locks).

Expand Down Expand Up @@ -427,7 +427,7 @@ terminates with an error.

The default value is `0`, xtrabackup does not wait
for queries to complete and starts `FLUSH TABLES WITH READ LOCK`
immediately. Where supported, xtrabackup automatically uses the [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy
immediately. Where supported, xtrabackup automatically uses the [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy
non-InnoDB data to avoid blocking DML queries that modify the InnoDB tables.

### ftwrl-wait-threshold
Expand All @@ -440,7 +440,7 @@ xtrabackup to detect long-running queries with a non-zero value of
is not started until such long-running queries exist.

This option has no effect if `--ftwrl-wait-timeout` is `0`. The default value
is `60` seconds. The xtrabackup binary automatically uses [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy
is `60` seconds. The xtrabackup binary automatically uses [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy
non-InnoDB data to avoid blocking DML queries that modify InnoDB tables when backup locks are supported.

### ftwrl-wait-query-type
Expand All @@ -452,7 +452,7 @@ Usage: `--ftwrl-wait-query-type=all|update`This option specifies which queries c
Usage: `--galera-info`

This option creates the `xtrabackup_galera_info` file, which contains the local node state at the backup time. This option should be used when
performing the backup of a Percona XtraDB Cluster. The option has no effect when [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/backup-locks.html) are used to create the backup.
performing the backup of a Percona XtraDB Cluster. The option has no effect when [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/backup-locks.html) are used to create the backup.

### generate-new-master-key

Expand Down Expand Up @@ -594,7 +594,7 @@ To use this option xtrabackup user should have the
`PROCESS` and `SUPER` privileges.

Where supported, xtrabackup
automatically uses [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy non-InnoDB data to avoid blocking DML queries that modify InnoDB tables.
automatically uses [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy non-InnoDB data to avoid blocking DML queries that modify InnoDB tables.

### kill-long-query-type

Expand Down Expand Up @@ -707,7 +707,7 @@ about the binary log position of the backup. This option shouldn’t be used if
happening on non-InnoDB tables; this includes the system MyISAM tables in the
mysql database. Otherwise, those operations could lead to an inconsistent backup.

Where supported, xtrabackup will automatically use [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy
Where supported, xtrabackup will automatically use [Backup locks :octicons-link-external-16:](https://docs.percona.com/percona-server/{{ps}}/backup-locks.html) as a lightweight alternative to `FLUSH TABLES WITH READ LOCK` to copy
non-InnoDB data to avoid blocking DML queries that modify InnoDB tables.

If you consider using this option because your backups fail to acquire
Expand Down
4 changes: 2 additions & 2 deletions docs/yum-download-rpm.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,13 @@ The following example downloads *Percona XtraBackup* {{release}} release package
2. Use `wget` to download the `RPM` package:

```bash
wget https://downloads.percona.com/downloads/Percona-XtraBackup-{{vers}}/Percona-XtraBackup-{{release}}/binary/redhat/9/x86_64/percona-xtrabackup-97-{{release}}.1.el9.x86_64.rpm
wget https://downloads.percona.com/downloads/Percona-XtraBackup-{{vers}}/Percona-XtraBackup-{{release}}/binary/redhat/9/x86_64/percona-xtrabackup-97-{{rpm}}1.el9.x86_64.rpm
```

3. Install Percona XtraBackup by running:

```bash
sudo dnf install ./percona-xtrabackup-97-{{release}}.1.el9.x86_64.rpm
sudo dnf install ./percona-xtrabackup-97-{{rpm}}1.el9.x86_64.rpm
```

## Common dependencies
Expand Down
3 changes: 3 additions & 0 deletions variables.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,8 @@ release: '9.7.1-rc1'
version: '9.7'
vers: '9.7' # is used in links and to specify a product version
pkg: 'pxb-97-lts'
deb: '9.7.1~rc1' # is used in package download links DEB
rpm: '9.7.1-1.rc' # is used in package download links RPM
ps: '8.4' # ps version
release-date: '2025-07-15'
title_date: '2025-07-15'
Loading