summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authormic54 <mic54@protonmail.com>2019-04-14 13:25:59 -0500
committermic54 <mic54@protonmail.com>2019-04-14 13:25:59 -0500
commit12f11e72c9cce67d8bb9b85ce9a9c39e40aac61f (patch)
treea96a5512dc8e5516cf35250f8bac4d6b2d919028 /docs
parent32096506f68beb493ad207a9a8018681b11de203 (diff)
downloadvyos-documentation-12f11e72c9cce67d8bb9b85ce9a9c39e40aac61f.tar.gz
vyos-documentation-12f11e72c9cce67d8bb9b85ce9a9c39e40aac61f.zip
modified tunnel int to parent, vti to sub, and added gre
Diffstat (limited to 'docs')
-rw-r--r--docs/interfaces/tunnel.rst54
-rw-r--r--docs/interfaces/vti.rst22
2 files changed, 54 insertions, 22 deletions
diff --git a/docs/interfaces/tunnel.rst b/docs/interfaces/tunnel.rst
new file mode 100644
index 00000000..8fa1c0d7
--- /dev/null
+++ b/docs/interfaces/tunnel.rst
@@ -0,0 +1,54 @@
+.. _interfaces-tunnel:
+
+Tunnel Interfaces
+=================
+
+Generic Routing Encapsulation (GRE)
+-----------------------------------
+
+A GRE tunnel requires a tunnel source (local-ip), a tunnel destination (remote-ip),
+an encapsulation type (gre), and an address (ipv4/ipv6). Below is a configuration example
+taken from a VyOS router and a Cisco IOS router.
+
+**VyOS Router:**
+
+.. code-block:: sh
+
+ set interfaces tunnel tun100 address '10.0.0.1/30'
+ set interfaces tunnel tun100 encapsulation 'gre'
+ set interfaces tunnel tun100 local-ip '198.18.0.2'
+ set interfaces tunnel tun100 remote-ip '198.18.2.2'
+
+**Cisco IOS Router:**
+
+.. code-block:: sh
+
+ interface Tunnel100
+ ip address 10.0.0.2 255.255.255.252
+ tunnel source 198.18.2.2
+ tunnel destination 198.18.0.2
+
+The main difference between these two configurations is that VyOS requires you explicitly
+configure your encapsulation type. The Cisco router defaults to 'gre ip'.
+
+
+Virtual Tunnel Interface (VTI)
+------------------------------
+
+Set Virtual Tunnel Interface
+
+.. code-block:: sh
+
+ set interfaces vti vti0 address 192.168.2.249/30
+ set interfaces vti vti0 address 2001:db8:2::249/64
+
+Results in:
+
+.. code-block:: sh
+
+ vyos@vyos# show interfaces vti
+ vti vti0 {
+ address 192.168.2.249/30
+ address 2001:db8:2::249/64
+ description "Description"
+ }
diff --git a/docs/interfaces/vti.rst b/docs/interfaces/vti.rst
deleted file mode 100644
index bb97e323..00000000
--- a/docs/interfaces/vti.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-.. _interfaces-vti:
-
-Tunnel Interfaces (vti)
------------------------
-
-Set Virtual Tunnel interface
-
-.. code-block:: sh
-
- set interfaces vti vti0 address 192.168.2.249/30
- set interfaces vti vti0 address 2001:db8:2::249/64
-
-Results in:
-
-.. code-block:: sh
-
- vyos@vyos# show interfaces vti
- vti vti0 {
- address 192.168.2.249/30
- address 2001:db8:2::249/64
- description "Description"
- }