942c9b6ed8
Update Source to upstream version 0.8.2 * Previoud patches 0001-0017 & 0027 are included in this commit Rename files * Previous patches 0018-0026 & 0028 are not patches 0021-0030 Add 0001-libmultipath-make-vector_foreach_slot_backwards-work.patch Add 0002-libmultipath-add-marginal-paths-and-groups-infrastru.patch Add 0003-tests-add-path-grouping-policy-unit-tests.patch Add 0004-libmultipath-add-wrapper-function-around-pgpolicyfn.patch Add 0005-tests-update-pgpolicy-tests-to-work-with-group_paths.patch Add 0006-libmultipath-fix-double-free-in-pgpolicyfn-error-pat.patch Add 0007-libmultipath-consolidate-group_by_-functions.patch Add 0008-libmultipath-make-pgpolicyfn-take-a-paths-vector.patch Add 0009-libmultipath-make-group_paths-handle-marginal-paths.patch Add 0010-tests-add-tests-for-grouping-marginal-paths.patch Add 0011-libmultipath-add-marginal_pathgroups-config-option.patch Add 0012-libmutipath-deprecate-delay_-_checks.patch Add 0013-multipathd-use-marginal_pathgroups.patch Add 0014-multipath-update-man-pages.patch * The above 13 patches add the marinal_pathgroups option Add 0015-multipath.conf-add-enable_foreign-parameter.patch Add 0016-multipath.conf.5-document-foreign-library-support.patch * The above 2 patches add the enable_foreign option Add 0017-mpathpersist-remove-broken-unused-code.patch Add 0018-libmultipath-EMC-PowerMax-NVMe-device-config.patch Add 0019-mpathpersist-fix-leaks.patch Add 0020-libmultipath-fix-mpcontext-initialization.patch * The above 20 patches have been submitted upstream
100 lines
4.5 KiB
Diff
100 lines
4.5 KiB
Diff
From 0992a545413cf2bcbde18c90f04b9e5b1077fd62 Mon Sep 17 00:00:00 2001
|
|
From: Benjamin Marzinski <bmarzins@redhat.com>
|
|
Date: Thu, 1 Aug 2019 16:29:41 -0500
|
|
Subject: [PATCH] multipath: update man pages
|
|
|
|
Add documentation for the marginal_pathgroups option and the
|
|
(un)setmarginal commands.
|
|
|
|
Signed-off-by: Benjamin Marzinski <bmarzins@redhat.com>
|
|
---
|
|
multipath/multipath.conf.5 | 34 ++++++++++++++++++++++++++++++----
|
|
multipathd/multipathd.8 | 19 +++++++++++++++++++
|
|
2 files changed, 49 insertions(+), 4 deletions(-)
|
|
|
|
diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5
|
|
index 08297a41..ac8eadd0 100644
|
|
--- a/multipath/multipath.conf.5
|
|
+++ b/multipath/multipath.conf.5
|
|
@@ -1042,6 +1042,28 @@ The default is: \fBno\fR
|
|
.
|
|
.
|
|
.TP
|
|
+.B marginal_pathgroups
|
|
+If set to \fIno\fR, the \fIdelay_*_checks\fR, \fImarginal_path_*\fR, and
|
|
+\fIsan_path_err_*\fR options will keep marginal, or \(dqshaky\(dq, paths from
|
|
+being reinstated until they have been monitored for some time. This can cause
|
|
+situations where all non-marginal paths are down, and no paths are usable
|
|
+until multipathd detects this and reinstates a marginal path. If the multipath
|
|
+device is not configured to queue IO in this case, it can cause IO errors to
|
|
+occur, even though there are marginal paths available. However, if this
|
|
+option is set to \fIyes\fR, when one of the marginal path detecting methods
|
|
+determines that a path is marginal, it will be reinstated and placed in a
|
|
+seperate pathgroup that will only be used after all the non-marginal pathgroups
|
|
+have been tried first. This prevents the possibility of IO errors occuring
|
|
+while marginal paths are still usable. After the path has been monitored
|
|
+for the configured time, and is declared healthy, it will be returned to its
|
|
+normal pathgroup. See "Shaky paths detection" below for more information.
|
|
+.RS
|
|
+.TP
|
|
+The default is: \fBno\fR
|
|
+.RE
|
|
+.
|
|
+.
|
|
+.TP
|
|
.B find_multipaths
|
|
This option controls whether multipath and multipathd try to create multipath
|
|
maps over non-blacklisted devices they encounter. This matters a) when a device is
|
|
@@ -1689,10 +1711,14 @@ events. \fImultipathd\fR supports three different methods for detecting this
|
|
situation and dealing with it. All methods share the same basic mode of
|
|
operation: If a path is found to be \(dqshaky\(dq or \(dqflipping\(dq,
|
|
and appears to be in healthy status, it is not reinstated (put back to use)
|
|
-immediately. Instead, it is watched for some time, and only reinstated
|
|
-if the healthy state appears to be stable. The logic of determining
|
|
-\(dqshaky\(dq condition, as well as the logic when to reinstate,
|
|
-differs between the three methods.
|
|
+immediately. Instead, it is placed in the \(dqdelayed\(dq state and watched
|
|
+for some time, and only reinstated if the healthy state appears to be stable.
|
|
+If the \fImarginal_pathgroups\fR option is set, the path will reinstated
|
|
+immediately, but placed in a special pathgroup for marginal paths. Marginal
|
|
+pathgroups will not be used until all other pathgroups have been tried. At the
|
|
+time when the path would normally be reinstated, it will be returned to its
|
|
+normal pathgroup. The logic of determining \(dqshaky\(dq condition, as well as
|
|
+the logic when to reinstate, differs between the three methods.
|
|
.TP 8
|
|
.B \(dqdelay_checks\(dq failure tracking
|
|
This method is \fBdeprecated\fR and mapped to the \(dqsan_path_err\(dq method.
|
|
diff --git a/multipathd/multipathd.8 b/multipathd/multipathd.8
|
|
index edac7a92..048a838d 100644
|
|
--- a/multipathd/multipathd.8
|
|
+++ b/multipathd/multipathd.8
|
|
@@ -277,6 +277,25 @@ Remove the persistent reservation key associated with $map from the
|
|
\fIreservation_key\fR is set to \fBfile\fR in \fI/etc/multipath.conf\fR.
|
|
.
|
|
.TP
|
|
+.B path $path setmarginal
|
|
+move $path to a marginal pathgroup. The path will remain in the marginal
|
|
+path group until \fIunsetmarginal\fR is called. This command will only
|
|
+work if \fImarginal_pathgroups\fR is enabled and there is no Shaky paths
|
|
+detection method configured (see the multipath.conf man page for details).
|
|
+.
|
|
+.TP
|
|
+.B path $path unsetmarginal
|
|
+return marginal path $path to its normal pathgroup. This command will only
|
|
+work if \fImarginal_pathgroups\fR is enabled and there is no Shaky paths
|
|
+detection method configured (see the multipath.conf man page for details).
|
|
+.
|
|
+.TP
|
|
+.B map $map unsetmarginal
|
|
+return all marginal paths in $map to their normal pathgroups. This command
|
|
+will only work if \fImarginal_pathgroups\fR is enabled and there is no Shaky
|
|
+paths detection method configured (see the multipath.conf man page for details).
|
|
+.
|
|
+.TP
|
|
.B quit|exit
|
|
End interactive session.
|
|
.
|
|
--
|
|
2.17.2
|
|
|