pam_slurm_adopt is cool, and AFAIK a unique capability for us. But we have *zero* documentation on the website for it - the only thing we ship is a README file in the source directory.
Can you make a page under doc/html page describing the setup and common configuration? You can steal the contents of that README almost verbatim, although I'd avoid mentioning some of the less-sane options it theoretically supports. (E.g., it mentions an argument meant to force root to be subject to the same restriction - but no one should ever use that, and the code itself intentionally refuses to enforce that option.)
You'll probably want to test this on the knc node - there are some installation quirks you'll want to document with RHEL7 (which most people would use it on), and you'd want to explicitly reference which config files to edit. (The most important thing is to disable pam_systemd, which will totally ruin everything forever if left enabled.)
*** Bug 4218 has been marked as a duplicate of this bug. ***
Documentation is live on the website.
Closing as resolved/fixed.
Actually, the FAQ needs to be fixed for question 9 under the "For Administrators" section. The update was confusing because it says "the rest is about pam_slurm" but doesn't actually talk about pam_slurm until the last paragraph.
Thanks Marshall. Committed, and tagging this as closed.
Author: Marshall Garey <firstname.lastname@example.org>
Date: Tue Mar 27 15:02:31 2018 -0600
Docs - update FAQ entry about use of PAM.