8/21/2019 Vyatta-BasicRouting 6.5R1 v01
1/85
Vyatta
Suite200
1301ShorewayRoad
Belmont,CA94002
vyatta.com
6504137200
1888VYATTA1(USandCanada)
VYATTA,INC.
|
VyattaSystem
BasicRoutingREFERENCE GUIDEForwardingandRouting
StaticRoutes
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
2/85
COPYRIGHT
Copyright20052012Vyatta,Inc.Allrightsreserved.
Vyattareservestherighttomakechangestosoftware,hardware,anddocumentationwithoutnotice.Forthemostrecentversionof
documentation,visittheVyattawebsiteatvyatta.com.
PROPRIETARYNOTICES
VyattaisaregisteredtrademarkofVyatta,Inc.
HyperVisaregisteredtrademarkofMicrosoftCorporation.
VMware,VMwareESX,andVMwareserveraretrademarksofVMware,Inc.
XenServer,andXenCenteraretrademarksofCitrixSystems,Inc.
Allothertrademarksarethepropertyoftheirrespectiveowners.
RELEASEDATE:October2012
DOCUMENTREVISION.6.5R1v01
RELEASEDWITH:6.5R1
PARTNO.A00215100016
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
3/85
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
4/85
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
5/85
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
6/85
vi
BasicRouting 6.5R1v01 Vyatta
showipv6routeforward ......................................................................... 29
showipv6routekernel ........................................................................... 30
showipv6routeripng ............................................................................ 31
showipv6routestatic............................................................................ 32
showipv6
route
summary
........................................................................
33
showipv6route................................................................................. 24
showmonitoringprotocolsrib..................................................................... 34
showtable..................................................................................... 35
traceroute............................................................................... 36
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
7/85
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
8/85
viii
BasicRouting 6.5R1v01 Vyatta
Preface
This document presents information about forwarding and routing on the Vyatta
system.This preface provides information about using this guide. The following topics arepresented:
Intended Audience
Organization of This Guide
Document Conventions
Vyatta Publications
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
9/85
IntendedAudience ix
BasicRouting 6.5R1v01 Vyatta
IntendedAudience
This guide is intended for experienced system and network administrators.Depending on the functionality to be used, readers should have specific knowledge
in the following areas:
Networking and data communications
TCP/IP protocols
General router configuration
Routing protocols
Network administration
Network security
IP services
OrganizationofThisGuide
This guide has the following aid to help you find the information you are looking for:
Quick List of Commands
Use this list to help you quickly locate commands.
List of Examples
Use this list to help you locate examples youd like to try or look at.
This guide has the following chapters:
Chapter Description Page
Chapter 1:ForwardingandRouting Thischapterdescribescommandsfor
forwardingandbasicrouting.
1
Chapter 2:StaticRoutes Thischapterexplainshowtosetstaticroutes
usingtheVyattasystem.
37
GlossaryofAcronyms 70
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
10/85
DocumentConventions x
BasicRouting 6.5R1v01 Vyatta
DocumentConventions
This guide uses the following advisory paragraphs, as follows.
NOTE Notesprovideinformationyoumightneedtoavoidproblemsorconfigurationerrors.
This document uses the following typographic conventions.
WARNING Warningsalertyoutosituationsthatmayposeathreattopersonalsafety.
CAUTION Cautionsalertyoutosituationsthatmightcauseharmtoyoursystemordamagetoequipment,orthatmayaffectservice.
Monospace Examples, command-line output, and representations ofconfiguration nodes.
boldMonospace Your input: something you type at a command line.
bold Commands, keywords, and file names, when mentionedinline.
Objects in the user interface, such as tabs, buttons, screens,and panes.
italics An argument or variable where you supply a value.
A key on your keyboard, such as . Combinations ofkeys are joined by plus signs (+), as in +c.
[ key1 | key2] Enumerated options for completing a syntax. An example is[enable | disable].
num1numN A inclusive range of numbers. An example is 165535, whichmeans 1 through 65535, inclusive.
arg1..argN A range of enumerated values. An example is eth0..eth3,which means eth0, eth1, eth2, or eth3.
arg[ arg...]arg[,arg...]
A value that can optionally represent a list of elements (aspace-separated list and a comma-separated list, respectively).
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
11/85
VyattaPublications xi
BasicRouting 6.5R1v01 Vyatta
VyattaPublications
Full product documentation is provided in the Vyatta technical library. To see whatdocumentation is available for your release, see the Guide to Vyatta Documentation.
This guide is posted with every release of Vyatta software and provides a greatstarting point for finding the information you need.
Additional information is available on www.vyatta.comand www.vyatta.org.
http://www.vyatta.com/http://www.vyatta.org/http://www.vyatta.org/http://www.vyatta.com/8/21/2019 Vyatta-BasicRouting 6.5R1 v01
12/85
1
BasicRouting 6.5R1v01 Vyatta
Chapter1:ForwardingandRouting
This chapter describes commands for forwarding and basic routing.
This chapter presents the following topics:
Forwarding and Routing Commands
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
13/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 2
BasicRouting 6.5R1v01 Vyatta
ForwardingandRoutingCommands
This chapter contains the following commands.
ConfigurationCommands
None
OperationalCommands
clearipprefixlist Clearsprefixliststatisticsorstatus.
clearipv6prefixlist Clearsprefixliststatisticsorstatus.
ping SendsICMPECHO_REQUESTpacketstonetworkhosts.
resetiproutecache Flushesthekernelroutecache.
resetipv6routecache FlushesthekernelIPv6routecache.
showipforwarding DisplaysIPforwardingstatus.
showiproute DisplaysroutesstoredintheRIBandFIB.
showiproutelongerprefixes Displaysprefixeslongerthanaspecifiedprefix.
showiproutecache Displaysthekernelroutecache.
showiprouteconnected Displaysdirectlyconnectedroutes.
showiprouteforward DisplaysroutesstoredintheFIB.
showiproutestatic Displaysstaticroutes.
showiproutekernel Displayskernelroutes.
showiproutesummary Displaysroutessummary.
showiproutesupernetsonly Displayssupernetroutes.
showiproutetable Displaysroutesstoredinanalternateroutingtable
showipv6route DisplaysIPv6routesstoredintheRIBandFIB.
show
ipv6
route
longer
prefixes Displays
IPv6
prefixes
longer
than
a
specified
prefix.
showipv6routebgp DisplaysIPv6BGProutes.
showipv6routecache DisplaysthekernelIPv6routecache.
showipv6routeconnected DisplaysIPv6connectedroutes.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
14/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 3
BasicRouting 6.5R1v01 Vyatta
showipv6routeforward DisplaysIPv6routesstoredintheFIB.
showipv6routekernel DisplaysIPv6kernelroutes.
showipv6routeripng DisplaysIPv6RIPngroutes.
showipv6
route
static Displays
IPv6
static
routes.
showipv6routesummary DisplaysIPv6routessummary.
showmonitoringprotocolsrib DisplaysRoutingInformationBase(RIB)debuggingflags.
showtable Displaysthesystemsroutingtable.
traceroute Displaystheroutepacketstaketoanetworkhost.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
15/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 4
BasicRouting 6.5R1v01 Vyatta
clearipprefixlist
Clears prefix list statistics or status.
Syntax
clear ip prefix-list[list-name[ipv4net]]
CommandMode
Operational mode.
Parameters
Default
Statistics for all prefix-lists are cleared.
UsageGuidelines
Use this command to clear prefix list statistics or status.
list-name Optional. Clears statistics for the specified prefix list.
ipv4net Optional. Clears statistics for the specified network.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
16/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 5
BasicRouting 6.5R1v01 Vyatta
clearipv6prefixlist
Clears prefix list statistics or status.
Syntax
clear ipv6 prefix-list[list-name[ipv6net]]
CommandMode
Operational mode.
Parameters
Default
Statistics for all prefix-lists are cleared.
UsageGuidelines
Use this command to clear prefix list statistics or status.
list-name Optional. Clears statistics for the specified prefix list.
ipv6net Optional. Clears statistics for the specified network.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
17/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 6
BasicRouting 6.5R1v01 Vyatta
ping
Sends ICMP ECHO_REQUEST packets to network hosts.
Syntax
ping[ipv4| ipv6] host
CommandMode
Operational mode
Parameters
UsageGuidelines
The pingcommand is used to test whether a network host is reachable or not.
The pingcommand uses the ICMP protocols mandatory ECHO_REQUESTdatagram to elicit an ICMP ECHO_RESPONSE from a host or gateway.ECHO_REQUEST datagrams (pings) have an IP and ICMP header, followed by astructtimeval and then an arbitrary number of pad bytes used to fill out thepacket.
When using pingfor fault isolation, it should first be run on the local host, to verifythat the local network interface is up and running. Then, hosts and gateways furtherand further away should be pinged. Round-trip times and packet loss statistics arecomputed.
If duplicate packets are received, they are not included in the packet loss calculation,although the round-trip time of these packets is used in calculating theminimum/average/maximum round-trip time numbers.
ipv4 Specifies that the hostsIPv4 address is to be pinged. This option isto be used when the hostspecified is a hostname rather than an IPaddress.
ipv6 Specifies that the hostsIPv6 address is to be pinged. This option isto be used when the hostspecified is a hostname rather than an IPaddress.
host The host being pinged. Can be specified either as hostname (if DNSis being used on the network) or as an IPv4 or IPv6 address. If ahostname is specified and neither the ipv4or ipv6options are used,the IPv4 or the IPv6 address associated with the hostname will be
pinged depending on which of these is resolved first.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
18/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 7
BasicRouting 6.5R1v01 Vyatta
When the pingcommand is interrupted, using +c, a brief statistical summaryis displayed.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
19/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 8
BasicRouting 6.5R1v01 Vyatta
resetiproutecache
Flushes the kernel route cache.
Syntax
reset ip route cache[ipv4net]
CommandMode
Operational mode.
Parameters
Default
Flushes the entire route cache.
UsageGuidelines
Use this command to flush the kernel route cache or a flush a specific route from thecache.
ipv4net Optional. Flushes the specified route from the kernel route cache.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
20/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 9
BasicRouting 6.5R1v01 Vyatta
resetipv6routecache
Flushes the kernel IPv6 route cache.
Syntax
reset ipv6 route cache[ipv6net]
CommandMode
Operational mode.
Parameters
Default
Flushes the entire IPv6 route cache.
UsageGuidelines
Use this command to flush the kernel IPv6 route cache or a flush a specific route fromthe cache.
ipv6net Optional. Flushes the specified route from the kernel IPv6 routecache.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
21/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 10
BasicRouting 6.5R1v01 Vyatta
showipforwarding
Displays IP forwarding status.
Syntax
show ip forwarding
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display the current IP forwarding status.
Examples
Example 1-1shows how to display the status of IP forwarding.
Example11 DisplayingIPforwardingstatus
vyatta@vyatta:~$showipforwarding
IPforwardingison
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
22/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 11
BasicRouting 6.5R1v01 Vyatta
showiproute
Displays routes stored in the RIB and FIB.
Syntax
show ip route[ipv4| ipv4net]
CommandMode
Operational mode.
Parameters
Default
Lists all routes in the RIB and FIB.
UsageGuidelines
Use this command to display active prefixes stored in the Routing Information Base
(RIB), as well as those stored in the Forwarding Information Base (FIB).
The routes shown in the FIB can also be seen using show ip route forward command.
Examples
Example 1-2shows how to display routes in the RIB and FIB.
Example12 DisplayingroutesintheRIBandFIB
vyatta@vyatta:~$showiproute
Codes:
K
kernel
route,
C
connected,
S
static,
R
RIP,
O
OSPF, I ISIS,B BGP,> selectedroute,* FIBroute
S>*0.0.0.0/0[1/0]via10.1.0.1,eth0
O 10.1.0.0/24[110/10]isdirectlyconnected,eth0,05:35:15
C>*10.1.0.0/24isdirectlyconnected,eth0
O>*10.192.32.0/24[110/20]via10.1.0.45,eth0,05:35:15
ipv4 Optional. Displays routing information for the specified address.
ipv4net Optional. Displays routing information for the specified prefix.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
23/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 12
BasicRouting 6.5R1v01 Vyatta
O>*10.192.128.0/24[110/11]via10.1.0.66,eth0,05:35:15
O>*10.192.128.1/32[110/11]via10.1.0.66,eth0,05:35:15
O>*10.192.129.0/24[110/11]via10.1.0.66,eth0,05:35:15
O>*10.192.130.0/24[110/11]via10.1.0.66,eth0,05:35:15
O>*10.192.131.0/24[110/11]via10.1.0.66,eth0,05:35:15
C>*
127.0.0.0/8
is
directly
connected,
loO>*172.16.0.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.1.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.2.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.3.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.4.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.5.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.6.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.7.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.8.0/24[110/11]via10.1.0.4,eth0,05:35:15
O>*172.16.9.0/24[110/11]via10.1.0.4,eth0,05:35:15
C>*172.16.234.0/25isdirectlyconnected,eth1
S>*
192.94.202.0/24
[1/0]
via
172.16.234.27,
eth1vyatta@vyatta:~$
Example 1-3shows information how to display information for the route to address10.192.128.1.
Example13 Displayingroutinginformationaboutaspecificaddress
vyatta@vyatta:~$showiproute10.192.128.1
Routingentryfor10.192.128.1/32
Known
via
"ospf",
distance
110,
metric
11,
best
Lastupdate09:47:07ago
*10.1.0.66,viaeth0
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
24/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 13
BasicRouting 6.5R1v01 Vyatta
showiproutelongerprefixes
Displays prefixes longer than a specified prefix.
Syntax
show ip routeipv4netlonger-prefixes
CommandMode
Operational mode.
Parameters
Default
None.
UsageGuidelines
Use this command to display all prefixes in the Routing Information Base (RIB) thatare longer than a given IP address or prefix.
Examples
Example 1-4shows how to list prefixes longer than the prefix 10.192.128.0/24.
Example14 Displayingrouteswithlongerprefixes
vyatta@vyatta:~$showiproute10.192.128.0/24longerprefixes
Codes:K kernelroute,C connected,S static,R RIP,O OSPF,
I ISIS,B BGP,> selectedroute,* FIBroute
O>*10.192.128.0/24[110/11]via10.1.0.66,eth0,09:36:20
O>*10.192.128.1/32[110/11]via10.1.0.66,eth0,09:36:20
vyatta@vyatta:~$
ipv4net Mandatory. Displays all prefixes longer than the specified prefix.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
25/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 14
BasicRouting 6.5R1v01 Vyatta
showiproutecache
Displays the kernel route cache.
Syntax
show ip route cache[ipv4net]
CommandMode
Operational mode.
Parameters
Default
Lists routes in the kernel route cache.
UsageGuidelines
Use this command to display information about routes stored in the kernel routecache. The route cache contains all paths currently in use by the cache. Multipleequal-cost paths are necessary before equal-cost-multi-path (ECMP) routing can beperformed.
Examples
Example 1-5shows how to list routes in the kernel route cache.
Example15 Listingroutesinthekernelroutecache
vyatta@vyatta:~$showiproutecache
local10.1.0.62from10.1.0.1devlo src10.1.0.62
cache users1age42seciifeth0
multicast224.0.0.5from10.1.0.45devlo src10.1.0.62
cache users1used8age5seciifeth0
local10.1.0.62from69.59.150.131devlo src10.1.0.62
cache users1used3age47seciifeth0
10.1.0.1from10.1.0.62deveth0
cache users1age42secmtu1500advmss1460hoplimit64
ipv4net Optional. Displays kernel route cache information for the specifiedroute.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
26/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 15
BasicRouting 6.5R1v01 Vyatta
10.0.0.30from10.1.0.62toslowdelayvia10.1.0.1deveth0
cache users2age0secmtu1500advmss1460hoplimit64
multicast224.0.0.5from10.1.0.56devlo src10.1.0.62
cache users1used8age8seciifeth0
multicast224.0.0.5from10.1.0.66devlo src10.1.0.62
cache
users
1
used
8
age
0sec
iif
eth0multicast224.0.0.6deveth0 src10.1.0.62
cache users1age21secmtu1500advmss1460hoplimit64
multicast224.0.0.5from10.1.0.4devlo src10.1.0.62
cache users1used9age1seciifeth0
69.59.150.131via10.1.0.1deveth0 src10.1.0.62
cache users1age47secmtu1500advmss1460hoplimit64
multicast224.0.0.5deveth0 src10.1.0.62
cache users1used8age5secmtu1500advmss1460hoplimit64
69.59.150.131from10.1.0.62via10.1.0.1deveth0
cache users1used1age47secmtu1500advmss1460hoplimit64
local
10.1.0.62
from
10.0.0.30
tos
lowdelay
dev
lo
src
10.1.0.62 cache users1used1age0seciifeth0
vyatta@vyatta:~$
Example 1-6shows how to display information about route 10.1.0.62 in the kernelroute cache.
Example16 Displayinginformationaboutarouteinthekernelroutecache
vyatta@vyatta:~$showiproutecache10.1.0.62
local
10.1.0.62
from
10.1.0.1
dev
lo
src
10.1.0.62 cache users1used3age9seciifeth0
local10.1.0.62from69.59.150.131devlo src10.1.0.62
cache users1used7age102seciifeth0
local10.1.0.62from10.0.0.30toslowdelaydevlo src10.1.0.62
cache users1used33iifeth0
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
27/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 16
BasicRouting 6.5R1v01 Vyatta
showiprouteconnected
Displays directly connected routes.
Syntax
show ip route connected
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display routes directly connected to the local system.
Examples
Example 1-7shows how to list directly connected routes.
Example17 Displayingconnectedroutes
vyatta@vyatta:~$showiprouteconnected
Codes:K kernelroute,C connected,S static,R RIP,O OSPF,
I ISIS,B BGP,> selectedroute,* FIBroute
C>*10.1.0.0/24isdirectlyconnected,eth0
C>*127.0.0.0/8isdirectlyconnected,lo
C>*172.16.234.0/25isdirectlyconnected,eth1
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
28/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 17
BasicRouting 6.5R1v01 Vyatta
showiprouteforward
Displays routes stored in the FIB.
Syntax
show ip route forward[ipv4net]
CommandMode
Operational mode.
Parameters
Default
Lists routes in the FIB.
UsageGuidelines
Use this command to display the FIB.
The FIB contains multiple equal-cost paths if existed. Multiple equal-cost paths arenecessary before equal-cost multi-path (ECMP) routing or WAN load balancing canbe performed.
Examples
Example 1-8shows how to display routes recorded in the FIB.
Example18 DisplayingroutesintheFIB
vyatta@vyatta:~$showiprouteforward
default
via
10.1.0.1
dev
eth0
proto
zebra10.1.0.0/24deveth0 protokernel scopelink src10.1.0.62
10.192.32.0/24via10.1.0.45deveth0 protozebra metric20
10.192.128.0/24via10.1.0.66deveth0 protozebra metric11
10.192.128.1via10.1.0.66deveth0 protozebra metric11
10.192.129.0/24via10.1.0.66deveth0 protozebra metric11
10.192.130.0/24via10.1.0.66deveth0 protozebra metric11
ipv4net Optional. Displays information from the kernel forwarding tablefor the specified route.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
29/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 18
BasicRouting 6.5R1v01 Vyatta
10.192.131.0/24via10.1.0.66deveth0 protozebra metric11
172.16.0.0/24via10.1.0.4deveth0 protozebra metric11
172.16.1.0/24via10.1.0.4deveth0 protozebra metric11
172.16.2.0/24via10.1.0.4deveth0 protozebra metric11
172.16.3.0/24via10.1.0.4deveth0 protozebra metric11
172.16.4.0/24
via
10.1.0.4
dev
eth0
proto
zebra
metric
11172.16.5.0/24via10.1.0.4deveth0 protozebra metric11
172.16.6.0/24via10.1.0.4deveth0 protozebra metric11
172.16.7.0/24via10.1.0.4deveth0 protozebra metric11
172.16.8.0/24via10.1.0.4deveth0 protozebra metric11
172.16.9.0/24via10.1.0.4deveth0 protozebra metric11
172.16.234.0/25deveth1 protokernel scopelink src172.16.234.23
192.94.202.0/24via172.16.234.27deveth1 protozebra
vyatta@vyatta:~$
Example 1-9shows how to display information from the FIB about route10.1.0.0/24.
Example19 DisplayinginformationaboutarouteintheFIB
vyatta@vyatta:~$showiprouteforward10.1.0.0/24
10.1.0.0/24deveth0 protokernel scopelink src10.1.0.62
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
30/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 19
BasicRouting 6.5R1v01 Vyatta
showiproutekernel
Displays kernel routes.
Syntax
show ip route kernel
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display kernel routes. Kernel routes are routes that have beenadded through means other than by using the Vyatta CLI; for example by using theoperating system route command, as in the following:
routeadd net10.172.24.0netmask255.255.255.0gw10.1.0.1
Examples
Example 1-10shows how to display kernel routes.
Example110 Displayingkernelroutes
vyatta@vyatta:~$showiproutekernel
Codes:K kernelroute,C connected,S static,R RIP,O OSPF,
I ISIS,B BGP,> selectedroute,* FIBroute
K>*
10.172.24.0/24
via
10.1.0.1,
eth0vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
31/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 20
BasicRouting 6.5R1v01 Vyatta
showiproutestatic
Displays static routes.
Syntax
show ip route static
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display static routes in the Routing Information Base (RIB).
Examples
Example 1-11shows how to list static routes.
Example111 Displayingstaticroutes
vyatta@vyatta:~$showiproutestatic
Codes:K kernelroute,C connected,S static,R RIP,O OSPF,
I ISIS,B BGP,> selectedroute,* FIBroute
S>*0.0.0.0/0[1/0]via10.1.0.1,eth0
S>*192.94.202.0/24[1/0]via172.16.234.27,eth1
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
32/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 21
BasicRouting 6.5R1v01 Vyatta
showiproutesummary
Displays routes summary.
Syntax
show ip route summary
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display a summary of the various routes by route source.
Examples
Example 1-12shows how to display a summary of routes.
Example112 Displayingasummaryofroutes
vyatta@vyatta:~$showiproutesummary
RouteSource Routes FIB
connected 4 4
static 2 2
ospf 1 0
ebgp 0 0
ibgp 289016 289011
Totals 289023 289017
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
33/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 22
BasicRouting 6.5R1v01 Vyatta
showiproutesupernetsonly
Displays supernet routes.
Syntax
show ip route supernets-only
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display supernet routes.
Supernet routes are routes that have a subnet mask thatis less specific than thenatural classful mask.
Examples
Example 1-13shows how to list supernet routes.
Example113 Displayingsupernetroutes
vyatta@vyatta:~$showiproutesupernetsonly
Codes:K kernelroute,C connected,S static,R RIP,O OSPF,
I ISIS,B BGP,> selectedroute,* FIBroute
S>*0.0.0.0/0[1/0]via10.1.0.1,eth0
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
34/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 23
BasicRouting 6.5R1v01 Vyatta
showiproutetable
Displays routes stored in an alternate routing table
Syntax
show ip route table table
CommandMode
Operational mode.
Parameters
Default
None.
UsageGuidelines
Use this command to display routes stored in the alternate routing table specified.The alternate routing tables are used with policy based routing. See the Vyatta PolicyBased Routing Reference Guidefor information on policy based routing.
Examples
Example 1-4shows how to display routes in an alternate routing table.
Example114 Displayingroutesinalternateroutingtable5
vyatta@vyatta:~$showiproutetable5
table5:
Codes:K kernelroute,C connected,S static,R RIP,O OSPF,
I ISIS,B BGP,> selectedroute,* FIBroute
S>*12.34.56.0/24[1/0]via192.168.1.254,eth0
vyatta@vyatta:~$
table Displays routing information in the specified alternate routingtable.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
35/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 24
BasicRouting 6.5R1v01 Vyatta
showipv6route
Displays IPv6 routes stored in the RIB and FIB.
Syntax
show ipv6 route[ipv6| ipv6net]
CommandMode
Operational mode.
Parameters
Default
Lists all IPv6 routes in the RIB and FIB.
UsageGuidelines
Use this command to display active IPv6 prefixes stored in the Routing InformationBase (RIB), as well as those stored in the Forwarding Information Base (FIB).
The routes shown in the FIB can also be seen using show ip route forward command.
ipv6 Optional. Displays routing information for the specified IPv6address.
ipv6net Optional. Displays routing information for the specified IPv6prefix.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
36/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 25
BasicRouting 6.5R1v01 Vyatta
showipv6routelongerprefixes
Displays IPv6 prefixes longer than a specified prefix.
Syntax
show ipv6 routeipv6netlonger-prefixes
CommandMode
Operational mode.
Parameters
Default
None.
UsageGuidelines
Use this command to display all prefixes in the Routing Information Base (RIB) thatare longer than a given IPv6 address or prefix.
ipv6net Mandatory. Displays all prefixes longer than the specified IPv6prefix.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
37/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 26
BasicRouting 6.5R1v01 Vyatta
showipv6routebgp
Displays IPv6 BGP routes.
Syntax
show ipv6 route bgp
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display IPv6 BGP routes.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
38/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 27
BasicRouting 6.5R1v01 Vyatta
showipv6routecache
Displays the kernel IPv6 route cache.
Syntax
show ipv6 route cache[ipv6net]
CommandMode
Operational mode.
Parameters
Default
Lists routes in the kernel IPv6 route cache.
UsageGuidelines
Use this command to display information about routes stored in the kernel IPv6route cache. The route cache contains all paths currently in use by the cache.Multiple equal-cost paths are necessary before equal-cost-multi-path (ECMP)routing can be performed.
ipv6net Optional. Displays kernel IPv6 route cache information for thespecified route.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
39/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 28
BasicRouting 6.5R1v01 Vyatta
showipv6routeconnected
Displays IPv6 connected routes.
Syntax
show ipv6 route connected
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display IPv6 routes directly connected to the local system.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
40/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 29
BasicRouting 6.5R1v01 Vyatta
showipv6routeforward
Displays IPv6 routes stored in the FIB.
Syntax
show ipv6 route forward[ipv6net]
CommandMode
Operational mode.
Parameters
Default
Lists IPv6 routes in the FIB.
UsageGuidelines
Use this command to display the FIB.
The FIB contains multiple equal-cost paths if existed. Multiple equal-cost paths arenecessary before equal-cost multi-path (ECMP) routing or WAN load balancing canbe performed.
ipv6net Optional. Displays information from the kernel forwarding tablefor the specified IPv6 route.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
41/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 30
BasicRouting 6.5R1v01 Vyatta
showipv6routekernel
Displays IPv6 kernel routes.
Syntax
show ipv6 route kernel
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display IPv6 kernel routes. Kernel routes are routes that havebeen added through means other than by using the Vyatta CLI.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
42/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 31
BasicRouting 6.5R1v01 Vyatta
showipv6routeripng
Displays IPv6 RIPng routes.
Syntax
show ipv6 route ripng
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display IPv6 RIPng routes.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
43/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 32
BasicRouting 6.5R1v01 Vyatta
showipv6routestatic
Displays IPv6 static routes.
Syntax
show ipv6 route static
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display IPv6 static routes in the Routing Information Base(RIB).
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
44/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 33
BasicRouting 6.5R1v01 Vyatta
showipv6routesummary
Displays IPv6 routes summary.
Syntax
show ipv6 route summary
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display a summary of the various IPv6 routes by route source.
Examples
Example 1-15shows a summary of IPv6 routes.
Example115 showipv6routesummary:DisplayingasummaryofIPv6routes
vyatta@vyatta:~$showipv6routesummary
RouteSource Routes FIB
connected 4 4
static 2 2
Totals 6 6
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
45/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 34
BasicRouting 6.5R1v01 Vyatta
showmonitoringprotocolsrib
Displays Routing Information Base (RIB) debugging flags.
Syntax
show monitoring protocols rib
CommandMode
Operational mode.
Parameters
None
Default
None.
UsageGuidelines
Use this command to see how debugging is set for the Routing Information Base.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
46/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 35
BasicRouting 6.5R1v01 Vyatta
showtable
Displays the systems routing table.
Syntax
show table
CommandMode
Operational mode.
Parameters
None.
Default
None.
UsageGuidelines
Use this command to display the systems routing table.
Examples
Example 1-16shows how to display the routing table.
Example116 Displayingtheroutingtable
vyatta@vyatta:~$showtable
table0
vyatta@vyatta:~$
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
47/85
Chapter1:ForwardingandRouting ForwardingandRoutingCommands 36
BasicRouting 6.5R1v01 Vyatta
traceroute
Displays the route packets take to a network host.
Syntax
traceroute [ipv4| ipv6] host
CommandMode
Operational mode
Parameters
UsageGuidelines
Use this command to perform a traceroute operation for a network host.Traceroute utilizes the IP protocol time to live (ttl) field and attempts to elicit anICMP TIME_EXCEEDED response from each gateway along the path to some hostto track the route a set of packets follows. It attempts to trace the route an IP packetwould follow to some Internet host by launching UDP probe packets with a smalltime to live, then listening for an ICMP Time exceeded reply from a gateway.
ipv4 Display the route packets take to the hostsIPv4 address. Thisoption is to be used when the hostspecified is a hostname ratherthan an IP address.
ipv6 Display the route packets take to the hostsIPv6 address. Thisoption is to be used when the hostspecified is a hostname ratherthan an IP address.
host The host that is the destination for the trace. Can be specifiedeither as a name (if DNS is being used on the network) or as anIPv4 or IPv6 address.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
48/85
37
BasicRouting 6.5R1v01 Vyatta
Chapter2:StaticRoutes
This chapter explains how to set static routes using the Vyatta system.
This chapter presents the following topics:
Static Route Configuration
Static IPv6 Route Configuration
Static Route Commands
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
49/85
Chapter2:StaticRoutes StaticRouteConfiguration 38
BasicRouting 6.5R1v01 Vyatta
StaticRouteConfiguration
This section presents the following topics:
Static Routes Overview
Configuring Static Routes
Floating Static Routes
Showing Static Routes in the Routing Table
StaticRoutesOverviewA static route is a manually configured route, which, in general, cannot be updateddynamically from information the Vyatta system learns about the network topology.However, if a link fails, the router will remove routes, including static routes, from
the Routing Information Base (RIB) that used this interface to reach the next hop.In general, static routes should only be used for very simple network topologies, orto override the behavior of a dynamic routing protocol for a small number of routes.
The collection of all routes the router has learned from its configuration or from itsdynamic routing protocols is stored in its Routing Information Base (RIB).
Unicast routes are directly used to determine the forwarding table used for unicastpacket forwarding.
ConfiguringStaticRoutes
In this example, a sample configurations are presented for basic static routes. Whenyou are finished, the system will be configured as shown in Figure 2-1. In thisexample, a static route is created that says, in effect, any packets destined for the11.0.0.0/8 network should be forwarded to 172.16.0.26.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
50/85
Chapter2:StaticRoutes StaticRouteConfiguration 39
BasicRouting 6.5R1v01 Vyatta
Figure21 Staticroutes
This section includes the following examples:
Example 2-1 Creating a static route
Example 2-1creates a static route to network 11.0.0.0/8 directed towards172.16.0.26.
To create a static route, perform the following steps in configuration mode.
R1
eth0
172.16.0.65
172.16.0.0/24
Static Route
Destination: 11.0.0.0/8
Next-Hop: 172.16.0.26
R2 11.0.0.0/8
10.10.40.0/24
eth0
172.16.0.26
Example21 Creatingastaticroute
Step Command
CreateastaticroutetoR2. vyatta@R1#setprotocolsstaticroute11.0.0.0/8nexthop172.16.0.26
Committheconfiguration. vyatta@R1#commit
Viewtheconfiguration. vyatta@R1#showprotocolsstaticroute
route11.0.0.0/8{
nexthop172.16.0.26{
}
}
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
51/85
Chapter2:StaticRoutes StaticIPv6RouteConfiguration 40
BasicRouting 6.5R1v01 Vyatta
FloatingStaticRoutesUsually, static routes have a relatively short administrative distancetypically 1, andusually shorter than the administrative distances for dynamic (learned) routes. Afloating static route is a static route with an administrative distance greater than
that for dynamic routes.You can configure a static route to be a floating route by setting the administrativedistance higher than the distance applied to the routes in your dynamic routingprotocol. This renders the static route less desirable than a dynamic route. At thesame time, if the dynamic route is lost, the static route is available to take over traffic,which can be forwarded through the static route as an alternate path.
ShowingStaticRoutesintheRoutingTableTo display route information, use the show ip route command. To show just staticroutes, use the show ip route staticfilter, as shown in Example 2-2.
Example22 Showingstaticroutesintheroutingtable
vyatta@R1:~$showiproutestatic
Codes:K kernelroute,C connected,S static,R RIP,O OSPF,
I ISIS,B BGP,> selectedroute,* FIBroute
S>*11.0.0.0/8[1/0]via172.16.0.26,eth0
vyatta@R1:~$
StaticIPv6RouteConfiguration
Figure 2-2shows an IPv6 network with three nodes. In this example we will showconfiguration of the nodes using static routes to enable R2 and R4 to communicatevia R1.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
52/85
Chapter2:StaticRoutes StaticIPv6RouteConfiguration 41
BasicRouting 6.5R1v01 Vyatta
Figure22 StaticIPv6routingexample
VerifyThatIPv6ForwardingisEnabledIn order for R1 to be able to pass data between interfaces eth0 and eth2 (i.e., betweenR4 and R2) it must be configured to enable forwarding. To determine if forwardingis enabled, perform the following step in operational mode.
If forwarding is not enabled, as is the case in Example 2-3, the system must beconfigured to enable forwarding. To enable forwarding, perform the following stepsin configuration mode.
2001:db8:2::/64
R1
eth2
2001:db8:2::1
R2
eth0
2001 :db8:2::2
2001:db8:1::/64
R4
2001:db8:1::1
eth0
eth0
2001:db8:1::4
Example23 DetermineifforwardingisenabledonR1
Step Command
DisplaythestateofIPv6
forwardingonR1.
vyatta@R1:~$showipv6forwarding
ipv6forwardingisoff
Example24 EnableforwardingonR1
Step Command
EnableforwardingonR1. vyatta@R1#deletesystemipv6disableforwarding
Committhechange. vyatta@R1#commit
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
53/85
Chapter2:StaticRoutes StaticIPv6RouteConfiguration 42
BasicRouting 6.5R1v01 Vyatta
AddtheDefaultIPv6RouteOn R4, all traffic that is not routed elsewhere will be sent to R1. To configure thedefault route, perform the following steps in configuration mode.
Changetooperationalmode vyatta@R1#exit
exit
vyatta@R1:~$
Displaythe
state
of
IPv6
forwardingonR1.vyatta@R1:~$
show
ipv6
forwarding
ipv6forwardingison
Example24 EnableforwardingonR1
Example25 AddthedefaultrouteonR4
Step Command
Addthe
default
route
on
R4. vyatta@R4#
set
protocols
static
route6
::/0
next
hop
2001:db8:1::1
Committhechange. vyatta@R4#commit
Changetooperationalmode. vyatta@R4#exit
exit
vyatta@R4:~$
Verifythedefaultrouteinthe
routingtable.
vyatta@R4:~$showipv6route
Codes:K kernelroute,C connected,S static,R RIPng,O OSPFv3,
I ISIS,B BGP,* FIBroute.
S>*::/0[1/0]via2001:db8:1::1,eth0
C>*::1/128isdirectlyconnected,lo
C>*2001:db8:1::/64isdirectlyconnected,eth0
C*fe80::/64isdirectlyconnected,eth1
C>*fe80::/64isdirectlyconnected,eth0
K>*ff00::/8isdirectlyconnected,eth0
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
54/85
Chapter2:StaticRoutes StaticIPv6RouteConfiguration 43
BasicRouting 6.5R1v01 Vyatta
AddaStaticIPv6RouteAs an alternative to the default route we created on R4, well create a static route onR2. To configure a static route to the 2001:db8:1::/64 network, perform thefollowing steps in configuration mode.
ConfirmConnectivityTo confirm that R2 and R4 can communicate, use the pingcommand. To confirmconnectivity between R2 and R4, perform the following step in operational mode.
Example26
Addastatic
route
on
R2
Step Command
AddastaticrouteonR2. vyatta@R1# setprotocolsstaticroute62001:db8:1::/64nexthop2001:db8:2::1
Committhechange. vyatta@R1# commit
Changetooperationalmode. vyatta@R1# exit
exit
vyatta@R2:~$
Verifythe
static
route
in
the
routingtable.vyatta@R2:~$
show
ipv6
route
Codes:K kernelroute,C connected,S static,R RIPng,O OSPFv3,
I ISIS,B BGP,* FIBroute.
C>*::1/128isdirectlyconnected,lo
S>*2001:db8:1::/64[1/0]via2001:db8:2::1,eth0
C>*2001:db8:2::/64isdirectlyconnected,eth0
C*fe80::/64isdirectlyconnected,eth1
C>*fe80::/64isdirectlyconnected,eth0
K>*ff00::/8isdirectlyconnected,eth0
Example27 ConfirmconnectivitybetweenR2andR4
Step Command
PingR4fromR2. vyatta@R2:~$ ping2001:db8:1::4
PING2001:db8:1::4(2001:db8:1::4) 56databytes
64bytesfrom2001:db8:1::4:icmp_seq=1ttl=63time=5.65ms
64
bytes
from
2001:db8:1::4:
icmp_seq=2
ttl=63
time=0.382
ms^C
2001:db8:1::4pingstatistics
2packetstransmitted,2received,0%packetloss,time1011ms
rttmin/avg/max/mdev=0.382/3.016/5.650/2.634ms
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
55/85
Chapter2:StaticRoutes StaticIPv6RouteConfiguration 44
BasicRouting 6.5R1v01 Vyatta
As an alternative, use tracerouteto verify that the goes from R2 to R1 to R4. Toconfirm connectivity between R2 and R4 through R1 using traceroute, perform thefollowing step in operational mode.
Example28 ConfirmconnectivitybetweenR2andR4viaR1
Step Command
TracetheroutefromR2toR4. vyatta@R2:~$ traceroute2001:db8:1::4
tracerouteto2001:db8:1::4(2001:db8:1::4),30hopsmax,40bytepackets
1 (2001:db8:2::1) 4.448ms 4.148ms 4.092ms
2 (2001:db8:1::4) 4.297ms 4.306ms 4.308ms
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
56/85
Chapter2:StaticRoutes StaticRouteCommands 45
BasicRouting 6.5R1v01 Vyatta
StaticRouteCommands
This chapter contains the following commands.
ConfigurationCommands
protocolsstaticinterfaceroute
nexthopinterface
Allowsyoutoconfigurethenexthopinterfaceforan
interfacebasedstaticroute.
protocolsstaticinterfaceroute6
nexthopinterface
Allowsyoutoconfigurethenexthopinterfaceforan
interfacebasedIPv6staticroute.
protocolsstaticrouteblackhole Allowsyoutoconfigureablackholestaticroute.
protocolsstaticroutenexthop
Allowsyoutoconfigurethenexthopforastaticroute.
protocolsstaticroute6blackhole AllowsyoutoconfigureablackholeIPv6staticroute.
protocolsstaticroute6nexthop
AllowsyoutoconfigurethenexthopforanIPv6static
route.
protocolsstatictableinterfaceroute
nexthopinterface
Allowsyoutoconfigurethenexthopinterfaceforan
interfacebasedstaticrouteinanalternateroutingtable.
protocolsstatictableinterfaceroute6
nexthopinterface
Allowsyoutoconfigurethenexthopinterfaceforan
interfacebasedIPv6staticrouteinanalternaterouting
table.
protocolsstatictableroute
blackhole
Allowsyoutoconfigureablackholestaticrouteinan
alternaterouting
table.
protocolsstatictableroute
nexthop
Allowsyoutoconfigurethenexthopforastaticrouteinan
alternateroutingtable.
protocolsstatictableroute6
blackhole
AllowsyoutoconfigureablackholeIPv6staticrouteinan
alternateroutingtable.
protocolsstatictableroute6
nexthop
AllowsyoutoconfigurethenexthopforanIPv6static
routeinanalternateroutingtable.
OperationalCommands
show
ip
route
static Displays
static
routes.
Seepage 20.
showipv6routestatic DisplaysIPv6staticroutes.Seepage 32.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
57/85
Chapter2:StaticRoutes StaticRouteCommands 46
BasicRouting 6.5R1v01 Vyatta
protocolsstaticinterfaceroute
nexthopinterface
Allows you to configure the next-hop interface for an interface-based static route.
Syntax
set protocols static interface-routesubnetnext-hop-interface interface [disable|distancedistance]
delete protocols static interface-routesubnetnext-hop-interface interface[disable|distance]
show protocols static interface-routesubnetnext-hop-interface interface[disable|distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
interfaceroutesubnet{
nexthopinterfaceinterface{
disable
distancedistance
}
}
}
}
Parameters
subnet Mandatory. Multi-node. Defines an interface-based static route.The format is a destination subnet of the form address/prefix.
You can define multiple interface-based routes by creating multipleinterface-routeconfiguration nodes.
interface Mandatory. The next-hop interface.
disable Disables the interface-based static route.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
58/85
Chapter2:StaticRoutes StaticRouteCommands 47
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure interface-based static routes on the router.
Use the setform of this command to specify the next-hop interface for the route.
Use the deleteform of this command to remove the next-hop interface.
Use the showform of this command to view the next-hop interface for the route.
distance Optional. Sets the next-hop distance for this route. Routes with asmaller distance are selected before those with a larger distance.The range is 1 to 255. The default is 1.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
59/85
Chapter2:StaticRoutes StaticRouteCommands 48
BasicRouting 6.5R1v01 Vyatta
protocolsstaticinterfaceroute6
nexthopinterface
Allows you to configure the next hop interface for an interface-based IPv6 staticroute.
Syntax
set protocols static interface-route6subnetnext-hop-interfaceethx[disable| distancedistance]
delete protocols static interface-route6subnetnext-hop-interfaceethx[disable|distance]
show protocols static interface-route6subnetnext-hop-interfaceethx[disable|distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
interfaceroute6subnet{
nexthopinterfaceethx{
disable
distancedistance
}
}
}
}
Parameters
subnet Mandatory. Multi-node. Defines an interface-based static route.
The format is a destination subnet of the form IPv6-address/prefix.You can define multiple interface-based routes by creating multipleinterface-route6configuration nodes.
ethx Mandatory. The next hop Ethernet interface.
disable Disables the interface-based IPv6 static route.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
60/85
Chapter2:StaticRoutes StaticRouteCommands 49
BasicRouting 6.5R1v01 Vyatta
DefaultNone.
UsageGuidelines
Use this command to configure interface-based IPv6 static routes on the system.
Use the setform of this command to specify the next hop interface for the route.
Use the deleteform of this command to remove the next hop interface.
Use the showform of this command to view the next hop interface for the route.
distance Optional. Defines the next-hop distance for this route. Routes witha smaller distance are selected before those with a larger distance.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
61/85
Chapter2:StaticRoutes StaticRouteCommands 50
BasicRouting 6.5R1v01 Vyatta
protocolsstaticrouteblackhole
Allows you to configure a black-hole static route.
Syntax
set protocols static routesubnetblackhole [distancedistance]
delete protocols static routesubnetblackhole [distance]
show protocols static routesubnetblackhole [distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
routesubnet{
blackhole{
distancedistance
}
}
}
}
Parameters
Default
None.
subnet Mandatory. Multi-node. Defines a static route. The format is adestination subnet of the form address/prefix.
You can define multiple static routes by creating multiple routeconfiguration nodes.
distance Optional. Defines the black-hole distance for this route. Routeswith a smaller distance are selected before those with a larger
distance. The range is 1 to 255. The default is 1.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
62/85
Chapter2:StaticRoutes StaticRouteCommands 51
BasicRouting 6.5R1v01 Vyatta
UsageGuidelines
Use this command to configure a black-hole static route on the router. Ablack-hole route is a route for which the system silently discard packets that arematched.
Use the setform of this command to set a black-hole route.
Use the deleteform of this command to remove a black-hole route.
Use the showform of this command to view black-hole route configuration.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
63/85
Chapter2:StaticRoutes StaticRouteCommands 52
BasicRouting 6.5R1v01 Vyatta
protocolsstaticroutenexthop
Allows you to configure the next hop for a static route.
Syntax
set protocols static routesubnetnext-hop address[disable| distancedistance]
delete protocols static routesubnetnext-hop address[disable| distance]
show protocols static routesubnetnext-hop address[disable| distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
routesubnet{
nexthopaddress{
disable
distancedistance
}
}
}
}
Parameters
subnet Mandatory. Multi-node. Defines a static route. The format is adestination subnet of the form address/prefix.
You can define multiple static routes by creating multiple routeconfiguration nodes.
address Mandatory. The address of the next-hop router.
disable Disables the static route.
distance Optional. Defines the next-hop distance for this route. Routes witha smaller distance are selected before those with a larger distance.The range is 1 to 255. The default is 1.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
64/85
Chapter2:StaticRoutes StaticRouteCommands 53
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure static routes on the router.
Use the setform of this command to specify the next hop for the route.
Use the deleteform of this command to remove the static route next hop.
Use the showform of this command to view static route next-hop configuration.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
65/85
Chapter2:StaticRoutes StaticRouteCommands 54
BasicRouting 6.5R1v01 Vyatta
protocolsstaticroute6blackhole
Allows you to configure a blackhole IPv6 static route.
Syntax
set protocols static route6subnetblackhole [distancedistance]
delete protocols static route6subnetblackhole[distance]
show protocols static route6subnetblackhole[distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
route6subnet{
blackhole{
distancedistance
}
}
}
}
Parameters
Default
None.
subnet Mandatory. Multi-node. Defines an IPv6 static route. The formatis a destination subnet of the form IPv6-address/prefix.
You can define multiple static routes by creating multiple routeconfiguration nodes.
distance Optional. Defines the blackhole distance for this route. Routeswith a smaller distance will be selected before those with a largerdistance.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
66/85
Chapter2:StaticRoutes StaticRouteCommands 55
BasicRouting 6.5R1v01 Vyatta
UsageGuidelines
Use this command to configure a blackhole IPv6 static route. A blackhole routesilently discards packets that are matched.
Use the setform of this command to specify a blackhole IPv6 static route.Use the deleteform of this command to remove a blackhole IPv6 static route.
Use the showform of this command to view blackhole IPv6 static routeconfiguration.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
67/85
Chapter2:StaticRoutes StaticRouteCommands 56
BasicRouting 6.5R1v01 Vyatta
protocolsstaticroute6nexthop
Allows you to configure the next hop for an IPv6 static route.
Syntax
set protocols static route6subnetnext-hopaddress[disable| distancedistance|interfaceinterface]
delete protocols static route6subnetnext-hopaddress[disable| distance| interface]
show protocols static route6subnetnext-hopaddress[disable| distance| interface]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
route6subnet{
nexthopaddress{
disable
distancedistance
interfaceinterface
}
}
}
}
Parameters
subnet Mandatory. Multi-node. Defines an IPv6 static route. The formatis a destination subnet of the form IPv6-address/prefix.
You can define multiple static routes by creating multiple route6configuration nodes.
address Mandatory. The IPv6 address of the next hop router.
disable Disable the IPv6 static route.
distance Optional. Defines the next-hop distance for this route. Routes witha smaller distance will be selected before those with a largerdistance.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
68/85
Chapter2:StaticRoutes StaticRouteCommands 57
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure IPv6 static routes on the system.
Use the setform of this command to specify the next hop for the route.
Use the deleteform of this command to remove the static route next hop.
Use the showform of this command to view static route next hop configuration.
interface Optional. The outgoing interface used to reach the next-hopaddress. This is necessary when the next-hop address is a link-localaddress (that is, it has a fe80::/64 prefix).
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
69/85
Chapter2:StaticRoutes StaticRouteCommands 58
BasicRouting 6.5R1v01 Vyatta
protocolsstatictableinterfaceroute
nexthopinterface
Allows you to configure the next-hop interface for an interface-based static route inan alternate routing table.
Syntax
set protocols static tabletable interface-routesubnetnext-hop-interface interface[disable| distancedistance]
delete protocols static tabletable interface-routesubnetnext-hop-interface interface[disable| distance]
show protocols static tabletable interface-routesubnetnext-hop-interface interface[disable| distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
tabletable
interfaceroutesubnet{
next
hop
interfaceinterface
{
disable
distancedistance
}
}
}
}
}
Parameters
table Mandatory. Multi-node. Defines an alternate routing table to beused by policy based routing rules.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
70/85
Chapter2:StaticRoutes StaticRouteCommands 59
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure interface-based static routes in an alternate routingtable. The alternate routing tables are used with policy based routing. See the VyattaPolicy Based Routing Reference Guidefor information on policy based routing.
Use the setform of this command to specify the next-hop interface.
Use the deleteform of this command to remove the next-hop interface.
Use the showform of this command to view the next-hop interface.
subnet Mandatory. Multi-node. Defines an interface-based static route.The format is a destination subnet of the form address/prefix.
You can define multiple interface-based routes by creating multipleinterface-routeconfiguration nodes.
interface Mandatory. The next-hop interface.
disable Disables the interface-based static route.
distance Optional. Sets the next-hop distance for this route. Routes with asmaller distance are selected before those with a larger distance.The range is 1 to 255. The default is 1.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
71/85
Chapter2:StaticRoutes StaticRouteCommands 60
BasicRouting 6.5R1v01 Vyatta
protocolsstatictableinterfaceroute6
nexthopinterface
Allows you to configure the next hop interface for an interface-based IPv6 staticroute in an alternate routing table.
Syntax
set protocols static tabletable interface-route6subnetnext-hop-interfaceethx[disable| distancedistance]
delete protocols static tabletable interface-route6subnetnext-hop-interfaceethx[disable| distance]
show protocols static tabletable interface-route6subnetnext-hop-interfaceethx[disable| distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
tabletable{interfaceroute6subnet{
next
hop
interfaceethx
{
disable
distancedistance
}
}
}
}
}
Parameters
table Mandatory. Multi-node. Defines an alternate routing table to beused by policy based routing rules.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
72/85
Chapter2:StaticRoutes StaticRouteCommands 61
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure interface-based IPv6 static routes in an alternaterouting table. The alternate routing tables are used with policy based routing. See theVyatta Policy Based Routing Reference Guidefor information on policy basedrouting.
Use the setform of this command to specify the next hop interface for the route.
Use the deleteform of this command to remove the next hop interface.
Use the showform of this command to view the next hop interface for the route.
subnet Mandatory. Multi-node. Defines an interface-based static route.The format is a destination subnet of the form IPv6-address/prefix.
You can define multiple interface-based routes by creating multipleinterface-route6configuration nodes.
ethx Mandatory. The next hop Ethernet interface.
disable Disables the interface-based IPv6 static route.
distance Optional. Defines the next-hop distance for this route. Routes witha smaller distance are selected before those with a larger distance.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
73/85
Chapter2:StaticRoutes StaticRouteCommands 62
BasicRouting 6.5R1v01 Vyatta
protocolsstatictablerouteblackhole
Allows you to configure a black-hole static route in an alternate routing table.
Syntax
set protocols static tabletable routesubnetblackhole [distancedistance]
delete protocols static tabletable routesubnetblackhole [distance]
show protocols static tabletable routesubnetblackhole [distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
tabletable{
routesubnet{
blackhole{
distancedistance
}
}
}
}
}
Parameters
table Mandatory. Multi-node. Defines an alternate routing table to beused by policy based routing rules.
subnet Mandatory. Multi-node. Defines a static route. The format is adestination subnet of the form address/prefix.
You can define multiple static routes by creating multiple route
configuration nodes.
distance Optional. Defines the black-hole distance for this route. Routeswith a smaller distance are selected before those with a largerdistance. The range is 1 to 255. The default is 1.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
74/85
Chapter2:StaticRoutes StaticRouteCommands 63
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure a black-hole static route in an alternate routingtable. A black-hole route is a route for which the system silently discard packets thatare matched.
The alternate routing tables are used with policy based routing. See the Vyatta PolicyBased Routing Reference Guidefor information on policy based routing.
Use the setform of this command to set a black-hole route.
Use the deleteform of this command to remove a black-hole route.
Use the showform of this command to view black-hole route configuration.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
75/85
Chapter2:StaticRoutes StaticRouteCommands 64
BasicRouting 6.5R1v01 Vyatta
protocolsstatictableroutenexthop
Allows you to configure the next hop for a static route in an alternate routing table.
Syntax
set protocols static tabletable routesubnetnext-hop address[disable| distancedistance]
delete protocols static tabletable routesubnetnext-hop address[disable| distance]
show protocols static tabletable routesubnetnext-hop address[disable| distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
tabletable{
routesubnet{
nexthopaddress{
disable
distancedistance
}
}
}
}
}
Parameters
table Mandatory. Multi-node. Defines an alternate routing table to beused by policy based routing rules.
subnet Mandatory. Multi-node. Defines a static route. The format is adestination subnet of the form address/prefix.
You can define multiple static routes by creating multiple routeconfiguration nodes.
address Mandatory. The address of the next-hop router.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
76/85
Chapter2:StaticRoutes StaticRouteCommands 65
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure static routes in an alternate routing table. Thealternate routing tables are used with policy based routing. See the Vyatta PolicyBased Routing Reference Guidefor information on policy based routing.
Use the setform of this command to specify the next hop for the route.
Use the deleteform of this command to remove the static route next hop.
Use the showform of this command to view static route next-hop configuration.
disable Disables the static route.
distance Optional. Defines the next-hop distance for this route. Routes witha smaller distance are selected before those with a larger distance.The range is 1 to 255. The default is 1.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
77/85
Chapter2:StaticRoutes StaticRouteCommands 66
BasicRouting 6.5R1v01 Vyatta
protocolsstatictableroute6blackhole
Allows you to configure a blackhole IPv6 static route in an alternate routing table.
Syntax
set protocols static tabletable route6subnetblackhole [distancedistance]
delete protocols static tabletable route6subnetblackhole[distance]
show protocols static tabletable route6subnetblackhole[distance]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
tabletable{
route6subnet{
blackhole{
distancedistance
}
}
}
}
}
Parameters
table Mandatory. Multi-node. Defines an alternate routing table to beused by policy based routing rules.
subnet Mandatory. Multi-node. Defines an IPv6 static route. The formatis a destination subnet of the form IPv6-address/prefix.
You can define multiple static routes by creating multiple route
configuration nodes.
distance Optional. Defines the blackhole distance for this route. Routeswith a smaller distance will be selected before those with a largerdistance.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
78/85
Chapter2:StaticRoutes StaticRouteCommands 67
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure a blackhole IPv6 static route in an alternate routingtable. A blackhole route silently discards packets that are matched.
The alternate routing tables are used with policy based routing. See the Vyatta PolicyBased Routing Reference Guidefor information on policy based routing.
Use the setform of this command to specify a blackhole IPv6 static route.
Use the deleteform of this command to remove a blackhole IPv6 static route.
Use the showform of this command to view blackhole IPv6 static routeconfiguration.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
79/85
Chapter2:StaticRoutes StaticRouteCommands 68
BasicRouting 6.5R1v01 Vyatta
protocolsstatictableroute6nexthop
Allows you to configure the next hop for an IPv6 static route in an alternate routingtable.
Syntax
set protocols static tabletable route6subnetnext-hopaddress[disable| distancedistance| interfaceinterface]
delete protocols static tabletable route6subnetnext-hopaddress[disable| distance| interface]
show protocols static tabletable route6subnetnext-hopaddress[disable| distance|interface]
CommandMode
Configuration mode.
ConfigurationStatement
protocols{
static{
tabletable{
route6subnet{
next
hopaddress
{
disable
distancedistance
interfaceinterface
}
}
}
}
}
Parameters
table Mandatory. Multi-node. Defines an alternate routing table to beused by policy based routing rules.
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
80/85
Chapter2:StaticRoutes StaticRouteCommands 69
BasicRouting 6.5R1v01 Vyatta
Default
None.
UsageGuidelines
Use this command to configure IPv6 static routes on the system in an alternaterouting table. The alternate routing tables are used with policy based routing. See theVyatta Policy Based Routing Reference Guidefor information on policy basedrouting.
Use the setform of this command to specify the next hop for the route.
Use the deleteform of this command to remove the static route next hop.
Use the showform of this command to view static route next hop configuration.
subnet Mandatory. Multi-node. Defines an IPv6 static route. The formatis a destination subnet of the form IPv6-address/prefix.
You can define multiple static routes by creating multiple route6configuration nodes.
address Mandatory. The IPv6 address of the next hop router.
disable Disable the IPv6 static route.
distance Optional. Defines the next-hop distance for this route. Routes witha smaller distance will be selected before those with a largerdistance.
interface Optional. The outgoing interface used to reach the next-hopaddress. This is necessary when the next-hop address is a link-localaddress (that is, it has a fe80::/64 prefix).
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
81/85
70
BasicRouting 6.5R1v01 Vyatta
GlossaryofAcronyms
ACL access control list
ADSL Asymmetric Digital Subscriber Line
AMI Amazon Machine Image
API Application Programming Interface
AS autonomous system
ARP Address Resolution Protocol
AWS Amazon Web Services
BGP Border Gateway Protocol
BIOS Basic Input Output System
BPDU Bridge Protocol Data Unit
CA certificate authority
CCMP AES in counter mode with CBC-MAC
CHAP Challenge Handshake Authentication Protocol
CLI command-line interface
DDNS dynamic DNS
DHCP Dynamic Host Configuration Protocol
DHCPv6 Dynamic Host Configuration Protocol version 6
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
82/85
71
BasicRouting 6.5R1v01 Vyatta
DLCI data-link connection identifier
DMI desktop management interface
DMZ demilitarized zone
DN distinguished name
DNS Domain Name System
DSCP Differentiated Services Code Point
DSL Digital Subscriber Line
eBGP external BGP
EBS Amazon Elastic Block Storage
EC2 Amazon Elastic Compute Cloud
EGP Exterior Gateway Protocol
ECMP equal-cost multipath
ESP Encapsulating Security Payload
FIB Forwarding Information Base
FTP File Transfer Protocol
GRE Generic Routing Encapsulation
HDLC High-Level Data Link Control
I/O Input/Ouput
ICMP Internet Control Message Protocol
IDS Intrusion Detection System
IEEE Institute of Electrical and Electronics Engineers
IGP Interior Gateway Protocol
IPS Intrusion Protection System
IKE Internet Key Exchange
IP Internet Protocol
IPOA IP over ATM
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
83/85
72
BasicRouting 6.5R1v01 Vyatta
IPsec IP security
IPv4 IP Version 4
IPv6 IP Version 6
ISP Internet Service Provider
KVM Kernel-Based Virtual Machine
L2TP Layer 2 Tunneling Protocol
LACP Link Aggregation Control Protocol
LAN local area network
LDAP Lightweight Directory Access Protocol
LLDP Link Layer Discovery Protocol
MAC medium access control
MIB Management Information Base
MLPPP multilink PPP
MRRU maximum received reconstructed unit
MTU maximum transmission unit
NAT Network Address Translation
ND Neighbor Discovery
NIC network interface card
NTP Network Time Protocol
OSPF Open Shortest Path First
OSPFv2 OSPF Version 2
OSPFv3 OSPF Version 3
PAM Pluggable Authentication Module
PAP Password Authentication Protocol
PAT Port Address Translation
PCI peripheral component interconnect
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
84/85
73
BasicRouting 6.5R1v01 Vyatta
PKI Public Key Infrastructure
PPP Point-to-Point Protocol
PPPoA PPP over ATM
PPPoE PPP over Ethernet
PPTP Point-to-Point Tunneling Protocol
PTMU Path Maximum Transfer Unit
PVC permanent virtual circuit
QoS quality of service
RADIUS Remote Authentication Dial-In User Service
RHEL Red Hat Enterprise Linux
RIB Routing Information Base
RIP Routing Information Protocol
RIPng RIP next generation
Rx receive
S3 Amazon Simple Storage Service
SLAAC Stateless Address Auto-Configuration
SNMP Simple Network Management Protocol
SMTP Simple Mail Transfer Protocol
SONET Synchronous Optical Network
SSH Secure Shell
SSID Service Set Identifier
STP Spanning Tree Protocol
TACACS+ Terminal Access Controller Access Control System Plus
TBF Token Bucket Filter
TCP Transmission Control Protocol
TKIP Temporal Key Integrity Protocol
8/21/2019 Vyatta-BasicRouting 6.5R1 v01
85/85
74
ToS Type of Service
TSS TCP Maximum Segment Size
Tx transmit
UDP User Datagram Protocol
VHD virtual hard disk
vif virtual interface
VLAN virtual LAN
VPC Amazon virtual private cloud
VPN Virtual Private Network
VRRP Virtual Router Redundancy Protocol
WAN wide area network
WAP wireless access point
WPA Wired Protected Access
Top Related