[jira] Created: (DERBY-3637) Docs for attribute slaveHost should say what the attribute means when used with startSlave=true

["John H. Embretsen (JIRA)" <ji...@apache.org>]

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

                 Key: DERBY-3637
                 URL: https://issues.apache.org/jira/browse/DERBY-3637
             Project: Derby
          Issue Type: Improvement
          Components: Documentation, Replication
    Affects Versions: 10.4.1.3
            Reporter: John H. Embretsen
            Priority: Minor


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


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.