diff --git a/reference/mysqlnd_ms/concepts.xml b/reference/mysqlnd_ms/concepts.xml
index da834337b4..e907331fac 100755
--- a/reference/mysqlnd_ms/concepts.xml
+++ b/reference/mysqlnd_ms/concepts.xml
@@ -2312,12 +2312,14 @@ mysqlnd_ms_xa_commit($link, 1);
For each failed XA transaction the garbage collection makes
max_retries (default: 5) attempts to finish it. After that
- PECL/mysqlnd_ms gives up and the XA transaction must be
- cleaned up by a human operator. There are two possible reasons for this. Either
+ PECL/mysqlnd_ms gives up. There are two possible reasons for this. Either
a participating server crashed and has not become accessible again within
max_retries invocations of the garbage collection, or there
is a situation that the built-in garbage collection cannot cope with. Likely, the
- latter would be considered a bug.
+ latter would be considered a bug. However, you can manually force more
+ garbage collection runs calling mysqlnd_ms_xa_gc with the
+ appropriate parameter set. Should even those function runs fail to solve
+ the situation, then the problem must be solved by an operator.
The function mysqlnd_ms_get_stats
diff --git a/reference/mysqlnd_ms/functions/mysqlnd-ms-xa-gc.xml b/reference/mysqlnd_ms/functions/mysqlnd-ms-xa-gc.xml
index 6afe475e95..55fa0d157d 100644
--- a/reference/mysqlnd_ms/functions/mysqlnd-ms-xa-gc.xml
+++ b/reference/mysqlnd_ms/functions/mysqlnd-ms-xa-gc.xml
@@ -14,6 +14,8 @@
mysqlnd_ms_xa_gcmixedconnectionstringgtrid
+ booleanignore_max_retries
+
@@ -77,6 +79,21 @@
+
+ ignore_max_retries
+
+
+ Whether to ignore the plugin configuration max_retries setting.
+ If garbage collection continously fails and the max_retries
+ limit is reached prior to finishing the failed global transaction,
+ you can attempt further runs prior to investigating the cause
+ and solving the issue manually by issueing appropriate SQL statements
+ on the participants. Setting the parameter has the same effect
+ as temporarily setting max_retries = 0.
+
+
+
+
diff --git a/reference/mysqlnd_ms/setup.xml b/reference/mysqlnd_ms/setup.xml
index 6f5ba72eb8..aaee55bd49 100755
--- a/reference/mysqlnd_ms/setup.xml
+++ b/reference/mysqlnd_ms/setup.xml
@@ -3034,6 +3034,9 @@ CREATE TABLE mysqlnd_ms_xa_gc (
long as crashed servers become available again quickly.
Still, a situation may arise where a human is required to
act because the built-in garbage collection stopped or failed.
+ In this case, you may first want to check if the transaction still
+ cannot be fixed by forcing mysqlnd_ms_xa_gc
+ to ignore the setting, prior to handling it manually.
Default: 5