Skip to content

Update wsrep-system-index.md #230

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: 8.4
Choose a base branch
from
Open
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
19 changes: 5 additions & 14 deletions docs/wsrep-system-index.md
Original file line number Diff line number Diff line change
Expand Up @@ -1254,11 +1254,11 @@ Defines storage for streaming replication fragments. The available values are `t
| Config File: | Yes |
| Scope: | Global |
| Dynamic: | No |
| Default Value: | ``xtrabackup-v2`, `clone`` |
| Default Value: | ``xtrabackup-v2, clone`` |

Percona XtraDB Cluster 8.4.4-1 adds `clone` to the default value. For older versions of Percona XtraDB Cluster, the default value is `xtrabackup-v2`.

This variable limits SST methods accepted by the server for [wsrep_sst_method](#wsrep_sst_method) variable. The default value is `xtrabackup-v2`.
This variable limits SST methods accepted by the server for [wsrep_sst_method](#wsrep_sst_method) variable. The default value is `xtrabackup-v2` or `clone`.

### `wsrep_sst_donor`

Expand Down Expand Up @@ -1325,22 +1325,13 @@ Defines the method or script for [State Snapshot Transfer](state-snapshot-transf

Available values are:

* `xtrabackup-v2`: Uses *Percona XtraBackup* to perform SST. This value is the default.
Privileges and permissions for running *Percona XtraBackup*
* `xtrabackup-v2`: Uses Percona XtraBackup to perform SST. This value is the default.
Privileges and permissions for running Percona XtraBackup
can be found in [Percona XtraBackup documentation](https://docs.percona.com/percona-xtrabackup/8.0/privileges.html). For more information, see [Percona XtraBackup SST Configuration](xtrabackup-sst.md#xtrabackup-sst). The `xtrabackup-v2` method supports clusters with GTIDs and async replicas.

* `clone`: Introduced in Percona XtraDB Cluster 8.4.4-4, uses the [clone method for SST](clone-sst.md).

* `skip`: Use this to skip SST.
**Removed in Percona XtraDB Cluster 8.0.33-25.** This value can be used when initially starting the cluster
and manually restoring the same data to all nodes.
This value should not be used permanently because it could lead to data inconsistency across the nodes.

* `ist_only` : **Introduced in Percona XtraDB Cluster 8.0.33-25.** This value allows only Incremental State Transfer (IST). If a node cannot sync with the cluster with IST, abort that node's start. This action leaves the data directory unchanged. This value prevents starting a node, after a manual backup restoration, that does not have a `grastate.dat` file. This missing file could initiate a full-state transfer (SST) which can be a more time and resource-intensive operation.

!!! note

``xtrabackup-v2`` provides support for clusters with GTIDs and async replicas.
* `ist_only`: This value allows only Incremental State Transfer (IST). If a node cannot sync with the cluster with IST, abort that node's start. This action leaves the data directory unchanged. This value prevents starting a node that does not have a `grastate.dat` file after a manual backup restoration. This missing file could initiate a full-state transfer (SST), which can be more time- and resource-intensive.

!!! admonition "See also"

Expand Down