Chapter 5. Network Connections
Connections define how the router communicates with clients, other routers, and brokers. You can configure incoming connections to define how the router listens for data from clients and other routers, and you can configure outgoing connections to define how the router sends data to other routers and brokers.
5.1. Listening for Incoming Connections
Listening for incoming connections involves setting the host and port on which the router should listen for traffic.
Procedure
In the router’s configuration file, add a
listener
:listener { host: HOST_NAME/ADDRESS port: PORT_NUMBER/NAME ... }
host
- Either an IP address (IPv4 or IPv6) or hostname on which the router should listen for incoming connections.
port
- The port number or symbolic service name on which the router should listen for incoming connections.
For information about additional attributes, see Listener in the Configuration Reference.
If necessary, secure the connection.
If you have set up SSL/TLS or SASL in your environment, you can configure the router to only accept encrypted or authenticated communication on this connection.
-
If you want the router to listen for incoming connections on additional hosts or ports, configure an additional
listener
entity for each host and port.
5.2. Adding Outgoing Connections
Configuring outgoing connections involves setting the host and port on which the router should connect to other routers and brokers.
Procedure
In the router’s configuration file, add a
connector
:connector { name: NAME host: HOST_NAME/ADDRESS port: PORT_NUMBER/NAME ... }
name
-
The name of the
connector
. You should specify a name that describes the entity to which the connector connects. This name is used by configured addresses (for example, alinkRoute
entity) in order to specify which connection should be used for them. host
- Either an IP address (IPv4 or IPv6) or hostname on which the router should connect.
port
- The port number or symbolic service name on which the router should connect.
For information about additional attributes, see Connector in the Configuration Reference.
If necessary, secure the connection.
If you have set up SSL/TLS or SASL in your environment, you can configure the router to only send encrypted or authenticated communication on this connection.
-
For each remaining router or broker to which this router should connect, configure an additional
connector
entity.