View source for WiFi roaming setup for home/small office

__TOC__

==Introduction==
This article provides a basic configuration example of WiFi roaming.

==Prerequisites==
* Main gateway with WAN access (Any RUTOS router. RUTXR1 is used in this example)
* Access Points (Any WiFi-capable RUTOS device. RUTX11 (Router 1) and RUT955 (Router 2) are used in this example)
* All devices on <b><i>R_00.02.05.1</i></b> or newer firmware. Legacy firmware is not supported.

Before you start configuring the router <b>turn on "Advanced WebUI" mode</b>. You can do that by clicking the "Basic" button under "Mode", which is located at the top-right corner of the WebUI. 

[[File:Networking_rutx_manual_webui_basic_advanced_mode_v1.gif|border|class=tlt-border]]

==Configuration==

[[File:Networking rutos configuration examples wifi roaming configuration scheme v2.png|border|class=tlt-border]]

===Gateway router===
----
# Login to the router's WebUI, navigate to the '''Network → Interfaces → Edit LAN''' page. Enter main gateway's IP address and save. We will leave it default (192.168.1.1) for this example.

[[File:Networking rutos configuration examples wifi roaming 1 v1.png|border|class=tlt-border]]

===Access Points===
----
<ol>
  <li>Connect your AP to the gateway router using LAN to LAN connection.</li>
  <li>Login to the router's WebUI, navigate to the '''Network → Interfaces → Edit LAN''' page. Configure as follows:</li>
  <ol>
    <li>Enter IP address on the same subnet as main gateway. We will use 192.168.1.2 for Router 1 and 192.168.1.3 for Router 2 in this example.</li>
    <li>Enter <b>IPv4 gateway</b>. We will use our gateway router's IP - 192.168.1.1.</li>
    <li>Disable <b>DHCP server</b>.</li>
  </ol>
</ol>

[[File:Networking rutos configuration examples wifi roaming 2 v1.png|border|class=tlt-border]]

<ol start="3">
  <li>Alternatively, instead of manually configuring each interface, you can select <b>DHCP</b> Protocol and let it decide the address.</li>
</ol>

[[File:Networking rutos configuration examples wifi roaming 3 v1.png|border|class=tlt-border]]

<b>Note: </b>The configuration below applies to all APs and must match:

<ol start="4">
  <li>Navigate to the '''Network → Wireless → Edit AP''' page. Configure an existing AP follows or create a new one:</li>
  <ol>
    <li>Change AP SSID. We will use "WifiRoam" for this example.</li>
    <li>Select Network - <b>lan</b></li>
  </ol>
</ol>

[[File:Networking rutos configuration examples wifi roaming 4 v1.png|border|class=tlt-border]]

<ol start="5">
  <li>Navigate to the '''Wireless Security''' section. Configure as follows:</li>
  <ol>
    <li>Choose encryption. We will leave default WPA2-PSK.</li>
    <li>Enter the password.</li>
    <li>Enable <b>802.11r Fast Transition</b></li>
    <li>Enter the <b>Mobility Domain</b>. Leave empty or choose a 4 character hexadecimal ID, i.e. <i>abcd</i></li>
  </ol>
</ol>

[[File:Networking rutos configuration examples wifi roaming 5 v1.png|border|class=tlt-border]]

==Results==
The single AP should now be visible on your WiFi devices (an iOS phone is used in this example).

[[File:Networking rutos configuration examples wifi roaming result v1.png|border|class=tlt-border]]

==Testing the setup==
If you followed all the steps correctly, WiFi roaming should now function accordingly. You may test it by connecting to the WiFi network. You should see that the gateway IP is our main gateway router's LAN IP. 

[[File:Networking rutos configuration examples wifi roaming testing 1 v1.png|border|class=tlt-border]]

Additionally, we can see that there is a client connected in Router 1 WebUI. There should be working internet connection on our wireless device (phone).

[[File:Networking rutos configuration examples wifi roaming testing 2 v1.png|border|class=tlt-border]]

We can also disable the wireless AP on Router 1 to see if our wireless device (phone) will automatically switch to the other AP and retain internet connection.

[[File:Networking rutos configuration examples wifi roaming testing 3 v2.png|border|class=tlt-border]]

==Troubleshooting==
* Make sure you have no other devices with a DHCP server on the same subnet as main gateway router.
* Make sure each Access Point is configured identically.
* We cannot guarantee full wireless coverage for each individual setup, therefore if you are losing the connection, make sure that the physical locations of each AP are set up accordingly.
[[Category:WIFI]]