diff mbox series

multipath-tools: add more info for NetApp RDAC arrays

Message ID 20220823233352.70881-1-xose.vazquez@gmail.com (mailing list archive)
State Not Applicable, archived
Delegated to: Mike Snitzer
Headers show
Series multipath-tools: add more info for NetApp RDAC arrays | expand

Commit Message

Xose Vazquez Perez Aug. 23, 2022, 11:33 p.m. UTC
From:
https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-49E94674-947F-4921-A1D1-CE9B42DCBA39.html
https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-CA17AE34-F5B2-4FF4-8FD4-4A7AA4238976.html
https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-3DA657A9-FF4A-4237-90EC-BA8863B7431E.html

To use ALUA mode, "Automatic Load Balancing" should be enabled and
"Select operating system:" should be changed to "Linux DM-MP (Kernel 3.10 or later)".

To use RDAC mode, "Automatic Load Balancing" should be disabled and
"Select operating system:" should be changed to "Linux DM-MP (Kernel 3.9 or earlier)".


Add it to prio and hardware_handler, and to alua info.


Cc: NetApp RDAC team <ng-eseries-upstream-maintainers@netapp.com>
Cc: Martin Wilck <mwilck@suse.com>
Cc: Benjamin Marzinski <bmarzins@redhat.com>
Cc: Christophe Varoqui <christophe.varoqui@opensvc.com>
Cc: DM-DEVEL ML <dm-devel@redhat.com>
Signed-off-by: Xose Vazquez Perez <xose.vazquez@gmail.com>
---
 README.md                  | 5 +++--
 multipath/multipath.conf.5 | 8 +++++---
 2 files changed, 8 insertions(+), 5 deletions(-)

Comments

Martin Wilck Aug. 24, 2022, 8:23 a.m. UTC | #1
On Wed, 2022-08-24 at 01:33 +0200, Xose Vazquez Perez wrote:
> From:
> https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-49E94674-947F-4921-A1D1-CE9B42DCBA39.html
> https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-CA17AE34-F5B2-4FF4-8FD4-4A7AA4238976.html
> https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-3DA657A9-FF4A-4237-90EC-BA8863B7431E.html
> 
> To use ALUA mode, "Automatic Load Balancing" should be enabled and
> "Select operating system:" should be changed to "Linux DM-MP (Kernel
> 3.10 or later)".
> 
> To use RDAC mode, "Automatic Load Balancing" should be disabled and
> "Select operating system:" should be changed to "Linux DM-MP (Kernel
> 3.9 or earlier)".
> 
> 
> Add it to prio and hardware_handler, and to alua info.
> 
> 
> Cc: NetApp RDAC team <ng-eseries-upstream-maintainers@netapp.com>
> Cc: Martin Wilck <mwilck@suse.com>
> Cc: Benjamin Marzinski <bmarzins@redhat.com>
> Cc: Christophe Varoqui <christophe.varoqui@opensvc.com>
> Cc: DM-DEVEL ML <dm-devel@redhat.com>
> Signed-off-by: Xose Vazquez Perez <xose.vazquez@gmail.com>
> ---
>  README.md                  | 5 +++--
>  multipath/multipath.conf.5 | 8 +++++---
>  2 files changed, 8 insertions(+), 5 deletions(-)
> 
> diff --git a/README.md b/README.md
> index b05b1332..4e34c591 100644
> --- a/README.md
> +++ b/README.md
> @@ -165,8 +165,9 @@ To enable ALUA, the following options should be
> changed:
>     "LUN Affinity" and "ALUA" should be changed to "Enable",
> "Redundancy Type"
>     must be "Active-Active".
>  
> -- LSI/Engenio/NetApp RDAC class, as NetApp SANtricity E/EF Series
> and OEM arrays:
> -   "Select operating system:" should be changed to "Linux DM-MP
> (Kernel 3.10 or later)".
> +- LSI/Engenio/NetApp RDAC class, as NetApp SANtricity E/EF Series
> and rebranded arrays:
> +  "Automatic Load Balancing" should be enabled and "Select operating
> system:"
> +  should be changed to "Linux DM-MP (Kernel 3.10 or later)".
>  
>  - NetApp ONTAP:
>     To check ALUA state: "igroup show -v <igroup_name>", and to
> enable ALUA:
> diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5
> index acdd1ae6..58080990 100644
> --- a/multipath/multipath.conf.5
> +++ b/multipath/multipath.conf.5
> @@ -6,7 +6,7 @@
>  .\" Update the date below if you make any significant change.
>  .\" ----------------------------------------------------------------
> ------------
>  .
> -.TH MULTIPATH.CONF 5 2021-09-08 Linux
> +.TH MULTIPATH.CONF 5 2022-08-14 Linux
>  .
>  .
>  .\" ----------------------------------------------------------------
> ------------
> @@ -320,7 +320,8 @@ Generate the path priority for NetApp ONTAP
> class, and rebranded arrays.
>  .I rdac
>  (Hardware-dependent)
>  Generate the path priority for LSI/Engenio/NetApp RDAC class as
> NetApp SANtricity
> -E/EF Series, and rebranded arrays.
> +E/EF Series and rebranded arrays, with Automatic Load Balancing
> disabled and
> +Select operating system: Linux DM-MP (Kernel 3.9 or earlier).
>  .TP
>  .I hp_sw
>  (Hardware-dependent)
> @@ -1568,7 +1569,8 @@ with Failover Mode 1 (Passive Not Ready(PNR)).
>  .I 1 rdac
>  (Hardware-dependent)
>  Hardware handler for LSI/Engenio/NetApp RDAC class as NetApp
> SANtricity E/EF
> -Series, and rebranded arrays.
> +Series and rebranded arrays, with Automatic Load Balancing disabled
> and
> +Select operating system: Linux DM-MP (Kernel 3.9 or earlier).

Don't we handle RDAC just right with detect_prio and detect_checker set
to 1? I'd like to avoid adding wording here that suggest to the user
that she needs to tune settings, where it's actually not necessary.

Thanks,
Martin

--
dm-devel mailing list
dm-devel@redhat.com
https://listman.redhat.com/mailman/listinfo/dm-devel
Schremmer, Steven Aug. 24, 2022, 4:02 p.m. UTC | #2
> From: Martin Wilck <mwilck@suse.com>
> Sent: Wednesday, August 24, 2022 3:24 AM
> On Wed, 2022-08-24 at 01:33 +0200, Xose Vazquez Perez wrote:
> > From:
> > https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-
> 49E94674-947F-4921-A1D1-CE9B42DCBA39.html
> > https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-
> CA17AE34-F5B2-4FF4-8FD4-4A7AA4238976.html
> > https://library.netapp.com/ecmdocs/ECMLP2439710/html/GUID-
> 3DA657A9-FF4A-4237-90EC-BA8863B7431E.html
> >
> > To use ALUA mode, "Automatic Load Balancing" should be enabled and
> > "Select operating system:" should be changed to "Linux DM-MP (Kernel
> > 3.10 or later)".
> >
> > To use RDAC mode, "Automatic Load Balancing" should be disabled and
> > "Select operating system:" should be changed to "Linux DM-MP (Kernel
> > 3.9 or earlier)".
> >
> >
> > Add it to prio and hardware_handler, and to alua info.
> >
> >
> > Cc: NetApp RDAC team <ng-eseries-upstream-maintainers@netapp.com>
> > Cc: Martin Wilck <mwilck@suse.com>
> > Cc: Benjamin Marzinski <bmarzins@redhat.com>
> > Cc: Christophe Varoqui <christophe.varoqui@opensvc.com>
> > Cc: DM-DEVEL ML <dm-devel@redhat.com>
> > Signed-off-by: Xose Vazquez Perez <xose.vazquez@gmail.com>
> > ---
> >  README.md                  | 5 +++--
> >  multipath/multipath.conf.5 | 8 +++++---
> >  2 files changed, 8 insertions(+), 5 deletions(-)
> >
> > diff --git a/README.md b/README.md
> > index b05b1332..4e34c591 100644
> > --- a/README.md
> > +++ b/README.md
> > @@ -165,8 +165,9 @@ To enable ALUA, the following options should be
> > changed:
> >     "LUN Affinity" and "ALUA" should be changed to "Enable",
> > "Redundancy Type"
> >     must be "Active-Active".
> >
> > -- LSI/Engenio/NetApp RDAC class, as NetApp SANtricity E/EF Series
> > and OEM arrays:
> > -   "Select operating system:" should be changed to "Linux DM-MP
> > (Kernel 3.10 or later)".
> > +- LSI/Engenio/NetApp RDAC class, as NetApp SANtricity E/EF Series
> > and rebranded arrays:
> > +  "Automatic Load Balancing" should be enabled and "Select operating
> > system:"
> > +  should be changed to "Linux DM-MP (Kernel 3.10 or later)".
> >
> >  - NetApp ONTAP:
> >     To check ALUA state: "igroup show -v <igroup_name>", and to
> > enable ALUA:
> > diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5
> > index acdd1ae6..58080990 100644
> > --- a/multipath/multipath.conf.5
> > +++ b/multipath/multipath.conf.5
> > @@ -6,7 +6,7 @@
> >  .\" Update the date below if you make any significant change.
> >  .\" ----------------------------------------------------------------
> > ------------
> >  .
> > -.TH MULTIPATH.CONF 5 2021-09-08 Linux
> > +.TH MULTIPATH.CONF 5 2022-08-14 Linux
> >  .
> >  .
> >  .\" ----------------------------------------------------------------
> > ------------
> > @@ -320,7 +320,8 @@ Generate the path priority for NetApp ONTAP
> > class, and rebranded arrays.
> >  .I rdac
> >  (Hardware-dependent)
> >  Generate the path priority for LSI/Engenio/NetApp RDAC class as
> > NetApp SANtricity
> > -E/EF Series, and rebranded arrays.
> > +E/EF Series and rebranded arrays, with Automatic Load Balancing
> > disabled and
> > +Select operating system: Linux DM-MP (Kernel 3.9 or earlier).
> >  .TP
> >  .I hp_sw
> >  (Hardware-dependent)
> > @@ -1568,7 +1569,8 @@ with Failover Mode 1 (Passive Not Ready(PNR)).
> >  .I 1 rdac
> >  (Hardware-dependent)
> >  Hardware handler for LSI/Engenio/NetApp RDAC class as NetApp
> > SANtricity E/EF
> > -Series, and rebranded arrays.
> > +Series and rebranded arrays, with Automatic Load Balancing disabled
> > and
> > +Select operating system: Linux DM-MP (Kernel 3.9 or earlier).
> 
> Don't we handle RDAC just right with detect_prio and detect_checker set
> to 1? I'd like to avoid adding wording here that suggest to the user
> that she needs to tune settings, where it's actually not necessary.
> 
> Thanks,
> Martin

Yes, with the multipath defaults that have been in place for years now the
proper prio and checker get used.

The linked NetApp documentation is misleading, and I'll work to get that fixed
in the newer versions. Manual enable/disable of Automatic LUN Balancing is
NOT required as it follows the operating system type selected in the array
configuration.

Thanks,
Steve

--
dm-devel mailing list
dm-devel@redhat.com
https://listman.redhat.com/mailman/listinfo/dm-devel
diff mbox series

Patch

diff --git a/README.md b/README.md
index b05b1332..4e34c591 100644
--- a/README.md
+++ b/README.md
@@ -165,8 +165,9 @@  To enable ALUA, the following options should be changed:
    "LUN Affinity" and "ALUA" should be changed to "Enable", "Redundancy Type"
    must be "Active-Active".
 
-- LSI/Engenio/NetApp RDAC class, as NetApp SANtricity E/EF Series and OEM arrays:
-   "Select operating system:" should be changed to "Linux DM-MP (Kernel 3.10 or later)".
+- LSI/Engenio/NetApp RDAC class, as NetApp SANtricity E/EF Series and rebranded arrays:
+  "Automatic Load Balancing" should be enabled and "Select operating system:"
+  should be changed to "Linux DM-MP (Kernel 3.10 or later)".
 
 - NetApp ONTAP:
    To check ALUA state: "igroup show -v <igroup_name>", and to enable ALUA:
diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5
index acdd1ae6..58080990 100644
--- a/multipath/multipath.conf.5
+++ b/multipath/multipath.conf.5
@@ -6,7 +6,7 @@ 
 .\" Update the date below if you make any significant change.
 .\" ----------------------------------------------------------------------------
 .
-.TH MULTIPATH.CONF 5 2021-09-08 Linux
+.TH MULTIPATH.CONF 5 2022-08-14 Linux
 .
 .
 .\" ----------------------------------------------------------------------------
@@ -320,7 +320,8 @@  Generate the path priority for NetApp ONTAP class, and rebranded arrays.
 .I rdac
 (Hardware-dependent)
 Generate the path priority for LSI/Engenio/NetApp RDAC class as NetApp SANtricity
-E/EF Series, and rebranded arrays.
+E/EF Series and rebranded arrays, with Automatic Load Balancing disabled and
+Select operating system: Linux DM-MP (Kernel 3.9 or earlier).
 .TP
 .I hp_sw
 (Hardware-dependent)
@@ -1568,7 +1569,8 @@  with Failover Mode 1 (Passive Not Ready(PNR)).
 .I 1 rdac
 (Hardware-dependent)
 Hardware handler for LSI/Engenio/NetApp RDAC class as NetApp SANtricity E/EF
-Series, and rebranded arrays.
+Series and rebranded arrays, with Automatic Load Balancing disabled and
+Select operating system: Linux DM-MP (Kernel 3.9 or earlier).
 .TP
 .I 1 hp_sw
 (Hardware-dependent)