leafnodes
Configuration for setting up leaf node connections.
Properties
Incoming Connections
A server that has been configured to accept connections from one or more leaf nodes. This would be the hub in a hub-and-spoke topology, for example.
| Name | Description | Type | Default | Reloadable |
|---|---|---|---|---|
host | Host name the server will listen on for incoming leaf node connections. | string | 0.0.0.0 | No |
port | Port the server will listen for incoming leaf node connections. | integer | 7422 | No* |
listen | string | - | No | |
tls | TLS configuration for securing leaf node connections. | object | - | Yes* |
advertise | Hostport to advertise how this sever be contacted by leaf nodes. This is useful for setups with a NAT. | string | - | No |
no_advertise | If true, the server will not be advertised to leaf nodes. | boolean | false | No |
authorization | Authorization scoped to accepting leaf node connections. | object | - | No |
isolate_leafnode_interest | Do not propagate subscription interest learned from one leaf node to the others attached to this server. | boolean | false | No |
write_deadline | How long a leaf node write may block before the connection is treated as stalled. | duration | 10s | No |
write_timeout | What to do when a leaf node connection misses its write_deadline. | string | default | No |
min_version | The minimum server version required of the connecting leaf node. This must be at least version 2.8.0. | string | - | No |
compression | Defines the compression mode to use for an incoming leafnode connection. If set to on, it will use the s2_auto. | (multiple) | - | Yes* |
* See the property page for reload caveats.
Outgoing Connections
A server that has been configured to connect to another server configured to accept leaf node connections. In a hub-and-spoke topology, this would be the spoke, typically in a remote location or on an edge device.
| Name | Description | Type | Default | Reloadable |
|---|---|---|---|---|
remotes | List of entries specifiying servers where the leaf node client connection can be made. | object | - | No |
reconnect | Interval in seconds at which reconnect attempts to a remote server are made. | integer | - | No |