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 [...]... 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) . 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‐00 16 iii WANInterfaces 6. 5R1 v01 Vyatta Contents QuickListofCommands........................................................vi ListofExamples. ...............159 x WANInterfaces 6. 5R1 v01 Vyatta Example4‐8“showinterfaceswirelessmodemwlmxstatistics”:Displayingstatisticsforthewirelessmodeminterface 160 xi WANInterfaces 6. 5R1 v01 Vyatta Preface This. ....................158 GlossaryofAcronyms......................................................... 161 vi WANInterfaces 6. 5R1 v01 Vyatta QuickListofCommands Use this list to help you quickly locate commands. clearinterfacesconnection<wlmx>