Open topic with navigation

TIBCO Rendezvous® 8.7.0

# 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

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2023. Cloud Software Group, Inc. All Rights Reserved.