Router.addPassiveInterface()

Method

Declaration

NeighborInterface addPassiveInterface(
    java.lang.String  localHost,
    int               localPort
    java.lang.String  neighborName,
    int               cost,
    boolean           compressed,
    boolean           encrypted,
    java.lang.String  peerCertificate)
  throws ConfigurationException
NeighborInterface addPassiveInterface(
    int               localPort
    java.lang.String  neighborName,
    int               cost,
    boolean           compressed,
    boolean           encrypted,
    java.lang.String  peerCertificate)
  throws ConfigurationException
NeighborInterface addPassiveInterface(
    int               localPort
    java.lang.String  neighborName,
    int               cost,
    boolean           encrypted,
    java.lang.String  peerCertificate)
  throws ConfigurationException

Note	Use the first form when the router is release 7.2 or later. Use the second form when the router is release 7.1 (it is deprecated for later releases). Use the third form when the router is release 7.0.

Purpose

Specify a neighbor interface that passively accepts connections from its neighbor.

Remarks

Use this method to specify a neighbor interface in which the local router does not actively attempt to connect to the remote neighbor. Instead, it passively waits for the remote neighbor to request a connection.

On a BorderRouter, this method automatically configures the default policy for all pairings of the new interface with every other existing interface. The default policy forwards _INBOX.> (all inbox subjects); for additional details, see Policy on page 105 in TIBCO Rendezvous Administration.

Parameter	Description
`localHost`	The local router will listen on this network interface for neighbor connection requests from remote routers. Supply an IP address or hostname denoting a local network interface. For more information, see Local Host in TIBCO Rendezvous Administration.
`localPort`	The local router will listen on this local TCP port for neighbor connection requests from its remote neighbor. For more information, see Local Connect Port in TIBCO Rendezvous Administration.
`neighborName`	The local router will passively accept neighbor connections only from this remote router.
`cost`	The path cost of this neighbor link; see Load Balancing in TIBCO Rendezvous Administration. You may supply the default cost, NeighborInterface.DEFAULT_COST.
`compressed`	When `true`, the new neighbor interface compresses outbound data and uncompresses inbound data. When `false`, the new neighbor interface does not compress data. Notice that it is inconsistent for one neighbor to compress data while the other does not. Neighbors must agree concerning compression, otherwise they cannot establish a connection. Rendezvous routing daemons support data compression in release 7.1 and later; earlier releases do not. When the routing daemon does not support data compression, use the form of this method that omits this parameter.
`encrypted`	When `true`, the two neighbors must communicate using TLS protocols. When `false`, the two neighbors must communicate using non-secure protocols. Notice that both neighbors must use the same protocols, otherwise they cannot establish a connection.
`peerCertificate`	In TLS protocols, the local router expects the remote router to present this certificate as evidence of its identity. Supply the text of the public certificate (in PEM encoding).

Router.addPassiveInterface()

Declaration

Purpose

Remarks

See Also