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

• Type: New Feature
• Resolution: Fixed
• Priority: Minor
• Labels: 2.9
• Assignee: Andreas Dilger
• Reporter: Chris Hanna (Inactive)

Issue Links

• is related to: LUDOC-196 Complete Lustre Manual updates for UID/GID Mapping

Comments

[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

[Kit Westneat (Inactive)]

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]

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

[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.

[Chris Hanna (Inactive)]

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)]

Yes, you can attached it here.

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

[Chris Hanna (Inactive)]

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)]

Location sounds good, and outline sounds good.

[Chris Hanna (Inactive)]

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)]

The ultimate destination is the Operations Manual:

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