Uploaded image for project: 'Lustre Documentation'
  1. Lustre Documentation
  2. LUDOC-322

reinstate Kerberos chapter in the manual

Details

    • Improvement
    • Resolution: Fixed
    • Minor
    • Lustre 2.14.0 Manual
    • 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

          [LUDOC-322] reinstate Kerberos chapter in the manual
          gerrit Gerrit Updater added a comment -

          Andreas Dilger (adilger@whamcloud.com) merged in patch https://review.whamcloud.com/41425/
          Subject: LUDOC-322 sec: reinstate Kerberos doc
          Project: doc/manual
          Branch: master
          Current Patch Set:
          Commit: 2c82bcd0e7356e9c228a95800789febec5fdc6b7

          gerrit Gerrit Updater added a comment - Andreas Dilger (adilger@whamcloud.com) merged in patch https://review.whamcloud.com/41425/ Subject: LUDOC-322 sec: reinstate Kerberos doc Project: doc/manual Branch: master Current Patch Set: Commit: 2c82bcd0e7356e9c228a95800789febec5fdc6b7
          gerrit Gerrit Updater added a comment -

          Sebastien Buisson (sbuisson@ddn.com) uploaded a new patch: https://review.whamcloud.com/41425
          Subject: LUDOC-322 sec: reinstate Kerberos doc
          Project: doc/manual
          Branch: master
          Current Patch Set: 1
          Commit: 83e0d7eeb52472650ecac926892e7449717b1325

          gerrit Gerrit Updater added a comment - Sebastien Buisson (sbuisson@ddn.com) uploaded a new patch: https://review.whamcloud.com/41425 Subject: LUDOC-322 sec: reinstate Kerberos doc Project: doc/manual Branch: master Current Patch Set: 1 Commit: 83e0d7eeb52472650ecac926892e7449717b1325
          sebastien Sebastien Buisson added a comment -

          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:

          pandoc -f docx -t docbook -o newdocbook.dbk --standalone original.docx
          sebastien Sebastien Buisson added a comment - 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: pandoc -f docx -t docbook -o newdocbook.dbk --standalone original.docx
          adilger Andreas Dilger added a comment -

          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.

          adilger Andreas Dilger added a comment - 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.
          sebastien Sebastien Buisson added a comment -

          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 Sebastien Buisson added a comment - 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?
          adilger Andreas Dilger added a comment -

          Sebastien, is there any chance you could look into this?

          adilger Andreas Dilger added a comment - Sebastien, is there any chance you could look into this?
          adilger Andreas Dilger added a comment -

          Sebastien, would you be able to copy and update the old Kerberos chapter back into the manual.

          adilger Andreas Dilger added a comment - Sebastien, would you be able to copy and update the old Kerberos chapter back into the manual.
          adilger Andreas Dilger added a comment - - edited

          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.

          adilger Andreas Dilger added a comment - - edited 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.

          People

            sebastien Sebastien Buisson
            adilger Andreas Dilger
            Votes:
            0 Vote for this issue
            Watchers:
            6 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: