mirror of
https://github.com/vyos/vyos-documentation.git
synced 2025-10-26 08:41:46 +01:00
67 lines
2.2 KiB
ReStructuredText
67 lines
2.2 KiB
ReStructuredText
.. _udp_broadcast_relay:
|
|
|
|
###################
|
|
UDP Broadcast Relay
|
|
###################
|
|
|
|
Certain vendors use broadcasts to identify their equipment within one ethernet
|
|
segment. Unfortunately if you split your network with multiple VLANs you loose
|
|
the ability of identifying your equipment.
|
|
|
|
This is where "UDP broadcast relay" comes into play! It will forward received
|
|
broadcasts to other configured networks.
|
|
|
|
Every UDP port which will be forward requires one unique ID. Currently we
|
|
support 99 IDs!
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
.. cfgcmd:: set service broadcast-relay id <n> description <description>
|
|
|
|
A description can be added for each and every unique relay ID. This is
|
|
useful to distinguish between multiple different ports/appliactions.
|
|
|
|
.. cfgcmd:: set service broadcast-relay id <n> interface <interface>
|
|
|
|
The interface used to receive and relay individual broadcast packets. If you
|
|
want to receive/relay packets on both `eth1` and `eth2` both interfaces need
|
|
to be added.
|
|
|
|
.. cfgcmd:: set service broadcast-relay id <n> address <ipv4-address>
|
|
|
|
Set the source IP of forwarded packets, otherwise original senders address
|
|
is used.
|
|
|
|
.. cfgcmd:: set service broadcast-relay id <n> port <port>
|
|
|
|
The UDP port number used by your apllication. It is mandatory for this kind
|
|
of operation.
|
|
|
|
.. cfgcmd:: set service broadcast-relay id <n> disable
|
|
|
|
Each broadcast relay instance can be individually disabled without deleting
|
|
the configured node by using the following command:
|
|
|
|
.. cfgcmd:: set service broadcast-relay disable
|
|
|
|
In addition you can also disable the whole service without the need to remove
|
|
it from the current configuration.
|
|
|
|
.. note:: You can run the UDP broadcast relay service on multiple routers
|
|
connected to a subnet. There is **NO** UDP broadcast relay packet storm!
|
|
|
|
Example
|
|
-------
|
|
|
|
To forward all broadcast packets received on `UDP port 1900` on `eth3`, `eth4`
|
|
or `eth5` to all other interfaces in this configuration.
|
|
|
|
.. code-block:: none
|
|
|
|
set service broadcast-relay id 1 description 'SONOS'
|
|
set service broadcast-relay id 1 interface 'eth3'
|
|
set service broadcast-relay id 1 interface 'eth4'
|
|
set service broadcast-relay id 1 interface 'eth5'
|
|
set service broadcast-relay id 1 port '1900'
|