Vyatta
Suite200
1301ShorewayRoad
Belmont,CA94002
vyatta.com
6504137200
1888VYATTA1(USandCanada)
VYATTA,INC. | VyattaSystem
WANInterfaces
REFERENCEGUIDE
SerialInterfaces
TestingSerialLines
DSLInterfaces
WirelessModemInterfaces
COPYRIGHT
Copyright©2005–2012Vyatta,Inc.Allrightsreserved.
Vyattareservestherighttomakechangestosoftware,hardware,anddocumentationwithoutnotice.Forthemostrecentversionof
documentation,visittheVyattawebsiteatvyatta.com.
PROPRIETARYNOTICES
VyattaisaregisteredtrademarkofVyatta,Inc.
Hyper‐VisaregisteredtrademarkofMicrosoftCorporation.
VMware,VMwareESX,andVMwareserveraretrademarksofVMware,Inc.
XenServer,andXenCenteraretrademarksofCitrixSystems,Inc.
Allothertrademarksarethepropertyoftheirrespectiveowners.
RELEASEDATE:October2012
DOCUMENTREVISION.6.5R1
v01
RELEASEDWITH:6.5R1
PARTNO.A0‐0212‐10‐0016
iii
WANInterfaces 6.5R1v01 Vyatta
Contents
QuickListofCommands........................................................vi
ListofExamples ...............................................................ix
Preface. .....................................................................xi
IntendedAudience ........................................... ....................................xii
OrganizationofThisGuide .................
.................................... ................. .. .xii
DocumentConventions ..........................................
................................xiii
VyattaPublicati ons................
............... ...............................................xiii
Chapter1SerialInterfaces ...................................................... 1
SerialInterfaceConfiguration ...................................................................... 2
VirtualInterfacesonSerialInterfaces .......................
................................. ....2
EnablingInterfaces ...........
.................................... ................. .. .........2
ViewingAvailableSerialInterfaces.................................
..............................3
SerialInterfaceCommands..................
............... ........................................5
clearinterfacesserial............................................
..............................8
interfacesserial<wanx>.................
.....................................................11
interfacesserial<wanx>description<desc> ...........................................
...........13
interfacesserial<wanx>e1‐options.................. .................
............... ...........15
interfacesserial<wanx>e1‐optionsclock<type> .................
................................17
interfacesserial<wanx>e1‐optionsframing<type>...........
............... ................... ..19
interfacesserial<wanx>e1‐optionstimeslots ........
............... ................... ..........21
interfacesserial<wanx>e3‐options..
.................................................... .......23
interfacesserial<wanx>e3‐optionsclock<type> ...................................
..............24
interfacesserial<wanx>e3‐optionsframing<type>.............................
..................26
interfacesserial<wanx>e3‐optionsline‐coding<type> ........................
....................28
interfacesserial<wanx>encapsulation<type> ................ .........
..........................30
interfacesserial<wanx>synch‐options ....................
................................. .....32
interfacesserial<wanx>synch‐optionsbaud‐rate<rate> .....
................................. .....34
interfacesserial<wanx>synch‐optionsclock<type>......
................................. ........36
interfacesserial<wanx>synch‐optionsconnection<type> ..
.................................... ...38
interfacesserial<wanx>synch‐optionsline‐cod ing<type>....
................................. .....40
interfacesserial<wanx>synch‐optionsline‐idle<type>....
................................. .......42
interfacesserial<wanx>t1‐options ......
.................................... ................. .. 44
interfacesserial<wanx>t1‐optionsclock<type> .......................................
...........46
interfacesserial<wanx>t1‐optionslbo<range> ........... .....................
............... ...48
iv
WANInterfaces 6.5R1v01 Vyatta
interfacesserial<wanx>t1‐optionstimeslots.......................... ...........................50
interfacesserial<wanx>t3‐options .............. .. .......................
......................52
interfacesserial<wanx>t3‐optionsclock<type> ......................
............................54
interfacesserial<wanx>t3‐optionsframing<type> ...............
................................56
interfacesserial<wanx>t3‐optionsline‐coding<type>...........
..................................58
monitorinterfacesserial<wanx>traffic ...........
................................. .............60
showinterfacesserial .
.................................... ................. .. ................62
showinterfacesserial<wanx>.........................
........................................64
showinterfacesserial<wanx>bert‐status ....
...................................................65
showinterfacesserial<wanx>cisco‐hdlc ................ ............................
............67
showinterfacesserial<wanx>frame‐relay .................................
......................68
showinterfacesserial<wanx>log.......................
.................................... ...69
showinterfacesserial<wanx>loopback .......
..................................................70
showinterfacesserial<wanx>physical ..............................................
............71
showinterfacesserial<wanx>ppp .. ...............................
............... .............72
showinterfacesserial<wanx>queue .................
............... ................... ........74
showinterfacesserial<wanx>trace ...
............... ................... .................... ...75
Chapter2TestingSerialLines ................................................... 77
SerialLineTestingOverview.................................... ...................................78
SerialLineLoopbacks ....... .................
................................. ...................78
LoopbackTests ......................... ................... ..
...................................81
BitErrorRateTests...........
.................................................... ...............83
SerialLineTestingCommands..............................
.................................... ...85
test‐definitionbert<test‐name>......
................................. ........................87
test‐definitionbert<test‐name>duration<duration>.....................................
.........89
test‐definitionbert<test‐name>err‐insert‐rate<rate>.............. ...................
............90
test‐definitionbert<test‐name>loopup‐code<code> .. ............................
............... 92
test‐definitionbert<test‐name>pattern<pattern‐name>...........................
............... 94
test‐definitionbert<test‐name>pattern<pattern‐name>alternating‐word.........................
..96
test‐definitionbert<test‐name>pattern<pattern‐name>repeating .................... .............98
testinterface<wanx>start‐bert<test
‐name> ..................... ..............................100
testinterface<wanx>stop‐bert ........................ ................... .
............... ....102
testloopbackdown .............................
................................ .. ..........103
testloopbackstart ....
............... ................... ....................................105
testloopbackup.............................
................................. ..............107
Chapter3DSLInterfaces ......................................................109
DSLConfiguration .......................... ....................................................110
ADSLInterfacesOverview ... ................
.................................................110
ADSL
ConfigurationExample..................................................................110
v
WANInterfaces 6.5R1v01 Vyatta
DSLCommands ...................... ................... ................. ......................113
interfacesadsl<adslx> ..... ...........
.................................... ................. .115
interfacesadsl<adslx>pvc<pvc‐id> ..................................... ...
............... ....117
interfacesadsl<adslx>watchdog<state> ........... ................
............................119
monitorinterfacesadsl<if‐name>traffic ................
.......................................121
showinterfacesadsl<if‐name> ......
............... ................... ................. ......122
showinterfacesadsl<if‐name>queue ............................... .......
...................123
showinterfacesadsl<if‐name>status..........................
................................124
Chapter4WirelessModemInterfaces........................................... 125
WirelessModemConfiguration ..................................... ..............................126
WirelessModemInterfaceCommands .............................
................................128
clearinterfacesconnection<wlmx>..... ..........
................................. ............130
connectinterface<wlmx>...
.................................................................131
disconnectinterface<wlmx> ................... .. ...........
............... ..................132
interfaceswirelessmodem<wlmx>..............
............... ................... ............133
interfaceswirelessmodem<wlmx>backup.
............... ......................................135
interfaceswirelessmodem<wlmx>description<desc> ................ ................... .........
137
interfaceswirelessmodem<wlmx>device<device>....................................... ......
.139
interfaceswirelessmodem<wlmx>ipv6address............................... .............
.....140
interfaceswirelessmodem<wlmx>ipv6disable‐forwarding. .......................................
142
interfaceswirelessmodem<wlmx>ipv6dup‐addr‐detect‐transmits<num>............ ...............144
interfaceswirelessmodem<wlmx>ipv6router‐advert........
................................ .. ..146
interfaceswirelessmodem<wlmx>mtu<mtu>.........
............... ................... .......151
interfaceswirelessmodem<wlmx>network<scriptfile>.....
............... ................... ....153
interfaceswirelessmodem<wlmx>no‐dns ........
............... ................... ............155
interfaceswirelessmodem<wlmx>ondemand
..................................................156
showinterfaceswirelessmodem .......................................... ....................158
GlossaryofAcronyms......................................................... 161
vi
WANInterfaces 6.5R1v01 Vyatta
QuickListofCommands
Use this list to help you quickly locate commands.
clearinterfacesconnection<wlmx> ......................... ......................................130
clearinterfacesserial ...............................
................................. .............8
connectinterface<wlmx> .
.................................... ................. .. ...............131
disconnectinterface<wlmx>............... ............
..........................................132
interfacesadsl<adslx>pvc<pvc‐id>..
............... ..............................................117
interfacesadsl<adslx>watchdog<state>.......................... ..........
.......................119
interfacesadsl<adslx> ........................
................................. .................115
interfacesserial<wanx>description<desc> .................... ................... ......
............13
interfacesserial<wanx>e1‐optionsclock<type>............................. ..
............... .......17
interfacesserial<wanx>e1‐optionsframing<type> ........ ..............
.............................19
interfacesserial<wanx>e1‐optionstimeslots...............
............... ................... .......21
interfacesserial<wanx>e1‐options ....
............... ................... ..........................15
interfacesserial<wanx>e3‐optionsclock<type>............................. .....
...................24
interfacesserial<wanx>e3‐optionsframing<type> ........ .................
..........................26
interfacesserial<wanx>e3‐optionsline‐coding<type>................
................................28
interfacesserial<wanx>e3‐options .............
................................. ..................23
interfacesserial<wanx>encapsulation<type>............................................
...........30
interfacesserial<wanx>synch‐optionsbaud‐rate<rate>..................... .. .........
............... 34
interfacesserial<wanx>synch‐optionsclock<type> ..................... .......
............... .......36
interfacesserial<wanx>synch‐optionsconnection<type> .....................
........................38
interfacesserial<wanx>synch‐optionsline‐coding<type> ..................
...........................40
interfacesserial<wanx>synch‐optionsline‐idle<type> ................
................................42
interfacesserial<wanx>synch‐options..............
................................................32
interfacesserial
<wanx>t1‐optionsclock<type>................................. .....................46
interfacesserial<wanx>t1‐optionslbo<range>............................ ........
..................48
interfacesserial<wanx>t1‐optionstimeslots ..........................
..............................50
interfacesserial<wanx>t1‐options................
................................. ................44
interfaces
serial<wanx>t3‐optionsclock<type>...................................................... 54
interfacesserial<wanx>t3‐optionsframing<type> ..................................
............... ..56
interfacesserial<wanx>t3‐optionsline‐coding<type> ......... .. ..............
............... ........58
interfacesserial<wanx>t3‐options.......................
............... ................... ........52
interfacesserial<wanx> ......
............... ................... ..................................11
vii
WANInterfaces 6.5R1v01 Vyatta
interfaceswirelessmodem<wlmx>backup .......................... ................... ............135
interfaceswirelessmodem<wlmx>description<desc>....................................
............137
interfaceswirelessmodem<wlmx>device<device> ..................................
................139
interfaceswirelessmodem<wlmx>ipv6address ..............................
.......................140
interfaceswirelessmodem<wlmx>ipv6disable‐forwarding .......... ...........
......................142
interfaceswirelessmodem<wlmx>ipv6dup‐addr‐detect‐transmits<num> ...................
...........144
interfaceswirelessmodem<wlmx>ipv6router‐advert ..................................
..............146
interfaceswirelessmodem<wlmx>mtu<mtu> ..... ................... ........
......................151
interfaceswirelessmodem<wlmx>network<scriptfile> .......................
.......................153
interfaceswirelessmodem<wlmx>no‐dns................... ....
................................. ..155
interfaceswirelessmodem<wlmx>ondemand .... .......
................................. ..........156
interfaceswirelessmodem<wlmx> .....
................................. ..........................133
monitorinterfacesadsl<if‐name>traffic.................................. .
............... .........121
monitorinterfacesserial<wanx>traffic..... ................
........................................60
showinterfacesadsl<if‐name>queue....
............... ................... ................. ......123
showinterfacesadsl<if‐name>status ................. .. ...................
.......................124
showinterfacesadsl<if‐name>......................
................................. ............122
showinterfacesserial<wanx>bert
‐status.................................................... .......65
showinterfacesserial<wanx>cisco‐hdlc............... ...................
............... ...........67
showinterfacesserial<wanx>frame‐relay...................
........................................68
showinterfacesserial<wanx>log ......
............... ................... ..........................69
showinterfacesserial<wanx>loopback.....................................
........................70
showinterfacesserial<wanx>physical......................
................................. .......71
showinterfacesserial<wanx>ppp.....
................................. ...........................72
showinterfacesserial<wanx>queue.. ................... ..............
............... .............74
showinterfacesserial<wanx>trace.................
............... ................... .............75
showinterfacesserial
<wanx> ............................................. ........................64
showinterfacesserial.................... .........
...............................................62
showinterfaceswirelessmodem
................................. .................................158
testinterface<wanx>start‐bert<test‐name>...........................
............................100
testinterface<wanx>stop‐bert..................
............... ................... ...............102
test
loopbackdown......... ................... .................................................103
testloopbackstart.....................
.........................................................105
testloopbackup ... ................... ..................
.......................................107
test‐definitionbert<test‐name>duration<duration> ....
................................ .. ...........89
test‐definitionbert<test‐name>
err‐insert‐rate<rate> .............. ..................................90
viii
WANInterfaces 6.5R1v01 Vyatta
test‐definitionbert<test‐name>loopup‐code<code>...................................... ...........92
test‐definitionbert<test‐name>pattern<pattern‐name>alternating‐word ...............................96
test‐definitionbert
<test‐name>pattern<pattern‐name>repeating.....................................98
test‐definitionbert<test‐name>pattern<pattern‐
name> .............. ................... .............94
test‐definitionbert<test‐
name>.............................. ................... ..................87
ix
WANInterfaces 6.5R1v01 Vyatta
ListofExamples
Use this list to help you locate examples you’d like to look at or try.
Example1‐1Viewingavailablesysteminterfaces ............................................. ..........3
Example1‐2“clearinterfacesserial”..................................
...............................9
Example1‐3“clearinterfacesserialwan0counterscisco‐hdlc”:Displayingtheresultoftheclearcommand....
..9
Example1‐4Displayingtrafficdata............................ ...............
.......................60
Example1‐5“showinterfacesserial”:Displayingserialinterfaceinformation..................
............62
Example1‐6“showinterfacesserialwan1”:Displayingserialinterfaceinformation........ .................64
Example1‐7
“showinterfacesserialwanxbert‐status”.................................................65
Example1‐8“showinterfacesserialwanxppp”.......................................
................72
Example1‐9“showinterfacesserialwanxtrace”...........................
...........................75
Example2‐1TestingthelocalWANinterface.................
................................. .......82
Example2‐2TestingtheremoteWANinterface ..
................................. ...................82
Example2‐3Testingthecircuit ................. .........................
............... ...........82
Example2‐4Testingaphysicalloopbackonthelocalsystem ..............
............... ...............83
Example2‐5StartingaBERT............ ..
........................................................101
Example2‐6StoppingaBERT........................................
.............................102
Example2‐7Deactivatingalocalloopbackonwan0.............
................................. .....104
Example2‐8Successfultestofa loopback .....
................................. .....................105
Example2‐9Unsuccessfulloopbacktest.........................................
...................106
Example2‐10Activatingalocalloopback...................... ...
............... ...................108
Example3‐1CreatingandconfiguringanADSLinterfaceforPPPoEencapsulation.....
....................112
Example4‐1SierraWirelessUSBConnect881modemaccessingtheAT&Tnetwork.................
......126
Example4‐2UTStarcom3GmodemaccessingtheVerizonnetwork .................................
...126
Example4‐3Disconnectingfromthenetwork................................... .....
...............127
Example4‐4Connectingtothenetwork .............................
...............................127
Example4‐5“showinterfaces”:Displayinginterfacestatus...........
............... ..................158
Example4‐6“showinterfaceswirelessmodemwlm0”:Displayingwirelessmodeminterfaceinformation......159
Example4
‐7“showinterfaceswirelessmodemwlm0debug”:Displayingdebuginformationforthewirelessmodem
interface.....................................
............... ................... ...............159
x
WANInterfaces 6.5R1v01 Vyatta
Example4‐8“showinterfaceswirelessmodemwlmxstatistics”:Displayingstatisticsforthewirelessmodeminterface
160
xi
WANInterfaces 6.5R1v01 Vyatta
Preface
This document describes the various deployment, installation, and upgrade options
for Vyatta software.
This preface provides information about using this guide. The following topics are
presented:
• Intended Audience
• Organization of This Guide
• Document Conventions
• Vyatta Publications
IntendedAudience
xii
WANInterfaces 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 you’d like to try or look at.
This guide has the following chapters:
Chapter Description Page
Chapter 1:SerialInterfaces Thischapterexplainshowtoconfigureand
monitorserialinterfacesontheVyatta
system.
1
Chapter 2:Testin gSerialLines Thischapterdescribesthetestsavailablefor
serialinterfacesontheVyattasystem.
77
Chapter 3:DSLInterfaces ThischapterexplainshowtouseDigital
SubscriberLine(DSL)interfacesontheVyatta
system.Currentlythe
Vy attasystemsupports
AsymmetricalDSL(ADSL)interfacesonly.
109
Chapter 4:WirelessModem
Interfaces
Thischapterexplainshowtoworkwith
wirelessmodemsontheVyattasystem.
125
GlossaryofAcronyms 161
DocumentConventions
xiii
WANInterfaces 6.5R1v01 Vyatta
DocumentConventions
This guide uses the following advisory paragraphs, as follows.
NOTENotesprovideinformationyoumightneedtoavoidproblemsorconfigurationerrors.
This document uses the following typographic conventions.
VyattaPublications
WARNINGWarningsalertyoutosituationsthatmayposeathreattopersonalsafety.
CAUTIONCautionsalertyoutosituationsthatmightcauseharmtoyoursystemordamageto
equipment,orthatmayaffectservice.
Monospace
Examples, command-line output, and representations of
configuration nodes.
boldMonospace
Your input: something you type at a command line.
bold Commands, keywords, and file names, when mentioned
inline.
Objects in the user interface, such as tabs, buttons, screens,
and panes.
italics An argument or variable where you supply a value.
<key> A key on your keyboard, such as <Enter>. Combinations of
keys are joined by plus signs (“+”), as in <Ctrl>+c.
[ key1 | key2] Enumerated options for completing a syntax. An example is
[enable | disable].
num1–numN A inclusive range of numbers. An example is 1–65535, which
means 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 (a
space-separated list and a comma-separated list, respectively).
VyattaPublications
xiv
WANInterfaces 6.5R1v01 Vyatta
Full product documentation is provided in the Vyatta technical library. To see what
documentation is available for your release, see the Guide to Vyatta Documentation.
This guide is posted with every release of Vyatta software and provides a great
starting point for finding the information you need.
Additional information is available on www.vyatta.com and www.vyatta.org.
1
WANInterfaces 6.5R1v01 Vyatta
Chapter1:SerialInterfaces
This chapter explains how to configure and monitor serial interfaces on the Vyatta
system.
This chapter presents the following topics:
• Serial Interface Configuration
• Serial Interface Commands
ThisfeatureisavailableonlyintheVyattaSubscriptionEdition.
Chapter1:SerialInterfaces SerialInterfaceConfiguration
2
WANInterfaces 6.5R1v01 Vyatta
SerialInterfaceConfiguration
This section presents the following topics:
• Virtual Interfaces on Serial Interfaces
• Enabling Interfaces
• Viewing Available Serial Interfaces
VirtualInterfacesonSerialInterfaces
The Vyatta system distinguishes between physical interfaces (interfaces), and logical
interfaces (virtual interfaces, or vifs).
Every physical network device in the system is considered to be an “interface.” An
example of a interface is a physical port on a serial card. Every serial interface has
zero or more corresponding vifs.
On serial interfaces, physical line characteristics are specific for the interface, but
encapsulation (Cisco HDLC, Frame Relay, or Point-to-Point Protocol) is specified
for vifs.
Unlike Ethernet interfaces, a physical serial interface cannot directly have a
configured IP address. Instead, the IP address must be assigned to the vif.
Note that each serial vif can support exactly one IP address.
EnablingInterfaces
The Vyatta system will automatically discover any available physical serial interfaces
on startup. Before you can apply any configuration to a serial interface, a vif must be
“created” for the interface and its encapsulation specified in the configuration tree.
For serial interfaces, physical line characteristics are applied to the interface as a
whole. Encapsulation characteristics are applied to the vif, as shown in the
configuration hierarchy below:
interfaces{
serialwan0{
ppp{
vif1{
Chapter1:SerialInterfaces SerialInterfaceConfiguration
3
WANInterfaces 6.5R1v01 Vyatta
}
}
}
}
The current implementation supports Cisco HDLC, Frame Relay, and Point-to-Point
Protocol encapsulation.
• Cisco HDLC and point-to-point interfaces support only one vif, and this vif must
have the identifier 1.
• The identifier for Frame Relay vifs is the DLCI number. This can range from 16
through 991.
• Currently, any vif on a serial interface can support exactly one IP address.
ViewingAvailableSerialInterfaces
You can only configure interfaces that actually are available to the operating system
on the hardware you are using.
To view all the interfaces known to the operating system, use the show interfaces
system command in operational mode, as shown in Example 1-1:
Example1‐1Viewingavailablesysteminterfaces
vyatta@vyatta>show interfaces system
eth0:<BROADCAST,MULTICAST,UP,LOWER_UP>mtu1500qdiscpfifo_faststate
UPqlen1000
link/ether00:15:c5:fb:ba:e8brdff:ff:ff:ff:ff:ff
inet10.1.0.44/24brd10.1.0.255scopeglobaleth0
inet6fe80::215:c5ff:fefb:bae8/64scopelink
valid_lftforeverpreferred_lftforever
RX:bytespacketserrorsdroppedoverrunmcast
184692570001
TX:bytespacketserrorsdroppedcarriercollisions
174341700000
eth1:<BROADCAST,MULTICAST,UP,LOWER_UP>mtu1500qdiscpfifo_faststate
UPqlen1000
link/ether00:15:c5:fb:ba:e9brdff:ff:ff:ff:ff:ff
inet6fe80::215:c5ff:fefb:bae9/64scopelink
valid_lftforeverpreferred_lftforever
RX:bytespacketserrorsdroppedoverrunmcast
000000
Chapter1:SerialInterfaces SerialInterfaceConfiguration
4
WANInterfaces 6.5R1v01 Vyatta
TX:bytespacketserrorsdroppedcarriercollisions
42440000
lo:<LOOPBACK,UP,LOWER_UP>mtu16436qdiscnoqueuestateUNKNOWN
link/loopback00:00:00:00:00:00brd00:00:00:00:00:00
inet127.0.0.1/8scopehostlo
inet6::1/128scopehost
valid_lftforeverpreferred_lftforever
RX:bytespacketserrorsdroppedoverrunmcast
3600600000
TX:bytespacketserrorsdroppedcarriercollisions
3600600000
wan0:<POINTOPOINT,NOARP,UP,LOWER_UP>mtu4112qdiscpfifo_faststateUP
qlen100
link/ppp
RX:bytespacketserrorsdroppedoverrunmcast
000500
TX:bytespacketserrorsdroppedcarriercollisions
000000
wan1:
<POINTOPOINT,NOARP,UP,LOWER_UP>mtu4112qdiscpfifo_faststateUP
qlen100
link/ppp
RX:bytespacketserrorsdroppedoverrunmcast
000500
TX:bytespacketserrorsdroppedcarriercollisions
000000
Chapter1:SerialInterfaces SerialInterfaceCommands
5
WANInterfaces 6.5R1v01 Vyatta
SerialInterfaceCommands
This chapter contains the following commands.
ConfigurationCommands
SerialInterface
interfacesserial<wanx> Specifiesbasicserialinterfaceconfiguration,
includingLayer2encapsulationcharacteristics.
interfacesserial<wanx>description<desc> Specifiesadescriptionforaserialinterface.
interfacesserial<wanx>encapsulation<type> Setstheencapsulationtypeforaserialinterface.
E1Options
interfacesserial<wanx>e1‐options SpecifiesthephysicallinecharacteristicsforanE1
serialinterface.
interfacesserial<wanx>e1‐optionsclock<type> SetsthetimingsourceforanE1serialinterface.
interfacesserial<wanx>e1‐optionsframing<type> SetstheframingforanE1serialinterface.
interfacesserial<wanx>e1‐optionstimeslots Definestimeslotsfora
32‐channelchannelizedE1
line.
E3Options
interfacesserial<wanx>e3‐options SpecifiesthephysicallinecharacteristicsforanE3
serialinterface.
interfacesserial<wanx>e3‐optionsclock<type> SpecifiesthetimingsourceforanE3serial
interface.
interfacesserial<wanx>e3‐optionsframing<type> SpecifiestheframingtypeforanE3serial
interface.
interfacesserial<wanx>e3‐optionsline‐coding<type> Specifies
thelinecodingforanE3serialinterface.
SynchronousSerial
interfacesserial<wanx>synch‐options Specifiesthephysicallinecharacteristicsfor
synchronousserialinterfaces.
interfacesserial<wanx>synch‐options baud‐rate<rate> Setsthebitrateforaninternallyclocked
synchronousserialinterface.
interfacesserial<wanx>synch‐options clock<type> Setsthetimingsourceforasynchronousserial
interface.
Chapter1:SerialInterfaces SerialInterfaceCommands
6
WANInterfaces 6.5R1v01 Vyatta
interfacesserial<wanx>synch‐options connection<type> Setstheconnectiontypeforasynchronousserial
interface.
interfacesserial<wanx>synch‐options line‐coding<type> Setsthelinecodingstandardforasynchronous
serialinterface.
interfacesserial<wanx>synch‐options line‐idle<type> Setstheidlelinesignallingforasynchronousserial
interface.
T1Options
interfacesserial<wanx>t1‐options SpecifiesthephysicallinecharacteristicsforT1
serialinterfaces.
interfacesserial<wanx>t1‐optionsclock<type> SetsthetimingsourceforaT1serialinterface.
interfacesserial<wanx>t1‐optionslbo<range> Specifiesthelinebuild‐out(LBO)rangeforaT1
serialinterface.
interfacesserial<wanx>t1‐optionstimeslots Defines
timeslotsfora24‐channelchannelizedT1
line.
T3Options
interfacesserial<wanx>t3‐options SpecifiesthephysicallinecharacteristicsforaT3
serialinterface.
interfacesserial<wanx>t3‐optionsclock<type> Specifiesthetimingsourceforthe circuit.
interfacesserial<wanx>t3‐optionsframing<type> SpecifiestheframingtypeforaT3serialinterface.
interfacesserial<wanx>t3‐optionsline‐coding<type> Specifiestheline
codingforaT3serialinterface.
OperationalCommands
clearinterfacesserial Clearscounter sforserialinterfaces
monitorinterfacesserial<wanx>traffic Displaystrafficonaserialinterface.
showinterfacesserial Displaysstatisticsandstatusinformationforall
serialinterfaces.
showinterfacesserial<wanx> Displaysstatisticsandstatusinformationfora
serialinterface.
showinterfacesserial<wanx>bert‐status DisplaysamessageindicatingBERTprogressfora
serialinterface.
showinterfacesserial<wanx>cisco‐hdlc DisplaysCiscoHDLCinformationforaserial
interface.
showinterfacesserial<wanx>frame‐relay DisplaysFrameRelayinformationforaser ial
interface.
Chapter1:SerialInterfaces SerialInterfaceCommands
7
WANInterfaces 6.5R1v01 Vyatta
Commands for using other system features with serial interfaces can be found in the
following locations.
showinterfacesserial<wanx>log Displaysloginformationforaserialinterface.
showinterfacesserial<wanx>loopback Displaysloopbackinformationforaserial
interface.
showinterfacesserial<wanx>physical Di splaysphysicaldeviceinformationforaserial
interface.
showinterfacesserial<wanx>ppp DisplaysPoint‐to‐Pointprotocolinformationfora
serialinterface.
showinterfacesserial<wanx>queue Displays
queueinformationforaserialinterface.
showinterfacesserial<wanx>trace Displaystraceinformationforaserialinterface.
RelatedCommandsDocumentedElsewhere
SerialInterfaceTesting Com mandsfortestingserialinterfaces,includingcommandsforconfiguringBERT
tests,aredescribedin“Chapter 2:TestingSerialLines.”
Firewall CommandsforconfiguringfirewallonserialinterfacesaredescribedintheVyatta
FirewallReferenceGuide.
OSPF CommandsforconfiguringtheOpenShortestPathFirstroutingprotocolonserial
interfacesare
describedintheVyattaOSPFReferenceGuide.
RIP CommandsforconfiguringtheRoutingInformationProtocolonserialinterfacesare
describedintheVyattaRIPReferenceGuide.
QoS Commandsforconfiguringqualityofserviceonserialinterfacesaredescribedinthe
VyattaQoSReferenceGuide.
Systeminterfaces Commandsforshowingthephysical
interfacesavailableonyoursystemare
describedintheVyattaBasicSystemReferenceGuide.
Chapter1:SerialInterfaces SerialInterfaceCommands
8
WANInterfaces 6.5R1v01 Vyatta
clearinterfacesserial
Clears counters for serial interfaces
Syntax
clear interfaces serial [wanx counters {all | physical | cisco-hdlc | frame-relay | ppp}]
CommandMode
Operational mode.
Parameters
UsageGuidelines
Use this command to clear statistics for a specified serial interface.
When used with no option, this command clears all counters on all serial interfaces.
When a protocol or interface is specified, this command clears the counters for the
specified protocol on the specified interface.
Examples
Example 1-2 shows the result of the clear interfaces serial command used with no
options.
wanx The identifier of a configured serial interface.
all Clears all counters for the specified serial interface.
physical Clears counters related to the physical line settings for the specified
interface.
cisco-hdlc Clears counters related to Cisco HDLC settings for the specified
interface.
frame-relay Clears counters related to Frame Relay settings for the specified
interface.
ppp Clears counters related to Point-to-Point Protocol settings for the
specified interface.
Chapter1:SerialInterfaces SerialInterfaceCommands
9
WANInterfaces 6.5R1v01 Vyatta
Example1‐2“clearinterfacesserial”
vyatta@R1>clearinterfacesserial
Communicationstatisticsflushed
Operationalstatisticsflushed
DSU/CSUPerfomanceMonitoringcounterswereflushed.
Performancemonitoringcountersflushed
PPPstatisticsflushed
Communicationstatisticsflushed
Operationalstatisticsflushed
DSU/CSUPerfomanceMonitoringcounterswereflushed.
Performancemonitoringcountersflushed
PPPstatisticsflushed
vyatta@R1>
Example 1-3 shows the result of the clear interfaces serial command use with the
wan0 counters cisco-hdlc options.
Example1‐3“clearinterfacesserialwan0counterscisco‐hdlc”:Displayingtheresultof
theclearcommand.
vyatta@R1>clearinterfacesserialwan0counterscisco‐hdlc
DSU/CSUPerfomanceMonitoringcounterswereflushed.
Performancemonitoringcountersflushed
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
wan0.1:SLARPSTATISTICS
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
SLARPframetransmission/receptionstatistics
SLARPrequestpacketstransmitted:0
SLARPrequestpacketsreceived:0
SLARPReplypacketstransmitted:0
SLARPReplypacketsreceived:0
SLARPkeepalivepacketstransmitted:0
SLARP
keepalivepacketsreceived:0
IncomingSLARPPacketswithformaterrors
InvalidSLARPCode:0
ReplieswithbadIPaddr:0
Replieswithbadnetmask:0
SLARPtimeout/retrystatistics
SLARPRequesttimeouts:0
keepalivereceptiontimeouts:0
CiscoDiscoveryProtocolframes
Transmitted:0
Received:0
DSU/CSUPerfomanceMonitoringcounterswereflushed.
Chapter1:SerialInterfaces SerialInterfaceCommands
10
WANInterfaces 6.5R1v01 Vyatta
vyatta@R1>
Chapter1:SerialInterfaces SerialInterfaceCommands
11
WANInterfaces 6.5R1v01 Vyatta
interfacesserial<wanx>
Specifies basic serial interface configuration, including Layer 2 encapsulation
characteristics.
Syntax
set interfaces serial wanx
delete interfaces serial wanx
show interfaces serial wanx
CommandMode
Configuration mode.
ConfigurationStatement
interfaces{
serialwanx{
}
}
Parameters
Default
None.
UsageGuidelines
Use this command to configure a serial interface. You can define multiple serial
interfaces by creating multiple serial configuration nodes.
Note that you cannot use set to change the name of the serial interface. To change
the name of a serial interface, you must delete the old serial configuration node and
create a new one.
wanx Mandatory. Multi-node. The identifier for the serial interface you
are defining. This may be wan0 to wan23, depending on what
serial interfaces that are actually available on the system.