[LUDOC-441] Documentation needed for MR Routing Created: 11/Jun/19  Updated: 24/Apr/20  Resolved: 07/Nov/19

Status: Resolved
Project: Lustre Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: Lustre 2.13.0 Manual

Type: New Feature Priority: Blocker
Reporter: Joseph Gmitter (Inactive) Assignee: Amir Shehata (Inactive)
Resolution: Fixed Votes: 0
Labels: None

Attachments: PDF File LNet-Multi-RailRoutingUserDocumentation-110619-1724-5549.pdf    
Issue Links:
Gantt End to End
has to be finished together with LU-11297 Align LNet routing with Multi-Rail an... Resolved
Rank (Obsolete): 9223372036854775807

 Description   

Documentation for the feature work captured in LU-11297.



 Comments   
Comment by Joseph Gmitter (Inactive) [ 11/Jun/19 ]

PDF version of the doc attached, which needs to be translated into a docbook patch.

Comment by Joseph Gmitter (Inactive) [ 19/Aug/19 ]

"The following changes are brought in" - you are speaking to what was added in 2.13?

Also, we already have a Multi-Rail Routing section (16.5) in the ops manual, which was taken from https://wiki.whamcloud.com/display/LNet/Multi-Rail+%28MR%29+Routing. Can you integrate that material with this material so that someone can make a patch to update the manual?

Comment by Amir Shehata (Inactive) [ 26/Aug/19 ]

That section shows how to configure Multi-Rail with the routing feature before the Multi-Rail Routing Feature landed in 2.13. Routing code has always monitored the state of the route, in order to avoid using unavailable ones. This section describes how you can configure multiple interfaces on the same gateway node but as different routes. This way we can use the existing route monitoring algorithm to guard against interfaces going down.

With the Multi-Rail routing feature which landed in 2.13 the new algorithm uses the health feature to monitor the different interfaces of the gateway and always ensures that we use the healthiest interface. Therefore, the configuration trick described on this wiki page is no longer needed, however, can still work.

Comment by Gerrit Updater [ 25/Oct/19 ]

Joseph Gmitter (jgmitter@whamcloud.com) uploaded a new patch: https://review.whamcloud.com/36573
Subject: LUDOC-441 lnet: Add Multi-Rail Routing Documentation
Project: doc/manual
Branch: master
Current Patch Set: 1
Commit: b16d0e5b90a17c183b878e96e6f0ed1c38ae8f55

Comment by Joseph Gmitter (Inactive) [ 25/Oct/19 ]

The patch above is an initial, direct translation from the wiki page noted above.

ashehata please be on the lookout for the review feedback (including my own) and update the patch accordingly.

Comment by Gerrit Updater [ 07/Nov/19 ]

Joseph Gmitter (jgmitter@whamcloud.com) merged in patch https://review.whamcloud.com/36573/
Subject: LUDOC-441 lnet: Add Multi-Rail Routing Documentation
Project: doc/manual
Branch: master
Current Patch Set:
Commit: 1c600ce8d3a2dec1134376536470736e35a855cf

Generated at Sat Feb 10 03:42:57 UTC 2024 using Jira 9.4.14#940014-sha1:734e6822bbf0d45eff9af51f82432957f73aa32c.