Bug 1595684

Summary: Document the new multipathing configuration that is needed by load-balancing RFE-1575529
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Neha Berry <nberry>
Component: doc-Container_Native_Storage_with_OpenShiftAssignee: Bhavana <bmohanra>
Status: CLOSED CURRENTRELEASE QA Contact: Neha Berry <nberry>
Severity: medium Docs Contact:
Priority: unspecified    
Version: cns-3.10CC: asriram, bmohanra, pprakash, prasanna.kalever, rcyriac, rhs-bugs, sankarshan, storage-doc, xiubli
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-09-14 14:21:55 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1568866    

Description Neha Berry 2018-06-27 11:05:56 UTC 
Document URL: 
++++++++++++++++

Based on RFE - https://bugzilla.redhat.com/show_bug.cgi?id=1575529

In CNS 3.10 documentation with gluster-block related section, we would need to add the new multipath configuration details so as to support the load-balancing feature introduced as per RFE-1575529

In gluster-block versions prior to gluster-block-0.2.1-19.el7rhgs, there was no load-balancing feature enabled and hence we were using "prio:const" in /etc/multipath.conf file of initiators.

As part of specifying priorities, we will now have two target portal groups per storage object i.e. glfs_tg_pt_gp_ao and glfs_tg_pt_gp_ano, active optimized (AO) and active non optimized(ANO). AO will have prio 50 and ANO will have priority 10.

And to use this benefit, on the initiator side we will have to set 'prio alua'

# cat /etc/multipath.conf
[...]
# LIO iSCSI
devices {
        device {
                vendor "LIO-ORG"
                user_friendly_names "yes" # names like mpatha
                path_grouping_policy "failover" # one path per group
                path_selector "round-robin 0"
                failback immediate
                path_checker "tur"
                prio "alua"
                no_path_retry 120
                rr_weight "uniform"
        }
}




Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information: 


Description of problem:


Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info: