diff --git a/docs/.linkspector.yml b/docs/.linkspector.yml index 402c0eca..954ee5e2 100644 --- a/docs/.linkspector.yml +++ b/docs/.linkspector.yml @@ -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" diff --git a/docs/accelerate-backup-process.md b/docs/accelerate-backup-process.md index d4b478bd..b0bb8f43 100644 --- a/docs/accelerate-backup-process.md +++ b/docs/accelerate-backup-process.md @@ -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 diff --git a/docs/apt-download-deb.md b/docs/apt-download-deb.md index 4e1a1041..372068f7 100644 --- a/docs/apt-download-deb.md +++ b/docs/apt-download-deb.md @@ -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 diff --git a/docs/apt-repo.md b/docs/apt-repo.md index d930dac8..5a53b650 100644 --- a/docs/apt-repo.md +++ b/docs/apt-repo.md @@ -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 diff --git a/docs/download-instructions.md b/docs/download-instructions.md index 763cbd5c..0c62ec50 100644 --- a/docs/download-instructions.md +++ b/docs/download-instructions.md @@ -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. diff --git a/docs/encrypted-innodb-tablespace-backups.md b/docs/encrypted-innodb-tablespace-backups.md index 9390e04a..9eb37966 100644 --- a/docs/encrypted-innodb-tablespace-backups.md +++ b/docs/encrypted-innodb-tablespace-backups.md @@ -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. @@ -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 diff --git a/docs/glossary.md b/docs/glossary.md index 9a70d907..3bc657ef 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -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) diff --git a/docs/index-contents.md b/docs/index-contents.md index 9199be75..7aad2404 100644 --- a/docs/index-contents.md +++ b/docs/index-contents.md @@ -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) diff --git a/docs/quickstart-overview.md b/docs/quickstart-overview.md index be8701ea..dcb46973 100644 --- a/docs/quickstart-overview.md +++ b/docs/quickstart-overview.md @@ -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 diff --git a/docs/work-with-apparmor.md b/docs/work-with-apparmor.md index 1d2f5796..278e2c32 100644 --- a/docs/work-with-apparmor.md +++ b/docs/work-with-apparmor.md @@ -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 diff --git a/docs/xtrabackup-option-reference.md b/docs/xtrabackup-option-reference.md index b414faff..4df0f99d 100644 --- a/docs/xtrabackup-option-reference.md +++ b/docs/xtrabackup-option-reference.md @@ -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). @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 diff --git a/docs/yum-download-rpm.md b/docs/yum-download-rpm.md index 28786cbd..0c73fcd2 100644 --- a/docs/yum-download-rpm.md +++ b/docs/yum-download-rpm.md @@ -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 diff --git a/variables.yml b/variables.yml index 747625e5..d29a6e12 100644 --- a/variables.yml +++ b/variables.yml @@ -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'