Details
-
Improvement
-
Resolution: Fixed
-
Minor
-
Lustre 2.13.0 Manual, Lustre 2.14.0 Manual
-
9223372036854775807
Description
There was a chapter describing Kerberos configuration in the original Lustre user manual (https://docs.oracle.com/cd/E19527-01/821-2076-10/821-2076-10.pdf#G18.5529) that was deleted from the user manual because this feature was never supported. Now that work has been done to resurrect the Kerberos functionality this chapter should also be restored to the manual.
Unfortunately, the content of this chapter is somewhat out of date and would need to be updated before it is usable.
Attachments
Activity
Sebastien, it might be possible to import the HTML from that chapter into Word or maybe LibreOffice and then export it as Docbook. I believe that something similar was done for the original manual.
As a first step, I will copy the text from the documentations referenced above. There is also the old Lustre wiki that can be a good source as well:
http://wiki.old.lustre.org/index.php/GSS_/_Kerberos
Is there any convenient way to convert from HTML to the XML being used for the LOM?
Sebastien, would you be able to copy and update the old Kerberos chapter back into the manual.
The Kerberos section of the Lustre 1.8 manual is available on the old Lustre wiki in HTML format. Not sure if that can be converted to XML easily? https://wiki.lustre.org/images/3/3c/821-0035-12.pdf#G18.5529
It should probably remove any references to supporting DES and 3DES encryption, or explicitly state that these encryption algorithms are insecure today. Similarly, it should replace example uses of "CLUSTERFS.COM" with "LUSTRE.ORG" or similar.
I managed to generate a docbook documentation from HTML by first opening the HTML document into Word, save it as a Word document, and then run the following pandoc command: