Vyatta lan interfaces-6.5_r1_v01

1,401 views

Published on

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,401
On SlideShare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
28
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Vyatta lan interfaces-6.5_r1_v01

  1. 1. VyattaSuite 2001301 Shoreway RoadBelmont, CA 94002vyatta.com650 413 72001 888 VYATTA 1 (US and Canada)VYATTA, INC.    |     Vyatta SystemLAN InterfacesREFERENCE  GUIDELoopback InterfaceEthernet InterfacesEthernet Link Bonding InterfacesPseudo‐Ethernet InterfacesWireless InterfacesVLAN InterfacesInput Interfaces
  2. 2. COPYRIGHTCopyright © 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 NOTICESVyatta 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 2012DOCUMENT REVISION. 6.5R1 v01RELEASED WITH: 6.5R1 PART NO. A0‐0211‐10‐0017
  3. 3. iii LAN Interfaces 6.5R1 v01 VyattaContentsQuick List of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  xList of Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   xviPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   xviiiIntended Audience  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  xixOrganization of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  xixDocument Conventions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxVyatta Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  xxiChapter 1 Loopback Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Loopback Interface Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2Loopback Interface Configuration Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3Configuring Network Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3IPv6 on the Loopback Interface  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4Loopback Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5clear interfaces loopback counters  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6interfaces loopback lo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7interfaces loopback lo address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8interfaces loopback lo description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   10show interfaces loopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11Chapter 2 Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Ethernet Interfaces Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   14Ethernet Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   14Viewing System Interfaces  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   14Basic Ethernet Interface Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16Ethernet Multinetting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   17IPv6 on Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   18Ethernet Interface Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   19clear interfaces ethernet counters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   22interfaces ethernet <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   23interfaces ethernet <ethx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   25interfaces ethernet <ethx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   27interfaces ethernet <ethx> dhcpv6‐options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   28interfaces ethernet <ethx> disable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   30interfaces ethernet <ethx> disable‐flow‐control  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   31
  4. 4.    iv LAN Interfaces 6.5R1 v01 Vyattainterfaces ethernet <ethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   33interfaces ethernet <ethx> duplex <duplexity>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   34interfaces ethernet <ethx> hw‐id <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   36interfaces ethernet <ethx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   38interfaces ethernet <ethx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   40interfaces ethernet <ethx> ipv6 disable‐forwarding  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   42interfaces ethernet <ethx> ipv6 dup‐addr‐detect‐transmits <num>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   44interfaces ethernet <ethx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   46interfaces ethernet <ethx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   51interfaces ethernet <ethx> mirror <interface> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   53interfaces ethernet <ethx> mtu <mtu> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   55interfaces ethernet <ethx> redirect <interface>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   57interfaces ethernet <ethx> smp_affinity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   59interfaces ethernet <ethx> speed <speed>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   61monitor interfaces ethernet <ethx> traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   63show interfaces ethernet  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   65show interfaces ethernet detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   67show interfaces ethernet <ethx> brief. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   69show interfaces ethernet <ethx> identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   70show interfaces ethernet <ethx> physical. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   71show interfaces ethernet <ethx> queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   72show interfaces ethernet <ethx> statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   73Chapter 3 Ethernet Link Bonding Interfaces  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Ethernet Link Bonding Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   76Ethernet Bonding Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   77Basic Ethernet Bonding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   77Ethernet Bonding with VLAN  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   79IPv6 on Ethernet Link Bonding Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   79Ethernet Link Bonding Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   80interfaces bonding <bondx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   82interfaces bonding <bondx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   84interfaces bonding <bondx> arp‐monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   86interfaces bonding <bondx> description <desc>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   88interfaces bonding <bondx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   89interfaces bonding <bondx> disable  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   91interfaces bonding <bondx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   92interfaces bonding <bondx> hash‐policy <policy> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   93interfaces bonding <bondx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   95interfaces bonding <bondx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   97interfaces bonding <bondx> ipv6 disable‐forwarding  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   99
  5. 5.    v LAN Interfaces 6.5R1 v01 Vyattainterfaces bonding <bondx> ipv6 dup‐addr‐detect‐transmits <num>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   101interfaces bonding <bondx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   103interfaces bonding <bondx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   108interfaces bonding <bondx> mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   110interfaces bonding <bondx> mtu <mtu> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   113interfaces bonding <bondx> primary <ethx>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   115interfaces ethernet <ethx> bond‐group <bondx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   117show interfaces bonding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   119Chapter 4 Pseudo‐Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Pseudo‐Ethernet Interface Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   122Pseudo‐Ethernet Interface Configuration Examples  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   123Creating a Pseudo‐Ethernet Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   123IPv6 on Pseudo‐Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   124Pseudo‐Ethernet Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   125interfaces pseudo‐ethernet <pethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   127interfaces pseudo‐ethernet <pethx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   129interfaces pseudo‐ethernet <pethx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   131interfaces pseudo‐ethernet <pethx> dhcpv6‐options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   132interfaces pseudo‐ethernet <pethx> disable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   134interfaces pseudo‐ethernet <pethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   135interfaces pseudo‐ethernet <pethx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   136interfaces pseudo‐ethernet <pethx> ipv6 disable‐forwarding  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   138interfaces pseudo‐ethernet <pethx> ipv6 dup‐addr‐detect‐transmits <num>  . . . . . . . . . . . . . . . . . . . . . . . . .   140interfaces pseudo‐ethernet <pethx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   142interfaces pseudo‐ethernet <pethx> link <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   147interfaces pseudo‐ethernet <pethx> mac <mac‐addr>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   149Chapter 5 Wireless Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Wireless Interface Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   152Wireless Interface Configuration Examples  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   152Configuring a Wireless Access Point. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   152Configuring a Wireless Station . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   153IPv6 on Wireless Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   154Wireless Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   155interfaces wireless <wlanx>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   157interfaces wireless <wlanx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   159interfaces wireless <wlanx> channel <channel> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   161interfaces wireless <wlanx> country <country> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   163interfaces wireless <wlanx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   165interfaces wireless <wlanx> dhcpv6‐options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   166
  6. 6.    vi LAN Interfaces 6.5R1 v01 Vyattainterfaces wireless <wlanx> disable‐broadcast‐ssid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   168interfaces wireless <wlanx> disable‐link‐detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   170interfaces wireless <wlanx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   172interfaces wireless <wlanx> ipv6 disable‐forwarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   174interfaces wireless <wlanx> ipv6 dup‐addr‐detect‐transmits <num>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   176interfaces wireless <wlanx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   178interfaces wireless <wlanx> mac <mac‐addr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   183interfaces wireless <wlanx> mode <mode>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   185interfaces wireless <wlanx> physical‐device <device> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   187interfaces wireless <wlanx> security wep key <key> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   189interfaces wireless <wlanx> security wpa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   191interfaces wireless <wlanx> ssid <ssid> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   194interfaces wireless <wlanx> type <type>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   196monitor interfaces wireless <wlanx> traffic  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   198show interfaces wireless . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   200show interfaces wireless <wlanx>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   202show interfaces wireless <wlanx> brief . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   203show interfaces wireless <wlanx> queue  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   204show interfaces wireless <wlanx> scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   205show interfaces wireless <wlanx> stations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   207Chapter 6 VLAN Interfaces  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208VLAN Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   209VLAN Operation Using vifs  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   209Interface Types Supporting VLAN Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   209VLAN Operation vs. Multinetting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   209Simultaneous Ethernet and 802.1Q Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   210Referring to VLAN Interfaces in Commands  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   210IPv6 Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   210VLAN Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   210VLAN Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   211IPv6 on VLAN Interfaces  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   212VLAN Interface Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   213interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   215interfaces <interface> vif <vlan‐id> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   217interfaces <interface> vif <vlan‐id> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   219interfaces <interface> vif <vlan‐id> dhcpv6‐options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   221interfaces <interface> vif <vlan‐id> disable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   223interfaces <interface> vif <vlan‐id> disable‐link‐detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   225interfaces <interface> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   227interfaces <interface> ipv6 disable‐forwarding  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   229
  7. 7.    vii LAN Interfaces 6.5R1 v01 Vyattainterfaces <interface> ipv6 dup‐addr‐detect‐transmits <num>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   231interfaces <interface> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   233show interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   238Chapter 7 Input Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240Input Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   241Input Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   241Creating an Input Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   241IPv6 on Input Interfaces  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   242Input Interface Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   243interfaces input <ifbx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   244interfaces input <ifbx> description <descr>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   246show interfaces input <ifbx> vif <vlan‐id>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   247Glossary of Acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
  8. 8.    viii LAN Interfaces 6.5R1 v01 Vyatta
  9. 9.    ix LAN Interfaces 6.5R1 v01 Vyatta
  10. 10. xLAN Interfaces 6.5R1 v01 VyattaQuick List of CommandsUse this list to help you quickly locate commands.clear interfaces ethernet counters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   22clear interfaces loopback counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6interfaces <interface> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   227interfaces <interface> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   229interfaces <interface> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   231interfaces <interface> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   233interfaces <interface> vif <vlan‐id> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   217interfaces <interface> vif <vlan‐id> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   219interfaces <interface> vif <vlan‐id> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   221interfaces <interface> vif <vlan‐id> disable  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   223interfaces <interface> vif <vlan‐id> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   225interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   215interfaces bonding <bondx> address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   84interfaces bonding <bondx> arp‐monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   86interfaces bonding <bondx> description <desc>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   88interfaces bonding <bondx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   89interfaces bonding <bondx> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   91interfaces bonding <bondx> disable‐link‐detect  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   92interfaces bonding <bondx> hash‐policy <policy> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   93interfaces bonding <bondx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   95interfaces bonding <bondx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   97interfaces bonding <bondx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   99interfaces bonding <bondx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   101interfaces bonding <bondx> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   103interfaces bonding <bondx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   108interfaces bonding <bondx> mode  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   110interfaces bonding <bondx> mtu <mtu>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   113interfaces bonding <bondx> primary <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   115interfaces bonding <bondx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   82interfaces ethernet <ethx> address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   25interfaces ethernet <ethx> bond‐group <bondx>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   117interfaces ethernet <ethx> description <descr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   27
  11. 11.    xiLAN Interfaces 6.5R1 v01 Vyattainterfaces ethernet <ethx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   28interfaces ethernet <ethx> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   30interfaces ethernet <ethx> disable‐flow‐control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   31interfaces ethernet <ethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   33interfaces ethernet <ethx> duplex <duplexity> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   34interfaces ethernet <ethx> hw‐id <mac‐addr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   36interfaces ethernet <ethx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   38interfaces ethernet <ethx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   40interfaces ethernet <ethx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   42interfaces ethernet <ethx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   44interfaces ethernet <ethx> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   46interfaces ethernet <ethx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   51interfaces ethernet <ethx> mirror <interface>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   53interfaces ethernet <ethx> mtu <mtu>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   55interfaces ethernet <ethx> redirect <interface>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   57interfaces ethernet <ethx> smp_affinity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   59interfaces ethernet <ethx> speed <speed>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   61interfaces ethernet <ethx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   23interfaces input <ifbx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   246interfaces input <ifbx>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   244interfaces loopback lo address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8interfaces loopback lo description <descr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   10interfaces loopback lo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7interfaces pseudo‐ethernet <pethx> address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   129interfaces pseudo‐ethernet <pethx> description <descr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   131interfaces pseudo‐ethernet <pethx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   132interfaces pseudo‐ethernet <pethx> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   134interfaces pseudo‐ethernet <pethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   135interfaces pseudo‐ethernet <pethx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   136interfaces pseudo‐ethernet <pethx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   138interfaces pseudo‐ethernet <pethx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   140interfaces pseudo‐ethernet <pethx> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   142interfaces pseudo‐ethernet <pethx> link <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   147interfaces pseudo‐ethernet <pethx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   149interfaces pseudo‐ethernet <pethx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   127interfaces wireless <wlanx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   159
  12. 12.    xiiLAN Interfaces 6.5R1 v01 Vyattainterfaces wireless <wlanx> channel <channel>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   161interfaces wireless <wlanx> country <country> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   163interfaces wireless <wlanx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   165interfaces wireless <wlanx> dhcpv6‐options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   166interfaces wireless <wlanx> disable‐broadcast‐ssid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   168interfaces wireless <wlanx> disable‐link‐detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   170interfaces wireless <wlanx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   172interfaces wireless <wlanx> ipv6 disable‐forwarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   174interfaces wireless <wlanx> ipv6 dup‐addr‐detect‐transmits <num>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   176interfaces wireless <wlanx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   178interfaces wireless <wlanx> mac <mac‐addr>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   183interfaces wireless <wlanx> mode <mode> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   185interfaces wireless <wlanx> physical‐device <device>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   187interfaces wireless <wlanx> security wep key <key> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   189interfaces wireless <wlanx> security wpa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   191interfaces wireless <wlanx> ssid <ssid>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   194interfaces wireless <wlanx> type <type>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   196interfaces wireless <wlanx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   157monitor interfaces ethernet <ethx> traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   63monitor interfaces wireless <wlanx> traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   198show interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   238show interfaces bonding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   119show interfaces ethernet <ethx> brief  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   69show interfaces ethernet <ethx> identify. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   70show interfaces ethernet <ethx> physical  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   71show interfaces ethernet <ethx> queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   72show interfaces ethernet <ethx> statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   73show interfaces ethernet detail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   67show interfaces ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   65show interfaces input <ifbx> vif <vlan‐id>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   247show interfaces loopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11show interfaces wireless <wlanx> brief. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   203show interfaces wireless <wlanx> queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   204show interfaces wireless <wlanx> scan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   205show interfaces wireless <wlanx> stations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   207show interfaces wireless <wlanx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   202
  13. 13.    xiiiLAN Interfaces 6.5R1 v01 Vyattashow interfaces wireless. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   200
  14. 14.    xivLAN Interfaces 6.5R1 v01 Vyatta
  15. 15.    xvLAN Interfaces 6.5R1 v01 Vyatta
  16. 16. xviLAN Interfaces 6.5R1 v01 VyattaList of ExamplesUse this list to help you locate examples you’d like to look at or try.Example 1‐1 Configuring the loopback interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Example 1‐2 Displaying loopback interface information.  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Example 1‐3 Displaying additional loopback interface detail.   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Example 2‐1 Viewing available system interfaces  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Example 2‐2 Configuring Ethernet interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16Example 2‐3 Configuring Ethernet multinetting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   17Example 2‐4 Displaying traffic data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Example 2‐5 Displaying information for all Ethernet interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Example 2‐6 Displaying information for one Ethernet interface  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Example 2‐7 Displaying detailed Ethernet interface information   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Example 2‐8 Displaying brief Ethernet interface status   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Example 2‐9 Identifying an Ethernet interface by blinking its LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Example 2‐10 Displaying physical line characteristics for an Ethernet interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Example 2‐11 Displaying Ethernet queue information  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Example 2‐12 Displaying Ethernet statistics information  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Example 3‐1 Creating a bond group with two Ethernet interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   78Example 3‐2 Adding a VLAN to an existing bonding interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   79Example 3‐3 Displaying information about the bonding interfaces.  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Example 3‐4 Displaying information about the bonding slaves.   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120Example 4‐1 Creating a pseudo‐Ethernet interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   124Example 5‐1 Configuring an Access Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   153Example 5‐2 Configuring a Station. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   154Example 5‐3 Displaying captured data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Example 5‐4 Displaying wireless interface information   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Example 5‐5 Displaying detailed wireless interfaces information  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Example 5‐6 Displaying wireless‐specific information for all wireless interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Example 5‐7 Displaying status and statistics for a specific wireless interface   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
  17. 17.    xviiLAN Interfaces 6.5R1 v01 VyattaExample 5‐8 Displaying summary status for a wireless interface   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Example 5‐9 Displaying wireless interface queue information   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204Example 5‐10 Displaying scan information for a specific wireless interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Example 5‐11 Displaying detailed scan information for a specific wireless interface   . . . . . . . . . . . . . . . . . . . . . . . 206Example 5‐12 Displaying station data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Example 6‐2 Displaying virtual interface information  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Example 6‐3 Displaying brief status for a virtual interface.   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Example 6‐4 Displaying VLAN interface queue information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Example 7‐1 Configuring an Input interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   241Example 7‐2 Displaying Input interface information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247Example 7‐3 Displaying queue information for an Input interface   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
  18. 18. xviiiLAN Interfaces 6.5R1 v01 VyattaPrefaceThis document describes the various deployment, installation, and upgrade optionsfor Vyatta software.This preface provides information about using this guide. The following topics arepresented:• Intended Audience• Organization of This Guide• Document Conventions• Vyatta Publications
  19. 19.    Intended Audience xixLAN Interfaces 6.5R1 v01 VyattaIntended AudienceThis guide is intended for experienced system and network administrators.Depending on the functionality to be used, readers should have specific knowledgein the following areas:• Networking and data communications• TCP/IP protocols• General router configuration• Routing protocols• Network administration• Network security• IP servicesOrganization of This GuideThis guide has the following aid to help you find the information you are looking for:• Quick List of CommandsUse this list to help you quickly locate commands.• List of ExamplesUse this list to help you locate examples you’d like to try or look at.This guide has the following chapters:Chapter Description PageChapter 1: Loopback Interface This chapter explains how to work with the Vyatta system’s software loopback interface.1Chapter 2: Ethernet Interfaces This chapter describes basic configuration for Ethernet interfaces.13Chapter 3: Ethernet Link Bonding InterfacesThis chapter explains how to bond Ethernet links into a larger virtual link.75Chapter 4: Pseudo‐Ethernet InterfacesThis chapter describes how to create a pseudo‐Ethernet interface by defining multiple MAC addresses on a single physical interface.121Chapter 5: Wireless Interfaces This chapter explains how to work with wireless interfaces on the Vyatta system.151
  20. 20.    Document Conventions xxLAN Interfaces 6.5R1 v01 VyattaDocument ConventionsThis guide uses the following advisory paragraphs, as follows.NOTE  Notes provide information you might need to avoid problems or configuration errors.This document uses the following typographic conventions.Chapter 6: VLAN Interfaces This chapter lists the commands for configuring VLAN interfaces on Ethernet interfaces and Ethernet bonded links.208Chapter 7: Input Interface This chapter explains how to work with Input interfaces on the Vyatta system.240Glossary of Acronyms 249WARNING   Warnings alert you to situations that may pose a threat to personal safety. CAUTION  Cautions alert you to situations that might cause harm to your system or damage to equipment, or that may affect service.Monospace Examples, command-line output, and representations ofconfiguration nodes.bold Monospace Your input: something you type at a command line.bold Commands, keywords, and file names, when mentionedinline.Objects in the user interface, such as tabs, buttons, screens,and panes.italics An argument or variable where you supply a value.<key> A key on your keyboard, such as <Enter>. Combinations ofkeys 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, whichmeans 1 through 65535, inclusive.
  21. 21.    Vyatta Publications xxiLAN Interfaces 6.5R1 v01 VyattaVyatta PublicationsFull product documentation is provided in the Vyatta technical library. To see whatdocumentation is available for your release, see the Guide to Vyatta Documentation.This guide is posted with every release of Vyatta software and provides a greatstarting point for finding the information you need.Additional information is available on www.vyatta.com and www.vyatta.org.arg1..argN A range of enumerated values. An example is eth0..eth3,which means eth0, eth1, eth2, or eth3.arg[ arg...]arg[,arg...]A value that can optionally represent a list of elements (aspace-separated list and a comma-separated list, respectively).
  22. 22. 1LAN Interfaces 6.5R1 v01 VyattaChapter 1: Loopback InterfaceThis chapter explains how to work with the Vyatta system’s software loopbackinterface.This chapter presents the following topics:• Loopback Interface Overview• Loopback Interface Configuration Examples• Loopback Interface Commands
  23. 23. Chapter 1: Loopback Interface  Loopback Interface Overview 2LAN Interfaces 6.5R1 v01 VyattaLoopback Interface OverviewThe loopback interface is a special software-only interface that emulates a physicalinterface and allows the router to “connect” to itself. Packets routed to the loopbackinterface are rerouted back to the router and processed locally. Packets routed outthe loopback interface but not destined for the loopback interface are dropped.The loopback interface provides a number of advantages:• As long as the router is functioning, the loopback interface is always up, and sois very reliable. As long as there is even one functioning link to the router, theloopback interface can be accessed. The loopback interface thus eliminates theneed to try each IP address of the router until you find one that is still up.• Because the loopback interface is always up, a routing session (such as a BGPsession) can continue even if the outbound interface fails.• You can simplify collection of management information by specifying theloopback interface as the interface for sending and receiving managementinformation such as logs and SNMP traps.• The loopback interface can be used to increase security, by filtering incomingtraffic using access control rules that specify the local interface as the onlyacceptable destination.• In OSPF, you can advertise a loopback interface as an interface route into thenetwork, regardless of whether physical links are up or down. This increasesreliability by allowing traffic to take alternate paths if one or more physical linksgo down.• In BGP, parallel paths can be configured to the loopback interface on a peerdevice. This provides improved load sharing and redundancy.The router automatically creates the loopback interface on startup, with an interfacename of lo. It also automatically configures the loopback address with standard IPaddressing:• As per RFC 5735, the IPv4 address 127.0.0.1/8 is assigned to the loopbackaddress. Typically, the IPv4 address assigned to the loopback device is 127.0.0.1for IPv4, although any address in the range 127.0.0.0 to 127.255.255.255 ismapped to it.• As per RFC 3513, the IPv6, IP address ::1/128 is assigned to the loopbackinterface.• As per RFC 2606, the domain name localhost is mapped to the loopbackaddresses.When configuring the router, it is good practice to take advantage of the loopbackinterface’s reliability:
  24. 24. Chapter 1: Loopback Interface  Loopback Interface Configuration Examples 3LAN Interfaces 6.5R1 v01 Vyatta• The router’s hostname should be mapped to the loopback interface address,rather than to a physical interface.• In OSPF and BGP, the router ID should be set to the loopback address. This willprevent a possible dynamic recalculation and reassignment of the loopbackaddress when physical interfaces are added or removed from the system. Thisaction will be disruptive to active BGP and OSPF sessions.The Vyatta system has extensive support for IPv6, including IPv6 interfaceaddressing. The commands for configuring IPv6 on the loobback interface are givenin this chapter. A full description of Vyatta IPv6 support is provided in the VyattaIPv6 Support Reference Guide.Loopback Interface Configuration ExamplesThis section presents the following topics:• Configuring Network Addresses• IPv6 on the Loopback InterfaceConfiguring Network AddressesThe system automatically creates and addresses the loopback interface, so you neednot configure any additional addressing. If you delete the loopback node, the systemrecreates and re-addresses the loopback address again the next time the system starts.There may be times when you want to configure a smaller network prefix than /8 tothe loopback interface. The example in this section assigns the address192.168.75.1/32 to the loopback interface. When you have finished, the interfacewill be configured as in Figure 1-1.Figure 1‐1   Configuring the loopback interfaceR2lo192.168.75.1/32192.168.75.1/32
  25. 25. Chapter 1: Loopback Interface  Loopback Interface Configuration Examples 4LAN Interfaces 6.5R1 v01 VyattaTo configure the loopback interface, perform the following steps in configurationmode.IPv6 on the Loopback InterfaceExamples for configuring IPv6 on interfaces are provided in the Vyatta IPv6 SupportReference Guide.Example 1‐1   Configuring the loopback interfaceStep CommandAssign the IP address to the loopback interface.vyatta@R1# set interfaces loopback lo address 192.168.75.1/32 Commit the configuration. vyatta@R1# commitView the configuration. vyatta@R1# show interfaces loopbackloopback lo {address 192.168.75.1/32}
  26. 26. Chapter 1: Loopback Interface  Loopback Interface Commands 5LAN Interfaces 6.5R1 v01 VyattaLoopback Interface CommandsCommands for using other system features with loopback interfaces can be found inthe following locations.Configuration Commandsinterfaces loopback lo Defines the loopback interface.interfaces loopback lo address Sets an IP address and network prefix for the loopback interface.interfaces loopback lo description <descr> Allows you to record a description for the loopback interface.Operational Commands clear interfaces loopback counters Clears statistics counters for loopback interfaces. show interfaces loopback Displays information about the loopback interface.Related Commands Documented ElsewhereOSPF  OSPF is supported on the loopback interface. Commands for configuring OSPF are described in the Vyatta OSPF Reference Guide.QoS  QoS traffic policies are supported on the loopback interface. Commands for configuring quality of service on the loopback interface are described in the Vyatta QoS Reference Guide.RIP  RIP is supported on the loopback interface. Commands for configuring RIP are described in the Vyatta RIP Reference Guide.RIPng  RIPng is supported on the loopback interface. Commands for configuring RIPng are described in the Vyatta RIPng Reference Guide.
  27. 27. Chapter 1: Loopback Interface  Loopback Interface Commands 6LAN Interfaces 6.5R1 v01 Vyattaclear interfaces loopback countersClears statistics counters for loopback interfaces.Syntaxclear interfaces loopback [lo] countersCommand ModeOperational mode.ParametersDefaultClears all counters for the loopback interface.Usage GuidelinesUse this command to clear counters on the loopback interface.lo Optional. Clears statistics for the loopback interface only.Equivalent to using the command with no option.
  28. 28. Chapter 1: Loopback Interface  Loopback Interface Commands 7LAN Interfaces 6.5R1 v01 Vyattainterfaces loopback loDefines the loopback interface.Syntaxset interfaces loopback lodelete interfaces loopback loshow interfaces loopbackCommand ModeConfiguration mode.Configuration Statementinterfaces {loopback lo }ParametersNone.DefaultA configuration node is automatically created for the loopback interface on startup.Usage GuidelinesUse this command to configure the loopback interface.You can use the set form of this command to create the loopback interface. However,the system automatically creates a configuration node for the loopback interface onstartup, so you should not need to use the set form of this command to create theloopback interface unless you have deleted it.Use the delete form of this command to remove all configuration for the loopbackinterface. The system will create an empty configuration node for the interface thenext time the system starts.Use the show form of this command to view loopback interface configuration.
  29. 29. Chapter 1: Loopback Interface  Loopback Interface Commands 8LAN Interfaces 6.5R1 v01 Vyattainterfaces loopback lo addressSets an IP address and network prefix for the loopback interface.Syntaxset interfaces loopback lo address {ipv4 | ipv6}delete interfaces loopback lo address {ipv4 | ipv6}show interfaces loopback lo addressCommand ModeConfiguration mode.Configuration Statementinterfaces {loopback lo {address [ipv4|ipv6]}}ParametersDefaultNone.ipv4 An IPv4 address and network prefix for this interface. The formatis ip-address/prefix (for example, 127.0.0.1/8).You can define multiple IP addresses for the loopback interface bycreating multiple address configuration nodes.ipv6 An IPv6 address and network prefix for this interface. The formatis ipv6-address/prefix (for example, ::1/128).You can define multiple IPv6 addresses for a single interface, bycreating multiple address configuration nodes.
  30. 30. Chapter 1: Loopback Interface  Loopback Interface Commands 9LAN Interfaces 6.5R1 v01 VyattaUsage GuidelinesUse the set form of this command to specify the IP address and network mask for theloopback interface. You can set more than one IP address for the loopback interfaceby creating multiple address configuration nodes.Use the delete form of this command to remove the loopback interface address.Use the show form of this command to view loopback interface addressconfiguration.
  31. 31. Chapter 1: Loopback Interface  Loopback Interface Commands 10LAN Interfaces 6.5R1 v01 Vyattainterfaces loopback lo description <descr>Allows you to record a description for the loopback interface.Syntaxset interfaces loopback lo description descrdelete interfaces loopback lo descriptionshow interfaces loopback lo descriptionCommand ModeConfiguration mode.Configuration Statementinterfaces {loopback lo {description descr}}ParametersDefaultNone.Usage GuidelinesUse this command to set a description for the loopback interface.Use the set form of this command to specify the description.Use the delete form of this command to remove the description.Use the show form of this command to view description configuration.descr A description for the loopback interface.
  32. 32. Chapter 1: Loopback Interface  Loopback Interface Commands 11LAN Interfaces 6.5R1 v01 Vyattashow interfaces loopback Displays information about the loopback interface.Syntaxshow interfaces loopback [lo [brief] | detail]Command ModeOperational mode.ParametersDefaultWhen used with no option, this command displays brief status information for theloopback interface.Usage GuidelinesUse this command to view information and status for the loopback interface.The show interfaces loopback and show interfaces loopback lo brief commands areequivalent.The show interfaces loopback lo and show interfaces loopback detail commands areequivalent.lo Displays detailed statistics and configuration information for theloopback interface.brief Displays brief status information for the loopback interface. Enterthe show interfaces loopback command with the lo brief option isequivalent to entering it with no option.detail Displays detailed information and statistics about the loopbackinterface.
  33. 33. Chapter 1: Loopback Interface  Loopback Interface Commands 12LAN Interfaces 6.5R1 v01 VyattaExamplesExample 1-2 shows brief status information for the loopback interface.Example 1‐2   Displaying loopback interface information.vyatta@R1:~$ show interfaces loopbackCodes: S ‐ State, L ‐ Link, u ‐ Up, D ‐ Down, A ‐ Admin DownInterface        IP Address                        S/L  Description‐‐‐‐‐‐‐‐‐        ‐‐‐‐‐‐‐‐‐‐                        ‐‐‐  ‐‐‐‐‐‐‐‐‐‐‐lo               127.0.0.1/8                       u/u                 ::1/128Example 1-3 shows additional detail for the loopback interface.Example 1‐3   Displaying additional loopback interface detail.vyatta@R1:~$ show interfaces loopback lolo: <LOOPBACK,UP,LOWER_UP> mtu 16436 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       valid_lft forever preferred_lft forever    RX:  bytes    packets     errors    dropped    overrun      mcast         44056        730          0          0          0          0    TX:  bytes    packets     errors    dropped    carrier collisions         44056        730          0          0          0          0
  34. 34. 13LAN Interfaces 6.5R1 v01 VyattaChapter 2: Ethernet InterfacesThis chapter describes basic configuration for Ethernet interfaces.This chapter presents the following topics:• Ethernet Interfaces Overview• Ethernet Interface Configuration Examples• Ethernet Interface Commands
  35. 35. Chapter 2: Ethernet Interfaces  Ethernet Interfaces Overview 14LAN Interfaces 6.5R1 v01 VyattaEthernet Interfaces OverviewA system receives packets from neighboring systems through its network interfaces.On the LAN, this interface is typically an Ethernet interface.Ethernet interfaces are viewed and configured in the interfaces ethernet node of theconfiguration tree. The system automatically discovers the physical interfaces on thesystem and creates entries for them on startup in the configuration tree. For example,on a system with two Ethernet interfaces, the router automatically createsconfiguration nodes for eth0 and eth1.Once the interface is enabled and provided with an address, you can configure it withvarious system features—such as firewall, routing protocols, Quality of Service, andso on.The Vyatta system has extensive support for IPv6, including IPv6 interfaceaddressing. The commands for configuring IPv6 on Ethernet interfaces are given inthis chapter. A full description of Vyatta IPv6 support is provided in the Vyatta IPv6Support Reference Guide.Ethernet Interface Configuration ExamplesThis section presents the following topics:• Viewing System Interfaces• Basic Ethernet Interface Configuration• Ethernet Multinetting• IPv6 on Ethernet InterfacesViewing System Interfaces You can only configure interfaces that actually are physically available to theoperating system on the hardware you are using. To view all the interfaces known tothe operating system, use the show interfaces system command in operational mode,as shown in Example 2-1. In this example, the system has two physical Ethernetinterfaces, eth0 and eth1, plus a VLAN interface (vif) configured for VLAN 40 undereth1.Example 2‐1   Viewing available system interfacesvyatta@vyatta:~$ show interfaces systemvyatta@R1:~$ show interfaces systemeth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000    link/ether 3a:26:db:4d:63:a2 brd ff:ff:ff:ff:ff:ff
  36. 36. Chapter 2: Ethernet Interfaces  Ethernet Interface Configuration Examples 15LAN Interfaces 6.5R1 v01 Vyatta    inet 192.168.1.81/24 brd 192.168.1.255 scope global eth0    inet6 fe80::3826:dbff:fe4d:63a2/64 scope link       valid_lft forever preferred_lft forever    RX:  bytes    packets     errors    dropped    overrun      mcast      18512372     189264          0          0          0          0    TX:  bytes    packets     errors    dropped    carrier collisions        867299       7494          0          0          0          0eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000    link/ether aa:31:57:a8:ee:90 brd ff:ff:ff:ff:ff:ff    inet 10.10.30.65/24 brd 10.10.30.255 scope global eth1    inet6 fe80::a831:57ff:fea8:ee90/64 scope link       valid_lft forever preferred_lft forever    RX:  bytes    packets     errors    dropped    overrun      mcast             0          0          0          0          0          0    TX:  bytes    packets     errors    dropped    carrier collisions           776          8          0          0          0          0eth1.40@eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP    link/ether aa:31:57:a8:ee:90 brd ff:ff:ff:ff:ff:ff    inet 10.10.40.65/24 brd 10.10.40.255 scope global eth1.40    inet6 fe80::a831:57ff:fea8:ee90/64 scope link       valid_lft forever preferred_lft forever    RX:  bytes    packets     errors    dropped    overrun      mcast             0          0          0          0          0          0    TX:  bytes    packets     errors    dropped    carrier collisions           368          4          0          0          0          0lo: <LOOPBACK,UP,LOWER_UP> mtu 16436 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       valid_lft forever preferred_lft forever    RX:  bytes    packets     errors    dropped    overrun      mcast      11170696     186174          0          0          0          0    TX:  bytes    packets     errors    dropped    carrier collisions      11170696     186174          0          0          0          0
  37. 37. Chapter 2: Ethernet Interfaces  Ethernet Interface Configuration Examples 16LAN Interfaces 6.5R1 v01 VyattaBasic Ethernet Interface ConfigurationThis section presents a sample configuration for an Ethernet interface connected toan Ethernet LAN.When you have finished, the system will be configured as shown in Figure 2-1.Figure 2‐1   Basic Ethernet configurationExample 2-2 applies IP addresses directly to the two Ethernet interfaces alreadydiscovered for the system—eth0 and eth1. These interfaces were automaticallycreated by the system on startup, when the system detected the physical interfaces. In.Each IP address is applied directly to the interface. The system automaticallydiscovers the MAC address (hardware ID) of the Network Interface Card (NIC)housing the Ethernet interface, and applies default values for a number of otheroptions.To configure these interfaces, perform the following steps in configuration mode.R1eth0.65eth1.65172.16.0.0/2410.10.30.0/24Example 2‐2   Configuring Ethernet interfacesStep CommandAssign an IP address to interface eth0. vyatta@R1# set interfaces ethernet eth0 address 176.16.0.65/24Assign an IP address to interface eth1.vyatta@R1# set interfaces ethernet eth1 address 10.10.30.65/24 [edit]
  38. 38. Chapter 2: Ethernet Interfaces  Ethernet Interface Configuration Examples 17LAN Interfaces 6.5R1 v01 VyattaEthernet MultinettingEach physical interface can have multiple IP addresses assigned to it.If you want tohave multiple networks on the same physical interface (called multinetting), but youdon’t want to use 802.1Q VLANs, simply create multiple address configurationnodes directly under the primary interface.To configure Ethernet multinetting, perform the following steps in configurationmode.Commit and view the configuration.vyatta@R1# commitOK[edit]vyatta@R1# show interfaces etherneteth0 {     address 176.16.0.65/24     duplex auto     hw‐id 3a:26:db:4d:63:a2     smp_affinity auto     speed auto}eth1 {address 10.10.30.65/24duplex autohw‐id 00‐14‐22‐01‐5c‐6fsmp_affinity autospeed auto}[edit]Example 2‐2   Configuring Ethernet interfacesExample 2‐3   Configuring Ethernet multinettingStep CommandAssign the first IP address to eth0.vyatta@R2# set interfaces ethernet eth0 address 172.16.0.65/24 [edit]Assign the second IP address toeth0.vyatta@R1# set interfaces ethernet eth0 address 192.168.1.17/24[edit]
  39. 39. Chapter 2: Ethernet Interfaces  Ethernet Interface Configuration Examples 18LAN Interfaces 6.5R1 v01 VyattaIPv6 on Ethernet InterfacesExamples for configuring IPv6 on interfaces are provided in the Vyatta IPv6 SupportReference Guide.Commit and view theconfiguration.vyatta@R1# commitOK[edit]vyatta@Test1# show interfaces ethernet eth0address 192.168.1.81/24address 192.168.1.17/24duplex autohw‐id 3a:26:db:4d:63:a2smp_affinity autoauto[edit]Example 2‐3   Configuring Ethernet multinetting
  40. 40. Chapter 2: Ethernet Interfaces  Ethernet Interface Commands 19LAN Interfaces 6.5R1 v01 VyattaEthernet Interface CommandsConfiguration Commandsclear interfaces ethernet counters Clears statistics counters for Ethernet interfaces.interfaces ethernet <ethx> address Sets an IP address and network prefix for an Ethernet interface.interfaces ethernet <ethx> description <descr> Specifies a description for an Ethernet interface.interfaces ethernet <ethx> dhcpv6‐options Specifies the way in which a DHCPv6 client is to acquire an address and/or parameters from a DHCPv6 server.interfaces ethernet <ethx> disable Disables an Ethernet interface without discarding configuration.interfaces ethernet <ethx> disable‐flow‐control Disables IEEE 802.3x full‐duplex flow control (“PAUSE” frames).interfaces ethernet <ethx> disable‐link‐detect Directs an Ethernet interface not to detect physical link‐state changes.interfaces ethernet <ethx> duplex <duplexity> Sets the duplex mode for an Ethernet interface.interfaces ethernet <ethx> hw‐id <mac‐addr> Associates the Ethernet interface name with a hardware MAC address.interfaces ethernet <ethx> ip enable‐proxy‐arp Enables proxy ARP on an Ethernet interface.interfaces ethernet <ethx> ipv6 address Assigns an IPv6 address to an Ethernet interface.interfaces ethernet <ethx> ipv6 disable‐forwardingDisables IPv6 forwarding on an Ethernet interface.interfaces ethernet <ethx> ipv6 dup‐addr‐detect‐transmits <num>Specifies the number of times to transmit NS packets as part of the DAD process.interfaces ethernet <ethx> ipv6 router‐advert Specifies the router advertisements to be sent from an Ethernet interface.interfaces ethernet <ethx> mac <mac‐addr> Sets the MAC address of an Ethernet interface.interfaces ethernet <ethx> mirror <interface> Mirrors inbound traffic from an Ethernet interface to another interface.interfaces ethernet <ethx> mtu <mtu> Sets the MTU for an Ethernet interface.interfaces ethernet <ethx> redirect <interface> Redirects inbound traffic from an Ethernet interface to another interface.

×