diff options
author | Christian Poessinger <christian@poessinger.com> | 2019-08-05 15:50:55 +0200 |
---|---|---|
committer | Christian Poessinger <christian@poessinger.com> | 2019-11-07 21:54:22 +0100 |
commit | 9c87432239795df17c92ed1409bf72375d003a28 (patch) | |
tree | 049d6ed586234ec43275dca7e6ac242a6f862c81 /docs/interfaces/bridging.rst | |
parent | 0de54083437d84cb678d7d2676e6a2128e6baad4 (diff) | |
download | vyos-documentation-9c87432239795df17c92ed1409bf72375d003a28.tar.gz vyos-documentation-9c87432239795df17c92ed1409bf72375d003a28.zip |
bridge: T1556: adopt to new bridge syntax
Diffstat (limited to 'docs/interfaces/bridging.rst')
-rw-r--r-- | docs/interfaces/bridging.rst | 43 |
1 files changed, 24 insertions, 19 deletions
diff --git a/docs/interfaces/bridging.rst b/docs/interfaces/bridging.rst index e42d76ad..dbd5f0db 100644 --- a/docs/interfaces/bridging.rst +++ b/docs/interfaces/bridging.rst @@ -5,15 +5,23 @@ Interfaces in VyOS can be bridged together to provide software switching of Layer-2 traffic. A bridge is created when a bridge interface is defined. In the example below -we will be creating a bridge for VLAN 100 and assigning a VIF to the bridge. +we create a bridge named br100 with eth1 and eth2 as the bridge member ports. .. code-block:: sh set interfaces bridge 'br100' - ~~set interfaces ethernet eth1 vif 100 bridge-group bridge br100~~ - set interfaces bridge br100 member interface eth1 - -Interfaces assigned to a bridge-group do not have address configuration. An IP + set interfaces bridge br100 member interface eth1 + set interfaces bridge br100 member interface eth2 + +Each bridge member can be assiged a port cost and priority using the following +commands: + +.. code-block:: sh + + set interfaces bridge br100 member interface eth1 cost 10 + set interfaces bridge br100 member interface eth1 priority 1024 + +Interfaces assigned to a bridge do not have address configuration. An IP address can be assigned to the bridge interface itself, however, like any normal interface. @@ -29,16 +37,17 @@ Example Result: bridge br100 { address 192.168.100.1/24 address 2001:db8:100::1/64 - } - [...] - ethernet eth1 { - [...] - vif 100 { - bridge-group { - bridge br100 + member { + interface eth1 { + cost 10 + priority 1024 + } + interface eth2 { } } + } + [...] In addition to normal IP interface configuration, bridge interfaces support Spanning-Tree Protocol. STP is disabled by default. @@ -46,20 +55,16 @@ Spanning-Tree Protocol. STP is disabled by default. .. note:: Please use caution when introducing spanning-tree protocol on a network as it may result in topology changes. -To enable spanning-tree use the -`set interfaces bridge <name> stp true` command: +To enable spanning-tree use the `set interfaces bridge <name> stp` command: .. code-block:: sh - set interfaces bridge br100 stp true + set interfaces bridge br100 stp STP `priority`, `forwarding-delay`, `hello-time`, and `max-age` can be -configured for the bridge-group. The MAC aging time can also be configured +configured for the bridge. The MAC aging time can also be configured using the `aging` directive. -For member interfaces, the bridge-group `priority` and `cost` can be -configured. - The `show bridge` operational command can be used to display configured bridges: |