Derby
  1. Derby
  2. DERBY-3637

Docs for attribute slaveHost should say what the attribute means when used with startSlave=true

    Details

    • Type: Improvement Improvement
    • Status: Open
    • Priority: Minor Minor
    • Resolution: Unresolved
    • Affects Version/s: 10.4.1.3
    • Fix Version/s: None
    • Component/s: Documentation, Replication
    • Labels:
      None

      Description

      The documentation for the replication feature describes the new JDBC connection attribute "slaveHost" this way:

      "Specifies the system that will serve as the slave for database replication." [1]

      This is true (if system == network host) when used on the master side in a replication scenario.
      However, when used on the slave side in conjunction with the "startSlave=true" attribute, the slaveHost attribute specifies the network interface on which Derby (the slave database) will listen for connections from the master. This is not clear from the description of the attribute in the reference guide, which also says

      "It may be specified in conjunction with the startSlave=true attribute; if it is not, the default value is localhost."

      If the slave is started on a host that is separate from the master host, then the slave must listen on an interface that is reachable from the master, e.g "slaveHost=0.0.0.0" (all network interfaces, IPv4). This is analogous to the Network Server's -h option and the derby.drda.host property, and should be clarified in the documentation.

      [1]: http://db.apache.org/derby/docs/dev/ref/rrefattribslavehost.html

        Activity

        No work has yet been logged on this issue.

          People

          • Assignee:
            Unassigned
            Reporter:
            John H. Embretsen
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:

              Development