Changes between Initial Version and Version 1 of OpenWrt/network_config

Timestamp:

10/22/2017 05:28:45 AM (7 years ago)

Author:

trac

Comment:

--

OpenWrt/network_config

@@ +1 @@
+[[PageOutline]]
+
+= OpenWrt Network Configuration =
+OpenWrt completely replaces the conventional Linux distribution methods of network configuration. The various config files are replaced with the Unified Configuration Interface or [http://wiki.openwrt.org/doc/uci UCI].
+
+OpenWrt manages its own 'virtual' network interface names in /etc/config/network.
+
+See Also:
+ * [http://wiki.openwrt.org/doc/uci/wireless OpenWrt Wiki for Wireless]
+ * [http://wiki.openwrt.org/doc/uci OpenWrt UCI]
+ * [wiki:OpenWrt/wireless OpenWrt Wireless]
+
+== UCI and config files ==
+You can use the {{{uci}}} command-line utility to get/set configuration or edit the files directly under /system/config (if you know what your doing). Often we will provide uci command-line examples because these can be easily cut-n-pasted into a shell.
+
+UCI configuration can be edited in the files in /etc/config directly or by using {{{uci}}} commands. Often we will provide uci command-line examples because these can be easily cut-n-pasted into a shell.
+
+Network configuration is contained in /etc/config/network.
+
+Example configuration for a single ENET interface:
+ * looking at /etc/config/network
+{{{
+root@OpenWrt:/# cat /etc/config/network
+config interface 'loopback'
+        option ifname 'lo'
+        option proto 'static'
+        option ipaddr '127.0.0.1'
+        option netmask '255.0.0.0'
+
+config interface 'lan'
+        option ifname 'eth0'
+        option type 'bridge'
+        option proto 'static'
+        option ipaddr '192.168.1.1'
+        option netmask '255.255.255.0'
+        option ip6assign '60'
+
+config interface 'wan6'
+        option ifname '@wan'
+        option proto 'dhcpv6'
+
+config globals 'globals'
+        option ula_prefix 'fda7:b97b:37b2::/48'
+
+}}}
+ * using UCI:
+{{{
+root@OpenWrt:/# uci show network
+network.loopback=interface
+network.loopback.ifname=lo
+network.loopback.proto=static
+network.loopback.ipaddr=127.0.0.1
+network.loopback.netmask=255.0.0.0
+network.lan=interface
+network.lan.ifname=eth0
+network.lan.type=bridge
+network.lan.proto=static
+network.lan.ipaddr=192.168.1.1
+network.lan.netmask=255.255.255.0
+network.lan.ip6assign=60
+network.wan6=interface
+network.wan6.ifname=@wan
+network.wan6.proto=dhcpv6
+network.globals=globals
+network.globals.ula_prefix=fda7:b97b:37b2::/48
+}}}
+
+
+To change the IP address of the '''lan''' network which is configured as a bridge containing the '''eth0''' interface using UCI:
+{{{
+uci set network.lan.ipaddr 192.168.1.2
+uci commit
+}}}
+
+You can restart the networking by typing the following command:
+{{{
+/etc/init.d/network restart
+}}}
+
+
+[=#stp]
+== Spanning Tree Protocol - STP ==
+The Spanning Tree Protocol (STP) is a network protocol that builds a logical loop-free topology for Ethernet networks. The basic function of STP is to prevent bridge loops and the broadcast radiation that results from them.
+
+By default bridges are configured without STP thus if you connected multiple ports in a bridge to a LAN you would create a bridge loop.
+
+You can enable STP to avoid bridge loops if you do want to connect multiple ports in a bridge to a LAN for redundancy purposes. To do so, edit {{{/etc/config/network}}} and add an {{{option stp 1}}} to the interface.
+
+For example:
+{{{
+config interface 'lan'
+        option ifname 'eth0'
+        option force_link '1'
+        option type 'bridge'
+        option proto 'static'
+        option ipaddr '192.168.1.1'
+        option netmask '255.255.255.0'
+        option ip6assign '60'
+        option stp      1
+
+}}}
+
+Verify with the brctl show command:
+{{{
+root@OpenWrt:/# brctl show
+bridge name     bridge id               STP enabled     interfaces
+br-lan          7fff.00d0127af035       yes             eth0
+}}}