Skip to content
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

PXC-4572 [DOCS] - PXC needs a local socket to work properly #182

Open
wants to merge 1 commit into
base: 8.0
Choose a base branch
from
Open
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
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. 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 local socket for the following tasks:

* Taking backup using Percona XtraBackup

* Detecting keyring component status

## Choose the SST Donor

Expand Down