[LUDOC-314] Create additions to the Lustre manual for IU's nodemap feature.

• Status: Resolved
• Project: Lustre Documentation
• Type: New Feature
• Priority: Minor
• Reporter: Chris Hanna
• Assignee: Andreas Dilger
• Resolution: Fixed
• Labels: 2.9

Issue Links

• is related to: LUDOC-196 Complete Lustre Manual updates for UI...

Comments

[Chris Hanna]

I've been tasked with creating this documentation. Do you have any suggestions as to where in the manual the documentation should land?

[Richard Henwood (Inactive)]

Thanks for this Chris.

Can you add in a label for the Lustre version this feature will be present in?

Also, is there an LU ticket you can link to?

[Richard Henwood (Inactive)]

The ultimate destination is the Operations Manual:

https://build.hpdd.intel.com/job/lustre-manual/lastSuccessfulBuild/artifact/lustre_manual.xhtml

[Chris Hanna]

Hi Richard,

The LU for the feature is 3291:
https://jira.hpdd.intel.com/browse/LU-3291

The feature is currently a technology preview in 2.7, with more landing in 2.8, but the documentation will reflect features up to 2.9. I would edit the label to 2.9, but it doesn't seem I have the permissions to.

Would a section in the operation manual heading III (Administering Lustre), between 22-23 be an appropriate location for this documentation? It should include a description and example use case of the nodemap feature.

[Richard Henwood (Inactive)]

Location sounds good, and outline sounds good.

[Chris Hanna]

Hi Richard,

I seem to be in a Gerrit rabbit-hole in which I cannot reset my password, and my current password does not work (although it works just fine here in HPDD Jira). Can I attach the new LustreNodemap.xml file and one-line change to III_LustreAdministration.xml here for review?

[Richard Henwood (Inactive)]

Yes, you can attached it here.

I'm curious about your Gerrit issue: which auth provider do you use?

[Chris Hanna]

Thanks. I used HPDD auth (https://id.hpdd.intel.com/openidserver/). Perhaps that isn't what I think it is.

I've attached both files. LustreNodemap.xml is brand new, and the only change to III_LustreAdministration was to add a line for the new file. Any feedback is welcome.

The git commit was to be:
LUDOC-314: Additions for Lustre manual for nodemap feature.

Added a chapter in the Lustre manual to describe the
nodemap LU-3291 terminology, briefly demonstrate use
cases and setup, and describe potential pitfalls.

[Richard Henwood (Inactive)]

I've checked and the HPDD auth provider does not allow anyone other than HPDD employees to authenticate against Gerrit.

You must use a Google account, a Yahoo account, or an other OpenID provider to log into Gerrit.

[Gerrit Updater]

Kit Westneat ([e-mail]) uploaded a new patch: http://review.whamcloud.com/17634
Subject: LUDOC-314 nodemap: first commit of nodemap documentation
Project: doc/manual
Branch: master
Current Patch Set: 1
Commit: f522a4b1a3edabf75859760e7f2237c762187249

[Kit Westneat]

Thanks for getting this together Chris, it's way better than anything I would have written. I uploaded it to gerrit and added some comments and suggestions.

Also, there's at least one place in the manual that references the need to have client UIDs and GIDs matched on the MDS. Ideally these would mention nodemap now. Here's the one I saw:
https://build.hpdd.intel.com/job/lustre-manual/lastSuccessfulBuild/artifact/lustre_manual.xhtml#section_rh2_d4w_gk

[Gerrit Updater]

Andreas Dilger ([e-mail]) merged in patch http://review.whamcloud.com/17634/
Subject: LUDOC-314 nodemap: first commit of nodemap documentation
Project: doc/manual
Branch: master
Current Patch Set:
Commit: 88bc91ba3b3cf4a077604097d387f1c938f9637d