routeros-scripts/doc/mod/bridge-port-vlan.md

2.9 KiB

Manage VLANs on bridge ports

◀ Go back to main README

🛈 This module can not be used on its own but requires the base installation. See main README for details.

Description

This module and its function are supposed to handle VLANs on bridge ports.

Requirements and installation

Just install the module:

$ScriptInstallUpdate mod/bridge-port-vlan;

Configuration

Using named VLANs you have to add comments in bridge vlan menu:

/ interface bridge vlan add bridge=bridge comment=intern tagged=br-local vlan-ids=10;
/ interface bridge vlan add bridge=bridge comment=geust tagged=br-local vlan-ids=20;
/ interface bridge vlan add bridge=bridge comment=extra tagged=br-local vlan-ids=30;

The configuration goes to ports' comments (/ interface bridge port).

/ interface bridge port add bridge=bridge comment="default=dhcp-client, alt=guest" disabled=yes interface=en1;
/ interface bridge port add bridge=bridge comment="default=intern, alt=guest, extra=30" interface=en2;
/ interface bridge port add bridge=bridge comment="default=guest, extra=extra" interface=en3;

Also dhcp client can be handled:

/ ip dhcp-client add comment="toggle with bridge port" disabled=no interface=en1;

Add a scheduler to start with default setup on system startup:

/ system scheduler add name=bridge-port-vlan on-event=":global GlobalFunctionsReady; :while (\$GlobalFunctionsReady != true) do={ :delay 500ms; }; :global BridgePortVlan; \$BridgePortVlan default;" start-time=startup;

Usage and invocation

The usage examples show what happens with the configuration from above.

Running the function $BridgePortVlan with parameter default applies all configuration given with default=:

$BridgePortVlan default;

For the three interfaces we get this configuration:

  • The special value dhcp-client enables the dhcp client for interface en1. The bridge port entry is disabled.
  • Primary VLAN intern (ID 10) is configured on en2.
  • Primary VLAN guest (ID 20) is configured on en3.

Running the function $BridgePortVlan with parameter alt applies all configuration given with alt=:

$BridgePortVlan alt;
  • Primary VLAN guest (ID 20) is configured on en1, dhcp client for the interface is disabled.
  • Primary VLAN guest (ID 20) is configured on en2.
  • Interface en3 is unchanged, primary VLAN guest (ID 20) is unchanged.

Running the function $BridgePortVlan with parameter extra applies another configuration:

  • Interface en1 is unchanged.
  • Primary VLAN extra (via its ID 30) is configured on en2.
  • Primary VLAN extra (ID 30) is configured on en3.

See also


◀ Go back to main README
▲ Go back to top