GRE Tunnel configuration examples RutOS: Difference between revisions

From Teltonika Networks Wiki
(Created page with "==Introduction== '''Generic Routing Encapsulation''' ('''GRE''') is a tunneling protocol that can encapsulate a wide variety of network layer protocols inside virtual point-t...")
 
 
(5 intermediate revisions by the same user not shown)
Line 3: Line 3:
'''Generic Routing Encapsulation''' ('''GRE''') is a tunneling protocol that can encapsulate a wide variety of network layer protocols inside virtual point-to-point links over an Internet Protocol network.
'''Generic Routing Encapsulation''' ('''GRE''') is a tunneling protocol that can encapsulate a wide variety of network layer protocols inside virtual point-to-point links over an Internet Protocol network.


This article provides an extensive configuration example with details on how to create a tunnel connection between two GRE Tunnel instances, both of which configured on RUTxxx routers.
This article provides an extensive configuration example with details on how to create a tunnel connection between two GRE Tunnel instances, both of which are configured on RUTxxx routers.


==Configuration overview and prerequisites==
==Configuration overview and prerequisites==
Line 22: Line 22:
==Router configuration==
==Router configuration==


If you have familiarized yourself with the configuration scheme and have all of the devices in order, we can start configuring the routers using instructions provided in this section:
If you have familiarized yourself with the configuration scheme and have all of the devices in order, we can start configuring the routers using the instructions provided in this section:


* Login to the router's WebUI and go to '''Services → VPN → GRE Tunnel'''. Enter a name for the new instance and click the "Add" button. Do this on both routers:
* Login to the router's WebUI and go to '''Services → VPN → GRE Tunnel'''. Enter a name for the new instance and click the "Add" button. Do this on both routers:


[[File:How to add new gre tunnel instance v2.png]]
[[File:Networking rutxxx configuration examples gre instance v1.jpg|border|class=tlt-border|1100px]]
----
----
* Click the "Edit" button located to the right of the newly created GRE Tunnel instance:
* Click the "Edit" button located to the right of the newly created GRE Tunnel instance:


[[File:How to edit gre tunnel.png]]
[[File:Networking rutxxx configuration examples editing gre v1.jpg|border|class=tlt-border|1100px]]
----
----
* You will be redirected to the settings window where you can start configuring the GRE Tunnel instance. Bellow is capture of configurations for both GRE Tunnel instances:
* You will be redirected to the settings window where you can start configuring the GRE Tunnel instance. Below is a capture of configurations for both GRE Tunnel instances:


[[File:Gre tunnel configuration example v2.png|1150px]]
[[File:Networking rutxxx configuration gre server and client configuration v1.png|border|class=tlt-border|1100px]]


* Below are explanations of the parameters highlighted in the figure above. Other parameters (not highlighted) are defaults. You can find descriptions for these parameters in the '''[[VPN#GRE Tunnel|VPN manual page, GRE Tunnel section]]'''
* Below are explanations of the parameters highlighted in the figure above. Other parameters (not highlighted) are defaults. You can find descriptions for these parameters in the '''[[VPN#GRE Tunnel|VPN manual page, GRE Tunnel section]]'''
** '''Enable''' - enables the GRE Tunnel instance
** '''Enable''' - enables the GRE Tunnel instance
** '''Tunnel source''' - select the network interface with Public IP which is used to establish the GRE tunnel.
** '''Remote endpoint IP address''' - the Public IP address of the opposite router
** '''Remote endpoint IP address''' - the Public IP address of the opposite router
** '''Remote network''' - LAN IP address of the opposite router. This and Remote network netmask are used for '''remote LAN access'''
** '''Outbound and Inbound key''' - 65000 (must match other device's Inbound/Outbound key)
** '''Remote network netmask''' - subnet mask of the opposite router's LAN
** '''Local tunnel IP''' - virtual IP address the GRE Tunnel instance (make sure it is '''unique''' for each instance)
** '''Local tunnel netmask''' - subnet mask of the local GRE Tunnel
** '''Enable Keep alive''' - enables the tunnel's keep alive function. When enabled, the instance sends ICMP packets to the specified host at the specified frequency. If no response is received, the instance attempts to restart the connection
** '''Enable Keep alive''' - enables the tunnel's keep alive function. When enabled, the instance sends ICMP packets to the specified host at the specified frequency. If no response is received, the instance attempts to restart the connection
*** '''Keep alive Host''' - hostname or IP address to which Keep alive packets will be sent to. Best to use a hostname/IP address belonging to the opposite instance's LAN. For this example we just use the other router's LAN IP address
*** '''Keep alive interval''' - the period (in seconds) at which Keep alive packets will be sent to the specified host in this example 200.
*** '''Keep alive interval''' - the period (in seconds) at which Keep alive packets will be sent to the specified host
** '''Local GRE interface IP address''' - virtual IP address the GRE Tunnel instance (make sure it is '''unique''' for each instance)
** '''Local GRE interface netmask''' - subnet mask of the local GRE Tunnel
** '''Remote subnet IP address''' - LAN IP address of opposite router
** '''Remote subnet IP address''' - Netmask of opposite router
'''NOTE''': remember to replace certain parameter values (like IP addresses) with your own relevant data.
'''NOTE''': remember to replace certain parameter values (like IP addresses) with your own relevant data.


==Testing the setup==
==Testing the setup==


If you've followed all the steps presented above, your configuration should be finished. But as with any other configuration, it is always wise to test the setup in order to make sure that it works properly. In order to test a GRE Tunnel connection, login to one of the routers' WebUIs and go to '''Services → CLI'''. Login with user name: '''root''' and the router's admin password. From there you should then be able to '''ping''' the opposite instance's virtual IP address. To use a ping command, type '''ping <ip_address>''' and press the "Enter" key on your keyboard:
If you've followed all the steps presented above, your configuration should be finished. But as with any other configuration, it is always wise to test the setup in order to make sure that it works properly. In order to test a GRE Tunnel connection, log in to one of the routers' WebUIs and go to '''Services → CLI'''. Log in with the user name: '''root''' and the router's admin password. From there you should then be able to '''ping''' the opposite instance's virtual IP address. To use a ping command, type '''ping <ip_address>''' and press the "Enter" key on your keyboard:


[[File:Configuration example ipsec testing.png]]
[[File:Networking rutxxx configuration examples ping to gre client v1.jpg|border|class=tlt-border]]


You can also test if LAN access is working the same way. Instead of pinging the opposite instance's LAN IP address, ping one of the end devices' IPs. One common issue that can be encountered here is that the end devices '''might need their DHCP leases renewed'''. There are many methods of accomplishing this, but the easiest and most accessible way is to simply disconnect and reconnect the LAN cable to device or the router that it's connected to.
You can also test if LAN access is working the same way. Instead of pinging the opposite instance's LAN IP address, ping one of the end devices' IPs. One common issue that can be encountered here is that the end devices '''might need their DHCP leases renewed'''. There are many methods of accomplishing this, but the easiest and most accessible way is to simply disconnect and reconnect the LAN cable to the device or the router that it's connected to.


If the ping requests are successful, congratulations, your setup works! If not, we suggest that you review all steps once more.
If the ping requests are successful, congratulations, your setup works! If not, we suggest that you review all the steps once more.


==See also==
==See also==


* Other types of VPNs suported by RUTxxx devices:
* Other types of VPNs suported by RUTxxx devices:
** [[OpenVPN configuration examples]]
**[[OpenVPN configuration examples RUT R 00.07|OpenVPN configuration examples]]
** [[IPsec configuration examples]]
** [[IPsec RUTOS configuration example|IPsec configuration examples]]
** [[PPTP configuration examples]]
** [[PPTP configuration examples RutOS|PPTP configuration examples]]
** [[L2TP configuration examples]]
** [[L2TP configuration examples RutOS|L2TP configuration examples]]

Latest revision as of 08:54, 26 May 2022

Introduction

Generic Routing Encapsulation (GRE) is a tunneling protocol that can encapsulate a wide variety of network layer protocols inside virtual point-to-point links over an Internet Protocol network.

This article provides an extensive configuration example with details on how to create a tunnel connection between two GRE Tunnel instances, both of which are configured on RUTxxx routers.

Configuration overview and prerequisites

Before we begin, let's overview the configuration that we are attempting to achieve and the prerequisites that make it possible.

Prerequisites:

  • Two RUTxxx routers of any type (excluding RUT850)
  • Both routers must have a Public Static or Public Dynamic IP addresses
  • At least one end device (PC, Laptop, Tablet, Smartphone) to configure the routers

Configuration scheme:

As indicated by the figure above, the configuration we are trying to achieve here is very basic: it concerns two RUTxxx routers - RUT1 and RUT2. They are connected into a virtual network via a GRE Tunnel.

Router configuration

If you have familiarized yourself with the configuration scheme and have all of the devices in order, we can start configuring the routers using the instructions provided in this section:

  • Login to the router's WebUI and go to Services → VPN → GRE Tunnel. Enter a name for the new instance and click the "Add" button. Do this on both routers:


  • Click the "Edit" button located to the right of the newly created GRE Tunnel instance:


  • You will be redirected to the settings window where you can start configuring the GRE Tunnel instance. Below is a capture of configurations for both GRE Tunnel instances:

  • Below are explanations of the parameters highlighted in the figure above. Other parameters (not highlighted) are defaults. You can find descriptions for these parameters in the VPN manual page, GRE Tunnel section
    • Enable - enables the GRE Tunnel instance
    • Tunnel source - select the network interface with Public IP which is used to establish the GRE tunnel.
    • Remote endpoint IP address - the Public IP address of the opposite router
    • Outbound and Inbound key - 65000 (must match other device's Inbound/Outbound key)
    • Enable Keep alive - enables the tunnel's keep alive function. When enabled, the instance sends ICMP packets to the specified host at the specified frequency. If no response is received, the instance attempts to restart the connection
      • Keep alive interval - the period (in seconds) at which Keep alive packets will be sent to the specified host in this example 200.
    • Local GRE interface IP address - virtual IP address the GRE Tunnel instance (make sure it is unique for each instance)
    • Local GRE interface netmask - subnet mask of the local GRE Tunnel
    • Remote subnet IP address - LAN IP address of opposite router
    • Remote subnet IP address - Netmask of opposite router

NOTE: remember to replace certain parameter values (like IP addresses) with your own relevant data.

Testing the setup

If you've followed all the steps presented above, your configuration should be finished. But as with any other configuration, it is always wise to test the setup in order to make sure that it works properly. In order to test a GRE Tunnel connection, log in to one of the routers' WebUIs and go to Services → CLI. Log in with the user name: root and the router's admin password. From there you should then be able to ping the opposite instance's virtual IP address. To use a ping command, type ping <ip_address> and press the "Enter" key on your keyboard:

You can also test if LAN access is working the same way. Instead of pinging the opposite instance's LAN IP address, ping one of the end devices' IPs. One common issue that can be encountered here is that the end devices might need their DHCP leases renewed. There are many methods of accomplishing this, but the easiest and most accessible way is to simply disconnect and reconnect the LAN cable to the device or the router that it's connected to.

If the ping requests are successful, congratulations, your setup works! If not, we suggest that you review all the steps once more.

See also