default-route: use dedicated chapter

This commit is contained in:
Christian Poessinger 2019-12-20 18:09:45 +01:00
parent c046551a8b
commit 2484e2f7c4
3 changed files with 42 additions and 29 deletions

View File

@ -7,6 +7,7 @@ System Configuration
.. toctree::
:maxdepth: 2
host-information
user-management
host-information
default-route
time-zone

View File

@ -0,0 +1,40 @@
.. _default_gateway:
#####################
Default Gateway/Route
#####################
In the past (VyOS 1.1) used a gateway-address configured under the system tree
(:cfgcmd:`set system gateway-address '<address>'`), this is no longer supported
and existing configurations are migrated to the new CLI command.
Configuration
=============
.. cfgcmd:: set protocols static route 0.0.0.0/0 next-hop '<address>'
Specify static route into the routing table sending all non local traffic
to the nexthop address `<address>`.
.. cfgcmd:: delete protocols static route 0.0.0.0/0
Delete default route from the system.
Operation
=========
.. opcmd:: show ip route 0.0.0.0
Show routing table entry for the default route.
.. code-block:: none
vyos@vyos:~$ show ip route 0.0.0.0
Routing entry for 0.0.0.0/0
Known via "static", distance 10, metric 0, best
Last update 09:46:30 ago
* 172.18.201.254, via eth0.201
.. seealso:: Configuration of :ref:`routing-static`

View File

@ -146,31 +146,3 @@ Example: Set alias `router1` for system with hostname `RT01`:
inet 10.20.30.41
}
Default Gateway/Route
=====================
In the past (VyOS 1.1.8) used a gateway-address configured in the system tree
(`set system gateway-address <IP address>`) this is no longer supported and
existing configurations are migrated to the new CLI commands.
It is replaced by inserting a static route into the routing table using:
.. code-block:: none
set protocols static route 0.0.0.0/0 next-hop <gateway ip>
Delete the default route from the system
.. code-block:: none
delete protocols static route 0.0.0.0/0
Show default route:
.. code-block:: none
vyos@vyos$ show ip route 0.0.0.0
Routing entry for 0.0.0.0/0
Known via "static", distance 1, metric 0, best
Last update 3d00h23m ago
* 172.16.34.6, via eth1