Router.addActiveInterface()

Method

Declaration

NeighborInterface addActiveInterface(
    java.lang.String  localHost,
    int               localPort
    java.lang.String  remoteHost,
    int               remotePort,
    java.lang.String  neighborName,
    int               cost,
    boolean           compressed,
    boolean           encrypted,
    java.lang.String  peerCertificate)
  throws ConfigurationException
NeighborInterface addActiveInterface(
    int               localPort
    java.lang.String  remoteHost,
    int               remotePort,
    java.lang.String  neighborName,
    int               cost,
    boolean           compressed,
    boolean           encrypted,
    java.lang.String  peerCertificate)
  throws ConfigurationException
NeighborInterface addActiveInterface(
    int               localPort
    java.lang.String  remoteHost,
    int               remotePort,
    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 actively connects with its neighbor.

Remarks

Use this method to specify a neighbor interface in which the local router actively attempts to connect to the remote neighbor.

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 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.

remoteHost

The local router will seek its neighbor running on this host computer. Supply either a resolvable hostname, or the IP address of the computer in a remote network where the neighboring daemon is running. For more information, see Remote Connection Information in TIBCO Rendezvous Administration.

remotePort

The local router will use this TCP port to request a neighbor connection with the remote router. The remote router must listen for neighbor requests on this port. For more information, see Remote Connection Information in TIBCO Rendezvous Administration.

neighborName

The local router will connect only with 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).

See Also

NeighborInterface

Router

Router.getNeighborInterfaces()

Router.removeNeighborInterface()

For the corresponding browser pages, see Add New Neighbor Interface in TIBCO Rendezvous Administration

For background information, see these sections:

Neighbors in TIBCO Rendezvous Administration
Accept Any as Neighbor in TIBCO Rendezvous Administration