Derby
  1. Derby
  2. DERBY-5212

Reference Manual: language on authentication/authorization needs changes for several URL attribute topics

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.8.1.2
    • Fix Version/s: 10.8.2.2, 10.9.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      Comments on DERBY-5203 show that we should modify the language on authentication and authorization in some of the URL attribute topics in the Reference Manual. Details will be provided in a comment.

      1. DERBY-5212.zip
        11 kB
        Kim Haase
      2. DERBY-5212.stat
        0.2 kB
        Kim Haase
      3. DERBY-5212.diff
        6 kB
        Kim Haase

        Issue Links

          Activity

          Hide
          Kim Haase added a comment -

          Knut Anders researched this issue extensively and reported his findings in DERBY-5203. His conclusions are as follows.

          I propose this new wording for all replication attributes (I think it applies to all, but I've only tested startSlave=true and startMaster=true), and for drop=true:

          "If authentication is turned on, you must also specify this attribute in conjunction with the user=userName and password=userPassword
          attributes. If both authentication and SQL authorization are turned on, the user must be the database owner."

          For shutdown=true, we could use the same wording with the extra qualification that it only applies to shutdown of a single database. We would also need to mention that system shutdown requires user=userName/password=userPassword if both authentication and SQL authorization are enabled.

          Show
          Kim Haase added a comment - Knut Anders researched this issue extensively and reported his findings in DERBY-5203 . His conclusions are as follows. I propose this new wording for all replication attributes (I think it applies to all, but I've only tested startSlave=true and startMaster=true), and for drop=true: "If authentication is turned on, you must also specify this attribute in conjunction with the user=userName and password=userPassword attributes. If both authentication and SQL authorization are turned on, the user must be the database owner." For shutdown=true, we could use the same wording with the extra qualification that it only applies to shutdown of a single database. We would also need to mention that system shutdown requires user=userName/password=userPassword if both authentication and SQL authorization are enabled.
          Hide
          Kim Haase added a comment -

          Attaching DERBY-5212.diff, DERBY-5212.stat, and DERBY-5212.zip, with changes to the following files:

          M src/ref/rrefattribdrop.dita
          M src/ref/rrefattribstartmaster.dita
          M src/ref/rrefattribstartslave.dita
          M src/ref/rrefattribstopmaster.dita
          M src/ref/rrefattrib16471.dita

          The documentation of the stopSlave and failover attributes appears to be correct as is, and slaveHost and slavePort depend on startMaster.

          Please let me know if further changes are needed.

          Show
          Kim Haase added a comment - Attaching DERBY-5212 .diff, DERBY-5212 .stat, and DERBY-5212 .zip, with changes to the following files: M src/ref/rrefattribdrop.dita M src/ref/rrefattribstartmaster.dita M src/ref/rrefattribstartslave.dita M src/ref/rrefattribstopmaster.dita M src/ref/rrefattrib16471.dita The documentation of the stopSlave and failover attributes appears to be correct as is, and slaveHost and slavePort depend on startMaster. Please let me know if further changes are needed.
          Hide
          Knut Anders Hatlen added a comment -

          Hi Kim,
          These changes look good to me. +1 to commit.

          Show
          Knut Anders Hatlen added a comment - Hi Kim, These changes look good to me. +1 to commit.
          Hide
          Kim Haase added a comment -

          Committed patch DERBY-5212.diff to documentation trunk at revision 1099086.
          Merged to 10.8 doc branch at revision 1099093.

          Show
          Kim Haase added a comment - Committed patch DERBY-5212 .diff to documentation trunk at revision 1099086. Merged to 10.8 doc branch at revision 1099093.
          Hide
          Kim Haase added a comment -

          Changes have appeared in Latest Alpha Manuals.

          Show
          Kim Haase added a comment - Changes have appeared in Latest Alpha Manuals.

            People

            • Assignee:
              Kim Haase
              Reporter:
              Kim Haase
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development