Skip to content

Commit

Permalink
PXC-4572 [DOCS] - PXC needs a local socket to work properly
Browse files Browse the repository at this point in the history
	modified:   docs/limitation.md
	modified:   docs/state-snapshot-transfer.md
  • Loading branch information
patrickbirch committed Dec 10, 2024
1 parent 3c0da6c commit 550bd0e
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 1 deletion.
12 changes: 11 additions & 1 deletion docs/limitation.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,16 @@ The following limitations apply to Percona XtraDB Cluster:
!!! admonition "See also"
[Galera Documentation: Tables without Primary Keys](https://galeracluster.com/library/training/tutorials/differences.html#tables-without-primary-keys)
* When configuring Percona XtraDB Cluster, your server must create a local socket.
You can set up a socket by providing a path, or you can skip creating one explicitly. However, do not leave the <socket> variable in my.cnf empty, like this: `socket=`. If you do, the server won’t create a socket.
State Snapshot Transfer (SST) requires the socket for the following tasks:
* Taking backup using Percona XtraBackup
* Detecting keyring component status
* Avoid reusing the names of persistent tables for temporary tables
Expand Down Expand Up @@ -110,4 +120,4 @@ Do not use one or more dot characters (.) when defining the values for the follo
* [log_bin_index](https://dev.mysql.com/doc/refman/8.0/en/replication-options-binary-log.html#option_mysqld_log-bin-index)
MySQL and **XtraBackup** handles the value in different ways and this difference causes unpredictable behavior.
MySQL and Percona XtraBackup handle the character in different ways and this difference causes unpredictable behavior.
8 changes: 8 additions & 0 deletions docs/state-snapshot-transfer.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,14 @@ The SST method can be configured using the [`wsrep_sst_method`](wsrep-system-ind
!!! note

If the [`gcs.sync_donor`](wsrep-provider-index.md#gcs.sync_donor) variable is set to `Yes` (default is `No`), the whole cluster will get blocked if the donor is blocked by SST.

## Limitation

When configuring Percona XtraDB Cluster, your server must create a local socket. If you skip the socket creation with `socket=` in my.cnf, the server does not create the socket. State Snapshot Transfer (SST) requires the local socket for the following tasks:

* Taking backup using Percona XtraBackup

* Detecting keyring component status

## Choose the SST Donor

Expand Down

0 comments on commit 550bd0e

Please sign in to comment.