From ee2a2e336c7e62a5a9c253ea20888b4d0e954007 Mon Sep 17 00:00:00 2001
From: Patrick Birch <48594400+patrickbirch@users.noreply.github.com>
Date: Fri, 6 Dec 2024 10:20:26 -0600
Subject: [PATCH] PXC-4572 [DOCS] - PXC needs a local socket to work properly

	modified:   docs/limitation.md
	modified:   docs/state-snapshot-transfer.md
---
 docs/limitation.md              | 12 +++++++++++-
 docs/state-snapshot-transfer.md |  8 ++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/limitation.md b/docs/limitation.md
index 3b0fa80c..69ce0b6d 100644
--- a/docs/limitation.md
+++ b/docs/limitation.md
@@ -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.
+
+    If you skip the socket creation with `socket=` in my.cnf, the server does not create the 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
 
@@ -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.
diff --git a/docs/state-snapshot-transfer.md b/docs/state-snapshot-transfer.md
index 37b1fcc3..59643fad 100644
--- a/docs/state-snapshot-transfer.md
+++ b/docs/state-snapshot-transfer.md
@@ -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