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

3.9 KiB
Raw Permalink Blame History

Manage VLANs on bridge ports

GitHub stars GitHub forks GitHub watchers required RouterOS version Telegram group @routeros_scripts donate with PayPal

⬅️ Go back to main README

Info: 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:

$ScriptInstallUpdate global-wait;
/system/scheduler/add name=bridge-port-vlan on-event="/system/script/run global-wait; :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