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

["Kim Haase (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DERBY-3637?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14129105#comment-14129105 ] 

Kim Haase commented on DERBY-3637:
----------------------------------

Still valid, I believe, though the description of the problem makes it hard to figure out exactly what needs to be said that would not confuse users too much. See http://db.apache.org/derby/docs/10.11/ref/rrefattribslavehost.html for the current topic.

I can't tell if the steps in "Starting and running replication" in the Admin Guide also need to be clarified.


> 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 was sent by Atlassian JIRA
(v6.3.4#6332)