2.3.5. WAN Participant

This type of Participant refers to a Initial Peers DomainParticipant that communicates with other WAN Participants in different networks. This Participant will work as bridge for every Participant working locally in the LAN and any other LAN that has a DDS Router with an active WAN Participant.

Warning

Do not try to communicate a WAN Participant with any other kind of Participant that is not of type WAN Participant.

2.3.5.1. Use case

Use this Participant to communicate an internal DDS network with other LANs through a WAN communication. Each of the networks to be connected require a running DDS Router, and the messages will be relayed from one to another depending on the topics filtered by each of them.

2.3.5.2. Kind aliases

  • wan

  • router

  • initial-peers

2.3.5.3. Configuration

The WAN Participant allows users to configure the listening and connection addresses (whether it should locate or be located by other remote Participants):

  • To configure the listening addresses, check the Listening Addresses configuration section.

  • To configure the connection addresses to connect with other Wan Participants, check the Connection Addresses configuration section.

Note

The network addresses set in listening-addresses and connection-addresses use UDP transport by default if the transport is not specified in the address configuration.

2.3.5.3.1. Repeater

This Participant allows a tag repeater to be used as a TURN server. Please refer to section Repeater DDS Router for more information.

2.3.5.3.2. WAN Configuration

Refer to section WAN Configuration for a detailed explanation on how to correctly configure the DDS Router for WAN communication.

2.3.5.4. Configuration Example

Configure a WAN Participant. It listens for clients in public IP 82.0.0.1 in port 11600 in TCP. It connects with a remote Participant in IPv6 address 2001:4860:4860::8888 and port 11666 using TCP transport.

- name: wan_participant                       # Participant Name = wan_participant

  kind: wan

  listening-addresses:                        # WAN Participant Listening Addresses
    - ip: 82.0.0.1                            # Use UDP by default
      port: 11600

  connection-addresses:                       # Another WAN Participant Listening Addresses
    - ip: 2001:4860:4860::8888
      port: 11666
      transport: tcp                          # Use UDP transport