Changes

1,872 bytes added ,  11:31, 12 April 2023
no edit summary
Line 1: Line 1:  +
<p style="color:red">The information in this page is updated in accordance with [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.03'''] firmware version.</p>
 +
 
==Introduction==
 
==Introduction==
This article contains instructions on how to configure
+
This article contains instructions on how to do UCI-based configuration for setting up RelayD with IPv4+IPv6 support.
 
   
==Tunnelbroker configuration==
 
==Tunnelbroker configuration==
===Login===
+
Tunnelbroker is a website operated by Hurricane Electric, a leading provider of internet services and networking solutions. The website provides a service called Hurricane Electric IPv6 Tunnel Broker, which allows users to create an IPv6 tunnel between their network and Hurricane Electric's network. This allows users to connect their devices to the internet using the IPv6 protocol, even if their internet service provider (ISP) does not support IPv6.
 +
====Login====
 
----
 
----
 
Go to [http://tunnelbroker.net tunnelbroker.net] and log into your account. If you don't have a registered account then you will need to create one - click '''register'''.
 
Go to [http://tunnelbroker.net tunnelbroker.net] and log into your account. If you don't have a registered account then you will need to create one - click '''register'''.
[[File:Tunnelbroker login.png|border|center|class=tlt-border|1004x1004px]]
+
[[File:Tunnelbroker login v2.png|border|center|class=tlt-border|1022 × 385px]]
   −
===IPv6 to IPv4 tunnel setup===
+
====IPv6 to IPv4 tunnel creation====
Setup IPv6 over IPv4, also known as 6in4 IPv6 transition mechanism
   
----
 
----
 +
Setup IPv6 over IPv4, also known as 6in4 IPv6 transition mechanism. To create a new tunnel:
 +
# Click on '''create regular tunnel''',
 +
# '''Enter''' your '''public IP''' (it will light up green, if the tunnel can be created with this IP),
 +
# '''Select''' the desired '''tunnel server''',
   −
To create a new tunnel, click on '''create regular tunnel''' ('''1'''), then '''enter''' your '''public IP''' (it will light up green, if the tunnel can be created with this IP) ('''2'''), '''select''' the desired '''tunnel server''' ('''3''') and '''create tunnel''' ('''4''').
+
To establish the tunnel, at the bottom of the page, you should see '''Create tunnel'''.
   −
[[File:Create IPv6 Tunnel.png|border|center|class=tlt-border|854x854px]]
+
[[File:Create IPv6 Tunnel v2.png|border|center|class=tlt-border|844 × 688px]]
    
After successful tunnel creation, you will be prompt to tunnel details window.
 
After successful tunnel creation, you will be prompt to tunnel details window.
   −
[[File:IPv6 Tunnel created.png|border|center|class=tlt-border|454x454px]]
+
[[File:IPv6 Tunnel created v2.png|border|center|class=tlt-border|663 × 638px]]
 +
 
 +
To create a a tunnel instance on your RUT router, navigate to '''example configurations''', there, select '''OpenWRT Barrier Breaker'''.
 +
and paste the following '''commands''' '''into''' your '''router CLI'''.
   −
To create a a tunnel instance on your RUT router, '''navigate''' to '''example configurations''' ('''1''') and select '''OpenWRT Barrier Breaker''' ('''2'''). Copy and paste the following commands into your RUT CLI. Do not forget to '''replace''' '''YOUR_TUNNELBORKER_USERNAME''' and '''YOUR_TUNNELBROKER_PASSWORD''' with your '''TunnelBroker account username''' and '''password'''.
+
[[File:Tunnel interface v2.png|border|center|class=tlt-border|661 × 641px]]
   −
[[File:Tunnel interface.png|border|center|class=tlt-border|554x554px]]
+
'''Note''': Do not forget to '''replace''' '''YOUR_TUNNELBORKER_USERNAME''' and '''YOUR_TUNNELBROKER_PASSWORD''' with your '''TunnelBroker account username''' and '''password'''.
   −
In the RUT CLI you can see that the new interface has been successfully created.
     −
[[File:Tunnel RUT interface created.png|border|center|class=tlt-border|554x554px]]
+
Use the  <code><span class="highlight" >'''cat /etc/config/network'''</span></code> command in routers CLI to see if the new interface was successfully created.
   −
==Relayd configuration==
+
[[File:Tunnel RUT interface created v2.png|border|center|class=tlt-border|507 × 169px]]
 +
==Router configuration==
 +
===Relayd and interface configuration using UCI===
 +
----
 
Relay is a daemon (computer program that runs as a background process) used to relay and dynamically redirect incoming connections to a target host. Its main purpose in RUTxxx routers is to extend the wireless network. For example, when RUTxxx is in STA Wireless Station mode, it can be used to bridge WAN and LAN interfaces to create a larger Wireless network.
 
Relay is a daemon (computer program that runs as a background process) used to relay and dynamically redirect incoming connections to a target host. Its main purpose in RUTxxx routers is to extend the wireless network. For example, when RUTxxx is in STA Wireless Station mode, it can be used to bridge WAN and LAN interfaces to create a larger Wireless network.
   −
This article provides an extensive configuration example of a basic Relay usage scenario with two RUTxxx devices.
+
[[UCI_command_usage|Unified Configuration Interface (UCI)]] is a small utility written in C (a shell script-wrapper is available as well) and is intended to centralize the whole configuration of a device running on OpenWrt.
===Relayd installation===
+
====Relayd installation====
 
----
 
----
 
Install relayd package if needed, skip this step on RUTX series devices or if you already installed it on your router
 
Install relayd package if needed, skip this step on RUTX series devices or if you already installed it on your router
Line 38: Line 48:  
opkg install relayd</pre>
 
opkg install relayd</pre>
   −
===WiFi client configuration===
+
====WiFi client configuration====
 
----
 
----
 
Add WiFi interface to make your router act as a WiFi client (connect to another AP)
 
Add WiFi interface to make your router act as a WiFi client (connect to another AP)
Line 53: Line 63:  
Change SSID here to an SSID that the router will be connecting to
 
Change SSID here to an SSID that the router will be connecting to
   −
<pre>uci set wireless.@wifi-iface[-1].ssid='RUT_4474_2G'</pre>
+
<pre>uci set wireless.@wifi-iface[-1].ssid='RUT1_SSID'</pre>
    
Change BSSID here to BSSID that the router will be connecting to (L2 address)
 
Change BSSID here to BSSID that the router will be connecting to (L2 address)
   −
<pre>uci set wireless.@wifi-iface[-1].bssid='00:1E:42:44:44:74'</pre>
+
<pre>uci set wireless.@wifi-iface[-1].bssid='RUT1_BSSID'</pre>
   −
Use appropriate auth method, PSK2 = WPA2-PSK here
+
Use appropriate encryption method, PSK2 = WPA2-PSK here
    
<pre>uci set wireless.@wifi-iface[-1].encryption='psk2'</pre>
 
<pre>uci set wireless.@wifi-iface[-1].encryption='psk2'</pre>
Line 65: Line 75:  
Change secret to appropriate one
 
Change secret to appropriate one
   −
<pre>uci set wireless.@wifi-iface[-1].key='Vc80Tps1'
+
<pre>uci set wireless.@wifi-iface[-1].key='SSID_PASSWORD'  
 
uci set wireless.@wifi-iface[-1].disabled='0'
 
uci set wireless.@wifi-iface[-1].disabled='0'
 
uci set wireless.@wifi-iface[-1].skip_inactivity_poll='0'
 
uci set wireless.@wifi-iface[-1].skip_inactivity_poll='0'
 
uci set wireless.@wifi-iface[-1].wifi_id='wifi1'</pre>
 
uci set wireless.@wifi-iface[-1].wifi_id='wifi1'</pre>
   −
===New internface configuration===
+
====IPv4 interface creation====
 
----
 
----
 +
Create a new interface IPv4 for WiFi WAN.
 
<pre>uci set network.wifi_wan=interface
 
<pre>uci set network.wifi_wan=interface
 
uci set network.wifi_wan.proto='dhcp'
 
uci set network.wifi_wan.proto='dhcp'
Line 79: Line 90:  
uci set network.wifi_wan.broadcast='0'</pre>
 
uci set network.wifi_wan.broadcast='0'</pre>
   −
Set mwan3 settings for new interface wifi_wan
+
Set mwan3 settings for new interface
    
<pre>uci set mwan3.wifi_wan=interface
 
<pre>uci set mwan3.wifi_wan=interface
Line 104: Line 115:  
uci add_list mwan3.balance_default.use_member='wifi_wan_member_balance'</pre>
 
uci add_list mwan3.balance_default.use_member='wifi_wan_member_balance'</pre>
   −
===IPv6 interface creation===
+
====IPv6 interface creation====
 
----
 
----
 +
Create a new IPv6 interface for WiFi WAN
 
<pre>uci set network.wifi_wan6=interface
 
<pre>uci set network.wifi_wan6=interface
 
uci set network.wifi_wan6.proto='dhcpv6'
 
uci set network.wifi_wan6.proto='dhcpv6'
Line 144: Line 156:  
uci set mwan3.default_rule_ipv6.family='ipv6'</pre>
 
uci set mwan3.default_rule_ipv6.family='ipv6'</pre>
   −
===LAN interface configuration===
+
====LAN interface configuration====
 
----
 
----
 +
Configure a LAN interface accordingly.
 
<pre>uci set network.lan_repeater=interface
 
<pre>uci set network.lan_repeater=interface
 
uci set network.lan_repeater.proto='relay'
 
uci set network.lan_repeater.proto='relay'
Line 151: Line 164:  
uci set network.lan_repeater.enabled='1'
 
uci set network.lan_repeater.enabled='1'
 
uci set network.lan_repeater.network='lan wifi_wan'</pre>
 
uci set network.lan_repeater.network='lan wifi_wan'</pre>
  −
<pre>uci set network.lan.ipaddr='192.168.1.3'</pre>
      
Set DHCP settings for LAN interface (disable dhcp on LAN) and enable IPv6 relay on wifi_wan interface and  
 
Set DHCP settings for LAN interface (disable dhcp on LAN) and enable IPv6 relay on wifi_wan interface and  
Line 167: Line 178:  
uci set dhcp.wifi_wan.ndp='relay'</pre>
 
uci set dhcp.wifi_wan.ndp='relay'</pre>
   −
===Firewall configuration===
+
====Firewall configuration====
 
----
 
----
Set firewall zone, using WAN firewall zone for newly created wifi_wan network interface
+
Set firewall zone, using WAN firewall zone for newly created WiFi WAN network interface.
 
   
<pre>uci set firewall.@zone[1].network='wan wan6 mob1s1a1 mob1s2a1 wifi_wan'</pre>
 
<pre>uci set firewall.@zone[1].network='wan wan6 mob1s1a1 mob1s2a1 wifi_wan'</pre>
   −
===Commit changes===
+
====Commit changes====
 
----
 
----
 
Save all the changes and restart the configuration
 
Save all the changes and restart the configuration
   
<pre>uci commit
 
<pre>uci commit
 
reload_config</pre>
 
reload_config</pre>
   −
==Test results==
+
==Testing the setup==
 +
If you've taken all of the steps described above, the configuration is done. But as with any other configuration, it is always wise to test the set up in order to make sure that it works properly.
 +
 
 +
* Check what IP address are you getting on [https://whatismyipaddress.com What is my IP address] website.
 +
 
 +
[[File:WhatismyIP.png|border|center|class=tlt-border|1088 × 393px]]
 +
 
 +
* You can also check what IP address you are getting via command line interface.
 +
 
 +
[[File:IPV6 on PC.png|border|center|class=tlt-border|701 × 434px]]
 +
 
 +
[[File:Cmdoutput IPv6.png|border|center|class=tlt-border|634 × 244px]]
 +
 
 +
==See also==
 +
More information about [[RUTOS_relay_/_Wi-Fi_extender_/_repeater_/_bridge_configuration|RelayD]]
 +
==External links==
 +
More about [http://tunnelbroker.net TunnelBroker.net]