[LUDOC-441] Documentation needed for MR Routing

• Type: New Feature
• Resolution: Fixed
• Priority: Blocker
• Fix Version/s: Lustre 2.13.0 Manual
• Assignee: Amir Shehata (Inactive)
• Reporter: Joseph Gmitter (Inactive)

Description

Documentation for the feature work captured in LU-11297.

Issue Links

• has to be finished together with: LU-11297 Align LNet routing with Multi-Rail and LNet health

Comments

[Gerrit Updater]

Joseph Gmitter ([e-mail]) 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

[Joseph Gmitter (Inactive)]

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.

[Gerrit Updater]

Joseph Gmitter ([e-mail]) 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

[Amir Shehata (Inactive)]

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.

[Joseph Gmitter (Inactive)]

"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?

[Joseph Gmitter (Inactive)]

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