Vyatta Suite200 1301ShorewayRoad Belmont,CA94002 vyatta.com 6504137200 1888VYATTA1(USandCanada) VYATTA,INC. |  VyattaSystem WANInterfaces REFERENCEGUIDE SerialInterfaces TestingSerialLines DSLInterfaces WirelessModemInterfaces COPYRIGHT Copyright©2005–2012Vyatta,Inc.Allrightsreserved. Vyattareservestherighttomakechangestosoftware,hardware,anddocumentationwithoutnotice.Forthemostrecentversionof documentation,visittheVyattawebsiteatvyatta.com. PROPRIETARYNOTICES VyattaisaregisteredtrademarkofVyatta,Inc. Hyper‐VisaregisteredtrademarkofMicrosoftCorporation. VMware,VMwareESX,andVMwareserveraretrademarksofVMware,Inc. XenServer,andXenCenteraretrademarksofCitrixSystems,Inc. Allothertrademarksarethepropertyoftheirrespectiveowners. RELEASEDATE:October2012 DOCUMENTREVISION.6.5R1 v01 RELEASEDWITH:6.5R1 PARTNO.A0‐0212‐10‐0016 iii WANInterfaces 6.5R1v01 Vyatta Contents QuickListofCommands........................................................vi ListofExamples ...............................................................ix Preface. .....................................................................xi IntendedAudience ........................................... ....................................xii OrganizationofThisGuide ................. .................................... ................. .. .xii DocumentConventions .......................................... ................................xiii VyattaPublicati ons................ ............... ...............................................xiii Chapter1SerialInterfaces ...................................................... 1 SerialInterfaceConfiguration ...................................................................... 2 VirtualInterfacesonSerialInterfaces ....................... ................................. ....2 EnablingInterfaces ........... .................................... ................. .. .........2 ViewingAvailableSerialInterfaces.................................  ..............................3 SerialInterfaceCommands.................. ............... ........................................5 clearinterfacesserial............................................ ..............................8 interfacesserial<wanx>................. .....................................................11 interfacesserial<wanx>description<desc> ........................................... ...........13 interfacesserial<wanx>e1‐options.................. ................. ............... ...........15 interfacesserial<wanx>e1‐optionsclock<type> ................. ................................17 interfacesserial<wanx>e1‐optionsframing<type>........... ............... ................... ..19 interfacesserial<wanx>e1‐optionstimeslots ........ ............... ................... ..........21 interfacesserial<wanx>e3‐options.. .................................................... .......23 interfacesserial<wanx>e3‐optionsclock<type> ................................... ..............24 interfacesserial<wanx>e3‐optionsframing<type>............................. ..................26 interfacesserial<wanx>e3‐optionsline‐coding<type> ........................ ....................28 interfacesserial<wanx>encapsulation<type> ................ ......... ..........................30 interfacesserial<wanx>synch‐options .................... ................................. .....32 interfacesserial<wanx>synch‐optionsbaud‐rate<rate> ..... ................................. .....34 interfacesserial<wanx>synch‐optionsclock<type>...... ................................. ........36 interfacesserial<wanx>synch‐optionsconnection<type> .. .................................... ...38 interfacesserial<wanx>synch‐optionsline‐cod ing<type>.... ................................. .....40 interfacesserial<wanx>synch‐optionsline‐idle<type>.... ................................. .......42 interfacesserial<wanx>t1‐options ...... .................................... ................. .. 44 interfacesserial<wanx>t1‐optionsclock<type> ....................................... ...........46 interfacesserial<wanx>t1‐optionslbo<range> ........... ..................... ............... ...48  iv WANInterfaces 6.5R1v01 Vyatta interfacesserial<wanx>t1‐optionstimeslots.......................... ...........................50 interfacesserial<wanx>t3‐options .............. .. ....................... ......................52 interfacesserial<wanx>t3‐optionsclock<type> ...................... ............................54 interfacesserial<wanx>t3‐optionsframing<type> ............... ................................56 interfacesserial<wanx>t3‐optionsline‐coding<type>........... ..................................58 monitorinterfacesserial<wanx>traffic ........... ................................. .............60 showinterfacesserial . .................................... ................. .. ................62 showinterfacesserial<wanx>......................... ........................................64 showinterfacesserial<wanx>bert‐status .... ...................................................65 showinterfacesserial<wanx>cisco‐hdlc ................ ............................ ............67 showinterfacesserial<wanx>frame‐relay ................................. ......................68 showinterfacesserial<wanx>log....................... .................................... ...69 showinterfacesserial<wanx>loopback ....... ..................................................70 showinterfacesserial<wanx>physical .............................................. ............71 showinterfacesserial<wanx>ppp .. ............................... ............... .............72 showinterfacesserial<wanx>queue ................. ............... ................... ........74 showinterfacesserial<wanx>trace ... ............... ................... .................... ...75 Chapter2TestingSerialLines ................................................... 77 SerialLineTestingOverview.................................... ...................................78 SerialLineLoopbacks ....... ................. ................................. ...................78 LoopbackTests ......................... ................... .. ...................................81 BitErrorRateTests........... .................................................... ...............83 SerialLineTestingCommands.............................. .................................... ...85 test‐definitionbert<test‐name>...... ................................. ........................87 test‐definitionbert<test‐name>duration<duration>..................................... .........89 test‐definitionbert<test‐name>err‐insert‐rate<rate>.............. ................... ............90 test‐definitionbert<test‐name>loopup‐code<code> .. ............................ ............... 92 test‐definitionbert<test‐name>pattern<pattern‐name>........................... ............... 94 test‐definitionbert<test‐name>pattern<pattern‐name>alternating‐word......................... ..96 test‐definitionbert<test‐name>pattern<pattern‐name>repeating .................... .............98 testinterface<wanx>start‐bert<test ‐name> ..................... ..............................100 testinterface<wanx>stop‐bert ........................ ................... . ............... ....102 testloopbackdown ............................. ................................ .. ..........103 testloopbackstart .... ............... ................... ....................................105 testloopbackup............................. ................................. ..............107 Chapter3DSLInterfaces ......................................................109 DSLConfiguration .......................... ....................................................110 ADSLInterfacesOverview ... ................ .................................................110 ADSL ConfigurationExample..................................................................110  v WANInterfaces 6.5R1v01 Vyatta DSLCommands ...................... ................... ................. ......................113 interfacesadsl<adslx> ..... ........... .................................... ................. .115 interfacesadsl<adslx>pvc<pvc‐id> ..................................... ... ............... ....117 interfacesadsl<adslx>watchdog<state> ........... ................ ............................119 monitorinterfacesadsl<if‐name>traffic ................ .......................................121 showinterfacesadsl<if‐name> ...... ............... ................... ................. ......122 showinterfacesadsl<if‐name>queue ............................... ....... ...................123 showinterfacesadsl<if‐name>status.......................... ................................124 Chapter4WirelessModemInterfaces........................................... 125 WirelessModemConfiguration ..................................... ..............................126 WirelessModemInterfaceCommands ............................. ................................128 clearinterfacesconnection<wlmx>..... .......... ................................. ............130 connectinterface<wlmx>... .................................................................131 disconnectinterface<wlmx> ................... .. ........... ............... ..................132 interfaceswirelessmodem<wlmx>.............. ............... ................... ............133 interfaceswirelessmodem<wlmx>backup. ............... ......................................135 interfaceswirelessmodem<wlmx>description<desc> ................ ................... ......... 137 interfaceswirelessmodem<wlmx>device<device>....................................... ...... .139 interfaceswirelessmodem<wlmx>ipv6address............................... ............. .....140 interfaceswirelessmodem<wlmx>ipv6disable‐forwarding. ....................................... 142 interfaceswirelessmodem<wlmx>ipv6dup‐addr‐detect‐transmits<num>............ ...............144 interfaceswirelessmodem<wlmx>ipv6router‐advert........ ................................ .. ..146 interfaceswirelessmodem<wlmx>mtu<mtu>......... ............... ................... .......151 interfaceswirelessmodem<wlmx>network<scriptfile>..... ............... ................... ....153 interfaceswirelessmodem<wlmx>no‐dns ........ ............... ................... ............155 interfaceswirelessmodem<wlmx>ondemand  ..................................................156 showinterfaceswirelessmodem .......................................... ....................158 GlossaryofAcronyms......................................................... 161 vi WANInterfaces 6.5R1v01 Vyatta QuickListofCommands Use this list to help you quickly locate commands. clearinterfacesconnection<wlmx> ......................... ......................................130 clearinterfacesserial ............................... ................................. .............8 connectinterface<wlmx> . .................................... ................. .. ...............131 disconnectinterface<wlmx>............... ............ ..........................................132 interfacesadsl<adslx>pvc<pvc‐id>.. ............... ..............................................117 interfacesadsl<adslx>watchdog<state>.......................... .......... .......................119 interfacesadsl<adslx> ........................ ................................. .................115 interfacesserial<wanx>description<desc> .................... ................... ...... ............13 interfacesserial<wanx>e1‐optionsclock<type>............................. .. ............... .......17 interfacesserial<wanx>e1‐optionsframing<type> ........ .............. .............................19 interfacesserial<wanx>e1‐optionstimeslots............... ............... ................... .......21 interfacesserial<wanx>e1‐options .... ............... ................... ..........................15 interfacesserial<wanx>e3‐optionsclock<type>............................. ..... ...................24 interfacesserial<wanx>e3‐optionsframing<type> ........ ................. ..........................26 interfacesserial<wanx>e3‐optionsline‐coding<type>................ ................................28 interfacesserial<wanx>e3‐options ............. ................................. ..................23 interfacesserial<wanx>encapsulation<type>............................................ ...........30 interfacesserial<wanx>synch‐optionsbaud‐rate<rate>..................... .. ......... ............... 34 interfacesserial<wanx>synch‐optionsclock<type> ..................... ....... ............... .......36 interfacesserial<wanx>synch‐optionsconnection<type> ..................... ........................38 interfacesserial<wanx>synch‐optionsline‐coding<type> .................. ...........................40 interfacesserial<wanx>synch‐optionsline‐idle<type> ................ ................................42 interfacesserial<wanx>synch‐options.............. ................................................32 interfacesserial <wanx>t1‐optionsclock<type>................................. .....................46 interfacesserial<wanx>t1‐optionslbo<range>............................ ........ ..................48 interfacesserial<wanx>t1‐optionstimeslots .......................... ..............................50 interfacesserial<wanx>t1‐options................ ................................. ................44 interfaces serial<wanx>t3‐optionsclock<type>...................................................... 54 interfacesserial<wanx>t3‐optionsframing<type> .................................. ............... ..56 interfacesserial<wanx>t3‐optionsline‐coding<type> ......... .. .............. ............... ........58 interfacesserial<wanx>t3‐options....................... ............... ................... ........52 interfacesserial<wanx> ...... ............... ................... ..................................11  vii WANInterfaces 6.5R1v01 Vyatta interfaceswirelessmodem<wlmx>backup .......................... ................... ............135 interfaceswirelessmodem<wlmx>description<desc>.................................... ............137 interfaceswirelessmodem<wlmx>device<device> .................................. ................139 interfaceswirelessmodem<wlmx>ipv6address .............................. .......................140 interfaceswirelessmodem<wlmx>ipv6disable‐forwarding .......... ........... ......................142 interfaceswirelessmodem<wlmx>ipv6dup‐addr‐detect‐transmits<num> ................... ...........144 interfaceswirelessmodem<wlmx>ipv6router‐advert .................................. ..............146 interfaceswirelessmodem<wlmx>mtu<mtu> ..... ................... ........ ......................151 interfaceswirelessmodem<wlmx>network<scriptfile> ....................... .......................153 interfaceswirelessmodem<wlmx>no‐dns................... .... ................................. ..155 interfaceswirelessmodem<wlmx>ondemand .... ....... ................................. ..........156 interfaceswirelessmodem<wlmx> ..... ................................. ..........................133 monitorinterfacesadsl<if‐name>traffic.................................. . ............... .........121 monitorinterfacesserial<wanx>traffic..... ................ ........................................60 showinterfacesadsl<if‐name>queue.... ............... ................... ................. ......123 showinterfacesadsl<if‐name>status ................. .. ................... .......................124 showinterfacesadsl<if‐name>...................... ................................. ............122 showinterfacesserial<wanx>bert ‐status.................................................... .......65 showinterfacesserial<wanx>cisco‐hdlc............... ................... ............... ...........67 showinterfacesserial<wanx>frame‐relay................... ........................................68 showinterfacesserial<wanx>log ...... ............... ................... ..........................69 showinterfacesserial<wanx>loopback..................................... ........................70 showinterfacesserial<wanx>physical...................... ................................. .......71 showinterfacesserial<wanx>ppp..... ................................. ...........................72 showinterfacesserial<wanx>queue.. ................... .............. ............... .............74 showinterfacesserial<wanx>trace................. ............... ................... .............75 showinterfacesserial <wanx> ............................................. ........................64 showinterfacesserial.................... ......... ...............................................62 showinterfaceswirelessmodem ................................. .................................158 testinterface<wanx>start‐bert<test‐name>........................... ............................100 testinterface<wanx>stop‐bert.................. ............... ................... ...............102 test loopbackdown......... ................... .................................................103 testloopbackstart..................... .........................................................105 testloopbackup ... ................... .................. .......................................107 test‐definitionbert<test‐name>duration<duration> .... ................................ .. ...........89 test‐definitionbert<test‐name> err‐insert‐rate<rate> .............. ..................................90  viii WANInterfaces 6.5R1v01 Vyatta test‐definitionbert<test‐name>loopup‐code<code>...................................... ...........92 test‐definitionbert<test‐name>pattern<pattern‐name>alternating‐word ...............................96 test‐definitionbert <test‐name>pattern<pattern‐name>repeating.....................................98 test‐definitionbert<test‐name>pattern<pattern‐ name> .............. ................... .............94 test‐definitionbert<test‐ name>.............................. ................... ..................87 ix WANInterfaces 6.5R1v01 Vyatta ListofExamples Use this list to help you locate examples you’d like to look at or try. Example1‐1Viewingavailablesysteminterfaces ............................................. ..........3 Example1‐2“clearinterfacesserial”.................................. ...............................9 Example1‐3“clearinterfacesserialwan0counterscisco‐hdlc”:Displayingtheresultoftheclearcommand.... ..9 Example1‐4Displayingtrafficdata............................ ............... .......................60 Example1‐5“showinterfacesserial”:Displayingserialinterfaceinformation.................. ............62 Example1‐6“showinterfacesserialwan1”:Displayingserialinterfaceinformation........ .................64 Example1‐7 “showinterfacesserialwanxbert‐status”.................................................65 Example1‐8“showinterfacesserialwanxppp”....................................... ................72 Example1‐9“showinterfacesserialwanxtrace”........................... ...........................75 Example2‐1TestingthelocalWANinterface................. ................................. .......82 Example2‐2TestingtheremoteWANinterface .. ................................. ...................82 Example2‐3Testingthecircuit ................. ......................... ............... ...........82 Example2‐4Testingaphysicalloopbackonthelocalsystem .............. ............... ...............83 Example2‐5StartingaBERT............ .. ........................................................101 Example2‐6StoppingaBERT........................................ .............................102 Example2‐7Deactivatingalocalloopbackonwan0............. ................................. .....104 Example2‐8Successfultestofa loopback ..... ................................. .....................105 Example2‐9Unsuccessfulloopbacktest......................................... ...................106 Example2‐10Activatingalocalloopback...................... ... ............... ...................108 Example3‐1CreatingandconfiguringanADSLinterfaceforPPPoEencapsulation..... ....................112 Example4‐1SierraWirelessUSBConnect881modemaccessingtheAT&Tnetwork................. ......126 Example4‐2UTStarcom3GmodemaccessingtheVerizonnetwork ................................. ...126 Example4‐3Disconnectingfromthenetwork................................... ..... ...............127 Example4‐4Connectingtothenetwork ............................. ...............................127 Example4‐5“showinterfaces”:Displayinginterfacestatus........... ............... ..................158 Example4‐6“showinterfaceswirelessmodemwlm0”:Displayingwirelessmodeminterfaceinformation......159 Example4 ‐7“showinterfaceswirelessmodemwlm0debug”:Displayingdebuginformationforthewirelessmodem interface..................................... ............... ................... ...............159  x WANInterfaces 6.5R1v01 Vyatta Example4‐8“showinterfaceswirelessmodemwlmxstatistics”:Displayingstatisticsforthewirelessmodeminterface 160 [...]... 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 WAN Interfaces 6. 5R1 v01 Vyatta 1 Chapter 1: Serial Interfaces...                              Transmitted:   0                                 Received:   0 DSU/CSU Perfomance Monitoring counters were flushed WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Commands 10 vyatta@ R1> WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Commands 11 interfaces serial   Specifies basic serial interface configuration, including... of numbers An example is 1 65 535, which means 1 through 65 535, 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) Vyatta Publications WAN Interfaces 6. 5R1 v01 Vyatta    Vyatta Publications xiv Full... form of this command to set the description for the serial interface WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Commands 14 Use the delete form of this command to remove description configuration Use the show form of this command to view description configuration WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Commands 15 interfaces serial  e1‐options ... WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Commands 18 Usage Guidelines Use this command to specify the clock source for an E1 circuit Use the set form of this command to set the E1 clock source Use the delete form of this command to restore the default E1 clock source Use the show form of this command to view E1 clock source configuration WAN Interfaces 6. 5R1 v01 Vyatta. .. WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Configuration 4     TX:  bytes    packets     errors    dropped    carrier collisions            424          4          0          0          0          0 lo:  mtu  164 36 qdisc noqueue state UNKNOWN     link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00     inet 127.0.0.1/8 scope host lo     inet6 ::1/128 scope host... described in the Vyatta RIP Reference Guide QoS  Commands for configuring quality of service on serial interfaces are described in the  Vyatta QoS Reference Guide System interfaces Commands for showing the physical interfaces available on your system are  described in the Vyatta Basic System Reference Guide WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Commands 8 clear interfaces serial Clears counters... system. Currently the Vyatta system supports  Asymmetrical DSL (ADSL) interfaces only 109 Chapter 4: Wireless Modem  Interfaces This chapter explains how to work with  wireless modems on the Vyatta system 125 Glossary of Acronyms WAN Interfaces 161 6. 5R1 v01 Vyatta    Document Conventions xiii Document Conventions This guide uses the following advisory paragraphs, as follows WARNING   Warnings alert you to situations that may pose a threat to personal safety. ... Chapter 1: Serial Interfaces This chapter explains how to configure and monitor serial interfaces on the Vyatta system This feature is available only in the Vyatta Subscription Edition This chapter presents the following topics: • • WAN Interfaces Serial Interface Configuration Serial Interface Commands 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Configuration 2 Serial Interface Configuration... transmission (E1) format The E1 signal format carries information at a rate of 2.048 Mbps and can carry 32 channels of 64 Kbps each Currently, only high-density bipolar of order 3 (hdb3) line encoding is supported WAN Interfaces 6. 5R1 v01 Vyatta Chapter 1: Serial Interfaces  Serial Interface Commands 16 NOTE  On Sangoma cards with the PMC‐Sierra chipset all ports must be configured with the same  line type (e.g. all T1 or all E1) . VyattaSystem WANInterfaces REFERENCEGUIDE SerialInterfaces TestingSerialLines DSLInterfaces WirelessModemInterfaces COPYRIGHT Copyright©2005–2012Vyatta,Inc.Allrightsreserved. Vyattareservestherighttomakechangestosoftware,hardware,anddocumentationwithoutnotice.Forthemostrecentversionof documentation,visittheVyattawebsiteatvyatta.com. PROPRIETARYNOTICES VyattaisaregisteredtrademarkofVyatta,Inc. Hyper‐VisaregisteredtrademarkofMicrosoftCorporation. VMware,VMwareESX,andVMwareserveraretrademarksofVMware,Inc. XenServer,andXenCenteraretrademarksofCitrixSystems,Inc. Allothertrademarksarethepropertyoftheirrespectiveowners. RELEASEDATE:October2012 DOCUMENTREVISION. 6. 5R1 v01 RELEASEDWITH: 6. 5R1 PARTNO.A0‐0212‐10‐00 16 iii WANInterfaces 6. 5R1 v01 Vyatta Contents QuickListofCommands........................................................vi ListofExamples. ...............159  x WANInterfaces 6. 5R1 v01 Vyatta Example4‐8“showinterfaceswirelessmodemwlmxstatistics”:Displayingstatisticsforthewirelessmodeminterface 160 xi WANInterfaces 6. 5R1 v01 Vyatta Preface This. ....................158 GlossaryofAcronyms.........................................................  161 vi WANInterfaces 6. 5R1 v01 Vyatta QuickListofCommands Use this list to help you quickly locate commands. clearinterfacesconnection<wlmx>