Post on 09-Feb-2022
transcript
BIG-IP® Advanced Routing™Border Gateway Protocol
Command Line Interface Reference Guide
Version 7.8.4
Publication DateThis document was published on June 27, 2013.
Legal Notices
CopyrightCopyright 2001-2013, F5 Networks, Inc. All rights reserved.
F5 Networks, Inc. (F5) believes the information it furnishes to be accurate and reliable. However, F5assumes no responsibility for the use of this information, nor any infringement of patents or other rights ofthird parties which may result from its use. No license is granted by implication or otherwise under anypatent, copyright, or other intellectual property right of F5 except as specifically described by applicableuser licenses. F5 reserves the right to change specifications at any time without notice.
TrademarksAAM, Access Policy Manager, Advanced Client Authentication, Advanced Firewall Manager, AdvancedRouting, AFM, Alive With F5, APM, Application Acceleration Manager, Application Security Manager,ARX, AskF5, ASM, BIG-IP, BIG-IQ, Cloud Extender, CloudFucious, Cloud Manager, ClusteredMultiprocessing, CMP, COHESION, Data Manager, DevCentral, DevCentral [DESIGN], DNS Express,DSC, DSI, Edge Client, Edge Gateway, Edge Portal, ELEVATE, EM, Enterprise Manager, ENGAGE, F5,F5 [DESIGN], F5 Certified [DESIGN], F5 Networks, Fast Application Proxy, Fast Cache, FirePass,Global Traffic Manager, GTM, GUARDIAN, iApps, IBR, Intelligent Browser Referencing, IntelligentCompression, IPv6 Gateway, iControl, iHealth, iQuery, iRules, iRules OnDemand, iSession, L7 RateShaping, LC, Link Controller, Local Traffic Manager, LTM, LineRate, LineRate Systems [DESIGN],LROS, Message Security Manager, MSM, OneConnect, Packet Velocity, PEM, Policy EnforcementManager, Protocol Security Manager, PSM, Real Traffic Policy Builder, ScaleN, Signalling DeliveryController, SDC, SSL Acceleration, StrongBox, SuperVIP, SYN Check, TCP Express, TDR, TMOS,Traffic Management Operating System, Traffix Systems, Traffix Systems (DESIGN), Transparent DataReduction, UNITY, VAULT, VIPRION, vCMP, VE F5 [DESIGN], Virtual Clustered Multiprocessing,WA, WAN Optimization Manager, WebAccelerator, WOM, and ZoneRunner, are trademarks or servicemarks of F5 Networks, Inc., in the U.S. and other countries, and may not be used without F5's expresswritten consent.
All other product and company names herein may be trademarks of their respective owners.
A portion of this reference guide is copyrighted by IP Infusion, Inc.
ZebOS is a registered trademark, and IP Infusion and the ipinfusion logo are trademarks of IP Infusion.All other trademarks are trademarks of their respective companies.
This documentation is subject to change without notice. The software described in this document and thisdocumentation are furnished under a license agreement or nondisclosure agreement. The software anddocumentation may be used or copied only in accordance with the terms of the applicable agreement. Nopart of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or anymeans electronic or mechanical, including photocopying and recording for any purpose other than thepurchaser's internal use without the written permission of IP Infusion Inc.
F5 Networks, Inc. (F5) believes the information it furnishes to be accurate and reliable. However, F5assumes no responsibility for the use of this information, nor any infringement of patents or other rights ofthird parties which may result from its use. No license is granted by implication or otherwise under anypatent, copyright, or other intellectual property right of F5 except as specifically described by applicableuser licenses. F5 reserves the right to change specifications at any time without notice.
All other product and company names herein may be trademarks of their respective owners.
i
ii
Table of Contents
CHAPTER 1 ZebOS Command Line Interface Environment . . . . . . . . . . . . . . . . . . 1Command Line Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Command Line Interface Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1Command Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3Format used for Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Command Negation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Variable Parameter Expansion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Show Command Tokens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Output Modifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Command Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Common Command Mode Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7BGP Daemon Command Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Address Family Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Common Executive Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Common Privileged Executive Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10Common Configure Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
CHAPTER 2 BGP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15address-family. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19aggregate-address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20auto-summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21bgp aggregate-nexthop-check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22bgp always-compare-med. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23bgp as-local-count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24bgp bestpath as-path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25bgp bestpath compare-confed-aspath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26bgp bestpath compare-routerid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27bgp bestpath dont-compare-originator-id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28bgp bestpath med. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29bgp bestpath tie-break-on-age . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30bgp client-to-client reflection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31bgp cluster-id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32bgp confederation identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33bgp confederation peers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34bgp config-type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35bgp dampening. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36bgp default ipv4-unicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37bgp default local-preference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38bgp deterministic med . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39bgp enforce-first-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
iii
Table of Contents
bgp extended-asn-cap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41bgp fast-external-failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42bgp graceful-restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43bgp inbound-route-filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44bgp log-neighbor-changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45bgp multiple-instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46bgp nexthop-trigger-count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47bgp nexthop-trigger delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48bgp nexthop-trigger enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49bgp rfc1771-path-select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50bgp rfc1771-strict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51bgp router-id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52bgp scan-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53bgp update-delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54clear bgp * . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55clear bgp <1-4294967295> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56clear bgp A.B.C.D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57clear bgp X:X::X:X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58clear bgp external . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59clear bgp ipv4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60clear bgp peer-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61clear bgp view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62clear ip bgp * . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63clear ip bgp <1-4294967295> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65clear ip bgp A.B.C.D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67clear ip bgp X:X::X:X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69clear ip bgp dampening . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70clear ip bgp external . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71clear ip bgp flap-statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72clear ip bgp ipv4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73clear ip bgp ipv6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74clear ip bgp peer-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75clear ip bgp view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76debug bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77distance bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78dump bgp all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79dump bgp routes-mrt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80dump bgp updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81exit-address-family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82ip as-path access-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83ip community-list <1-99> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84ip community-list <100-199> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85ip community-list WORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86ip community-list expanded. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87ip community-list standard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88ip extcommunity-list <1-99> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89ip extcommunity-list <100-199> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
iv
Table of Contents
ip extcommunity-list expanded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91ip extcommunity-list standard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92match ip peer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93mpls-resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94neighbor activate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95neighbor advertisement-interval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96neighbor allowas-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97neighbor attribute-unchanged. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98neighbor as-origination-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99neighbor capability dynamic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100neighbor capability graceful-restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101neighbor capability orf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102neighbor capability route-refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103neighbor collide-established . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104neighbor connection-retry-time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105neighbor default-originate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106neighbor description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107neighbor disallow-infinite-holdtime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108neighbor distribute-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109neighbor dont-capability-negotiate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110neighbor ebgp-multihop. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111neighbor enforce-multihop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112neighbor fall-over . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113neighbor filter-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114neighbor local-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115neighbor maximum-prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116neighbor next-hop-self . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117neighbor override-capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118neighbor passive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119neighbor peer-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120neighbor port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121neighbor prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122neighbor remote-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123neighbor remove-private-AS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124neighbor restart-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125neighbor route-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126neighbor route-reflector-client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127neighbor route-server-client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128neighbor send-community. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129neighbor shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130neighbor soft-reconfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131neighbor strict-capability-match . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132neighbor timers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133neighbor transparent-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134neighbor transparent-nexthop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135neighbor unsuppress-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136neighbor update-source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
v
Table of Contents
neighbor version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138neighbor weight. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140redistribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142restart bgp graceful. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143router bgp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144router bgp view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145set-overload-bit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147timers bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148undebug bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
CHAPTER 3 BGP4+ Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151address-family ipv6 labeled-unicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152aggregate-address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153clear bgp X:X::X:X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154clear bgp ipv6 * . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155clear bgp ipv6 <1-4294967295>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156clear bgp ipv6 A.B.C.D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157clear bgp ipv6 X:X::X:X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158clear bgp ipv6 external . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159clear bgp ipv6 peer-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160clear bgp ipv6 unicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161match ipv6 peer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162neighbor activate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163neighbor attribute-unchanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164neighbor capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165neighbor default-originate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166neighbor distribute-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167neighbor filter-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168neighbor maximum-prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169neighbor next-hop-self . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170neighbor peer-group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171neighbor prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172neighbor remove-private-AS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173neighbor route-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174neighbor route-reflector-client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175neighbor send-community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176neighbor soft-reconfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177neighbor unsuppress-map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179redistribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
CHAPTER 4 BGP VPN Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181address-family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182bgp inbound-route-filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184clear ip bgp * vpn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185clear ip bgp <1-4294967295> vpn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
vi
Table of Contents
clear ip bgp A.B.C.D vpn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187clear ip bgp X:X::X:X vpn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188clear ipv6 bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189debug bgp mpls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190exit-address-family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191import map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192ip vrf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193neighbor activate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194neighbor allow-ebgp-vpn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195neighbor allowas-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196neighbor as-origination-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197neighbor as-override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198neighbor description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199neighbor remote-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200neighbor send-community. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201neighbor shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202neighbor soo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203redistribute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204rd (route distinguisher). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205route-target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206set vpnv4 next-hop. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
CHAPTER 5 BGP Show Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209show bgp X:X::X:X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212show bgp X:X::X:X/M. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213show bgp community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214show bgp community-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215show bgp dampening. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216show bgp filter-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217show bgp inconsistent-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218show bgp ipv4 multicast A.B.C.D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219show bgp ipv4 multicast A.B.C.D/M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220show bgp ipv4 multicast community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221show bgp ipv4 multicast community-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222show bgp ipv4 multicast dampening . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223show bgp ipv4 multicast filter-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224show bgp ipv4 multicast inconsistent-as. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225show bgp ipv4 multicast neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226show bgp ipv4 multicast paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227show bgp ipv4 multicast prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228show bgp ipv4 multicast quote-regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229show bgp ipv4 multicast regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230show bgp ipv4 multicast route-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231show bgp ipv4 multicast summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232show bgp ipv4 neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233show bgp ipv4 paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234show bgp ipv4 prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
vii
Table of Contents
show bgp ipv4 quote-regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236show bgp ipv4 summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237show bgp ipv4 unicast A.B.C.D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238show bgp ipv4 unicast A.B.C.D/M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239show bgp ipv4 unicast community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240show bgp ipv4 unicast community-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241show bgp ipv4 unicast dampening . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242show bgp ipv4 unicast filter-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243show bgp ipv4 unicast inconsistent-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244show bgp ipv4 unicast neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245show bgp ipv4 unicast paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246show bgp ipv4 unicast prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247show bgp ipv4 unicast quote-regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248show bgp ipv4 unicast regexp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249show bgp ipv4 unicast route-map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250show bgp ipv4 unicast summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251show bgp ipv6 X:X::X:X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252show bgp ipv6 X:X::X:X/M. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253show bgp ipv6 community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254show bgp ipv6 community-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255show bgp ipv6 dampening. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256show bgp ipv6 filter-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257show bgp ipv6 inconsistent-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258show bgp ipv6 labeled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259show bgp ipv6 multicast. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260show bgp ipv6 neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261show bgp ipv6 paths. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262show bgp ipv6 prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263show bgp ipv6 quote-regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264show bgp ipv6 route-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265show bgp ipv6 summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266show bgp ipv6 unicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267show bgp ipv6 view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268show bgp neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269show bgp nexthop-tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270show bgp nexthop-tree-details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271show bgp paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272show bgp prefix-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273show bgp quote-regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274show bgp regexp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275show bgp route-map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276show bgp summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277show debugging bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278show ip bgp A.B.C.D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279show ip bgp A.B.C.D/M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280show ip bgp attribute-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281show ip bgp cidr-only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
viii
Table of Contents
show ip bgp community. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283show ip bgp community-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284show ip bgp community-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .285show ip bgp dampening . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .286show ip bgp filter-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .287show ip bgp inconsistent-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288show ip bgp ipv4 A.B.C.D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289show ip bgp ipv4 A.B.C.D/M. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290show ip bgp ipv4 community. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291show ip bgp ipv4 community-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .292show ip bgp ipv4 dampening . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .293show ip bgp ipv4 filter-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294show ip bgp ipv4 inconsistent-as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295show ip bgp ipv4 neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296show ip bgp ipv4 paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .297show ip bgp ipv4 prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298show ip bgp ipv4 quote-regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299show ip bgp ipv4 regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .300show ip bgp ipv4 route-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301show ip bgp ipv4 summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302show ip bgp neighbors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303show ip bgp paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305show ip bgp prefix-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306show ip bgp quote-regexp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307show ip bgp regexp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308show ip bgp route-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .309show ip bgp scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310show ip bgp summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311show ip bgp view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312show ip bgp vpnv4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313show ip bgp vpnv6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314show ip extcommunity-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315show ip protocols bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316show ip vrf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
Appendix A Regular Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index - 1
ix
Table of Contents
x
CHAPTER 1 ZebOS Command Line Interface Environment
Network administrators and application developers who install and configure ZebOS® IP routing software should use this Command Line Interface (CLI) reference guide. This guide includes contains the following information:
• An overview of the ZebOS Command Line Interface
• An overview of the Integrated Management Interface (IMI), including a description of both basic access and of the shell commands
• A complete reference of the Command Line Interface (CLI) commands used for Border Gateway Protocol (BGP) configurations
Command Line Interface OverviewThe ZebOS® Command Line Interface is a text-based facility conforming to industry standards. Many of the commands can be used in scripts to automate configuration tasks. Each CLI command is usually associated with a specific function or a common function performing a specific task.
The Integrated Management Interface (IMI) Shell, or IMISH, gives users and administrators the ability to issue commands to several daemons using a single TELNET session.
Command Line Interface HelpThe ZebOS CLI contains a text-based help facility. Access this help by typing in a full or partial command string then typing a question mark “?”. The ZebOS CLI displays the command keywords or parameters along with a short description. For example, at the CLI command prompt, type:
ZebOS> show ? (CLI does not display the question mark).The CLI displays this keyword list with short descriptions for each keyword:
ZebOS# show debugging Debugging functions (see also 'undebug') history Display the session command history ip IP information memory Memory statistics route-map route-map information running-config running configuration startup-config Contents of startup configuration version Displays ZebOS version
If the ? is typed in the middle of a keyword, the ZebOS CLI displays help for that keyword only.
ZebOS> show de? (CLI does not display the question mark). debugging Debugging functions (see also 'undebug')
If the ? is typed in the middle of a keyword, but the incomplete keyword matches several other keywords, ZebOS displays help for all matching keywords.
ZebOS> show i? (CLI does not display the question mark). interface Interface status and configuration ip IP information isis ISIS information
1
ZebOS Command Line Interface Environment
Command CompletionThe ZebOS CLI can complete the spelling of a command or a parameter. Begin typing the command or parameter, then press the TAB key. For example, at the CLI command prompt type sh:
ZebOS> shPress TAB. The CLI displays:
ZebOS> showIf the command or parameter partial spelling is ambiguous, the ZebOS CLI displays the choices that match the abbreviation. Type show i and press TAB. The CLI displays:
ZebOS> show iinterface ip isisZebOS> show i
The CLI displays the interface and ip keywords. Type n to select interface and press TAB. The CLI displays:
ZebOS> show inZebOS> show interface
Type ? and the CLI displays the list of parameters for the show interface command.
ZebOS> show interface IFNAME Interface name | Output modifiers > Output redirection <cr>
The CLI displays the only parameter associated with this command, the IFNAME parameter.
Note: For more information about output modifiers and output redirection, see the Show Command Tokens section.
Command AbbreviationsThe ZebOS CLI accepts abbreviations for commands. For example
sh in eth0is an abbreviation for the show interface command.
Command Line ErrorsAny unknown spelling variation causes the command line parser to display the error Unrecognized command in response to the ?. The parser redisplays the command as last entered. When the user presses the Enter key after typing an invalid command, the parser displays:
ZebOS(config)#router ospf here ^% Invalid input detected at '^' marker.
where the ^ points to the first character in error in the command.
If a command is incomplete, it displays the following message:
ZebOS> show% Incomplete command.
Some commands are too long for the display line and can wrap in mid-parameter or mid-keyword, as shown below:
area 10.10.0.18 virtual-link 10.10.0.19 authentication-key 57393
2
ZebOS Command Line Interface Environment
DefinitionsThe following table defines the terms used in this document.
Table 1: Definition of Terms
Typographic ConventionsThe following table describes the typographic conventions that are used in this guide.
Table 2: .Typographic Conventions
Term Description
token A token is a non-character, non-numeric symbol: {}, [], (), <>, |,?, >, =
parameter A parameter is an UPPERCASE term for which the user substitutes input.
keyword A keyword is a lowercase term that the user types exactly as shown.
line A line is the user input of any text string, including spaces. No other parameters may be entered after input for this token.
word A word is the user input of any contiguous text string (excluding spaces).
Convention Name Description Example
Monospaced font
Command Represents command strings entered on a command line and sample source code.
show ip ospf
UPPERCASE Variable parameter
Indicates user input. Enter values according to the description. Each uppercase token expands into one or more other tokens.
area AREAID range ADDRESS
lowercase Keyword parameter
Indicates keywords. Enter values exactly as displayed in the command description.
show ip ospf
| Vertical bar Limits the choices. Select one from the list. Do not enter the bar as part of the command.
A.B.C.D|<0-4294967295>
() Parentheses Encloses optional parameters. Select one. Do not enter the parentheses as part of the command.
(A.B.C.D|<0-4294967295>)
{} Braces Encloses optional parameters. Select none, one or more than one. Do not enter the brace as part of the command.
{priority <0-255>|poll-interval <1-65535>}
[] Square brackets
Encloses optional parameters. Select one. Do not enter the bracket as part of the command.
[parm2|parm2|parm3]
< > Angle brackets Encloses a numeric range, endpoints inclusive. Do not enter the bracket as part of the command.
<0-65535>
= Equal sign Separates the variable from explanatory text. Do not enter the equal sign as part of the command.
PROCESSID = <0-65535>
3
ZebOS Command Line Interface Environment
Format used for Command DescriptionThe following describes the format used when describing each command in this document.
Table 3: Command Description Formats
Command NegationMany commands can be negated using the no keyword. Depending on the command or the parameters, some command negation can disable one feature or a feature for a specific ID, interface, address or other identifier. However, some negation is for the base command only; thus, the negated form does not take a parameter.
Variable Parameter ExpansionFor some commands, an IP address or a number in a given range can replace a parameter. For example:
area AREAADDRESSID virtual-link ROUTERID (AUTHENTICATE|MSGD|INTERVAL)AREAADDRESSID=A.B.C.D|<0-4294967295>
Therefore, the following is the minimum command for the ROUTERID by an IP address:
area 10.10.0.11 virtual-link 10.10.0.12Users can only choose an optional parameter in the string [AUTHENTICATE|MSGD|INTERVAL]. In addition, users can replace a parameter by a keyword or parameter. For example, the following string replaces the MD5 parameter:
MD5= [message-digest-key <1-255> md5 MD5_KEY]
with MD5_KEY replaced by a 1-16 character string.
A.B.C.D IP address An IPv4-style address 10.0.11.123
X:X::X:X IP address An IPv6-style address 3ffe:506::1where the:: is all the zeros for address components not explicitly given.
Format Description
Command Name Describes the command, what the command does and when should it be used.
Command Syntax Displays the syntax of each command.
Parameters Defines parameters and options within each command syntax.
Default Displays the status of the command before it is executed.
Command Mode Displays the name of the command mode in which this command is used. Examples include Exec or Configure modes.
Example Displays an example of the command being executed and the complexities of the command syntax.
Related Commands Lists the commands that are of immediate importance.
Convention Name Description Example
4
ZebOS Command Line Interface Environment
Show Command TokensUsers can use two tokens to modify the output of a show command. Enter a question mark to display these tokens:
ZebOS# show users ? | Output modifiers > Output redirection
Output ModifiersUsers can type the | (vertical bar character) to use output modifiers. For example:
ZebOS>show rsvp | ?
begin Begin with the line that matchesexclude Exclude lines that matchinclude Include lines that matchredirect Redirect output
Begin ParameterThe begin parameter displays the output beginning with the first line containing a token matching the input string (everything typed after the begin token). For example:
ZebOS# show run | begin eth1...skippinginterface eth1 ipv6 address fe80::204:75ff:fee6:5393/64!interface eth2 ipv6 address fe80::20d:56ff:fe96:725a/64!line con 0 login!end
Exclude ParameterThe exclude parameter excludes all lines of output that contain the input string. In the following output example, all lines containing the word “include” are excluded:
ZebOS# show interface eth1 | exclude inputInterface eth1 Scope: both Hardware is Ethernet, address is 0004.75e6.5393 index 3 metric 1 mtu 1500 <UP,BROADCAST,RUNNING,MULTICAST> VRF Binding: Not bound Label switching is disabled No Virtual Circuit configured Administrative Group(s): None DSTE Bandwidth Constraint Mode is MAM inet6 fe80::204:75ff:fee6:5393/64 output packets 4438, bytes 394940, dropped 0
5
ZebOS Command Line Interface Environment
output errors 0, aborted 0, carrier 0, fifo 0, heartbeat 0, window 0 collisions 0
Include ParameterThe include parameter includes only those lines of output that contain the input string. In the output below, all lines containing the word “input” are included:
ZebOS# show interface eth1 | include input input packets 80434552, bytes 2147483647, dropped 0, multicast packets 0 input errors 0, length 0, overrun 0, CRC 0, frame 0, fifo 1, missed 0
Redirect ParameterThe redirect parameter puts the lines of output into the indicated file.
ZebOS# show history | redirect /var/frame.txt
In addition, the output redirection token (>) allows the user to specify a target file for the lines of output.
ZebOS# show history >/var/frame.txt
Note: To modify the lines displayed for any Show command in this guide, use the | (vertical bar) output modifier token; to save the output to a file, use the > (right arrow) output redirection token.
Command ModesCommands available for each protocol separate into several modes (or nodes) and are arranged in a hierarchy. Each mode has its own special commands.
Table 4: Command Modes
Name Description
Exec Mode Also called the View mode, this mode the first mode to appear after logging in to the CLI. It is a base mode from where users can perform basic commands, such as show, exit, quit, help, list, and enable.
Privileged Exec Mode Also called the Enable mode, it allows users to run additional basic commands, such as debug, write (for saving and viewing the configuration) and show commands.
Configure Mode Also called Configure Terminal mode, it allows users to run configuration commands and to serve as a gateway into the Interface, Router, Line, Route Map, Key Chain and Address Family modes.
Interface Mode Is used to configure protocol-specific settings for a particular interface. Any attribute configured in this mode overrides an attribute configured in the Router mode.
Line Mode Is used to make the access-class commands available.
6
ZebOS Command Line Interface Environment
Common Command Mode TreeThe diagram displays the common command mode tree.
Figure 1: Common Command Mode Tree
BGP Daemon Command ModesRouter Sometimes referred to as configure router mode, this mode is available for the MPLS, BGP, OSPF, and RIP protocols only and makes available router and routing commands.
Route-map This mode is used to set route metric, route-length and cost data. It is available for the BGP, OSPF, and RIP protocols only.
Address Family This mode allows support for multiprotocol BGP extension. It includes address family-specific commands that are used to modify the behavior of BGP for a specific address family. For details on this mode, see “Address Family Mode” on page 6.
Figure 2 on page 8 shows the complete BGP daemon command mode tree.
7
ZebOS Command Line Interface Environment
Figure 2: BGP Daemon Command
Address Family ModeThe following commands support BGP4+ extensions (refer to RFC 2283) and enable carrying of routing information for multiple Network Layer protocols.
Figure 3: Address Family Mode
8
ZebOS Command Line Interface Environment
The following table describes the parameters used in the above commands listed above.
Table 5: Address Family Mode Parameters
Common Executive Mode CommandsThe following are the common Executive Mode commands across multiple protocol daemons. Refer to the ZebOS Network Platform NSM Command Line Interface Reference Guide for information about the use of these commands.
Table 6: Common Exec Mode commands
Interface Description
ipv4 Specify IPv4 Address Family
ipv6 Specify IPv6 Address Family
vpn4 Specify VPNv4 Address Family
vrf VRF_NAME Specify the name of the virtual routing and forwarding (VRF) instance
unicast Specify unicast address prefixes
multicast Specify multicast address prefixes
Command Name Use this command to
clear resist the functionality of a variety of modules
debug debug a variety of modules
enable enter the Privileged Exec mode
exit leave the current mode, or logout of the session
hardware display the register value from the register
help display online text assistance
logout exit from the ZebOS CLI
ping send a ping request
quit leave the current mode
route-map enter the route-map mode and to permit or deny match/set operations
reset reset log-related command
rmon set the remote monitoring debugging feature
show application-priority display Application-Priority interface information
show arp display Internet Protocol (IP)
show cli display the CLI tree of the current mode
9
ZebOS Command Line Interface Environment
Common Privileged Executive Mode CommandsThe following are the common Privileged Executive Mode commands across multiple protocol daemons. Enter this mode by typing enable from the Executive mode. See the ZebOS Network Platform NSM Command Line Interface Reference Guide for information about the use of these commands.
Table 7: Common Privileged Exec Mode Commands
show dot1x display IEEE 802.1X Port-Based Access Control
show list display a list of all commands in the current mode
show history display all commands used in a session
show ip protocols display the IP routing protocol process parameters and statistics
show privilege display the current privilege level
show rmon display the Remote Monitoring Protocol (RMON) information
show route-id display the route-ID information
show users display information about terminal lines
show user-priority display the default user priority associated with the layer2 interface
show version display the current ZebOS version
terminal length set the number of lines in a terminal display
terminal monitor display debugging information on a monitor
traceroute enable the traceroute commands
undebug disable the debugging feature
Command Name Use this command to
clear ip prefix-list clear the IP prefix-list
configure terminal enter the Configure Terminal mode. You must me in the Privilege Executive mode to issue this command
copy running-config startup-config copy the current running configuration to the startup configuration file
disable exit Privileged Exec mode
end leave the current mode
exit leave the current mode, or logout of the session
hardware display the register value from the register
help display online text assistance
Command Name Use this command to
10
ZebOS Command Line Interface Environment
login Login to a particular virtual router context
logout exit from the ZebOS CLI
mstat show the statistics after multiple multicast traceroutes
mtrace trace a multicast path from source to destination
ping send a ping request
quit leave the current mode
reset reset the log related command
rmon set the remote monitoring debugging feature
show access-list display the list of IP access lists
show application-priority display the Application-Priority interface information
show arp display the Internet Protocol (IP)
show cli display the CLI tree of the current mode
show dot1x display the IEEE 802.1X Port-Based Access Control
show faults display the recorded faults
show list display a list of all commands in the current mode
show history display all commands used in a session
show ip prefix-list display the prefix list entries
show ip protocols display the IP routing protocol process parameters and statistics
show privilege display the current privilege level
show rmon display the Remote Monitoring Protocol (RMON) information
show route-id display the route-ID information
show route-map display user readable route-map information
show running-config display the current configuration
show startup-config display the startup configuration (from storage)
show users display information about terminal lines
show user-priority display the default user priority associated with the layer2 interface
show version display the current ZebOS version
telnet open a TELNET connection
terminal length set the number of lines in a terminal display
terminal monitor display debugging on a monitor
Command Name Use this command to
11
ZebOS Command Line Interface Environment
Common Configure Mode CommandsThe following are the common Configure Mode commands across multiple protocol daemons. Enter this mode by typing configuration terminal from the Privileged Executive mode. Refer to the ZebOS Network Platform NSM Command Line Interface Reference Guide for information about the use of these commands.
Table 8: Common Configure Mode Commands
trace enable the trace commands
traceroute enable the traceroute commands
undebug disable the debugging feature
write file write the current configuration file
write memory write the current configuration file to non-volatile memory
write terminal display current configurations to the VTY terminal
Command Name Use this command to
access-list configure an access-list for filtering packets
arp configure an address resolution protocol
banner toggle the display of the banner text
clear ip prefix-list clear the IP prefix-list
do run an exec-level command from the config mode
enable password change the password for the enable command
exit leave the current mode, or logout of the session
help display online text assistance
hostname set or change network server name
ip prefix-list create an entry for a prefix list
ipv6 access-list configure an access-list for filtering frames
ipv6 prefix-list create an entry for an IPv6 prefix list
line vty enter Line mode
list list all commands for a mode
log file specify the file that collects logging information
log record-priority specify the logging of the priority of a message
Command Name Use this command to
12
ZebOS Command Line Interface Environment
log stdout begin logging information to the standard output
log syslog begin logging information to the system log
log trap limit logging to a specified level or type
mac configure a MAC access list
mac-access-list configure a MAC access list for QOS (quality of service)
mac-address-table configure spanning tree group commands
max-fib-routes set the maximum number of FIB (forwarding information base) routes
max-static-routes set the maximum number of static routes
maximum-access-list set the maximum number of access-list entries
maximum-paths set the multipath numbers installed to FIB
ospf set the Open Shortest Path First (OSPF) commandoes
radius-server set the RADIUS server configuration commands
rip set the Routing Information Protocol (RIP) commands
rmon set the remote Monitoring Protocol (RMON) commands
route-map enter the route-map mode and to permit or deny match/set operations
router-id set the router identifier for this system
rsvp-bypass set the Bypass Tunnel for the RSVP
service advanced-vty set the VTY session to Privileged Exec mode instead of the Exec mode (which is the default)
service password-encryption specify encryption of passwords
service terminal-length set the terminal length for VTY sessions
set port set the port information for a Layer2 interface
show access-list display the list of IP access lists
show cli display the CLI tree of the current mode
show list displays a list of all commands in the current mode
show running-config display the current configuration
snmp configure SNMP information
undebug disable the debugging feature
username establish the user name authentication
Command Name Use this command to
13
ZebOS Command Line Interface Environment
virtual-router set a virtual-router configuration
vlan configure VLAN parameters
Command Name Use this command to
14
CHAPTER 2 BGP Commands
This chapter provides an alphabetized reference for each of the BGP configuration commands. Refer to Chapter 5, BGP Show Commands to view all of the BGP show commands.
This chapter includes the following commands:
• address-family on page 19
• aggregate-address on page 20
• auto-summary on page 21
• bgp aggregate-nexthop-check on page 22
• bgp always-compare-med on page 23
• bgp as-local-count on page 24
• bgp bestpath as-path on page 25
• bgp bestpath compare-confed-aspath on page 26
• bgp bestpath compare-routerid on page 27
• bgp bestpath dont-compare-originator-id on page 28
• bgp bestpath med on page 29
• bgp bestpath tie-break-on-age on page 30
• bgp client-to-client reflection on page 31
• bgp cluster-id on page 32
• bgp confederation identifier on page 33
• bgp confederation peers on page 34
• bgp config-type on page 35
• bgp dampening on page 36
• bgp default ipv4-unicast on page 37
• bgp default local-preference on page 38
• bgp deterministic med on page 39
• bgp enforce-first-as on page 40
• bgp extended-asn-cap on page 41
• bgp fast-external-failover on page 42
• bgp graceful-restart on page 43
• bgp inbound-route-filter on page 44
• bgp log-neighbor-changes on page 45
• bgp multiple-instance on page 46
• bgp nexthop-trigger delay on page 48
• bgp nexthop-trigger enable on page 49
• bgp rfc1771-path-select on page 50
• bgp rfc1771-strict on page 51
15
BGP Commands
• bgp router-id on page 52
• bgp scan-time on page 53
• bgp update-delay on page 54
• clear bgp * on page 55
• clear bgp <1-4294967295> on page 56
• clear bgp A.B.C.D on page 57
• clear bgp X:X::X:X on page 58
• clear bgp external on page 59
• clear bgp ipv4 on page 60
• clear bgp peer-group on page 61
• clear bgp view on page 62
• clear ip bgp * on page 63
• clear ip bgp <1-4294967295> on page 65
• clear ip bgp A.B.C.D on page 67
• clear ip bgp X:X::X:X on page 69
• clear ip bgp dampening on page 70
• clear ip bgp external on page 71
• clear ip bgp flap-statistics on page 72
• clear ip bgp ipv4 on page 73
• clear ip bgp ipv6 on page 74
• clear ip bgp peer-group on page 75
• clear ip bgp view on page 76
• debug bgp on page 77
• distance bgp on page 78
• dump bgp all on page 79
• dump bgp routes-mrt on page 80
• dump bgp updates on page 81
• exit-address-family on page 82
• ip as-path access-list on page 83
• ip community-list <1-99> on page 84
• ip community-list <100-199> on page 85
• ip community-list WORD on page 86
• ip community-list expanded on page 87
• ip community-list standard on page 88
• ip extcommunity-list <1-99> on page 89
• ip extcommunity-list <100-199> on page 90
• ip extcommunity-list expanded on page 91
• ip extcommunity-list standard on page 92
• match ip peer on page 93
16
BGP Commands
• mpls-resolution on page 94
• neighbor activate on page 95
• neighbor advertisement-interval on page 96
• neighbor allowas-in on page 97
• neighbor attribute-unchanged on page 98
• neighbor as-origination-interval on page 99
• neighbor capability dynamic on page 100
• neighbor capability graceful-restart on page 101
• neighbor capability orf on page 102
• neighbor capability route-refresh on page 103
• neighbor collide-established on page 104
• neighbor connection-retry-time on page 105
• neighbor default-originate on page 106
• neighbor description on page 107
• neighbor disallow-infinite-holdtime on page 108
• neighbor distribute-list on page 109
• neighbor dont-capability-negotiate on page 110
• neighbor ebgp-multihop on page 111
• neighbor enforce-multihop on page 112
• neighbor fall-over on page 113
• neighbor filter-list on page 114
• neighbor local-as on page 115
• neighbor maximum-prefix on page 116
• neighbor next-hop-self on page 117
• neighbor override-capability on page 118
• neighbor passive on page 119
• neighbor peer-group on page 120
• neighbor port on page 121
• neighbor prefix-list on page 122
• neighbor remote-as on page 123
• neighbor remove-private-AS on page 124
• neighbor restart-time on page 125
• neighbor route-map on page 126
• neighbor route-reflector-client on page 127
• neighbor route-server-client on page 128
• neighbor send-community on page 129
• neighbor shutdown on page 130
• neighbor soft-reconfiguration on page 131
• neighbor strict-capability-match on page 132
17
BGP Commands
• neighbor timers on page 133
• neighbor transparent-as on page 134
• neighbor transparent-nexthop on page 135
• neighbor unsuppress-map on page 136
• neighbor update-source on page 137
• neighbor version on page 138
• neighbor weight on page 139
• network on page 140
• redistribute on page 142
• restart bgp graceful on page 143
• router bgp on page 144
• router bgp view on page 145
• set-overload-bit on page 146
• synchronization on page 147
• timers bgp on page 148
• undebug bgp on page 149
18
BGP Commands
address-familyUse the address family command to enter the IPv4, IPv6 or VPNv4/v6 address family mode allowing configuration of address-family specific parameters. To leave the address family mode and return to the Configure mode use the exit-address-family command.
Use the no parameter with this command to disable this function.
Command Syntaxaddress-family [ipv4 multicast|unicast|vrf NAME] [ipv6 unicast|labeled-unicast|vrf NAME] [vpnv4 unicast] [vpnv6 unicast]
no address-family [ipv4 (vrf NAME)] [ipv6 (vrf NAME)]
Parametersipv4 Specify the IPv4 address family
ipv6 Specify the IPv6 address family
vpnv4 Specify the VPNv4 address family
vpnv6 Specify the VPNv6 address family
multicast Specify multicast as an address family modifier for IPv4
unicast Specify unicast as an address family modifier
labeled-unicast
Specify labeled-unicast as an address family modifier for IPv6
vrf Specify a VPN routing/forwarding instance for IPv4 or IPv6
NAME VPN routing/forwarding instance name
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 7657ZebOS(config-router)#neighbor 3ffe:506::1 remote-as 7657ZebOS(config-router)#neighbor 3ffe:506::1 interface eth1
ZebOS#configure terminalZebOS(config)#router bgp 7657ZebOS(config-router)#address-family ipv6ZebOS(config-router-af)#neighbor 3ffe:506::1 activateZebOS(config-router-af)#exit-address-family
Related Commandsexit, exit-address-family
19
BGP Commands
aggregate-addressUse this command to configure BGP aggregate entries.
Aggregates are used to minimize the size of routing tables. Aggregation combines the characteristics of several different routes and advertises a single route.The aggregate-address command creates an aggregate entry in the BGP routing table if any more-specific BGP routes are available in the specified range. Using the summary-only parameter advertises the prefix only, suppressing the more-specific routes to all neighbors. In the following example Router1 will propagate network 172.0.0.0 and suppresses the more specific route 172.10.0.0.
The as-set parameter creates an aggregate entry advertising the path for this route, consisting of all elements contained in all paths being summarized. Use this parameter to reduce the size of path information by listing the AS number only once, even if it was included in multiple paths that were aggregated. The as-set parameter is useful when aggregation of information results in an incomplete path information.
Use the no parameter with this command to disable this function.
Command Syntaxaggregate-address [A.B.C.D/M as-set|summary-only]
no aggregate-address A.B.C.D/M [as-set|summary-only]
ParametersA.B.C.D/M Specify the aggregate prefix.
as-set Generate AS set path information.
summary-only Filter more specific routes from updates.
DefaultDisabled
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#aggregate-address 10.0.0.0/8 as-set summary-only
ZebOS(config)#router bgp 100ZebOS(config-router)#no aggregate-address 10.0.0.0/8 as-set summary-only
20
BGP Commands
auto-summaryUse this command to enable sending summarized routes by a BGP speaker to its peers in the router configuration mode or in the address-family configuration mode. Auto-summary is used by a BGP router to advertise summarized routes to its peers. Auto-summary can be enabled if certain routes have already been advertised: in this case, configuring auto-summary advertises the summarized routes first, then corresponding non-summarized routes are withdrawn. If certain routes have already been advertised, and auto-summary is disabled, non-summarized routes are first advertised, then the corresponding summarized routes are withdrawn from all the connected peers.
Use the no parameter with this command to disable this function.
Command Syntaxauto-summary
no auto-summary
ParametersNone
DefaultDisabled
Command ModeRouter mode and Address Family IPv4 mode
ExamplesThe following example enables auto-summary in Router mode.
ZebOS#configure terminalZebOS(config)#router bgp 11ZebOS(config-router)#auto-summary
The following example enables auto-summary in the IPv4 address family.
ZebOS#configure terminalZebOS(config)#router bgp 1ZebOS(config)#address-family ipv4ZebOS(config-af)#auto-summary
21
BGP Commands
bgp aggregate-nexthop-checkUse this command to set the BGP option to perform aggregation only when next-hop matches the specified IP address.
Use the no parameter with this command to disable this function.
Command Syntaxbgp aggregate-nexthop-check
no bgp aggregate-nexthop-check
ParametersNone
DefaultDisabled
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#bgp aggregate-nexthop-check
22
BGP Commands
bgp always-compare-medUse this command to compare the Multi Exit Discriminator (MED) for paths from neighbors in different autonomous systems. Multi Exit Discriminator (MED) is used in best path selection by BGP. MED is compared after BGP attributes weight, local preference, AS-path and origin have been compared and are equal. MED comparison is done only among paths from the same autonomous system (AS). Use bgp always-compare-med command to allow comparison of MEDs from different ASs. The MED parameter is used to select the best path. A path with lower MED is preferred. If the bgp table shows the following and the always-compare-med is enabled:
Route1: as-path 400, med 300Route2: as-path 200, med 200Route3: as-path 400, med 250
Route1 is compared to Route2. Route2 is best of the two (lower MED). Next, Route2 is compared to Route3 and Route2 is chosen best path again (lower MED). If always-compare-med was disabled, MED is not taken into account when Route1 and Route2 are compared, because of different ASs and MED is compared for only Route1 and Route3. In this case, Route3 would be the best path. The selected route is also affected by the bgp deterministic-med command. Please see bgp deterministic-med command for details. If this command is used to compare MEDs for all paths, it should be configured on every BGP router in the AS.
Use the no parameter with this command to disallow the comparison.
Command Syntaxbgp always-compare-med
no bgp always-compare-med
ParametersNone
DefaultDisabled
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp always-compare-med
23
BGP Commands
bgp as-local-countUse this command to set the number of times the local-AS (Autonomous System) is to be prepended.
Use the no parameter with this command to disable this command.
Command Syntaxbgp as-local-count <2-64>
no bgp as-local-count <2-64>
Parameter<2-64> Set the number of times the local-AS is to be prepended
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp as-local-count 55
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp as-local-count 55
24
BGP Commands
bgp bestpath as-pathUse this command to prevent the router from considering as-path as a factor in the algorithm for choosing a route.
Use the no parameter with this command to allow the router to consider as-path in choosing a route.
Command Syntaxbgp bestpath as-path [ignore]
no bgp bestpath as-path [ignore]
Parametersignore Choose to ignore as-path length when selecting a route
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath as-path ignore
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp bestpath as-path ignore
25
BGP Commands
bgp bestpath compare-confed-aspathUse this command to allow comparing of the confederation AS path length. This command specifies that the AS confederation path length must be used when available in the BGP best path decision process. It is effective only when bgp bestpath as-path ignore command has not been used
Use the no parameter with this command to revert the selection and ignore AS confederation path length in the BGP best path selection.
Command Syntaxbgp bestpath compare-confed-aspath
no bgp bestpath compare-confed-aspath
ParametersNone
DefaultBGP receives routes with identical eBGP paths from eBGP peers and selects the first route received as the best path.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath compare-confed-aspath
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp bestpath compare-confed-aspath
Related Commandsbgp bestpath as-path ignore
26
BGP Commands
bgp bestpath compare-routeridUse this command to compare router-id for identical eBGP paths. When comparing similar routes from peers the BGP router does not consider router ID of the routes. By default, it selects the first received route. Use this command to include router ID in the selection process; similar routes are compared and the route with lowest router ID is selected. The router-id is the highest IP address on the router, with preference given to loopback addresses. Router-id can be manually set by using the bgp router-id command.
Use the no parameter with this command to disable this function.
Command Syntaxbgp bestpath compare-routerid
no bgp bestpath compare-routerid
ParametersNone
DefaultBGP receives routes with identical eBGP paths from eBGP peers and selects the first route received as the best path.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath compare-routerid
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp bestpath compare-routerid
Related Commandsshow ip bgp, show ip bgp neighbors
27
BGP Commands
bgp bestpath dont-compare-originator-idUse this command to compare “not” an originator-ID for an identical EBGP path.
Use the no parameter with this command to disable this function.
Command Syntaxbgp bestpath dont-compare-originator-id
no bgp bestpath dont-compare-originator-id
ParametersNone
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath dont-compare-originator-id
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp bestpath dont-compare-originator-id
Related Commandsshow ip bgp, show ip bgp neighbors
28
BGP Commands
bgp bestpath medUse this command to specify two MED (Multi Exit Discriminator) attributes--confed and missing-as-worst. The confed attribute enables MED comparison among paths learned from confederation peers. The MEDs are compared only if there is no external Autonomous System (an AS not within the confederation) in the path. If there is an external autonomous system in the path, the MED comparison is not made. For example in the following paths, the MED is not compared with Route3 as it is not in the confederation. MED is compared for Route1 and Route2 only.
Path1 = 32000 32004, med=4Path2 = 32001 32004, med=2Path3 = 32003 1, med=1
The missing-as-worst attribute to consider a missing MED attribute in a path as having a value of infinity, making the path without a MED value the least desirable path. If missing-as-worst is disabled, the missing MED is assigned the value of 0, making the path with the missing MED attribute the best path.
Use the no parameter with this command to prevent BGP from considering the MED attribute in comparing paths.
Command Syntaxbgp bestpath med [confed missing-as-worst)|missing-as-worst (confed)|remove-recv-med|remove-send-med]
no bgp bestpath med [confed (missing-as-worst)|missing-as-worst (confed)|remove-recv-med|remove-send-med]
Parametersconfed Compares MED among confederation paths
missing-as-worst
Treats missing MED as the least preferred one
remove-recv-med To remove rcvd MED attribute
remove-send-med To remove send MED attribute
Command ModeRouter mode
DefaultMED value is zero.
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath med missing-as-worst
ZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath med remove-recv-medZebOS(config-router)#no bgp bestpath med remove-recv-med
ZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath med remove-send-medZebOS(config-router)#no bgp bestpath med remove-send-med
29
BGP Commands
bgp bestpath tie-break-on-ageUse this command to select always the older preferred route even when the compare-route-id command is set.
Use the no parameter with this command to disable this function.
Command Syntaxbgp bestpath tie-break-on-age
no bgp bestpath tie-break-on-age
ParametersNone
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp bestpath dont-compare-originator-id
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp bestpath dont-compare-originator-id
Related Commandsshow ip bgp, show ip bgp neighbors
30
BGP Commands
bgp client-to-client reflectionUse this command to configure routers as route reflectors. Route reflectors are used when all Interior Border Gateway Protocol (iBGP) speakers are not fully meshed. If the clients are fully meshed the route reflector is not required, use no bgp client-to-client reflection command to disable the client-to-client route reflection.
Use the no parameter with this command to turn off client-to-client reflection.
Command Syntaxbgp client-to-client reflection
no bgp client-to-client reflection
ParametersNone
DefaultWhen a router is configured as a route reflector, client-to-client reflection is enabled by default.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp client-to-client reflection
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp client-to-client reflection
Related Commandsbgp cluster-id, neighbor route-reflector-client, show ip bgp
31
BGP Commands
bgp cluster-idUse this command to configure the cluster ID if the BGP cluster has more than one route reflector. A cluster includes route reflectors and its clients. Usually, each cluster is identified by the router ID of its single route reflector but to increase redundancy sometimes a cluster may have more than one route reflector. All router reflectors in such a cluster are then identified by a cluster ID. The bgp cluster-id command is used to configure the 4 byte cluster ID for clusters with more than one route reflectors.
Use the no parameter with this command (without any arguments) to remove the cluster ID.
Command Syntaxbgp cluster-id [<1-4294967295>|A.B.C.D]
no bgp cluster-id
Parameters<1-4294967295> Specify the cluster ID of this router acting as a route reflector, either as IP address or as a
maximum of 4 bytes
A.B.C.D Set the route reflector cluster-ID as an IP address
Command ModeRouter mode
ExamplesThe following configuration creates a cluster-id 5 including two route-reflector-clients.
ZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#neighbor 2.2.2.2 remote-as 200ZebOS(config-router)#neighbor 3.3.3.3 remote-as 200ZebOS(config-router)#neighbor 3.3.3.3 route-reflector-clientZebOS(config-router)#neighbor 5.5.5.5 remote-as 200ZebOS(config-router)#neighbor 5.5.5.5 route-reflector-clientZebOS(config-router)#neighbor 6.6.6.6 remote-as 200ZebOS(config-router)#bgp cluster-id 5
Related Commandsbgp client-to-client reflection, neighbor route-reflector-client, show ip bgp
32
BGP Commands
bgp confederation identifierUse this command to specify a BGP confederation identifier.
Use the no parameter with this command to remove the BGP confederation identifier.
Command Syntaxbgp confederation identifier <1-65535>
no bgp confederation identifier
Parameter<1-65535> Set the routing domain confederation AS number
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp confederation identifier 1
Related Commandsbgp confederation peers
33
BGP Commands
bgp confederation peersUse this command to configure the Autonomous Systems (AS) that belong to a confederation. A confederation allows an AS to be divided into several ASs. The AS is given a confederation identifier. External routers view only the whole confederation as one AS. Each AS is fully meshed within itself and is visible internally to the confederation.
Use the no parameter with this command to remove an autonomous system from the confederation.
Command Syntaxbgp confederation peers <1-65535>
no bgp confederation peers <1-65535>
Parameter<1-65535> AS numbers of eBGP peers that are under same confederation but in a different sub-AS
Command ModeRouter mode
ExamplesIn the following configuration example, the neighbor 172.210.30.2 and 172.210.20.1 have iBGP connection within AS 100, neighbor 173.213.30.1 is a BGP connection with a confederation peer 200 and neighbor 6.6.6.6 has an eBGP connection to external AS 300.
ZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp confederation identifier 300ZebOS(config-router)#bgp confederation peer 200ZebOS(config-router)#neighbor 172.210.30.2 remote-as 100ZebOS(config-router)#neighbor 172.210.20.1 remote-as 100ZebOS(config-router)#neighbor 173.213.30.1 remote-as 200ZebOS(config-router)#neighbor 6.6.6.6 remote-as 300
In this configuration, the neighbor 5.5.5.4 has an eBGP connection to confederation 300.
ZebOS#configure terminalZebOS(config)#router bgp 500ZebOS(config-router)#neighbor 5.5.5.4 remote-as 300
Related Commandsbgp confederation identifier
34
BGP Commands
bgp config-typeUse this command to set the BGP configuration to the standard type. After setting the configuration to be the standard type, make sure to use the neighbor send-community command to send out BGP community attributes. The zebos configuration type is the default and requires no specific configuration for sending out BGP standard community and extended community attributes. For the standard type, the no synchronization command is always shown in the configuration, whereas for the zebos type, this command is the default.
Use the no parameter with this command to remove this configuration.
Command Syntaxbgp config-type [standard|zebos]
no bgp config-type
Parametersstandard Specify the industry-standard style configuration
zebos Specify the ZebOS-style configuration
DefaultThe default configuration type is: bgp config-type zebos
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#bgp config-type standard
Related Commandsneighbor send-community
35
BGP Commands
bgp dampeningUse this command to set the bgp route dampening parameters. Route dampening minimizes the instability caused by route flapping. A penalty is added for every flap in a flapping route. As soon as the total penalty reaches the suppress limit the advertisement of the route is suppressed. This penalty is decayed according to the configured half time value. Once the penalty is lower than the reuse limit, the route advertisement is un-suppressed. The dampening information is purged from the router once the penalty becomes less than half of the reuse limit.
Use the no parameter with this command to unset the bgp dampening parameters.
Command Syntaxbgp dampening [route-map (WORD)] [<1-45>] [<1-20000>|<1-20000>|<1-255>|<1-45>]
no bgp dampening [route-map (WORD)] [<1-45>] (<1-20000>|<1-20000>|<1-255>|<1-45>]
Parametersroutemap Route-map to specify criteria for dampening.
WORD Specify the name of the route-map.
<1-45> Specify the reachability half-life time in minutes. The time for the penalty to decrease to one-half of its current value. The default is 15 minutes.
<1-20000> Specify the reuse limit value. When the penalty for a suppressed route decays below the reuse value, the routes become unsuppressed.
<1-20000> Specify the suppress limit value. When the penalty for a route exceeds the suppress value, the route is suppressed.
<1-255> Specify the max-suppress-time. Maximum time that a dampened route is suppressed.
<1-45> Specify the un-reachability half-life time for penalty, in minutes.
DefaultsThe default reachability half-time is 15 minutes.
The default reuse limit value is 750.
The default suppress limit is 2000.
The default max-suppress value is four times the half-life time, or 60 minutes.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 11ZebOS(config-router)#bgp dampening 20 800 2500 80 25
36
BGP Commands
bgp default ipv4-unicastUse this command to configure BGP defaults and activate IPv4-unicast for a peer by default. This affects the BGP global configuration
Use the no parameter with this command to disable the default behavior of the BGP routing process of exchanging IPv4 addressing information with BGP neighbor routers.
Command Syntaxbgp default ipv4-unicast
no bgp default ipv4-unicast
ParametersNone
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp default ipv4-unicast
37
BGP Commands
bgp default local-preferenceUse this command to change the default local preference value.Local preference indicates the preferred path when there are multiple paths to the same destination. The path having a higher preference is preferred. The preference is sent to all routers and access servers in the local autonomous system.
Use the no parameter with this command to revert to the default setting.
Command Syntaxbgp default local-preference <0-4294967295>
no bgp default local-preference <0-4294967295>
Parameter<0-4294967295> Range of values to configure a local preference value.
DefaultThe default local preference value is 100.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp default local-preference 2345555
Related Commandsset local-preference
38
BGP Commands
bgp deterministic medUse this command to have the software compare the Multi Exit Discriminator (MED) variable when choosing among routes advertised by different peers in the same autonomous system. MED is used in best path selection by BGP. MED is compared after BGP attributes weight, local preference, AS-path and origin have been compared and are equal.
For a correct comparison result, enable this command on all routers in a local AS. After enabling this command, all paths for the same prefix are grouped together and arranged according to their MED value. Based on this comparison, the best path is then chosen. This command compares MED variable when choosing routes advertised by different peers in the same AS, to compare MED, when choosing routes from neighbors in different ASs use the bgp always-compare-med command.
When the bgp deterministic-med command is enabled, routes from the same AS are grouped together, and the best routes of each group are compared. If the BGP table showed:
Route1: as-path 200, med 300, internalRoute2: as-path 400, med 200, internalRoute3: as-path 400, med 250, external
BGP would have a group of Route1 and a second group of Route2 and Route3 (the same ASs). The best of each group is compared. Route1 is the best of its group because it is the only route from AS 200. Route1 is compared to the Route2, the best of group AS 400 (the lower MED). Since the two routes are not from the same AS, the MED is not considered in the comparison. The external BGP route is preferred over the internal BGP route, making Route3 the best route; the preferred route would be different if always-compare-med command is enabled (See always-compare-med command).
Use the no parameter with this command to disallow this setting.
Command Syntaxbgp deterministic-med
no bgp deterministic-med
ParametersNone
DefaultDisabled
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp deterministic-med
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp deterministic-med
Related Commandsshow ip bgp, show ip bgp neighbors
39
BGP Commands
bgp enforce-first-asUse this command to enforce the first AS for the eBGP routes. This command specifies that any updates received from an external neighbor that do not have the neighbor’s configured Autonomous System (AS) at the beginning of the AS_PATH in the received update must be denied. Enabling this feature adds to the security of the BGP network by not allowing traffic from unauthorized systems.
Using the no parameter with this command to disable this feature.
Command Syntaxbgp enforce-first-as
no bgp enforce-first-as
ParametersNone
Command Mode Router mode
ExamplesZebOS#configure terminal ZebOS(config)#router bgp 100ZebOS(config-router)#bgp enforce-first-as
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp enforce-first-as
40
BGP Commands
bgp extended-asn-capUse this command to configure a BGP router to send 4-octet ASN capabilities.
Use the no parameter with this command to prevent a BGP router from sending 4-octet ASN capabilities.
Command Syntaxbgp extended-asn-cap
no bgp extended-asn-cap
ParametersNone
DefaultDisabled
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#bgp extended-asn-cap
41
BGP Commands
bgp fast-external-failoverUse this command to reset a BGP session immediately, if the interface used for BGP connection goes down.
Use the no parameter with this command to disable this feature.
Command Syntaxbgp fast-external-failover
no bgp fast-external-failover
ParametersNone
DefaultEnabled
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp fast-external-failover
42
BGP Commands
bgp graceful-restartUse this command to enable BGP graceful-restart capabilities. The restart-time parameter is used for setting the maximum time that a graceful-restart neighbor waits to come back up after a restart. This value is applied to all neighbors unless you explicitly override it by configuring the corresponding value on the neighbor. The stalepath-time parameter is used to set the maximum time to preserve stale paths from a gracefully restarted neighbor. All stalepaths, unless reinstated by the neighbor after a re-establishment, will be deleted at the expiration of this timer.
Use the no parameter with this command to restore the router to its default state.
Command Syntaxbgp graceful-restart [graceful-reset|restart-time <1-3600>|stalepath-time <1-3600>]
no bgp graceful-restart [graceful-reset|restart-time|stalepath-time]
Parametersgraceful-reset Sets a graceful-reset capability. This feature provides a graceful restart mechanism for a
BGP session reset in which the BGP daemon is not restarted, so that any changes in network configurations that cause BGP reset do not affect packet forwarding.
restart-time Maximum time needed for neighbors to restart.
<1-3600> Range of values for restart-time, in seconds.
stalepath-time Maximum time to retain stale paths from restarting neighbors.
<1-3600> Range of values for stalepath-time, in seconds.
DefaultThe default restart time is 120 seconds.
The default stalepath-time is 360 seconds.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#bgp graceful-restart restart-time 150ZebOS(config-router)#bgp graceful-restart graceful-reset
43
BGP Commands
bgp inbound-route-filterUse this command to enable the MPLS (Multiprotocol Label Switching) VPN/BGP inbound route filter.
Use the no parameter with this command to disable this feature.
Command Syntaxbgp inbound-route-filter
no bgp inbound-route-filter
ParametersNone
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp inbound-route-filter
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp inbound-route-filter
44
BGP Commands
bgp log-neighbor-changesUse this command to enable logging of status change messages without turning on debug bgp commands. ZebOS has many logging services for neighbor status, including debug bgp fsm and debug bgp events. However, these commands create a significant hit in system performance. If you need to log neighbor status changes only, F5 Networks recommends turning off all the debug commands and using the bgp log-neighbor-changes command.
A sample output of this log is:
%Protocol-Severity-Events: Message-textA sample output of the log for an interface down event is:
%BGP-5-ADJCHANGE: neighbor 10.10.0.24 Down Interface flapThis command logs the following events:
• BGP Notification Received• Erroneous BGP Update Received• User reset request• Peer time-out• Peer Closing down the session• Interface flap• Router ID changed• Neighbor deleted• Member added to peer group• Administrative shutdown• Remote AS changed• RR client configuration modification• Soft reconfiguration modification
Use the no parameter with this command to disable this feature.
Command Syntaxbgp log-neighbor-changes
no bgp log-neighbor-changes
ParametersNone
DefaultDisabled
Command ModeRouter mode
ExampleZebOS(config)#router bgp 100ZebOS(config-router)#bgp log-neighbor-changes
45
BGP Commands
bgp multiple-instanceUse this command to enable or disable the BGP multiple instance support.
Use the no parameter with this command to disable this functionality.
Command Syntaxbgp multiple-instance (allow-same-peer)
no bgp multiple-instance (allow-same-peer)
Parametersallow-same-peer
Allows the same peer to be activated in multiple views.
Note: The no bgp multiple-instance command is not valid if there are any BGP instances present.
DefaultNo multiple-instance support
Command ModeConfigure mode
ExamplesThe following example shows the use of the bgp multiple-instance command allowing the configuration of two instances.
ZebOS(config)#bgp multiple-instance
ZebOS(config)#quitZebOS#show run
Current configuration:hostname ZebOSpassword zebralog stdout!debug bgpdebug bgp eventsdebug bgp updatesdebug bgp fsm!bgp multiple-instance!router bgp 11 bgp router-id 10.10.10.50 neighbor 10.10.10.51 remote-as 11!
46
BGP Commands
bgp nexthop-trigger-countUse this command to configure the display of BGP nexthop-tracking status.
Use the no parameter with this command to disable this functionality.
Command Syntaxbgp nexthop-trigger-count <0-127>
no bgp nexthop-trigger-count <0-127>
Parameter<0-127> The BGP nexthop-tracking status.
Command ModeRouter mode
Example ZebOS(config)#router bgp 100ZebOS(config-router)#bgp nexthop-trigger-count 10
47
BGP Commands
bgp nexthop-trigger delayUse this command to set the delay time for nexthop address tracking. This command configures the delay interval between routing table walks for nexthop delay tracking, after which BGP does a routing table scan on receiving a nexthop change trigger from NSM. The time period determines how long BGP waits before it walks the full BGP table to determine which prefixes are affected by the nexthop changes, after it receives the trigger from NSM about one or more nexthop changes.
Use the no parameter with this command to reset the timer value to the default value.
Command Syntaxbgp nexthop-trigger delay <1-100>
no bgp nexthop-trigger delay
Parameter<1-100> Range of values for delay time, in seconds.
DefaultThe default nexthop delay time is 5 seconds.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#bgp nexthop-trigger delay 6
ZebOS#configure terminalZebOS(config)#no bgp nexthop-trigger delay
48
BGP Commands
bgp nexthop-trigger enableUse this command to enable nexthop address tracking. Nexthop address tracking is an event-driven notification system that monitors the status of routes installed in the Routing Information Base (RIB) and reports nexthop changes that affect internal BGP (iBGP) or external BGP (eBGP) prefixes directly to the BGP process. This improves the overall BGP convergence time, by allowing BGP to respond rapidly to nexthop changes for routes installed in the RIB.
If nexthop tracking is enabled after certain routes are learned, the registration of all nexthops for selected BGP routes is done after the nexthop tracking feature is enabled. If nexthop tracking is disabled, and if there are still some selected BGP routes, BGP de-registers the nexthops of all selected BGP routes from NSM.
Use the no parameter with this command to disable this feature. If the no command is given when nexthop tracking is in the process of execution, an error appears and nexthop tracking is not disabled. However, if the nexthop tracking timer is running at the time of negation, the nexthop tracking timer is stopped, and nexthop tracking is disabled.
Command Syntaxbgp nexthop-trigger enable
no bgp nexthop-trigger enable
ParametersNone
DefaultNexthop tracking is disabled by default, however, when nexthop tracking is enabled, and the delay time interval is not configured, the default nexthop delay time-interval is used, which is 5 seconds.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#bgp nexthop-trigger enable
49
BGP Commands
bgp rfc1771-path-selectUse this command to set RFC1771 compatible path selection mechanism.
Use the no parameter with this command to revert this setting.
Command Syntaxbgp rfc1771-path-select
no bgp rfc1771-path-select
ParametersNone
DefaultIndustry standard compatible path selection mechanism.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#bgp rfc1771-path-select
50
BGP Commands
bgp rfc1771-strictUse this command to set the Strict RFC1771 setting.
Use the no parameter with this command to revert this setting.
Command Syntaxbgp rfc1771-strict
no bgp rfc1771-strict
ParametersNone
DefaultDisabled
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#bgp rfc1771-strict
51
BGP Commands
bgp router-idUse this command to manually configure a fixed router ID as a BGP router identifier.
Use the no parameter with this command to disable this functionality.
Command Syntaxbgp router-id [A.B.C.D]
no bgp router-id [A.B.C.D]
Parameter A.B.C.D A manually configured router ID.
DefaultDisabled
Command ModeRouter mode
DefaultIn case the loopback interface is configured the router-id is set to the IP address of a loopback interface. If not, the highest IP address is the router-id.
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp router-id 1.1.2.3
ZebOS(config)#router bgp 100ZebOS(config-router)#no bgp router-id 1.1.2.3
52
BGP Commands
bgp scan-timeUse this command to configure scanning intervals of BGP routers. This interval is the period after which router checks the validity of the routes in its database. To disable BGP scanning, set the scan-time interval to 0 seconds.
Use the no parameter with this command to disable this functionality.
Command Syntaxbgp scan-time <0-60>
no bgp scan-time <0-60>
Parameter<0-60> Range of values for scan-time, in seconds.
DefaultThe default scan-time interval is 60 seconds.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp scan-time 10
53
BGP Commands
bgp update-delayUse this command to specify the update-delay value for a graceful-restart capable router. The update-delay value is the maximum time a graceful-restart capable router, which is restarting, will defer route-selection and advertisements to all its graceful-restart capable neighbors. This maximum time starts from the instance the first neighbor attains established state after restart. The restarting router prematurely terminates this timer when end-of-rib markers are received from all its graceful-restart capable neighbors.
Use the no parameter with this command to revert to the default update-delay value.
Command Syntaxbgp update-delay <1-3600>
no bgp update-delay <1-3600>
Parameters<1-3600> Range of values for update-delay, in seconds.
DefaultThe default update-delay value is 120 seconds.
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#bgp update-delay 345
54
BGP Commands
clear bgp *Use this command to reset the BGP connection for all peers.
Command Syntaxclear bgp * [in (prefix-filter)|out|soft (in|out)]
Parametersin Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp * soft in
55
BGP Commands
clear bgp <1-4294967295>Use this command to reset the BGP connection for peers in the specified Autonomous System.
Command Syntaxclear bgp <1-4294967295> [in (prefix-filter)|out|soft (in|out)]
Parameters<1-4294967295> Range of values for Autonomous System
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp 300 in prefix-filterZebOS#clear bgp 300 soft inZebOS#clear bgp 1 in prefix-filter
56
BGP Commands
clear bgp A.B.C.DUse this command to reset the BGP neighbor addresses to clear.
Command Syntaxclear bgp A.B.C.D [in (prefix-filter)|out|soft (in|out)]
ParametersA.B.C.D Neighbor address in IPv4 address format
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp 3.3.3.3 in prefix-filter
57
BGP Commands
clear bgp X:X::X:XUse this command to reset the BGP IPv6 neighbor addresses to clear.
Command Syntaxclear bgp X:X::X:X[in (prefix-filter)|out|soft (in|out)]
ParametersX:X::X:X Neighbor address in IPv6 format
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp 12:3::4:1 in prefix-filter
58
BGP Commands
clear bgp externalUse this command to reset the BGP connection for all external peers.
Command Syntaxclear bgp external [in (prefix-filter)|out|soft (in|out)]
Parametersin Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp external soft in
59
BGP Commands
clear bgp ipv4Use this command to reset the BGP connection for IPv4.
Command Syntaxclear bgp ipv4 [multicast|unicast (dampening|flap-statistics A.B.C.D|A.B.C.D/M]
Parametersmulticast Sets the address family modifier to multicast
unicast Sets the address family modifier to unicast
dampening Clears route flap dampening information
flap-statistics
Clears route flap statistics
A.B.C.D Indicates the IP prefix <network> (for example, 35.0.0.0)
A.B.C.D/M Indicates the IP prefix <network>/<length> (for example, 35.0.0.0/8)
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp ipv4 unicast dampening 1.1.1.1
60
BGP Commands
clear bgp peer-groupUse this command to reset the BGP connection for all members of a peer group.
Command Syntaxclear bgp peer-group [WORD|in prefix-filter|out|soft in|out]
ParametersWORD BGP peer-group name
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExamplesZebOS#clear bgp peer-group P1 soft in
61
BGP Commands
clear bgp viewUse this command to reset all BGP connections.
Command Syntaxclear bgp view [WORD|*|soft (in|out)]
ParametersWORD BGP view name
* Clear all peers
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ExamplesZebOS#clear bgp view instance1 * soft in
62
BGP Commands
clear ip bgp *Use this command to reset a BGP connection for all peers.
Command Syntaxclear ip bgp * [in (prefix-filter)] [ipv4 (multicast|unicast)|in (prefix-filter)|out|soft in|out] [out] [ipv6 (multicast|unicast)|in {prefix-filter}|out|soft {in|out}] [out] [soft (in|out)] [vpnv4 (unicast|in|out|soft (in|out)] [vpnv6 (unicast|in|out|soft (in|out)] [vrf (WORD)|in|out|soft (in|out)]
Parametersin Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
ipv4 Reset connection for address family IPv4
multicast Sets the address-family modifier to multicast
unicast Sets the address-family modifier to unicast
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
ipv6 Reset connection for address family IPv6
multicast Sets the address-family modifier to multicast
unicast Sets the address-family modifier to unicast
in Indicates that incoming advertised routes should be cleared
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
63
BGP Commands
vpnv4 Clear all VPNv4 address family peers (see clear ip bgp * vpn).
vpnv6 Clear all VPNv6 address family peers (see clear ip bgp * vpn).
vrf VPN routing/forwarding instance (see clear ip bgp * vpn).
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp * ZebOS#clear ip bgp * ipv4 unicast in prefix-filter ZebOS#clear ip bgp * vpnv6 unicast in
64
BGP Commands
clear ip bgp <1-4294967295>Use this command to reset a BGP connection for all peers in a specified Autonomous System.
Command Syntaxclear ip bgp <1-4294967295> [in (prefix-filter)] [ipv4 (multicast|unicast)|in {prefix-filter}|out|soft {in|out}] [out] [ipv6 (multicast|unicast)|in {prefix-filter}|out|soft {in|out}] [out] [soft (in|out)] [vpnv4 (unicast|in|out|soft (in|out)] [vpnv6 (unicast|in|out|soft (in|out)]
Parameters<1-4294967295> Range of values for Autonomous System ID
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
ipv4 Reset connection for address family IPv4
multicast Sets the address-family modifier to multicast
unicast Sets the address-family modifier to unicast
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
ipv6 Reset connection for address family IPv6
multicast Sets the address-family modifier to multicast
unicast Sets the address-family modifier to unicast
in Indicates that incoming advertised routes should be cleared
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
65
BGP Commands
out Indicates soft reconfiguration outbound update
vpnv4 Clear all VPNv4 address family peers (see clear ip bgp <1-4294967295> vpn).
vpnv6 Clear all VPNv6 address family peers (see clear ip bgp <1-4294967295> vpn).
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp 100ZebOS#clear ip bgp 200 ipv4 unicast in prefix-filter
66
BGP Commands
clear ip bgp A.B.C.DUse this command to reset an IPv4 BGP connection for a specific IPv4 address.
Command Syntaxclear ip bgp A.B.C.D [in (prefix-filter)] [ipv4 (multicast|unicast)|in (prefix-filter)|out|soft (in|out)] [out] [out] [soft (in|out)] [vpnv4 (unicast|in|out|soft (in|out)] [vrf (WORD)|in|out|soft (in|out)]
ParametersA.B.C.D IPv4 address of connection to reset
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
ipv4 Indicates that incoming advertised routes should be cleared
multicast Sets the address-family modifier to multicast
unicast Sets the address-family modifier to unicast
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update.
vpnv4 Clears all VPNv4 address family peers (see clear ip bgp A.B.C.D vpn).
unicast Sets the address-family modifier to unicast
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update.
vrf VPN routing/forwarding instance (see clear ip bgp A.B.C.D vpn).
WORD VPN routing/forwarding instance name
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
soft Indicates that both incoming and outgoing routes should be cleared
67
BGP Commands
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp 10.10.0.12 softZebOS#clear ip bgp 10.10.0.10 in prefix
68
BGP Commands
clear ip bgp X:X::X:XUse this command to reset an IPv6 BGP connection for a specific IP address.
Command Syntaxclear ip bgp X:X::X:X [in (prefix-filter)] [out] [out] [soft (in|out)] [vpnv6 (unicast|in|out|soft (in|out)]
ParametersX:X::X:X IPv6 address of the connection to reset.
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
vpnv6 Clears all VPNv6 address family peers (see clear ip bgp X:X::X:X vpn).
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp 10:10::0:12 softZebOS#clear ip bgp 10:10::0:10 vpnv6 unicast out
69
BGP Commands
clear ip bgp dampeningUse this command to reset all dampened BGP routes under the specified address family.
Command Syntaxclear ip bgp dampening [A.B.C.D|A.B.C.D/M]
ParametersA.B.C.D The IP prefix <network> (for example, 35.0.0.0)
A.B.C.D/MThe IP prefix <network>/<length> (for example, 35.0.0.0/8)
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp dampening 10.10.0.121ZebOS#clear ip bgp ipv4 unicast dampening
70
BGP Commands
clear ip bgp externalUse this command to reset a BGP connection for all external peers.
Command Syntaxclear ip bgp external [in (prefix-filter)] [ipv4 (multicast|unicast)|in {prefix-filter}|out|soft {in|out}] [out] [out] [soft (in|out)]
Parametersin Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
ipv4 Indicates that incoming advertised routes should be cleared
multicast Sets the address family modifier to multicast
unicast Sets the address family modifier to unicast.
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp external outZebOS#clear ip bgp external ipv4 unicast in prefix-filter
71
BGP Commands
clear ip bgp flap-statisticsUse this command to clear the flap count and history duration for all the prefixes under the specified address family.
Command Syntaxclear ip bgp flap-statistics [A.B.C.D|A.B.C.D/M]
ParametersA.B.C.D Indicates the IP prefix <network> (for example, 35.0.0.0)
A.B.C.D/M Indicates the IP prefix <network>/<length> (for example, 35.0.0.0/8)
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp flap-statistics 10.10.0.121ZebOS#clear ip bgp ipv4 unicast flap-statistics
72
BGP Commands
clear ip bgp ipv4Use this command to reset the IP BGP connection for either IPv4 unicast or multicast.
Command Syntaxclear ip bgp ipv4 [multicast|unicast] (dampening|flap-statistics) {A.B.C.D|A.B.C.D/M}
Parametersmulticast Sets the address family modifier to multicast
unicast sets the address family modifier to unicast
dampening Clears route flap dampening information
flap-statisticsClears route flap statistics
A.B.C.D The IP prefix <network> (for example, 35.0.0.0)
A.B.C.D/M The IP prefix <network>/<length> (for example, 35.0.0.0/8)
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp ipv4 unicast dampening 1.1.1.1
73
BGP Commands
clear ip bgp ipv6Use this command to reset the IP BGP connection for IPv6.
Command Syntaxclear ip bgp ipv6 [unicast] (dampening|flap-statistics) (X:X::X:X|X:X::X:X/M)
Parametersunicast Sets the address-family modifier to unicast.
dampening Clears route flap dampening information.
flap-statistics
Clears route flap statistics.
X:X::X:X Indicates the IP prefix <network> (for example, 35.0.0.0)
X:X::X:X/M Indicates the IP prefix <network>/<length> (for example, 35.0.0.0/8)
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp ipv6 unicast dampening 1.1.1.1
74
BGP Commands
clear ip bgp peer-groupUse this command to reset a BGP connection for all members of a peer group.
Command Syntaxclear ip bgp external [in (prefix-filter)] [ipv4 (multicast|unicast)|in (prefix-filter)|out|soft (in|out)] [out] [out] [soft (in|out)]
Parametersin Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
ipv4 Indicates that incoming advertised routes should be cleared.
multicast Sets the address-family modifier to multicast
unicast Sets the address-family modifier to unicast
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp peer-group Peer1 outZebOS#clear ip bgp peer-group mypeer ipv4 unicast in prefix-filter
75
BGP Commands
clear ip bgp viewUse this command to reset a BGP IPv4 connection, as well as, to reset the bgp instance for a specified view (WORD); use the clear ip bgp command to reset the default instance.
Command Syntaxclear ip bgp view (WORD) [*|in (prefix-filter)] [ipv4 (multicast|unicast)|in {prefix-filter}|soft {in|out}] [soft (in|out)]
ParametersWORD The BGP peer-group name
* Indicates that all peers should be cleared.
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
ipv4 Indicates that incoming advertised routes should be cleared
multicast Sets the address-family modifier to multicast
unicast Sets the address-family modifier to unicast
in Indicates that incoming advertised routes should be cleared
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp view I4 * in prefix-filterZebOS#clear ip bgp view I2 ipv4 unicast soft in
76
BGP Commands
debug bgpUse this command to enable all BGP troubleshooting functions. Use this command without any parameters to turn on normal bgp debug information.
Use the no parameter with this command to disable this function.
Command Syntaxdebug bgp [all|bfd|dampening|events|filters|fsm|keepalives|mpls|nht|nsm|updates (in|out)]
no debug bgp [all|bfd|dampening|events|filters|fsm|keepalives|mpls|nht|nsm|updates]
Parametersall Used with the no parameter exclusively; turns off all debugging for BGP.
bfd Enable debugging for BGP Bidirectional Forwarding Detection.
dampening Enable debugging for BGP dampening.
events Enable debugging for BGP events.
filters Enable debugging for BGP filters.
fsm Enable debugging for BGP Finite State Machine (FSM).
keepalives Enable debugging for BGP keepalives.
mpls Enable debugging for BGP Multiprotocol Label Switching.
nht Enable debugging for BGP NHT.
nsm Enable debugging for NSM messages.
updates Enable debugging for BGP updates.
in Indicate to debug inbound updates.
out Indicate to debug outbound updates.
Command ModePrivileged Exec mode and Configure Mode
ExamplesZebOS#debug bgpZebOS#debug bgp events
77
BGP Commands
distance bgpUse this command to define an administrative distance. This distance is a rating of trustworthiness of a router. The higher the distance the lower the trust rating. The administrative distance can be set for external, internal and local routes. External paths are routes learned from a neighbor out of the AS. The internal routes are routes learned from another router within the same AS. Local routes are for the router that is being redistributed from another process.
If the administrative distance is changed, it could create inconsistency in the routing table and obstruct routing. Use this command in Router mode to set the administrative distance for all address families. Use this command in Address Family mode to set the administrative distance per an IPv4 or IPv6 family.
Use the no parameter with this command to remove an administrative distance.
Command Syntaxdistance bgp [<1-255>|<1-255>|<1-255>]
no distance bgp [<1-255>|<1-255>|<1-255>]
Parameters<1-255> Range of values for distance for BGP external routes.
<1-255> Range of values for distance for BGP internal routes.
<1-255> Range of values for distance for BGP local routes.
DefaultThe default distance for external routes is 20.
The default distance for internal routes is 200.
The default distance for local routes is 200.
Command ModeRouter mode, Address Family IPv4 mode, and Address Family IPv6 mode
ExamplesThe following example shows how to set the administrative distance for BGP for all address families.
ZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#distance bgp 34 23 15
The following example shows how to set the administrative distance for BGP for an IPv6 address family.
ZebOS(config)#router bgp 100ZebOS(config-router)#address family ipv6ZebOS(config-router-af)#distance bgp 34 23 14
78
BGP Commands
dump bgp allUse this command to dump all BGP packets.
Use the no parameter with this command to disable this functionality.
Command Syntaxdump bgp all PATH [INTERVAL]
no dump bgp all
ParametersPATH Specify the output filename.
INTERVAL Set an interval for dumping BGP packets, either in seconds, or in the HH:MM format.
Command ModeConfigure mode
ExampleZebOS#configure terminalZebOS(config)#dump bgp all /home/ipi/bgp_dump 1H25M
79
BGP Commands
dump bgp routes-mrtUse this command to dump the entire BGP routing table.
Use the no parameter with this command to disable this functionality.
Command Syntaxdump bgp routes-mrt [PATH|INTERVAL]
no dump bgp routes-mrt
ParametersPATH Specify the output filename.
INTERVAL Set an interval for dumping BGP packets, either in seconds, or in the HH:MM format.
Command ModeConfigure mode
ExampleZebOS#configure terminalZebOS(config)#dump bgp route-mrt /home/ipi/bgp_routes 20m
80
BGP Commands
dump bgp updatesUse this command to dump BGP updates only.
Use the no option with this command to disable this functionality.
Command Syntaxdump bgp updates PATH [INTERVAL]
no dump bgp updates
ParametersPATH Identify an output file name.
INTERVAL Set an interval for dumping BGP packets, in seconds, or in the HH:MM format
Command ModeConfigure mode
ExampleZebOS#configure terminalZebOS(config)#dump bgp updates /home/ipi/bgp_updates 2h10m
81
BGP Commands
exit-address-familyUse this command to exit the address family mode. See address-family on page 19 for the steps to enter the address family mode.
Command Syntaxexit-address-family
ParametersNone
Command ModeAddress Family mode
ExamplesThe following example shows the use of exit-address-family command and the change in the prompt after using this command.
ZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv4 multicastZebOS(config-router-af)#exit-address-familyZebOS(config-router)#
Related Commandsaddress family
82
BGP Commands
ip as-path access-listUse this command to define a BGP Autonomous System (AS) path access list. A named community list is a filter based on regular expressions. If the regular expression matches the specified string representing the AS path of the route, then the permit or deny condition applies. Use this command to define the BGP access list globally, use the neighbor router configuration command to apply a specific access list.
Use the no parameter with this command to disable use of the access list.
Command Syntaxip as-path access-list [WORD] (deny|permit) [LINE]
no ip as-path access-list [WORD] (deny|permit) [LINE]
ParametersWORD The name of the access list
deny Denies access to matching conditions
permit Permits access to matching conditions
LINE Specify a regular expression to match the BGP AS paths See Appendix A, Regular Expressions for more details
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip as-path access-list mylist deny ^65535$
83
BGP Commands
ip community-list <1-99> Use this command to specify a standard community list that specifies BGP community attributes.
Use the no parameter with this command to delete the community list entry.
Command Syntaxip community-list <1-99> (deny|permit) {AA:NN|local-AS|no-advertise|no-export}
no ip community-list <1-99> (deny|permit) {AA:NN|local-AS|no-advertise|no-export}
ParametersW<1-99> The community list name value
deny Identify the community to reject
permit Identify the community to accept
AA:NN Enter a valid value for the community number
local-AS Identify which routes are not to be advertised to external BGP peers
no-advertise Identify which routes are not to be advertised to other BGP peers
no-export Identify which routes are not to be advertised outside of the AS boundary
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip community-list 55 permit 7675:80 7675:90
ZebOS(config)#no ip community-list 55 permit 7675:80 7675:90
Related Commandsip community-list standard, ip community-list expanded
84
BGP Commands
ip community-list <100-199>Use this command to specify a expanded community list that specifies BGP community attributes.
Use the no parameter with this command to delete the community list entry.
Command Syntaxip community-list <100-199> (deny|permit) [LINE]
no ip community-list <100-199> (deny|permit) [LINE]
ParametersWORD Specify the name of the access list
deny Denies access to matching conditions
permit Permits access to matching conditions
LINE Specify a regular expression to match the BGP AS paths. See Appendix A, Regular Expressions for more details.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip community-list 125 permit 6789906ZebOS(config)#ip community-list expanded CLIST permit .*
85
BGP Commands
ip community-list WORDUse the community-lists to specify BGP community attributes. The community attribute is used for implementing policy routing. It is an optional, transitive attribute and facilitates transfer of local policies through different autonomous systems. There are two kinds of community-lists: the expanded and standard. The standard community-list defines the community attributes in a specified format and not with regular expressions. The expanded community-list defines the community attributes with regular expressions.
Use the no parameter with this command to delete the community list entry.
Command Syntaxip community-list [WORD] (deny|permit) [AA:NN|local-AS|no-advertise|no-export]
no ip community-list [WORD] (deny|permit) [AA:NN|local-AS|no-advertise|no-export]
ParametersWORD The community list name
deny Identify the community to reject
permit Identify the community to accept
AA:NN Enter a valid value for the community number
local-AS Identify which routes are not to be advertised to external BGP peers
no-advertise Identify which routes are not to be advertised to other BGP peers
no-export Identify which routes are not to be advertised outside of the AS boundary
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip community-list mylist permit 7675:80 7675:90
ZebOS(config)#no ip community-list mylist permit 7675:80 7675:90
Related Commandsip community-list standard, ip community-list expanded
86
BGP Commands
ip community-list expandedUse the community-lists to specify BGP community attributes. The community attribute is used for implementing policy routing. It is an optional, transitive attribute and facilitates transfer of local policies through different autonomous systems. It includes community values that are 32 bits long.
There are two kinds of community-lists: expanded and standard. The standard community-list defines the community attributes in a specified format and not with regular expressions. The expanded community-list defines the community attributes with regular expressions.Use the no parameter with this command to delete the community list entry.
Command Syntaxip community-list [WORD] (deny|permit) [LINE]
no ip community-list [WORD] (deny|permit) [LINE]
ParametersWORD The name of the access list
deny Denies access to matching conditions
permit Permits access to matching conditions
LINE Specify a regular expression to match the BGP AS paths. See Appendix A, Regular Expressions for more details.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip community-list 125 permit 6789906ZebOS(config)#ip community-list expanded CLIST permit .*
Related Commandsip community-list, ip community-list standard
87
BGP Commands
ip community-list standardUse the community-lists to specify BGP community attributes. The community attribute is used for implementing policy routing. It is an optional, transitive attribute and facilitates transfer of local policies through different autonomous systems. It includes community values that are 32 bits long. There are two kinds of community-lists: expanded and standard. The standard community-list defines the community attributes in a specified format without regular expressions. The expanded community-list defines the community attributes with regular expressions.
Use this command to add a standard community-list entry. The standard community-list is compiled into binary format and is directly compared with the BGP communities attribute in the BGP updates. The comparison is faster than the expanded community-list. Any community value that does not match the standard community value is automatically treated as expanded.
Use the no parameter with this command to delete the standard community-list entry.
Command Syntaxip community-list standard [WORD] (deny|permit) [AA:NN|local-AS|no-advertise|no-export]
no ip community-list standard [WORD] (deny|permit) [AA:NN|local-AS|no-advertise|no-export]
ParametersWORD The community list name
deny Identify the community to reject
permit Identify the community to accept
AA:NN Enter a valid value for the community number
local-AS Identify routes that are not to be advertised to external BGP peers
no-advertise Identify routes that are not to be advertised to other BGP peers
no-export Identify routes that are not to be advertised outside of the AS boundary
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip community-list standard CLIST permit 7675:80 7675:90 no-exportZebOS(config)#ip community-list 34 permit 5675:50 no-advertise
Related Commandsip community-list, ip community-list expanded
88
BGP Commands
ip extcommunity-list <1-99>Use this command to create a standard extended community list.
Use the no parameter with this command to delete the community-list entry.
Command Syntaxip extcommunity-list <1-99> (deny|permit) [LINE]
no ip extcommunity-list <1-99> (deny|permit) [LINE]
Parameters<1-99> Standard extended community list number
deny Identify of community to reject
permit Identify of community to accept
LINE Specify a regular expression to match the BGP AS paths. See Appendix A, Regular Expressions for more details.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip extcommunity-list 125 permit 4567335ZebOS(config)#ip extcommunity-list expanded CLIST permit .*
Related Commandsip extcommunity-list standard
89
BGP Commands
ip extcommunity-list <100-199>Use this command to create an expanded extended community list.
Use the no parameter with this command to delete the community-list entry.
Command Syntaxip extcommunity-list <100-199> (deny|permit) [LINE]
no ip extcommunity-list <100-199> (deny|permit) [LINE]
Parameters<100-199> Expanded extended community list number
deny Identify community to reject
permit Identify community to accept
LINE Specify a regular expression to match the BGP AS paths. See Appendix A, Regular Expressions for more details.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip extcommunity-list 125 permit 4567335ZebOS(config)#ip extcommunity-list expanded CLIST permit .*
Related Commandsip extcommunity-list standard
90
BGP Commands
ip extcommunity-list expandedUse this command to create an expanded extended community list.
Use the no parameter with this command to delete the extended community-list entry.
Command Syntaxip extcommunity-list expanded [WORD] (deny|permit) [LINE]
no ip extcommunity-list expanded [WORD] (deny|permit) [LINE]
Parameters<100-199> Expanded extended community list number
deny Identify community to reject
permit Identify community to accept
LINE Specify a regular expression to match the BGP AS paths. See Appendix A, Regular Expressions for more details.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip extcommunity-list 125 permit 4567335ZebOS(config)#ip extcommunity-list expanded CLIST permit .*
Related Commandsip extcommunity-list standard
91
BGP Commands
ip extcommunity-list standardUse this command to create and delete a standard extended-community list. The extended community attribute is 8 bytes in 2 formats. The sub-type can be route target (rt) or site of origin (soo). Thus, the sub-type of each community must be specified when creating the extended community list. Regarding the formats, an extended community is based on the 6 byte value; these 6 bytes are represented in 4btyes:2bytes format:
• Format 1, AA:NN: The 16 bit value of the AS number is represented in higher-order 4 bytes. If the extended ASN capability is enabled, the AS number is represented using higher-order 4 bytes. The NN assigned value is represented in low-order 2 bytes in both cases.
• Format 2, IPaddr:NN: In this format, the higher-order 4 bytes are used to represent the IP address, and the low-order 2 bytes are used to represent the assigned value.
Use the no parameter with this command to delete the extended-community-list entry.
Command Syntaxip extcommunity-list standard [WORD] (deny|permit) [LINE rt|soo]
no ip extcommunity-list standard [WORD] (deny|permit) [LINE rt|soo]
ParametersWORD Standard extended-community list number
deny Identify community to reject
permit Identify community to accept
LINE Specify a regular expression to match the BGP AS paths. See Appendix A, Regular Expressions for more details.
rt Route target extended community in aa:nn or IP addr:nn format OR
soo Site-of-origin extended community in aa:nn or IP addr:nn format.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#ip extcommunity-list 36 permit rt 5675:50ZebOS(config)#ip extcommunity-list standard CLIST permit soo 7645:70
92
BGP Commands
match ip peerUse this command to apply policies based on the route source of which the BGP TCP/IP session formed using an IPv4 address in the update message.
Use the no parameter with this command to disable this function.
Command Syntaxmatch ip peer [<1-199>|<1300-2699>|WORD]
no match ip peer [<1-199>|<1300-2699>|WORD]
Parameters<1-199> Access-list number.
<1300-2699> Expanded range access-list number.
WORD Access-list name.
Command ModeRoute-map mode
ExamplesZebOS#configure terminalZebOS(config)#route-map in-A permit 10ZebOS(route-map)#match ip peer 1
93
BGP Commands
mpls-resolutionUse this command to allow BGP to query the NSM for preexisting LSPs (from RSVP or LDP), enabling BGP to map prefixes to these LSPs. For example, BGP peer (5.5.5.5/32) advertises a prefix 10.10.10.10/32 to the current BGP daemon. If mpls-resolution is enabled, BGP queries NSM to confirm if there is an LSP from current router to 5.5.5.5/32. If yes, BGP installs this IP route into the NSM, and also creates an FTN entry in the NSM. NSM subsequently installs this in the MPLS Forwarder and uses the outgoing label, ifindex and nexthop data of the LSP. This allows IP packets destined for 10.10.10.10/32 to be mapped onto a preexisting MPLS LSP.
If the LSP is already up, the mapping is done while BGP is installing IP routes to the NSM. If the LSP is removed after BGP has already mapped a prefix to an LSP, the mapping is withdrawn from the NSM.
The no mpls-resolution resets all peer information in BGP, and BGP needs to set up connections with its peers again. Since the mpls-resolution flag is not set, no mapping takes place.
Command Syntaxmpls-resolution
no mpls-resolution
ParametersNone
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#mpls-resolution
94
BGP Commands
neighbor activateUse this command to enable the exchange of the specified AF routes with a neighboring router. After the TCP connection is opened with the neighbor, use this command to enable or disable the exchange of the specified AF information with a neighboring router. To enable the exchange of multicast and VPNv4 address prefix types, neighbors are activated using the neighbor activate command in address family mode.
Use the no parameter with this command to disable exchange of information with a neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) activate
no neighbor (A.B.C.D|X:X::X:X|WORD) activate
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeAddress Family mode and Router mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 1.2.3.4 activate
Related Commandsneighbor remote-as
95
BGP Commands
neighbor advertisement-intervalUse this command to set the minimum interval between the sending of BGP routing updates. To reduce the flapping of routes to internet, a minimum advertisement interval is set, so that the BGP routing updates are sent only per interval seconds. BGP dampening can also be used to control the effects of flapping routes.
Use the no parameter with this command to set the interval time to default.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) advertisement-interval <0-600>
no neighbor (A.B.C.D|X:X::X:X|WORD) advertisement-interval <0-600>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<0-600> Range of values for advertisement-interval, in seconds.
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.3 advertisement-interval 45
96
BGP Commands
neighbor allowas-inUse this command to set the Accept As-path to include the AS number.
Use the no parameter with this command to reset to default.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) allowas-in <1-10>
no neighbor (A.B.C.D|X:X::X:X|WORD) allowas-in <1-10>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-10> Number of occurrences of AS number.
Command ModeRouter mode and Address Family mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.3 allowas-in 4
97
BGP Commands
neighbor attribute-unchangedUse this command to advertise unchanged BGP attributes to the specified neighbor.
Use the no parameter with this command to disable this function.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) attribute-unchanged [as-path|next-hop|med]
no neighbor (A.B.C.D|X:X::X:X|WORD) attribute-unchanged [as-path|next-hop|med]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
as-path AS path attribute
next-hop Nexthop attribute
med Multi-exit discriminator attribute
Command ModeRouter mode and Address Family mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.75 attribute-unchanged as-path med
98
BGP Commands
neighbor as-origination-intervalUse this command to set the minimum interval between the sending of AS-origination routing updates.
Use the no parameter with this command to disable this function.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) as-origination-interval <0-600>
no neighbor (A.B.C.D|X:X::X:X|WORD) as-origination-interval <0-600>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<0-600> Range of values for as-origination-interval, in seconds.
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.75 as-origination-interval 555
99
BGP Commands
neighbor capability dynamicUse this command to enable the dynamic capability for a specific peer. This command allows a BGP speaker to advertise or withdraw an address family capability to a peer in a non-disruptive manner.
Use the no parameter with this command to disable the dynamic capability.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) capability dynamic
no neighbor (A.B.C.D|X:X::X:X|WORD) capability dynamic
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
DefaultDisabled
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.10.1 capability dynamic
100
BGP Commands
neighbor capability graceful-restartUse this command to configure the router to advertise the Graceful Restart Capability to the neighbors. This configuration indicates that the BGP speaker has the ability to preserve its forwarding state for the address family when BGP restarts. Use this command to advertise to the neighbor routers the capability of graceful restart. However, users must first specify a neighbor’s remote-as identification number assigned by the neighbor router.
This command is available only when configuration option --enable-restart is enabled when compiling ZebOS.
Note: The graceful restart capability is advertised only when the graceful restart capability has been enabled using the bgp graceful-restart command.
Use the no parameter with this command to configure a router so it does not advertise the Graceful Restart Capability to its neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) capability graceful-restart
no neighbor (A.B.C.D|X:X::X:X|WORD) capability graceful-restart
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
DefaultDisabled
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.10.50 capability graceful-restart
Related Commandsbgp graceful-restart
101
BGP Commands
neighbor capability orfUse this command to enable Outbound Router Filtering (ORF), and advertise the ORF capability to its neighbors. The ORFs send and receive capabilities to lessen the number of updates exchanged between neighbors. By filtering updates, this option minimizes generating and processing of updates. The local router advertises the ORF capability in send mode, and the remote router receives the ORF capability in receive mode applying the filter as outbound policy. The two routers exchange updates to maintain the ORF for each router. Only an individual router or a peer group can be configured to be in receive or send mode. A peer-group member cannot be configured to be in receive or send mode.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) capability orf [prefix-list (both|receive|send)]
no neighbor (A.B.C.D|X:X::X:X|WORD) capability orf [prefix-list (both|receive|send)]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
prefix-list Advertise prefix list ORF capability to this neighbor
both Indicates that the local router can send ORF entries to its peer, as well as receive ORF entries from its peer.
receive Indicates that the local router is willing to receive ORF entries from its peer.
send Indicates that the local router is willing to send ORF entries to its peer.
DefaultDisabled
Command ModeRouter mode and Address Family (IPv4 unicast, IPv4 multicast, IPv6) mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.5 capability orf prefix-list bothZebOS(config-router)#neighbor effe:2897::0003:3ed5 capability orf prefix-list receive
102
BGP Commands
neighbor capability route-refreshUse this command to advertise to peer about route refresh capability support. If route refresh capability is supported, then router can dynamically request that the peer re-advertises its Adj-RIB-Out.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) capability route-refresh
no neighbor (A.B.C.D|X:X::X:X|WORD) capability route-refresh
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
DefaultDisabled
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.10.1 capability route-refresh
103
BGP Commands
neighbor collide-establishedUse this command to specify including a neighbor, already in an established state, for conflict resolution when a TCP connection collision is detected. This command is not required for most network deployments, so users should only use this command when required.
Note: The associated functionality of including an 'established' neighbor into TCP connection collision conflict resolution is automatically enabled when a neighbor is configured for BGP graceful-restart.
Use the no option with this command to turn this feature off.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) collide-established
no neighbor (A.B.C.D|X:X::X:X|WORD) collide-established
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
DefaultDisabled
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 3.3.3.3 collide-established
104
BGP Commands
neighbor connection-retry-timeUse this command to set the connection retry time for a specific BGP neighbor.
Use the no parameter with this command to clear the connection retry time for a specific BGP neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) connection-retry-time <1-65535>
no neighbor (A.B.C.D|X:X::X:X|WORD) connection-retry-time <1-65535>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-65535> Range of values for connection-retry time, in seconds.
DefaultThe default connection-retry time is 120 seconds.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 connection-retry-time 125
105
BGP Commands
neighbor default-originateUse this command to allow a BGP local router to send the default route 0.0.0.0 to a neighbor. This command can be used with standard or extended access lists.
Use the no parameter with this command to send no route as a default.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) default-originate (route-map|WORD)
no neighbor (A.B.C.D|X:X::X:X|WORD) default-originate (route-map|WORD)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
route-map The route-map to specify criteria to originate default routes.
WORD Add a route map name.
DefaultDisabled
Command ModeRouter mode and Address Family (IPv4 unicast, IPv4 multicast, IPv6) mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.10.1 default-originate route-map myroute
106
BGP Commands
neighbor descriptionUse this command to associate a description with a neighbor. This command helps in identifying a neighbor quickly. It is useful for an ISP that has multiple neighbor relationships.
Use the no parameter with this command to remove the description.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) description (LINE)
no neighbor (A.B.C.D|X:X::X:X|WORD) description (LINE)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
LINE Up to 80 characters of text describing the neighbor.
Command ModeRouter mode and Address Family ipv4 vrf mode (if BGP/VPN is supported)
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 1.2.3.4 description Backup router for sales
107
BGP Commands
neighbor disallow-infinite-holdtimeUse this command to disallow configuration of infinite hold-time. This command enables the local BGP speaker to reject a hold-time of “0” seconds from the peer (during exchange of open messages) or the user (during configuration).
Use the no parameter with this command to allow the BGP speaker to accept a hold-time of “0” from the peer or during configuration.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) disallow-infinite-holdtime
no neighbor (A.B.C.D|X:X::X:X|WORD) disallow-infinite-holdtime
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS(config-router)#neighbor 10.11.4.26 disallow-infinite-holdtimeZebOS(config-router)#neighbor 3ffe::45 disallow-infinite-holdtime
108
BGP Commands
neighbor distribute-listUse this command to filter route update from a particular BGP neighbor. Use only one distribute-list per BGP neighbor.
Use the no parameter with this command to remove an entry.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) distribute-list (WORD|<1-199>|<1300-2699>) [in|out]
no neighbor (A.B.C.D|X:X::X:X|WORD) distribute-list (WORD|<1-199>|<1300-2699>) [in|out]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The name of IP access-list
<1-199> An IP access-list number
<1300-2699> An expanded-range IP access-list number.
in Indicates that incoming advertised routes are filtered
out Indicates that outgoing advertised routes are filtered
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 1.2.3.4 distribute-list mylist out
109
BGP Commands
neighbor dont-capability-negotiateUse this command to disable capability negotiation. The capability negotiation is performed by default. This command is used to allow compatibility with older BGP versions that have no capability parameters used in open messages between peers.
Use the no parameter with this command to enable capability negotiation.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) dont-capability-negotiate
no neighbor (A.B.C.D|X:X::X:X|WORD) dont-capability-negotiate
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.34 dont-capability-negotiate
110
BGP Commands
neighbor ebgp-multihopUse this command to accept and attempt BGP connections to external peers on indirectly connected networks. Multihop is not established if the only route to the multihop peer is a default route. This avoids loop formation.
Use the no parameter with this command to return to the default.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) ebgp-multihop <1-255>
no neighbor (A.B.C.D|X:X::X:X|WORD) ebgp-multihop <1-255>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-255> Range of values for maximum hop count.
DefaultIf no maximum hop count is set, the default maximum hop count is 255.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.10.34 remote-as 20ZebOS(config-router)#neighbor 10.10.10.34 ebgp-multihop 5
111
BGP Commands
neighbor enforce-multihopUse this command to turn on the enforcement of eBGP neighbors perform multihop.
Use the no parameter with this command to turn off this feature.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) enforce-multihop
no neighbor (A.B.C.D|X:X::X:X|WORD) enforce-multihop
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.34 remote-as 20ZebOS(config-router)#neighbor 10.10.0.34 enforce-multihop
112
BGP Commands
neighbor fall-overUse this command to configure fall-over detection for BGP.
Use the no parameter with this command to disable this function.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) fall-over (bfd|multihop)
no neighbor (A.B.C.D|X:X::X:X|WORD) fall-over (bfd|multihop)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
bfd Specify bidirectional forwarding detection (BFD)
multihop Enable multihop
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.34 remote-as 20ZebOS(config-router)#neighbor 10.10.0.34 fall-over bfd multihop
113
BGP Commands
neighbor filter-listUse this command to set up a BGP filter. This command specifies an access list filter on updates based on the BGP autonomous system paths. Each filter is an access list based on regular expressions.
Use the no parameter with this command to disable this function.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) filter-list (WORD in|out)
no neighbor (A.B.C.D|X:X::X:X|WORD) filter-list (WORD in|out)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The name of an autonomous system path access list.
in Indicates that incoming advertised routes should be filtered.
out Indicates that outgoing advertised routes should be filtered.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.34 remote-as 20ZebOS(config-router)#neighbor 10.10.0.34 filter-list out in
114
BGP Commands
neighbor local-asUse this command to specify an AS (autonomous system) number to use with BGP neighbor.
Use the no parameter with this command to disable this command.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) local-as <1-4294967295>
no neighbor (A.B.C.D|X:X::X:X|WORD) local-as <1-4294967295>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-4294967295> Range of values for neighbor’s autonomous system (AS) number.
Note: The AS number 23456 is a reserved 2-octet AS number. An old BGP speaker (2-byte implementation) should be configured with 23456 as its remote AS number while peering with a non-mappable new BGP speaker (4-byte implementation).
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 11ZebOS(config-router)#neighbor 10.10.0.34 local-as 12345
115
BGP Commands
neighbor maximum-prefixUse this command to control the number of prefixes that can be received from a neighbor. This command allows the configuration of a specified number of prefixes that a BGP router is allowed to receive from a neighbor. When the warning-only option is not used, if any extra prefixes are received, the router ends the peering. A terminated peer stays down until the clear ip bgp command is used.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) maximum-prefix [<1-4294967295>|<1-100>|warning-only]
no neighbor (A.B.C.D|X:X::X:X|WORD) maximum-prefix [<1-4294967295>|<1-100>|warning-only]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-4294967295> Range of values for the maximum number of prefixes permitted.
<1-100> Specify the threshold value, 1 to 100 percent.
warning-only Only gives a warning message when the limit is exceeded.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 maximum-prefix 1244 warning-only
116
BGP Commands
neighbor next-hop-selfUse this command to configure the router as the next hop for a BGP-speaking neighbor or peer group. This command allows a BGP router to change the nexthop information that is sent to the iBGP peer. The nexthop information is set to the IP address of the interface used to communicate with the neighbor.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) next-hop-self
no neighbor (A.B.C.D|X:X::X:X|WORD) next-hop-self
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 remote-as 100ZebOS(config-router)#neighbor 10.10.0.72 next-hop-self
117
BGP Commands
neighbor override-capabilityUse this command to override a capability negotiation result.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) override-capability
no neighbor (A.B.C.D|X:X::X:X|WORD) override-capability
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 override-capability
118
BGP Commands
neighbor passiveUse this command to set a BGP neighbor as passive.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) passive
no neighbor (A.B.C.D|X:X::X:X|WORD) passive
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 passive
119
BGP Commands
neighbor peer-groupUse this command to add a neighbor to an existing peer-group. Neighbors with the same update policies are grouped into peer groups. This facilitates the updates of various policies, such as, distribute and filter lists. The peer-group is then configured easily with any of the neighbor commands. Any changes made to the peer group affect all members. To create a peer-group use the neighbor peer-group create command and then use this command to add neighbors to the group.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X) peer-group [WORD]
no neighbor (A.B.C.D|X:X::X:X) peer-group [WORD}
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
Example This example shows a new peer-group group1 and the adding of a neighbor 10.10.0.63 to the group.
ZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor group1 peer-group ZebOS(config-router)#neighbor 10.10.0.63 peer-group group1
This example create a peer-group.
ZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor group1 peer-group
120
BGP Commands
neighbor portUse this command to specify the BGP port of a neighbor.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) port <0-65535>
no neighbor (A.B.C.D|X:X::X:X|WORD) port <0-65535>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<0-65535> Range of values for TCP port number.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 port 643
121
BGP Commands
neighbor prefix-listUse this command to specify a prefix list for filtering BGP advertisements. Filtering by prefix list matches the prefixes of routes with those listed in the prefix list. If there is a match, the route is used. An empty prefix list permits all prefixes. If a given prefix does not match any entries of a prefix list, the route is denied access. When multiple entries of a prefix list match a prefix, the entry with the smallest sequence number is considered to be a real match.
The router begins the search at the top of the prefix list, with the sequence number 1. Once a match or deny occurs, the router does not need to go through the rest of the prefix list. For efficiency the most common matches or denies are listed at the top. The neighbor distribute-list command is an alternative to this command and only one of them can be used for filtering to the same neighbor in any direction.
Use the no parameter with this command to remove an entry.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) prefix-list (WORD in|out)
no neighbor (A.B.C.D|X:X::X:X|WORD) prefix-list (WORD in|out)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The number of an AS-path access list.
in Indicate that the access list applies to incoming advertisements.
out Indicate that the access list applies to outgoing advertisements.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#ip prefix-list list1 deny 30.0.0.0/24ZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 prefix-list list1 in
122
BGP Commands
neighbor remote-asThis command establishes BGP peering with a customer edge router.
Use this command to specify a neighbor’s autonomous system number. If the specified ASN matches the ASN number specified in the router bgp global configuration, the neighbor is identified as internal, if not (ASN does not match) then external, to the local AS. The specified neighbor exchanges only unicast address prefixes, unless the neighbor is also activated using the neighbor activate command which allows the exchange of other routing information.
Use the no parameter with this command to delete this peering.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) remote-as <1-4294967295>
no neighbor (A.B.C.D|X:X::X:X|WORD) remote-as <1-4294967295>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-4294967295> Range of values for neighbor’s autonomous system (AS) number.
Note: The AS number 23456 is a reserved 2-octet AS number. An old BGP speaker (2-byte implementation) should be configured with 23456 as its remote AS number while peering with a non-mappable new BGP speaker (4-byte implementation).
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 11ZebOS(config-router)#neighbor 10.10.0.73 remote-as 345ZebOS(config-router)#neighbor 11.11.0.74 remote-as 23456
Note: The last command in the above example should be used when the local speaker is OBGP and the neighbor is NBGP with 4-octet ASN.
123
BGP Commands
neighbor remove-private-ASUse this command to remove the private Autonomous System (AS) number from outbound updates. Private AS numbers are not advertised to the Internet. This command is used with external BGP peers only. The router removes the AS numbers only if the update includes private AS numbers. If the update includes both private and public AS numbers, the system treats it as an error.
Use the no parameter with this command to revert to default.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) remove-private-AS
no neighbor (A.B.C.D|X:X::X:X|WORD) remove-private-AS
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
DefaultDisabled
Command ModeRouter mode and Address Family mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.63 remove-private-AS
124
BGP Commands
neighbor restart-timeUse this command to set a different restart-time other than the global restart-time configured using the bgp graceful-restart command. This command takes precedence over the restart-time value specified using the bgp graceful-restart command. The restart-time value is the maximum time that a graceful-restart neighbor waits to come back up after a restart. The default value is 120 seconds. Make sure that the restart time specified using this command does not exceed the stalepath-time specified in the Router mode.
Use the no parameter with this command to restore the router to its default state.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) restart-time <1-3600>
no neighbor (A.B.C.D|X:X::X:X|WORD) restart-time <1-3600>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-3600> Delay value measured in seconds.
DefaultThe default restart-time is 120 seconds.
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 3.3.3.3 restart-time 45
Related Commandsbgp graceful-restart
125
BGP Commands
neighbor route-mapUse this command to apply a route map to incoming or outgoing routes. This command filters updates and modifies attributes. A route map is applied to inbound or outbound updates. Only the routes that pass the route map are sent or accepted in updates.
Use the no parameter with this command to remove a route map.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) route-map (WORD [in|out])
no neighbor (A.B.C.D|X:X::X:X|WORD) route-map (WORD [in|out])
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD A name for the route-map.
in Indicate that the access list applies to incoming advertisements.
out Indicate that the access list applies to outgoing advertisements.
Command ModeRouter mode and Address Family mode
ExamplesThe following example shows the configuration of the route-map name rmap2 and then the use of this map name in the neighbor route-map command.
ZebOS#configure terminalZebOS(config)#route-map rmap2 permit 6ZebOS(config-route-map)#match origin incomplete ZebOS(config-route-map)#set metric 100ZebOS(config-route-map)#exit ZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 route-map rmap2 in
126
BGP Commands
neighbor route-reflector-clientUse this command to configure the router as a BGP route reflector and configure the specified neighbor as its client. Route reflectors are a solution for the explosion of iBGP peering within an autonomous system. By route reflection the number of iBGP peers within an AS is reduced. Use this command to configure the local router as the route reflector and specify neighbors as its client. An AS can have more than one route reflector. One route reflector treats the other route reflector as another iBGP speaker.
Use the no parameter with this command to indicate that the neighbor is not a client.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) route-reflector-client
no neighbor (A.B.C.D|X:X::X:X|WORD) route-reflector-client
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode and Address Family mode
ExamplesIn the following configuration, Router1 is the route reflector for clients 3.3.3.3 and 2.2.2.2; it also has a non-client peer 6.6.6.6.
ZebOS#configure terminalZebOS(config)#router bgp 200ZebOS(config-router)#neighbor 3.3.3.3 remote-as 200ZebOS(config-router)#neighbor 3.3.3.3 route-reflector-clientZebOS(config-router)#neighbor 2.2.2.2 remote-as 200ZebOS(config-router)#neighbor 2.2.2.2 route-reflector-clientZebOS(config-router)#neighbor 6.6.6.6 remote-as 200
127
BGP Commands
neighbor route-server-clientUse this command to configure a neighbor as the Route Server client.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) route-server-client
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 route-server-client
128
BGP Commands
neighbor send-communityUse this command to specify that a community attribute should be sent to a BGP neighbor. The community attribute groups destinations in a certain community and applies routing decisions according to those communities. On receiving community attributes the router reannounces them to the neighbor. Only when the no parameter is used with this command the community attributes are not reannounced to the neighbor. By default, both standard and extended community attributes are sent to a neighbor. To explicitly send only the standard or extended community attribute, run the bgp config-type command with the standard parameter, before running this command.
Use the no parameter with this command to remove the entry. Use the extended and no parameters to remove extended communities. If no other parameter is used with the no parameters, this only removes the standard communities.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) send-community (both|extended|standard)
no neighbor (A.B.C.D|X:X::X:X|WORD) send-community (both|extended|standard)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
both Sends Standard and Extended Community attributes.
extended Sends Extended Community attributes.
standard Sends Standard Community attributes.
DefaultBoth standard and extended community attributes are sent to a neighbor.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#bgp config-type standardZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 send-community extended
Related Commandsbgp config-type
129
BGP Commands
neighbor shutdownUse this command to disable a neighbor. This command shuts down any active session for the specified neighbor and clears all related routing data.
Use the no parameter with this command to re-enable the neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) shutdown
no neighbor (A.B.C.D|X:X::X:X|WORD) shutdown
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 shutdown
130
BGP Commands
neighbor soft-reconfigurationUse this command to store updates for inbound soft reconfiguration. Soft-reconfiguration may be used in lieu of BGP route refresh capability. Using this command enables local storage of all the received routes and their attributes. This requires additional memory. When a soft reset (inbound) is done on this neighbor, the locally stored routes are re-processed according to the inbound policy. The BGP neighbor connection is not affected.
Use the no parameter with this command to disable this function.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) soft-reconfiguration [inbound]
no neighbor (A.B.C.D|X:X::X:X|WORD) soft-reconfiguration [inbound]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
inbound Allow inbound soft reconfiguration for this neighbor
Command ModeRouter mode and Address Family (IPv4 unicast, IPv4 multicast, IPv6) mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 soft-reconfiguration inbound
131
BGP Commands
neighbor strict-capability-matchUse this command to close the BGP connection if capability value does not completely match to remote peer.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) strict-capability-match
no neighbor (A.B.C.D|X:X::X:X|WORD) strict-capability-match
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 strict-capability-match
132
BGP Commands
neighbor timersUse this command to set the timers for a specific BGP neighbor. Keepalive messages are sent by a router to inform another router that the BGP connection between the two is still active. The keepalive interval is the period of time between each keepalive message sent by the router. The holdtime interval is the time the router waits to receive a keepalive message and if it does not receive a message for this period it declares the neighbor dead.
Use the no parameter with this command to clear the timers for a specific BGP neighbor
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) timers [<0-65535> (<0-65535>)|connect <0-65535>]
no neighbor (A.B.C.D|X:X::X:X|WORD) timers [connect]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<0-65535> Interval after which, on not receiving a keepalive message, the router declares a neighbor dead.
<0-65535> Range of values for the holdtime, in seconds.
connect Indicate the BGP connect timer.
<1-65535> Range of values for the connect timer, in seconds.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 timers 60 120 ZebOS(config-router)#neighbor 10.10.10.10 timers connect 10
ZebOS(config-router)#no neighbor 10.10.10.10 timers connect
133
BGP Commands
neighbor transparent-asUse this command to specify not to append your AS path number even if the peer is an eBGP peer.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) transparent-as
Parameters
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 transparent-as
134
BGP Commands
neighbor transparent-nexthopUse this command to keep the nexthop value of the route even if the peer is an eBGP peer.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) transparent-nexthop
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 transparent-nexthop
135
BGP Commands
neighbor unsuppress-mapUse this command to selectively leak more-specific routes to a particular neighbor. When the aggregate-address command is used with the summary-only option, the more-specific routes of the aggregate are suppressed to all neighbors. Use the unsuppress-map command to selectively leak more-specific routes to a particular neighbor.
Use the no parameter with this command to restore the setting to the default level.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) unsuppress-map (WORD)
no neighbor (A.B.C.D|X:X::X:X|WORD) unsuppress-map (WORD)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The name of the route-map used to select routes to be un-suppressed.
Command ModeRouter mode and Address Family mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.73 unsuppress-map mymap
ZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#address-family ipv4 unicastZebOS(config-router-af)#neighbor 10.10.0.70 unsuppress-map mymap
136
BGP Commands
neighbor update-sourceThis command allows internal BGP sessions to use any operational interface for TCP connections. Use this command in conjunction with any specified interface on the router. The loopback interface is the interface that is most commonly used with this command. The use of loopback interface eliminates a dependency and BGP does not have to rely on the availability of a particular interface for making TCP connections.
Use the no parameter with this command to restore the interface assignment to the closest interface.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) update-source (WORD)
no neighbor (A.B.C.D|X:X::X:X|WORD) update-source (WORD)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The loopback interface name.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 update-source myif
137
BGP Commands
neighbor versionUse this command to configure the ZebOS software to accept only a particular BGP version. By default, the system uses BGP version 4 and on request dynamically negotiates down to version 2. Using this command disables the router’s version-negotiation capability and forces the router to use only a specified version with the neighbor.
Use the no parameter with this command to use the default version level of a neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) version <4>
no neighbor (A.B.C.D|X:X::X:X|WORD) version
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
4 The BGP version number
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 version 4
ZebOS(config)#router bgp 12ZebOS(config-router)#no neighbor 10.10.10.10 version
138
BGP Commands
neighbor weightUse this command to specify a weight value, per address-family, to all routes learned from a neighbor. The route with the highest weight gets preference when the same prefix is learned from more than one peer. Unlike the local-preference attribute, the weight attribute is relevant only to the local router. The weights assigned using the set weight command override the weights assigned using this command.
Use this command in Router mode to specify a weight value for all address families. Use this command in Address Family mode to specify a weight value per IPv4/IPv6/VPNv4/6PE address family,
When the weight is set for a peer group, all members of the peer group get the same weight. This command can also be used to assign a different weight to an individual peer-group member. When an individually-configured weight of a peer-group member is removed, its weight is reset to its peer-group’s weight.
Use the no parameter with this command to remove a weight assignment.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) weight <0-65535>
no neighbor (A.B.C.D|X:X::X:X|WORD) weight <0-65535>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<0-65535> Range of values for the weight this command assigns to the route.
Command ModeRouter mode, Address-Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 weight 60
ZebOS(config-router)#no neighbor 10.10.10.10 weight 60
139
BGP Commands
networkUse this command to specify the networks to be advertised by the BGP routing process. A unicast network address without a mask is accepted if it falls into the natural boundary of its class. A class-boundary mask is derived if the address matches its natural class-boundary.
Use the no parameter with this command to remove a network route entry.
Command Syntaxnetwork [A.B.C.D|A.B.C.D/M|synchronization] (backdoor|routemap (WORD)|mask A.B.C.D)
no network [A.B.C.D|A.B.C.D/M|synchronization] (backdoor|routemap (WORD)|mask A.B.C.D)
network synchronization
network (A.B.C.D) backdoor
network (A.B.C.D) route-map (WORD) [backdoor]
network (A.B.C.D) mask (A.B.C.D) [backdoor]
network (A.B.C.D) mask (A.B.C.D)route-map (WORD) [backdoor]
ParametersA.B.C.D/M IP prefix <network>/<length>, for example., 35.0.0.0/8
A.B.C.D IP prefix <network>, for example, 35.0.0.0
synchronization
Perform IGP synchronization on network routes
backdoor Indicate a BGP backdoor route
routemap Route map used to modify the attributes
WORD Name of the route map
mask Network mask
A.B.C.D Network mask, for example, 255.255.0.0
Command ModeRouter mode and Address-family mode
ExamplesThe following example illustrates a Class-A address configured as a network route. The natural Class-A network prefix mask length of 8 is internally derived, that is, 2.0.0.0/8.
ZebOS(config)#router bgp 1ZebOS(config-router)#network 2.0.0.0
The following example enables IGP synchronization of BGP static network routes in the router configuration mode.
ZebOS#configure terminalZebOS(config)#router bgp 11ZebOS(config-router)#network synchronization
The following example enables IGP synchronization of BGP static network routes in the IPv6-Unicast address family.
ZebOS#configure terminal
140
BGP Commands
ZebOS(config)#router bgp 11ZebOS(config)#address-family ipv6 unicastZebOS(config-af)#network synchronization
141
BGP Commands
redistributeUse this command to inject routes from one routing process into another. Redistribution is used by routing protocols to advertise routes that are learned by some other means, such as by another routing protocol or by static routes. Since all internal routes are dumped into BGP, careful filtering is applied to make sure that only routes to be advertised reach the internet, not everything. This command allows redistribution by injecting prefixes from one routing protocol into another routing protocol.
Use the no parameter with this command to disable this function.
Command Syntaxredistribute [connected|isis|kernel|ospf|rip|static] (route-map WORD)
no redistribute [connected|isis|kernel|ospf|rip|static] (route-map WORD)
Parametersconnected Redistribute connected routes in the VRF
isis Redistribute connected ISO IS-IS routes
kernel Redistribute connected kernel routes
ospf Redistribute OSPFv2 or OSPFv3 routes in the VRF
rip Redistribute RIP routes in the VRF
static Redistribute static routes in the VRF
route-map Indicate a route map reference
WORD A pointer to route-map entries
Command ModeRouter mode and Address Family IPv6 mode
ExamplesThe following example shows the configuration of the route-map name rmap1 and then the use of this map name in the redistribute route-map command.
ZebOS#configure terminalZebOS(config)#route-map rmap1 permit 1ZebOS(config-route-map)#match origin incomplete ZebOS(config-route-map)#set metric 100ZebOS(config-route-map)#exit ZebOS(config)#router bgp 12ZebOS(config-router)#redistribute ospf route-map rmap1
142
BGP Commands
restart bgp gracefulUse this command to enable BGP-speaker router for graceful restart. This command stops the whole BGP process and makes ZebOS retain the BGP routes and mark them as stale. Receiving BGP speakers, retain and mark as stale all BGP routes received from the restarting speaker for all the address families received in the Graceful Restart Capability exchange.
Command Syntaxrestart bgp graceful
ParametersNone
Command ModePrivileged Exec mode
ExamplesZebOS#restart bgp graceful
Related Commandsneighbor capability graceful-restart
143
BGP Commands
router bgpUse this command to enter the BGP router mode.
Use the no parameter with this command to disable a routing process.
Command Syntaxrouter bgp <1-4294967295>
no router bgp <1-4294967295>
Parameters<1-4294967295> Range of values for the Autonomous System (AS) number.
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#
144
BGP Commands
router bgp viewUse this command to configure a BGP routing view.
Use the no parameter with this command to disable a routing view.
Note: When a BGP view is configured, it does not install any routes in the kernel for that view,
Command Syntaxrouter bgp <1-4294967295> (view WORD)
no router bgp <1-4294967295> (view [WORD)
Parameters<1-4294967295> Range of values for the Autonomous System (AS) number.
WORD Specify the view name
Command ModeConfigure mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12 view 1ZebOS(config-router)#
Related Commandsrouter bgp
145
BGP Commands
set-overload-bitUse this command to set the overload-bit in self-LSPs. If the overload-bit is set in LSPs, the router is not used as a transit router during SPF calculation. This command causes a router to update its own LSP with the overload bit set and causes the other routers not to use this router as a transit or forwarding router. The router continues to receive LSPs when the overload bit is set. If the on-startup option is specified, the router sets the overload bit only at startup, then clears the bit after the specified interval has elapsed. If the on-startup option is specified using the wait-for-bgp option, the overload bit is setup at startup, then the bit is cleared after the BGP router signals it has finished converging or if the router does not signal it has finished converging in 10 minutes. If there is no BGP process running, the overload bit clears immediately.
If the BGP process is started later than the overload bit is set, the bit clears after the BGP router signals it has finished converging or if the BGP router does not signal it has finished converging in 10 minutes. If the suppress option is specified, the router suppresses the redistribution of specified types of reachability data during overload state. The suppress option can be used with the external or interlevel parameters, or both parameters.
Use the no parameter to clear the overload-bit from self-LSPs.
Command Syntax set-overload-bit [on-startup|<5-86400>|wait-for-bgp|suppress (external| interlevel)]
set-overload-bit [suppress (external|interlevel)|on-startup|<5-86400>|wait-for-bgp]
no set-overload-bit
Parameterson-startup Designate an interval in seconds after which the overload state is exited.
suppress Indicate to suppress specific types of IP prefixes.
<5-86400> Range of values, in seconds, to advertise one’s self as overloaded after reboot.
wait-for-bgp
Choose how BGP determines when to unset the overload bit.
external Redistribute external reachability to prevent IP prefixes learned from other protocols from being advertised.
interlevel Redistribute inter-level reachability.
DefaultBy default, no overload-bit is set.
Command ModeRouter mode
ExampleThis example sets overload bit at startup, does not unset the overload bit until BGP converges, suppresses redistribution between levels, and suppresses redistribution from external routing protocols while the overload bit is set.
ZebOS(config)#router isis bbZebOS(config-router)#set-overload-bit on-startup wait-for-bgp suppress interlevel external
146
BGP Commands
synchronizationUse this command to enable IGP synchronization of Internal BGP (iBGP) learned routes with the Internal Gateway Protocol (IGP) system in the router configuration mode or in the address-family configuration mode.
Synchronization is used when a BGP router should not advertise routes learned from iBGP neighbors, unless those routes are also present in an IGP (for example, OSPF). Synchronization may be enabled when all the routers in an autonomous system do not speak BGP, and the autonomous system is a transit for other autonomous systems.
The no synchronization command is used when BGP router can advertise routes learned from its iBGP neighbors without waiting for the IGP reachability to be present.
Command Syntaxsynchronization
no synchronization
ParametersNone
DefaultIGP synchronization is disabled.
Command ModeRouter mode and Address Family modes
ExamplesThe following example enables IGP synchronization of iBGP routes in Router mode.
ZebOS#configure terminalZebOS(config)#router bgp 11ZebOS(config-router)#synchronization
The following example enables IGP synchronization of iBGP routes in the IPv6-Unicast address family.
ZebOS#configure terminalZebOS(config)#router bgp 11ZebOS(config-router)#address-family ipv6 unicastZebOS(config-af)#synchronization
147
BGP Commands
timers bgpUse this command to globally set or reset the keepalive and holdtime values for all the neighbors.
Use the no parameter with this command to reset timers to default value.
Command Syntaxtimers bgp [<0-65535>|<0-65535>]
no timers bgp [<0-65535>|<0-65535>]
Parameters<0-65535> The frequency with which the keepalive messages are sent to the neighbors
<0-65535> The interval after which the neighbor is considered dead if keepalive messages are not received
DefaultThe default keepalive value is 30 seconds.
The default holdtime value is 90 seconds.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#timers bgp 40 120
148
BGP Commands
undebug bgpUse this command to disable BGP debugging functions.
Command Syntax undebug bgp (all|bfd|dampening|events|filters|fsm|keepalives|mpls|nht|nsm|updates)
Parametersall Disable all debugging for BGP.
bfd Disable debugging for BGP Bidirectional Forwarding Detection (BFD).
dampening Disable debugging for BGP dampening.
events Disable debugging for BGP events.
filters Disable debugging for BGP filters.
fsm Disable debugging for BGP Finite State Machine (FSM).
keepalives Disable debugging for BGP keepalives.
mpls Disable debugging for BGP MPLS.
nht Disable debugging for BGP NHT messages.
nsm Disable debugging for NSM messages.
updates Disable debugging for BGP updates.
Command ModePrivileged Exec mode
ExamplesZebOS#undebug bgp events
149
BGP Commands
150
CHAPTER 3 BGP4+ Command
This chapter lists and describes all of the BGP4+ configuration commands. Refer to Chapter 5, BGP Show Commands to view all of the BGP show commands.
This chapter includes the following commands:
• address-family ipv6 labeled-unicast on page 152
• aggregate-address on page 153
• clear bgp X:X::X:X on page 154
• clear bgp ipv6 * on page 155
• clear bgp ipv6 <1-4294967295> on page 156
• clear bgp ipv6 A.B.C.D on page 157
• clear bgp ipv6 X:X::X:X on page 158
• clear bgp ipv6 external on page 159
• clear bgp ipv6 peer-group on page 160
• clear bgp ipv6 unicast on page 161
• match ipv6 peer on page 162
• neighbor activate on page 163
• neighbor attribute-unchanged on page 164
• neighbor capability on page 165
• neighbor default-originate on page 166
• neighbor distribute-list on page 167
• neighbor filter-list on page 168
• neighbor maximum-prefix on page 169
• neighbor next-hop-self on page 170
• neighbor peer-group on page 171
• neighbor prefix-list on page 172
• neighbor remove-private-AS on page 173
• neighbor route-map on page 174
• neighbor route-reflector-client on page 175
• neighbor send-community on page 176
• neighbor soft-reconfiguration on page 177
• neighbor unsuppress-map on page 178
• network on page 179
• redistribute on page 180
151
BGP4+ Command
address-family ipv6 labeled-unicastUse this command to enter the IPv6 Provider Edge (6PE) Address Family mode. This command enables the exchanging of labeled routes data among ISP PE-routers and switches in Address-Family IPv6 Labeled-Unicast mode.
When a neighbor activate command is given in this Address Family mode, the router will be 6PE capable.
Command Syntaxaddress-family ipv6 labeled-unicast
ParametersNone
Command ModeRouter mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv6 labeled-unicastZebOS(config-router-af)#
Related Commandsexit-address-family, neighbor active
152
BGP4+ Command
aggregate-addressUse this command to configure BGP aggregate entries.
Aggregates are used to minimize the size of routing tables. Aggregation combines the characteristics of several different routes and advertises a single route. This command creates an aggregate entry in the BGP routing table if any more-specific BGP routes are available in the specified range. Using the summary-only parameter advertises the prefix only, suppressing more-specific routes to neighbors.
The as-set parameter creates an aggregate entry advertising the path for this route, consisting of all elements contained in all paths being summarized. Use the as-set parameter to reduce the size of path information by listing the AS number only once, even if it was included in multiple paths that were aggregated. The as-set parameter is useful when aggregation of information results in an incomplete path information.
Use the no parameter with this command to disable this functionality.
Command Syntaxaggregate-address [A.B.C.D/M (as-set|summary-only)]
no aggregate-address [A.B.C.D/M (as-set|summary-only)]
ParametersA.B.C.D/M The aggregate prefix.
as-set Generates AS set path information.
summary-only Filters more specific routes from updates.
Command ModeAddress Family mode
DefaultDisabled
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#neighbor 2.2.2.2 remote-as 100ZebOS(config-router)#neighbor 3.3.3.3 remote-as 200ZebOS(config-router)#address-family ipv6ZebOS(config-router-af)#aggregate-address 3ffe::/32 as-set summary-only
153
BGP4+ Command
clear bgp X:X::X:XUse this command to reset the BGP IPv6 neighbor addresses to clear.
Command Syntaxclear bgp X:X::X:X [in (prefix-filter)|out|soft (in|out)]
ParametersX:X::X:X Neighbor address in IPv6 format
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExamplesZebOS#clear bgp 3:3::3:3 in prefix-filter
154
BGP4+ Command
clear bgp ipv6 *Use this command to reset the BGP connection for all IPv6 peers.
Command Syntaxclear bgp ipv6 * [in (prefix-filter)|out|soft (in|out)]
Parametersin Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp ipv6 * soft in
155
BGP4+ Command
clear bgp ipv6 <1-4294967295>Use this command to reset the BGP connection with a specified AS (Autonomous System) number for IPv6 peers.
Command Syntaxclear bgp ipv6 <1-4294967295> [in (prefix-filter)|out|soft (in|out)]
Parameters<1-4294967295> Range of values for AS number for IPv6 peers.
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp ipv6 12345 in
156
BGP4+ Command
clear bgp ipv6 A.B.C.DUse this command to reset the BGP neighbor addresses for IPv6 peers.
Command Syntaxclear bgp ipv6 A.B.C.D [in (prefix-filter)|out|soft (in|out)]
ParametersA.B.C.D Neighbor address in IPv4 format.
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp ipv6 3.3.3.3 in prefix-filter
157
BGP4+ Command
clear bgp ipv6 X:X::X:XUse this command to reset the BGP IPv6 neighbor addresses to clear.
Command Syntaxclear bgp ipv6 X:X::X:X [in (prefix-filter)|out|soft (in|out)]
ParametersX:X::X:X Neighbor address in IPv6 format
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp ipv6 12:3::4:1 in prefix-filter
158
BGP4+ Command
clear bgp ipv6 externalUse this command to reset the BGP connection for all external IPv6 peers.
Command Syntaxclear bgp ipv6 external [in (prefix-filter)|out|soft (in|out)]
Parametersin Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp ipv6 external soft in
159
BGP4+ Command
clear bgp ipv6 peer-groupUse this command to reset the BGP connection for all members of a IPv6 peer group.
Command Syntaxclear bgp ipv6 peer-group (WORD) [in (prefix-filter)|out|soft (in|out)]
ParametersWORD BGP peer-group name
in Indicates that incoming advertised routes should be cleared.
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared
soft Indicates that both incoming and outgoing routes should be cleared
in Indicates soft reconfiguration inbound update
out Indicates soft reconfiguration outbound update
Command ModePrivileged Exec mode
ExamplesZebOS#clear bgp ipv6 peer-group P1 soft in
160
BGP4+ Command
clear bgp ipv6 unicastUse this command to reset the BGP connection for IPv6.
Command Syntaxclear bgp ipv6 unicast [dampening|flap-statistics (X:X::X:X|X:X::X:X/M)]
Parametersdampening Clear route dampening information.
flap-statisticsClear route flap statistics.
X:X::X:X IPv6 prefix <network>, for example., 2003::
X:X::X:X/M IPv6 prefix <network>/<length>, for example, 2003::/16
Command ModePrivileged Exec mode
ExampleZebOS#clear bgp ipv6 unicast dampening 1:2::3:4/7
161
BGP4+ Command
match ipv6 peerUse this command to apply policies based on the route source of which the BGP TCP/IP session is formed using the IPv6 address, unlike the nexthop in the update message.
Use the no parameter with this command to disable this functionality.
Command Syntaxmatch ipv6 peer [<1-199>|<1300-2699>|WORD]
no match ipv6 peer [<1-199>|<1300-2699>|WORD]
Parameters<1-199> Range of values for access-list number.
<1300-2699> Range of values for expanded access-list number.
WORD Access-list name.
Command ModeConfigure mode
ExampleZebOS#configure terminalZebOS(config)#route-map in-A permit 10ZebOS(route-map)#match ipv6 peer 1
162
BGP4+ Command
neighbor activateUse this command to enable the exchange of the specified AF routes with a neighboring router. After the TCP connection is opened with the neighbor, use this command to enable or disable the exchange of the specified AF information with a neighboring router. To enable the exchange of multicast and VPNv4 address prefix types, neighbors are activated using the neighbor activate command in address family mode.
Use the no parameter with this command to disable exchange of information with a neighbor.
Command Syntax
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) activate (A.B.C.D|X:X::X:X|WORD)
no neighbor (A.B.C.D|X:X::X:X|WORD) activate (A.B.C.D|X:X::X:X|WORD)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeAddress Family mode and Router mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 1.2.3.4 activate
Related Commandsneighbor remote-as, neighbor peer-group
163
BGP4+ Command
neighbor attribute-unchangedUse this command to advertise unchanged BGP attributes to the specified neighbor.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) attribute-unchanged (A.B.C.D|X:X::X:X|WORD) [as-path|next-hop|med]
no neighbor (A.B.C.D|X:X::X:X|WORD) attribute-unchanged (A.B.C.D|X:X::X:X|WORD)[as-path|next-hop|med]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
as-path AS path attribute.
next-hop Nexthop attribute.
med Multi-exit Discriminator attribute.
Command ModeRouter mode and Address Family mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.75 attribute-unchanged as-path med
164
BGP4+ Command
neighbor capabilityUse this command to enable Outbound Router Filtering (ORF), and advertise the ORF capability to its neighbors. The ORFs send and receive capabilities to lessen the number of updates exchanged between neighbors. By filtering updates, this option minimizes generating and processing of updates. The local router advertises the ORF capability in send mode, and the remote router receives the ORF capability in receive mode applying the filter as outbound policy. The two routers exchange updates to maintain the ORF for each router. Only an individual router or a peer group can be configured to be in receive or send mode. A peer-group member cannot be configured to be in receive or send mode.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) capability [orf|prefix-list (both|receive|send)]
no neighbor (A.B.C.D|X:X::X:X|WORD) capability [orf|prefix-list (both|receive|send)]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
orf Advertises ORF capability to its neighbors.
both Indicates that the local router can send ORF entries to its peer and receive ORF entries from its peer.
receive Indicates that the local router is willing to receive ORF entries from its peer.
send Indicates that the local router is willing to send ORF entries to its peer.
DefaultDisabled
Command ModeRouter mode and Address Family (IPv4 unicast, IPv4 multicast, IPv6) mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.5 capability orf prefix-list bothZebOS(config-router)#neighbor effe:2897::0003:3ed5 capability orf prefix-list receive
165
BGP4+ Command
neighbor default-originateUse this command to allow a BGP local router to send the default route 0.0.0.0 to a neighbor for use as a default route. This command can be used with standard or extended access lists.
Use the no parameter with this command to send no route as a default.
Use this command to allow a BGP local router to send the default route 0.0.0.0 to a neighbor. This command can be used with standard or extended access lists.
Use the no parameter with this command to send no route as a default.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) default-originate (route-map|WORD)
no neighbor (A.B.C.D|X:X::X:X|WORD) default-originate (route-map|WORD)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
route-map The route-map to specify criteria to originate default routes.
WORD The route map name.
DefaultDisabled
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.10.1 default-originate route-map myroute
166
BGP4+ Command
neighbor distribute-listUse this command to filter route update from a particular BGP neighbor. Use only one distribute-list per BGP neighbor.
Use the no parameter with this command to remove an entry.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) distribute-list (WORD|<1-199>|<1300-2699>) [in|out]
no neighbor (A.B.C.D|X:X::X:X|WORD) distribute-list (WORD|<1-199>|<1300-2699>) [in|out]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The name of an IP access-list.
<1-199> The standard IP access-list number.
<1300-2699> The expanded-range IP access-list number.
in Indicates that incoming advertised routes should be filtered.
out Indicates that outgoing advertised routes should be filtered.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 1.2.3.4 distribute-list mylist out
167
BGP4+ Command
neighbor filter-listUse this command to set up a BGP filter. This command specifies an access list filter on updates based on the BGP autonomous system paths. Each filter is an access list based on regular expressions.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) filter-list (WORD in|out)
no neighbor (A.B.C.D|X:X::X:X|WORD) filter-list (WORD in|out)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The name of an autonomous system path access list.
in Indicates that incoming advertised routes should be filtered.
out Indicates that outgoing advertised routes should be filtered.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.34 filter-list out
168
BGP4+ Command
neighbor maximum-prefixUse this command to control the number of prefixes that can be received from a neighbor. This command allows the configuration of a specified number of prefixes that a BGP router is allowed to receive from a neighbor. When the warning-only option is not used, if any extra prefixes are received, the router ends the peering. A terminated pee stays down until the clear ip bgp command is used.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) maximum-prefix [<1-4294967295>|<1-100>|warning-only]
no neighbor (A.B.C.D|X:X::X:X|WORD) maximum-prefix [<1-4294967295>|<1-100>|warning-only]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-4294967295> Range of values for the maximum number of prefixes permitted.
<1-100> Range of values for threshold value.
warning-only Only gives a warning message when the limit is exceeded.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 maximum-prefix 1244 warning-only
Related Commandsneighbor remote-as, neighbor peer-group
169
BGP4+ Command
neighbor next-hop-selfUse this command to configure the router as the next hop for a BGP-speaking neighbor or peer group. This command allows a BGP router to change the nexthop information that is sent to the iBGP peer. The nexthop information is set to the IP address of the interface used to communicate with the neighbor.
Use the no parameter with this command to disable this feature.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) next-hop-self
no neighbor (A.B.C.D|X:X::X:X|WORD) next-hop-self
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group. used with a command, the command applies on all peers in the specified group.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 remote-as 100ZebOS(config-router)#neighbor 10.10.0.72 next-hop-self
170
BGP4+ Command
neighbor peer-groupUse this command so that Neighbors with the same update policies are grouped into peer groups. This facilitates the updates of various policies, such as, distribute and filter lists. The peer-group is then configured easily with any of the neighbor commands. Any changes made to the peer group affects all members. To create a peer-group, use the neighbor peer-group create command and then use this command to add neighbors to the group.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) peer-group
no neighbor (A.B.C.D|X:X::X:X|WORD) peer-group
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
Example This example shows a new peer-group, group1, and addition of a neighbor, 10.10.0.63, to the group.
ZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor group1 peer-group ZebOS(config-router)#neighbor 10.10.0.63 peer-group group1
171
BGP4+ Command
neighbor prefix-listUse this command to specify a prefix list for filtering BGP advertisements. Filtering by prefix list matches the prefixes of routes with those listed in the prefix list. If there is a match, the route is used. An empty prefix list permits all prefixes. If a given prefix does not match any entries of a prefix list, the route is denied access. When multiple entries of a prefix list match a prefix, the entry with the smallest sequence number is considered to be a real match.
The router begins the search at the top of the prefix list, with the sequence number 1. Once a match or deny occurs, the router does not need to go through the rest of the prefix list. For efficiency the most common matches or denies are listed at the top. The neighbor distribute-list command is an alternative to this command and only one of them can be used for filtering to the same neighbor in any direction.
Use the no parameter with this command to remove an entry.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) prefix-list (WORD in|out)
no neighbor (A.B.C.D|X:X::X:X|WORD) prefix-list (WORD in|out)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The number of an AS-path access list.
in Indicates that the access list applies to incoming advertisements.
out Indicates that the access list applies to outgoing advertisements.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#ip prefix-list list1 deny 30.0.0.0/24ZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 prefix-list list1 in
Related Commandsip prefix-list (refer to the NSM Command Reference)
172
BGP4+ Command
neighbor remove-private-ASUse this command to remove the private Autonomous System (AS) number from outbound updates.
Private AS numbers are not advertised to the Internet. This command is used with external BGP peers only. The router removes the AS numbers only if the update includes private AS numbers. If the update includes both private and public AS numbers, the system treats it as an error.
Use the no parameter with this command to revert to default.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) remove-private-AS
no neighbor (A.B.C.D|X:X::X:X|WORD) remove-private-AS
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
DefaultDisabled
Command ModeRouter mode and Address Family [ipv4 unicast|ipv4 multicast|ipv6|vpnv4 unicast] mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.63 remove-private-AS
173
BGP4+ Command
neighbor route-mapUse this command to apply a route map to incoming or outgoing routes. A route map is applied to inbound or outbound updates. Only the routes that pass the route map are sent or accepted in updates.
Use the no parameter with this command to remove a route map.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) route-map (WORD in|out)
no neighbor (A.B.C.D|X:X::X:X|WORD) route-map (WORD in|out)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The name of the route-map.
in Indicates that the access list applies to incoming advertisements.
out Indicates that the access list applies to outgoing advertisements.
Command ModeRouter mode and Address Family mode
ExamplesThe following example shows the configuration of the route-map name rmap2 and then the use of this map name in the neighbor route-map command.
ZebOS#configure terminalZebOS(config)#route-map rmap2 permit 6ZebOS(config-route-map)#match origin incomplete ZebOS(config-route-map)#set metric 100ZebOS(config-route-map)#exit ZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 route-map rmap2 in
174
BGP4+ Command
neighbor route-reflector-clientUse this command to configure the router as a BGP route reflector and configure the specified neighbor as its client.
Route reflectors are a solution for the explosion of iBGP peering within an autonomous system. By route reflection the number of iBGP peers within an AS is reduced. Use the neighbor route-reflector-client command to configure the local router as the route reflector and specify neighbors as its client. An AS can have more than one route reflector. One route reflector treats the other route reflector as another iBGP speaker.
Use the no parameter with this command to indicate that the neighbor is not a client.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) route-reflector-client
no neighbor (A.B.C.D|X:X::X:X|WORD) route-reflector-client
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode and Address Family mode
ExamplesIn the following configuration, Router1 is the route reflector for clients 3.3.3.3 and 2.2.2.2; it also has a non-client peer 6.6.6.6.
ZebOS#configure terminalZebOS(config)#router bgp 200ZebOS(config-router)#neighbor 3.3.3.3 remote-as 200ZebOS(config-router)#neighbor 3.3.3.3 route-reflector-clientZebOS(config-router)#neighbor 2.2.2.2 remote-as 200ZebOS(config-router)#neighbor 2.2.2.2 route-reflector-clientZebOS(config-router)#neighbor 6.6.6.6 remote-as 200
175
BGP4+ Command
neighbor send-communityUse this command to specify a community attribute to be sent to a neighbor. The community attribute groups destinations in a certain community and applies routing decisions according to those communities. By default, on receiving the communities attribute the router re-announces them to the neighbor. Only when the no parameter is used with this command the community attributes are not re-announced to the neighbor.
Use the no parameter with this command to remove the entry.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) send-community (both|extended|standard)
no neighbor (A.B.C.D|X:X::X:X|WORD) send-community (both|extended|standard)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
both Send Standard and Extended Community attributes.
extended Send Extended Community attributes.
standard Send Standard Community attributes.
DefaultBoth standard and extended community attributes are sent to a neighbor.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.72 send-community extended
176
BGP4+ Command
neighbor soft-reconfigurationUse this command to store updates for inbound soft reconfiguration. Soft-reconfiguration may be used in lieu of BGP route refresh capability. Using this command enables local storage of all the received routes and their attributes. This requires additional memory. When a soft reset (inbound) is done on this neighbor, the locally stored routes are re-processed according to the inbound policy. The BGP neighbor connection is not affected.
Use the no parameter with this command to disable this functionality.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) soft-reconfiguration [inbound]
no neighbor (A.B.C.D|X:X::X:X|WORD) soft-reconfiguration [inbound]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group..
inbound Allow inbound soft reconfiguration for this neighbor.
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 12ZebOS(config-router)#neighbor 10.10.10.10 soft-reconfiguration inbound
177
BGP4+ Command
neighbor unsuppress-mapUse this command to selectively leak more-specific routes to a particular neighbor. When the aggregate-address command is used with the summary-only option, the more-specific routes of the aggregate are suppressed to all neighbors. Use the unsuppress-map command to selectively leak more-specific routes to a particular neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) unsuppress-map [WORD]
no neighbor (A.B.C.D|X:X::X:X|WORD) unsuppress-map [WORD]
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
WORD The name of the route-map used to select routes to be un-suppressed.
Command ModeRouter mode and Address Family (ipv4 unicast|ipv4 multicast|ipv6) mode
ExampleZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#neighbor 10.10.0.73 unsuppress-map mymap
ZebOS#configure terminalZebOS(config)#router bgp 10ZebOS(config-router)#address-family ipv4 unicastZebOS(config-router-af)#neighbor 10.10.0.70 unsuppress-map mymap
178
BGP4+ Command
networkUse this command to specify the networks to be advertised by the BGP routing process. Use the backdoor parameter to specify a backdoor route to a BGP border router that will provide better information about the network. For data to be advertised by BGP, its routing table must include a route to the specified network. This command specifies the networks to be advertised. The network command works if the network being advertised is known to the router.
The backdoor parameter enables a route to be the preferred route even if it has a greater distance. A network that is specified as a backdoor network is not sourced by the local router but is learned from the external routers. In the following example, 172.10.0.0 is treated as a local entry but is advertised differently.
Use the no parameter with this command to remove an entry.
Command Syntaxnetwork [A.B.C.D|A.B.C.D/M|synchronization] (backdoor|routemap WORD|mask {A.B.C.D})
no network [A.B.C.D|A.B.C.D/M|synchronization] (backdoor|routemap WORD|mask A.B.C.D)
ParametersA.B.C.D/M IP prefix <network>/<length>, for example., 35.0.0.0/8
A.B.C.D IP prefix <network>, for example, 35.0.0.0
synchronization
Perform IGP synchronization on network routes
backdoor Specify a BGP backdoor route
routemap Route map used to modify the attributes
WORD Name of the route map
mask Network mask, for example, 255.255.0.0
A.B.C.D Network mask, for example, 255.255.0.0
Command ModeRouter mode and Address Family mode
ExamplesZebOS(config)#router bgp 10ZebOS(config-router)#network 172.26.0.0/16
If Router1 receives updates from 172.10.0.0 via two routing protocols RIP (distance 120) and eBGP (distance 20), router1 chooses the shorter route. Use the backdoor parameter to allows Router1 to learn about 172.10.0.0 via RIP.
ZebOS(config)#router ripZebOS(config)#network 172.10.0.0ZebOS(config)#router bgp 200ZebOS(config)#neighbor 3.3.3.3 remote-as 500ZebOS(config)#network 172.10.0.0 backdoor
ZebOS(config-router)#network 172.16.1.0/24 route-map ipi
179
BGP4+ Command
redistributeUse this command to inject routes from one routing process into another. Redistribution is used by routing protocols to advertise routes that are learned by some other means, such as by another routing protocol or by static routes. Since all internal routes are dumped into BGP, careful filtering is applied to make sure that only routes to be advertised reach the internet, not everything. This command allows redistribution by injecting prefixes from one routing protocol into another routing protocol.
Use the no parameter with this command to disable this functionality.
Command Syntaxredistribute [connected|isis|kernel|ospf|rip|static] [route-map WORD]
no redistribute [connected|isis|kernel|ospf|rip|static] [route-map WORD]
Parametersconnected Redistribute connected routes in the VRF.
isis Redistribute connected ISO IS-IS routes.
kernel Redistribute connected kernel routes.
ospf Redistribute OSPFv2 or OSPFv3 routes in the VRF.
rip Redistribute RIP routes in the VRF.
static Redistribute static routes in the VRF.
route-map Specify a route map reference.
WORD A pointer to route-map entries.
Command ModeAddress Family-vrf mode
ExamplesThe following example shows the configuration of the route-map name rmap1 and then the use of this map name in the redistribute route-map command.
ZebOS(config)#route-map rmap1 permit 1ZebOS(config-route-map)#match origin incomplete ZebOS(config-route-map)#set metric 100ZebOS(config-route-map)#exit ZebOS(config)#router bgp 12ZebOS(config-router)#redistribute ospf route-map rmap1
180
CHAPTER 4 BGP VPN Commands
This chapter lists and describes all of the BGP VPN configuration commands. Refer to Chapter 5, BGP Show Commands to view all of the BGP show commands.
This chapter includes the following commands:
• address-family on page 182
• bgp inbound-route-filter on page 184
• clear ip bgp * vpn on page 185
• clear ip bgp <1-4294967295> vpn on page 186
• clear ip bgp A.B.C.D vpn on page 187
• clear ip bgp X:X::X:X vpn on page 188
• clear ipv6 bgp on page 189
• debug bgp mpls on page 190
• exit-address-family on page 191
• import map on page 192
• ip vrf on page 193
• neighbor activate on page 194
• neighbor allow-ebgp-vpn on page 195
• neighbor allowas-in on page 196
• neighbor as-origination-interval on page 197
• neighbor as-override on page 198
• neighbor description on page 199
• neighbor remote-as on page 200
• neighbor send-community on page 201
• neighbor shutdown on page 202
• neighbor soo on page 203
• redistribute on page 204
• rd (route distinguisher) on page 205
• route-target on page 206
• set vpnv4 next-hop on page 207
181
BGP VPN Commands
address-familyUse this command to configure routing exchange between Provider Edge (PE) and Customer Edge (CE) devices.
The BGP sessions between PE routers can carry different types of routes (VPN-IPv4, IPv4, VPN-IPv6 and IPv6 routes). Address families are used to control the type of BGP session. Configure a BGP address family for each VRF configured on the PE router and a separate address family to carry VPN-IPv4 routes between PE routers. All non VPN BGP neighbors are defined using the Router mode. All VPN BGP neighbors are defined under its associated Address Family mode. The BGP process with no address-family specified, is the default address-family where any sessions are configured that either are not associated with a VRF or are used to carry IPv4 or IPv6 routes.
Command Syntaxaddress-family [ipv4 multicast|unicast|vrf NAME] [ipv6 unicast|labeled-unicast|vrf NAME] [vpnv4 unicast] [vpnv6 unicast]
no address-family [ipv4 vrf NAME] [ipv6 vrf NAME]
Parametersipv4 Specify the IPv4 address family.
multicast Identify multicast as an address-family modifier.
unicast Identify unicast as an address-family modifier.
vrf VPN routing/forwarding instance
NAME Name of the VRF instance
ipv6 Specify the IPv6 address family
unicast Identify unicast as an address-family modifier.
labeled-unicast
Identify labeled-unicast as an address-family modifier for IPv6.
vrf VPN routing/forwarding instance
NAME Name of the VRF instance
vpnv4 Specify the VPNv4 address family
unicast Identify unicast as an address-family modifier.
vpnv6 Specify the VPNv6 address family
unicast Identify unicast as an address-family modifier.
Command ModeRouter mode
ExamplesThis example places the router in address family configuration mode and specifies vrf1 as the name of the VRF instance to associate with subsequent IPv4 address family configuration mode commands:
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv4 vrf IPIZebOS(config-router-af)#
In this example, note that the prompt changed to config-router-af after using the address-family command.
ZebOS#configure terminal
182
BGP VPN Commands
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family vpnv4 unicastZebOS(config-router-af)#
183
BGP VPN Commands
bgp inbound-route-filterUse this command to control the installation of routing information into the BGP table.
When a router runs MPLS VPN/BGP PE, it exchanges routing information with a routing distinguisher. By default, ZebOS does not install routing information that does not match the configured routing distinguisher value. When the local box has two VRFs where each routing distinguisher value is 10:100 and 20:200, routing information with routing distinguisher 10:200 is not installed into BGP table.
When no bgp inbound-route-filter is configured, all of routing information is installed into the BGP table.
Command Syntaxbgp inbound-route-filter
no bgp inbound-route-filter
ParameterNone
DefaultEnabled, the router performs the routing distinguisher value check, by default.
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 100ZebOS(config-router)#bgp inbound-route-filter
184
BGP VPN Commands
clear ip bgp * vpnUse this command to reset either the VPNv4 or VPNv6 BGP connection for all peers. This command clears the BGP connection and dynamically resets the inbound routing table. This frees up additional memory required for storing updates to generate new updates.
Command Syntaxclear ip bgp * [vpnv4 (unicast|in|out|soft (in|out)] [vpnv6 (unicast|in|out|soft (in|out)] [vrf (WORD)|in|out|soft (in|out)]
Parametersvpnv4 Clears all VPNv4 address family peers.
unicast Sets the address-family modifier to unicast.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared.
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
vpnv6 Clears all VPNv6 address family peers.
unicast Sets the address-family modifier to unicast.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared.
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
vrf VPN routing/forwarding instance.
WORD VRF instance name.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared.
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ZebOS#clear ip bgp * ZebOS#clear ip bgp * vpnv6 unicast in
185
BGP VPN Commands
clear ip bgp <1-4294967295> vpnUse this command to reset a BGP connection for all VPN peers in a specified Autonomous System.
Command Syntaxclear ip bgp <1-4294967295> [vpnv4 (unicast|in|out|soft (in|out)] [vpnv6 (unicast|in|out|soft (in|out)]
Parameters<1-4294967295> Range of values for Autonomous System.
vpnv4 Clears all VPNv4 address family peers.
unicast Sets the address-family modifier to unicast.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared.
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
vpnv6 Clears all VPNv6 address family peers.
unicast Sets the address-family modifier to unicast.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared.
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp 500 vpnv4 unicast inZebOS#clear ip bgp 500 vpnv6 unicast in
186
BGP VPN Commands
clear ip bgp A.B.C.D vpnUse this command to reset an VPNv4 BGP connection for a specific IP address.
Command Syntaxclear ip bgp A.B.C.D [vpnv4 (unicast|in|out|soft (in|out)] [vrf (WORD)|in|out|soft (in|out)]
Parametersvpnv4 Clears all VPNv4 address family peers.
unicast Sets the address-family modifier to unicast.
Indicates that incoming advertised routes should be cleared.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared (in|out).
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
vrf VPN routing/forwarding instance.
WORD VPN Routing/Forwarding instance name.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared (in|out).
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp 10.10.0.12 softZebOS#clear ip bgp 10.10.0.10 vpnv4 unicast outZebOS#clear ip bgp 3.3.3.3 vrf VRF1 soft in
187
BGP VPN Commands
clear ip bgp X:X::X:X vpnUse this command to reset a VPNv6 BGP connection for a specific address.
Command Syntaxclear ip bgp X:X::X:X [in (prefix-filter)] [out] [out] [soft (in|out)] [vpnv6 (unicast|in|out|soft (in|out)]
ParametersX:X::X:X Reset connection for this IPv6 address.
in Indicates that incoming advertised routes should be cleared.
prefix-filter
prefix-filter
Indicates the push out prefix-list ORF and do inbound soft reconfiguration.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared (in|out).
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ExamplesZebOS#clear ip bgp 3ffe::8 vpnv6 unicast softZebOS#clear ip bgp 3ffe::8 vpnv6 unicast out
188
BGP VPN Commands
clear ipv6 bgpUse this command to reset the specified VPNv6 Routing/Forwarding (VRF) instance for BGP connections. If the neighbor address is specified with this command, it clears the specified connection. If no address is specified, this command clears all the BGP routes.
Command Syntaxclear ipv6 bgp (X:X::X:X|*) [vrf (WORD)|in|out|soft (in|out)]
Parameters* Clear all peers.
X:X::X:X BGP neighbor address to clear.
vrf VPN routing/forwarding instance.
WORD VPN Routing/Forwarding instance name.
in Indicates that incoming advertised routes should be cleared.
out Indicates that outgoing advertised routes should be cleared.
soft Indicates that both incoming and outgoing routes should be cleared.
in Indicates soft reconfiguration inbound update.
out Indicates soft reconfiguration outbound update.
Command ModePrivileged Exec mode
ExampleZebOS#clear ip bgp * vrf new in
189
BGP VPN Commands
debug bgp mplsUse this command to enable the display of MPLS related information.
Use the no parameter with this command to disable this function.
Note: This command is available only when vrf option is enabled.
Command Syntaxdebug bgp mpls
no debug bgp mpls
ParametersNone
DefaultDisabled
Command ModePrivileged Exec mode
Examplesdebug bgp mpls
190
BGP VPN Commands
exit-address-familyUse this command to exit Address-Family-vrf, Address-Family-vpnv4, or Address-Family-vpnv6 mode.
Command Syntaxexit-address-family
ParametersNone
Command ModeAddress Family-VRF, Address Family-VPNv4 and Address Family-VPNv6 mode.
ExamplesThe following example shows the change in prompt after using the exit-address-family command to exit the address-family mode.
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family vpnv6 unicastZebOS(config-router-af)#exit-address-family
Related Commandsaddress-family vpnv4 unicast, address-family vpnv6 unicast
191
BGP VPN Commands
import mapThis command assigns a route-map to the VRF. This map is applied for routing information imported from another PE or VRF.
Use this command when an application requires finer control over the routes imported into a VRF than provided by the import and export extended communities.This command associates a route-map with the specified VRF. You can filter routes that are eligible for import into a VRF through the use of a route-map.The route-map might deny access to selected routes from a community that is on the import list.
Use the no parameter with this command to remove the map.
Command Syntaximport map [WORD]
no import map
ParameterWORD A pointer to route-map entries.
Command ModeVRF mode
ExamplesZebOS(config)#ip vrf IPIZebOS(config-vrf)#import map set-prefZebOS(config-vrf)#
Related Commandsroute-map, ip vrf
192
BGP VPN Commands
ip vrfUse this command to assign a VPN Routing Forwarding instance.
Use the no parameter with this command to remove VPN routing forwarding from the instance.
Command Syntaxip vrf [WORD]
no ip vrf [WORD]
ParameterWORD Name of the VRF Routing Forwarding instance.
Command ModeConfigure mode
Command ExampleZebOS(config)#ip vrf IPIZebOS(config-vrf)#
193
BGP VPN Commands
neighbor activateUse this command to enable the exchange of the specified AF routes with a neighboring router. After the TCP connection is opened with the neighbor, use this command to enable or disable the exchange of the specified AF information with a neighboring router. To enable the exchange of multicast and VPNv4 address prefix types, neighbors are activated using the neighbor activate command in address family mode.
Use the no parameter with this command to disable exchange of information with a neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) activate
no neighbor (A.B.C.D|X:X::X:X|WORD) activate
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
DefaultA neighbor under address-family ipv4/ipv6 is activated by default. For all other address-families, use this command to enable a neighbor to exchange routing information of a specific address-family with a neighbor.
Command ModeAddress Family mode and Router mode
ExamplesZebOS(config)#router bgp 100ZebOS(config-router)#neighbor 10.10.20.1 remote-as 100ZebOS(config-router)#address-family vpnv4 unicastZebOS(config-router-af)#neighbor 10.10.20.1 activate
ZebOS(config)#router bgp 100ZebOS(config)#bgp router-id 13.13.13.13ZebOS(config-router)#neighbor 3ffe:15:15:15:15::0 remote-as 100ZebOS(config-router)#address-family vpnv6 unicastZebOS(config-router-af)#neighbor 3ffe:15:15:15:15::0 activate
Related Commandsaddress-family
194
BGP VPN Commands
neighbor allow-ebgp-vpnUse this command to allow an eBGP neighbor to be a VPN peer. By default, BGP VPN functionality is allowed only for iBGP peers. Using the neighbor allow-ebgp-vpn command allows the VPN connection to be established to an eBGP peer.
Use the no parameter with this command to remove the configuration.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) allow-ebgp-vpn
no neighbor (A.B.C.D|X:X::X:X|WORD) allow-ebgp-vpn
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeAddress Family-vpnv4 mode and Address Family-vpnv6 mode
ExamplesZebOS(config)#router bgp 200ZebOS(config-router)#neighbor 66.66.66.66 remote-as 100ZebOS(config-router)#neighbor 66.66.66.66 update-source loZebOS(config-router)#address-family vpnv4 unicastZebOS(config-router-af)#neighbor 66.66.66.66 allow-ebgp-vpnZebOS(config-router-af)#neighbor 66.66.66.66 activateZebOS(config-router-af)#exit-address-family
Related Commandsneighbor activate
195
BGP VPN Commands
neighbor allowas-inUse this command to configure PE routers to allow re-advertisement of all prefixes containing duplicate Autonomous System Numbers (ASNs).
In a hub and spoke configuration, a PE router re-advertises all prefixes containing duplicate ASNs. Use the neighbor allowas-in command to configure two VRFs on each PE router to receive and re-advertise prefixes. One of the VRFs receives prefixes with ASNs from all PE routers and then advertises them to neighboring PE routers. The other VRF receives prefixes with ASNs from the CE router and re-advertises them to all PE routers in the hub and spoke configuration. Control the number of times an ASN is advertised, by specifying a number from 1 to 10.
Use the no parameter with this command to disable the re-advertisement of a PE router's ASN.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) allowas-in <1-10>
no neighbor (A.B.C.D|X:X::X:X|WORD) allowas-in <1-10>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-10> Number of occurrences of AS number.
DefaultDisabled
Command ModeRouter mode and Address Family mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 7657ZebOS(config-router)#address-family ipv4 vrf VRF_AZebOS(config-router-af)#neighbor 10.10.0.1 allowas-in 3
ZebOS#configure terminalZebOS(config)#router bgp 7657ZebOS(config-router)#address-family ipv6 vrf VRF_AZebOS(config-router-af)#neighbor 3ffe:15:15:15:15::0 allowas-in 3
196
BGP VPN Commands
neighbor as-origination-intervalUse this command to adjust the interval of sending AS origination routing updates. This command is used to change the minimum interval between sending AS-origination routing updates. The interval can be from 1 to 600 seconds.
Use the no parameter with this command to disable this feature.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) as-origination-interval <1-600>
no neighbor (A.B.C.D|X:X::X:X|WORD) as-origination-interval <1-600>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-600> Range of values for AS-origination routing update interval, in seconds.
DefaultDisabled
Command ModeRouter mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 7657ZebOS(config-router)#neighbor 10.10.0.1 as-origination-interval 10
Related Commandsaddress-family ipv4 vrf
197
BGP VPN Commands
neighbor as-overrideUse this command to configure a PE router to override the Autonomous System Number (ASN) of a site with the ASN of a provider. BGP normally ignores the routes from the same AS. However, this command is used to override the customer‘s ASN in BGP, so that the customer CE accepts and installs routes from the same AS.
Typically, this command is used when Customer Edge (CE) routers have the same ASN in some or all sites. As per BGP requirement, a BGP speaker rejects a route that has the same ASN as itself, in the AS_PATH attribute. Thus the CE routers having the same ASN do not accept routes from each other. Configuring the neighbor as-override command on the PE router removes the CE neighbor’s ASN from the AS_PATH attribute allowing CE routers with the same ASN to accept routes from each other.
Use the no parameter with this command to remove VPN IPv4 or VPN IPv6 prefixes from a specified router.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) as-override
no neighbor (A.B.C.D|X:X::X:X|WORD) as-override
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeAddress Family-vrf mode
ExamplesZebOS#configure terminalZebOS(config)#router bgp 7657ZebOS(config-router)#address-family ipv4 vrf VRF_AZebOS(config-router-af)#neighbor 10.10.0.1 as-override
ZebOS#configure terminalZebOS(config)#router bgp 7657ZebOS(config-router)#address-family ipv6 vrf VRF_AZebOS(config-router-af)#neighbor 3ffe:15:15:15:15::0 as-override
Related Commandsaddress family ipv4 vrf, address family ipv6 vrf, neighbor remote-as
198
BGP VPN Commands
neighbor descriptionUse this command to associate a description with a neighbor. This command helps in identifying a neighbor quickly. It is useful for an ISP that has multiple neighbor relationships.
Use the no parameter with this command to remove the description.
Command Syntaxneighbor IPADDRESS (A.B.C.D|X:X::X:X|WORD) description (LINE)
no neighbor IPADDRESS (A.B.C.D|X:X::X:X|WORD) description (LINE)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
LINE Up to 80 characters of text describing the neighbor.
Command ModeRouter mode and Address Family-vrf mode
ExamplesZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv4 vrf VRF_AZebOS(config-router-af)#neighbor 10.10.0.1 description Bank of America
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv6 vrf VRF_AZebOS(config-router-af)#neighbor 3ffe:15:15:15:15::0 description Bank of America
Related Commandsaddress-family, neighbor remote-as
199
BGP VPN Commands
neighbor remote-asThis command establishes BGP peering with a customer edge router.
Use this command to specify a neighbor’s autonomous system number. If the specified ASN matches the ASN number specified in the router bgp global configuration, the neighbor is identified as internal, if not (ASN does not match) then external, to the local AS. The specified neighbor exchanges only unicast address prefixes, unless the neighbor is also activated using the neighbor activate command which allows the exchange of other routing information.
Use the no parameter with this command to delete this peering.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) remote-as <1-4294967295>
no neighbor (A.B.C.D|X:X::X:X|WORD) remote-as <1-4294967295>
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
<1-4294967295> Range of values for neighbor’s autonomous system number.
Note: ASNUM 23456 is a reserved 2-octet AS number. An old BGP speaker (2-byte implementation) should be configured with 23456 as its remote AS number while peering with a non-mappable new BGP speaker (4-byte implementation).
Command ModeAddress Family-vrf mode
ExamplesZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv4 vrf VRF_AZebOS(config-router-af)#neighbor 10.10.0.1 remote-as 65000
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv6 vrf VRF_AZebOS(config-router-af)#neighbor 3ffe:15:15:15:15::0 remote-as 65000
Related Commandsaddress-family ipv4 vrf, address-family ipv6 vrf
200
BGP VPN Commands
neighbor send-communityUse this command to send the extended-community attribute to a customer edge router. In VPN, route-distinguisher and route-target are encoded in BGP extended-community. This command enables sending of bgp routes with extended community to a neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) send-community (both|extended|standard)
no neighbor (A.B.C.D|X:X::X:X|WORD) send-community (both|extended|standard)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group.
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
both Send Standard and Extended Community attributes.
extended Send Extended Community attributes.
standard Send Standard Community attributes.
DefaultDisabled. No extended-community attribute is sent to a customer router.
Command ModeRouter mode and Address Family mode
ExamplesZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv4 vrf VRF_AZebOS(config-router-af)#neighbor 10.10.0.1 send-community extended
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv6 vrf VRF_AZebOS(config-router-af)#neighbor 3ffe:15:15:15:15::0 send-community extended
201
BGP VPN Commands
neighbor shutdownThis command disables a neighbor administratively.
Use this command to terminate any active session for a specified neighbor and clear all related routing information. In case a peer group is specified for shutdown, a large number of peering sessions could be terminated. The show ip bgp summary command displays the summary of BGP neighbors and their connections.
Use the no parameter with this command to re-enable a neighbor.
Command Syntaxneighbor (A.B.C.D|X:X::X:X|WORD) shutdown
no neighbor (A.B.C.D|X:X::X:X|WORD) shutdown
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
Command ModeRouter mode
Command ModeRouter mode and Address Family-vrf mode
ExamplesZebOS(config)#router bgp 100ZebOS(config-router)#neighbor 10.10.0.1 shutdown
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv6 vrf VRF_AZebOS(config-router-af)#neighbor 3ffe:15:15:15:15::0 shutdown
Related Commandsaddress-family ipv4 vrf, address-family ipv6 vrf, neighbor remote-as
202
BGP VPN Commands
neighbor sooUse this command to enable site-of-origin feature. If the customer AS is multi-homed to ISP, this command ensures that PE does not advertise the routes back to same AS.
Use the no parameter with this command to disable this feature.
Command Syntax neighbor (A.B.C.D|X:X::X:X|WORD) soo (ASN|IPID)
no neighbor (A.B.C.D|X:X::X:X|WORD) soo (ASN|IPID)
ParametersA.B.C.D The address of the BGP neighbor in IPv4 format.
X:X::X:X The address of the BGP neighbor in IPv6 format.
WORD Name of an existing peer-group
Note: For information about how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies to all peers in the specified group.
soo Indicates either ASN|IPID:
ASN AS Number:NN Specify a 16-bit AS number and an arbitrary number, for example, 100:1.
IPID A.B.C.D:NN Specify a 32-bit IP address and an arbitrary number, for example, 192.34.23.1:1.
Command ModeAddress Family-vrf mode
ExamplesZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv4 vrf VRF_AZebOS(config-router-af)#neighbor 10.10.0.1 soo 100:1
Related Commandsaddress-family ipv4 vrf, neighbor remote-as
203
BGP VPN Commands
redistributeUse this command to redistribute routes between routing domains.
Command Syntaxredistribute [connected|isis|kernel|ospf|rip|static] [route-map WORD]
no redistribute [connected|isis|kernel|ospf|rip|static] [route-map WORD]
Parametersconnected Redistribute connected routes in the VRF.
isis Redistribute connected ISO IS-IS routes.
kernel Redistribute connected kernel routes.
ospf Redistribute OSPFv2 or OSPFv3 routes in the VRF.
rip Redistribute RIP routes in the VRF.
static Redistribute static routes in the VRF.
route-map Specify a route map reference.
WORD A pointer to route-map entries.
Command ModeAddress Family-vrf mode
ExamplesZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv4 vrf VRF_AZebOS(config-router-af)#redistribute static
ZebOS(config)#router bgp 100ZebOS(config-router)#address-family ipv6 vrf VRF_AZebOS(config-router-af)#redistribute static
204
BGP VPN Commands
rd (route distinguisher)Use this command to assign a route distinguisher (RD) for the VRF. The route distinguisher value must be a unique value on the router.
This command creates routing and forwarding tables and specifies the default RD for a VPN. The RD is added to the customer's IPv4 prefixes, changing them into globally unique VPN-IPv4 prefixes.
Command Syntaxrd [ASN:nn_or_IP-address:nn]
ParametersASN:nn_or_IP-address:nn
Set an AS number and an arbitrary number (for example, 100:1). Otherwise, specify a 32-bit IP address and an arbitrary number (for example, 192.16.10.1:1).
Command ModeVRF mode
ExamplesZebOS(config)#ip vrf VRF_AZebOS(config-vrf)#rd 100:1
Related Commandsip vrf, route-target
205
BGP VPN Commands
route-targetUse this command to add a list of import and export route-target extended communities to the VRF.
This command creates lists of import and export route-target extended communities for the VRF. It specifies a target VPN extended community. Execute the command once for each community. All routes with the specific route-target extended community are imported into all VRFs with the same extended community as an import route-target.
Use the no parameter with this command to delete a route target.
Command Syntaxroute-target [both|export|import] (ASN:nn_or_IP-address:nn)
no route-target [both|export|import] (ASN:nn_or_IP-address:nn)
Parametersboth Specify both import and export.
export Adds route-target to the exporting routing information from the VRF.
import Import routing information which have this route-target.
ASN:nn_or_IP-address:nn
Specify an AS number and an arbitrary number (for example, 100:1). Otherwise, specify a 32-bit IP address and an arbitrary number (for example, 192.16.10.1:1).
Command ModeVRF mode
ExamplesZebOS(config)#ip vrf VRF_AZebOS(config-vrf)#route-target both 100:10
ZebOS(config)#ip vrf VRF_AZebOS(config-vrf)#route-target import 100:20
Related Commandsip vrf, route distinguisher
206
BGP VPN Commands
set vpnv4 next-hopUse this command to set the IP address of the VPNv4 next hop router.
Use the no parameter with this command to disable this feature.
Command Syntaxset vpnv4 next-hop (next-hop|A.B.C.D)
no set vpnv4 next-hop (next-hop|A.B.C.D)
Parameters next-hop Specify VPNv4 next-hop address
A.B.C.D Set IP address of nexthop
Command ModeRoute-map mode
ExamplesZebOS(config)#route-map vpn1 permit 10ZebOS(config-route-map)#set vpnv4 next-hop 10.10.0.5
Related Commandsroute-map
207
BGP VPN Commands
208
CHAPTER 5 BGP Show Commands
This chapter provides an alphabetized reference for each of the BGP show commands. It includes the following commands:
• show bgp X:X::X:X on page 212
• show bgp X:X::X:X/M on page 213
• show bgp community on page 214
• show bgp community-list on page 215
• show bgp dampening on page 216
• show bgp filter-list on page 217
• show bgp inconsistent-as on page 218
• show bgp ipv4 multicast A.B.C.D on page 219
• show bgp ipv4 multicast A.B.C.D/M on page 220
• show bgp ipv4 multicast community on page 221
• show bgp ipv4 multicast community-list on page 222
• show bgp ipv4 multicast dampening on page 223
• show bgp ipv4 multicast filter-list on page 224
• show bgp ipv4 multicast inconsistent-as on page 225
• show bgp ipv4 multicast neighbors on page 226
• show bgp ipv4 multicast paths on page 227
• show bgp ipv4 multicast prefix-list on page 228
• show bgp ipv4 multicast quote-regexp on page 229
• show bgp ipv4 multicast regexp on page 230
• show bgp ipv4 multicast route-map on page 231
• show bgp ipv4 multicast summary on page 232
• show bgp ipv4 neighbors on page 233
• show bgp ipv4 paths on page 234
• show bgp ipv4 prefix-list on page 235
• show bgp ipv4 quote-regexp on page 236
• show bgp ipv4 summary on page 237
• show bgp ipv4 unicast A.B.C.D on page 238
• show bgp ipv4 unicast A.B.C.D/M on page 239
• show bgp ipv4 unicast community on page 240
• show bgp ipv4 unicast community-list on page 241
• show bgp ipv4 unicast dampening on page 242
• show bgp ipv4 unicast filter-list on page 243
• show bgp ipv4 unicast inconsistent-as on page 244
209
BGP Show Commands
• show bgp ipv4 unicast neighbors on page 245
• show bgp ipv4 unicast paths on page 246
• show bgp ipv4 unicast prefix-list on page 247
• show bgp ipv4 unicast quote-regexp on page 248
• show bgp ipv4 unicast regexp on page 249
• show bgp ipv4 unicast route-map on page 250
• show bgp ipv4 unicast summary on page 251
• show bgp ipv6 X:X::X:X on page 252
• show bgp ipv6 X:X::X:X/M on page 253
• show bgp ipv6 community on page 254
• show bgp ipv6 community-list on page 255
• show bgp ipv6 dampening on page 256
• show bgp ipv6 filter-list on page 257
• show bgp ipv6 inconsistent-as on page 258
• show bgp ipv6 labeled on page 259
• show bgp ipv6 multicast on page 260
• show bgp ipv6 neighbors on page 261
• show bgp ipv6 paths on page 262
• show bgp ipv6 prefix-list on page 263
• show bgp ipv6 quote-regexp on page 264
• show bgp ipv6 route-map on page 265
• show bgp ipv6 summary on page 266
• show bgp ipv6 unicast on page 267
• show bgp ipv6 view on page 268
• show bgp neighbors on page 269
• show bgp nexthop-tracking on page 270
• show bgp nexthop-tree-details on page 271
• show bgp paths on page 272
• show bgp prefix-list on page 273
• show bgp quote-regexp on page 274
• show bgp regexp on page 275
• show bgp route-map on page 276
• show bgp summary on page 277
• show debugging bgp on page 278
• show ip bgp A.B.C.D on page 279
• show ip bgp A.B.C.D/M on page 280
• show ip bgp attribute-info on page 281
• show ip bgp cidr-only on page 282
• show ip bgp community on page 283
210
BGP Show Commands
• show ip bgp community-info on page 284
• show ip bgp community-list on page 285
• show ip bgp dampening on page 286
• show ip bgp filter-list on page 287
• show ip bgp inconsistent-as on page 288
• show ip bgp ipv4 A.B.C.D on page 289
• show ip bgp ipv4 A.B.C.D/M on page 290
• show ip bgp ipv4 community on page 291
• show ip bgp ipv4 community-list on page 292
• show ip bgp ipv4 dampening on page 293
• show ip bgp ipv4 filter-list on page 294
• show ip bgp ipv4 inconsistent-as on page 295
• show ip bgp ipv4 neighbors on page 296
• show ip bgp ipv4 paths on page 297
• show ip bgp ipv4 prefix-list on page 298
• show ip bgp ipv4 quote-regexp on page 299
• show ip bgp ipv4 regexp on page 300
• show ip bgp ipv4 route-map on page 301
• show ip bgp ipv4 summary on page 302
• show ip bgp neighbors on page 303
• show ip bgp paths on page 305
• show ip bgp prefix-list on page 306
• show ip bgp quote-regexp on page 307
• show ip bgp regexp on page 308
• show ip bgp route-map on page 309
• show ip bgp scan on page 310
• show ip bgp summary on page 311
• show ip bgp view on page 312
• show ip bgp vpnv4 on page 313
• show ip bgp vpnv6 on page 314
• show ip extcommunity-list on page 315
• show ip protocols bgp on page 316
• show ip vrf on page 317
211
BGP Show Commands
show bgp X:X::X:XUse this command to display BGP network information.
Command Syntaxshow bgp X:X::X:X
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 3ffe::8
212
BGP Show Commands
show bgp X:X::X:X/MUse this command to display BGP network information along with mask information.
Command Syntaxshow bgp X:X::X:X/M [longer-prefixes]
Parameterslonger-prefixes Display route as well as specific route.
Command ModePrivileged Exec mode and Exec mode
ExamplesZebOS#show bgp 3ffe::8/8ZebOS#show bgp 3ffe::8/8 longer-prefixes
213
BGP Show Commands
show bgp communityUse this command to display routes matching the communities.
Command Syntaxshow bgp community [AA:NN|local-AS|no-advertise|no-export] (exact-match)
ParametersAA:NN Specify a valid value for a community number.
local-AS Do not send outside local AS .
no-advertise Do not advertise to any peer .
no-export Do not export to next AS.
exact-match Specify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp community local-AS exact-match
214
BGP Show Commands
show bgp community-listUse this command to display routes matching the community-list.
Command Syntaxshow bgp community-list [WORD (exact-match)]
ParametersWORD Identify a community-list name.
exact-match Specify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp community-list mylist exact-match
215
BGP Show Commands
show bgp dampeningUse this command to display detailed information about dampening.
Command Syntaxshow bgp dampening [dampened-paths|flap-statistics|parameters]
Parametersdampened-paths Display paths suppressed due to dampening.
flap-statisticsDisplay flap statistics of routes.
parameters Display details of configured dampening parameters.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp dampening dampened-paths
216
BGP Show Commands
show bgp filter-listUse this command to display routes conforming to the filter-list.
Command Syntaxshow bgp filter-list [WORD]
ParametersWORD Specify the regular-expression access list name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp filter-list mylist
217
BGP Show Commands
show bgp inconsistent-asUse this command to display routes with inconsistent AS Paths.
Command Syntaxshow bgp inconsistent-as
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp inconsistent-as
218
BGP Show Commands
show bgp ipv4 multicast A.B.C.DUse this command to display multicast route information for a single IP in an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast A.B.C.D
ParametersA.B.C.D Display route information for this IPv4 address.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast 1.2.3.4
219
BGP Show Commands
show bgp ipv4 multicast A.B.C.D/MUse this command to display multicast route information for a single IP and length in an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast A.B.C.D/M
ParametersA.B.C.D/M Display route information for this IPv4address and length.
None
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast 1.2.3.4/5
220
BGP Show Commands
show bgp ipv4 multicast communityUse this command to display multicast route information that match communities within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast [AA:NN|local-AS|no-advertise|no-export] (exact-match)
ParametersAA:NN Specify a valid value for a community number.
local-AS Do not send outside local AS.
no-advertise Do not advertise to any peer.
no-export Do not export to next AS.
exact-matchSpecify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast community 12:34 exact-match
221
BGP Show Commands
show bgp ipv4 multicast community-listUse this command to display multicast route information that match a community-list within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast community-list [WORD (exact-match)]
ParametersWORD Identify a community-list name
exact-match Specify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast community-list mylist exact-match
222
BGP Show Commands
show bgp ipv4 multicast dampeningUse this command to display multicast dampening information within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast dampening [dampened-paths|flap-statistics|parameters]
Parametersdampened-paths Display paths suppressed due to dampening.
flap-statisticsDisplay flap statistics of routes.
parameters Display details of configured dampening parameters.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast dampening dampened-paths
223
BGP Show Commands
show bgp ipv4 multicast filter-listUse this command to display multicast route information that conform to a filter-list within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast filter-list [WORD]
ParametersWORD Specify the regular-expression access list name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast filter-list mylist
224
BGP Show Commands
show bgp ipv4 multicast inconsistent-asUse this command to display multicast route information for inconsistent AS paths within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast inconsistent-as
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast inconsistent-as
225
BGP Show Commands
show bgp ipv4 multicast neighborsUse this command to display multicast route information for TCP and BGP neighbor connections within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast neighbors [A.B.C.D|X:X::X:X] (advertised-routes|received prefix-filter|received-routes|routes)
ParametersA.B.C.D Specify an IPv4 address.
X:X::X:X Specify an IPv6 address
advertised-routes
Display the routes advertised to a BGP neighbor.
received Display information received from a BGP neighbor.
prefix-filter
Display the prefix list filter.
received-routes
Displays the received routes from neighbor. To display all the received routes from the neighbor, configure BGP soft reconfiguration first.
routes Display all accepted routes learned from neighbors.
Command ModePrivileged Exec mode and Exec mode
ExampleThe following output displays detailed information about the neighbor.
ZebOS#show bgp ipv4 multicast neighbors 1.2.3.4 advertised-routes
226
BGP Show Commands
show bgp ipv4 multicast pathsUse this command to display multicast route information for BGP paths within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast paths
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast paths
Address Refcnt Path[0x81fa578:0] (239)
227
BGP Show Commands
show bgp ipv4 multicast prefix-listUse this command to display multicast route information that match a prefix-list within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast prefix-list [WORD]
ParametersWORD Specify the name of the IP prefix list.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast prefix-list mylist
228
BGP Show Commands
show bgp ipv4 multicast quote-regexpUse this command to display multicast route information for an AS path regular expression within an IPv4 environment. Users must use quotes to enclose the regular expression.
Command Syntaxshow bgp ipv4 multicast quote-regexp [WORD]
ParametersWORD Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast quote-regexp “IPI”
229
BGP Show Commands
show bgp ipv4 multicast regexpUse this command to display multicast route information that match the AS path regular expression within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast regexp [LINE]
ParametersLINE Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast regexp myexpression
230
BGP Show Commands
show bgp ipv4 multicast route-mapUse this command to display multicast route information that match the specified route-map within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast route-map [WORD]
ParametersWORD Specify a route-map that is matched.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast route-map IPI
231
BGP Show Commands
show bgp ipv4 multicast summaryUse this command to display a multicast route summary of a BGP neighbor status within an IPv4 environment.
Command Syntaxshow bgp ipv4 multicast summary
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 multicast summary
232
BGP Show Commands
show bgp ipv4 neighborsUse this command to display routes on TCP and BGP neighbor connections within an IPv4 environment.
Command Syntaxshow bgp ipv4 neighbors [A.B.C.D|X:X::X:X] (advertised-routes|received {prefix-filter}|received-routes|routes)
ParametersA.B.C.D Specify an IPv4 address.
X:X::X:X Specify an IPv6 address
advertised-routes
Display routes advertised to a BGP neighbor.
received Display routes received from a BGP neighbor.
prefix-filter
Display the prefix list filter.
received-routes
Display routes received from neighbor. To display all the received routes from the neighbor, configure the BGP soft reconfigure first.
routes Display all accepted routes learned from neighbors.
Command ModePrivileged Exec mode and Exec mode
ExampleThe following output displays detailed information about the neighbor.
ZebOS#show bgp ipv4 neighbors 1.2.3.4 advertised-routes
233
BGP Show Commands
show bgp ipv4 pathsUse this command to display BGP path information within an IPv4 environment.
Command Syntaxshow bgp ipv4 paths
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 paths
Address Refcnt Path[0x81fa578:0] (239)
234
BGP Show Commands
show bgp ipv4 prefix-listUse this command to display routes matching the prefix-list within an IPv4 environment.
Command Syntaxshow bgp ipv4 prefix-list [WORD]
ParametersWORD Specify the name of the IP prefix list.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 prefix-list mylist
235
BGP Show Commands
show bgp ipv4 quote-regexpUse this command to display route information for an AS path regular expression within an IPv4 environment. Users must use quotes to enclose the regular expression.
Command Syntaxshow bgp ipv4 quote-regexp [WORD]
ParametersWORD Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 quote-regexp “IPI”
236
BGP Show Commands
show bgp ipv4 summaryUse this command to display a route summary of a BGP neighbor status within an IPv4 environment.
Command Syntaxshow bgp ipv4 summary
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 summary
237
BGP Show Commands
show bgp ipv4 unicast A.B.C.DUse this command to display unicast route information for a single IP in an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast A.B.C.D
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast 1.2.3.4
238
BGP Show Commands
show bgp ipv4 unicast A.B.C.D/MUse this command to display unicast route information for a single IP and length in an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast A.B.C.D/M
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast 1.2.3.4/5
239
BGP Show Commands
show bgp ipv4 unicast communityUse this command to display unicast route information that match communities within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast [AA:NN|local-AS|no-advertise|no-export] (exact-match)
ParametersAA:NN Specify a valid value for a community number.
local-AS Do not send outside local AS.
no-advertise Do not advertise to any peer.
no-export Do not export to next AS.
exact-matchSpecify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast community 12:34 exact-match
240
BGP Show Commands
show bgp ipv4 unicast community-listUse this command to display unicast route information that match a community-list within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast community-list [WORD (exact-match)]
ParametersWORD Specify a community-list name
exact-match Specify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast community-list mylist exact-match
241
BGP Show Commands
show bgp ipv4 unicast dampeningUse this command to display unicast dampening information within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast dampening [dampened-paths|flap-statistics|parameters]
Parametersdampened-paths Display paths suppressed due to dampening.
flap-statisticsDisplay flap statistics of routes.
parameters Display details of configured dampening parameters.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast dampening dampened-paths
242
BGP Show Commands
show bgp ipv4 unicast filter-listUse this command to display unicast route information that conforming to a filter-list within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast filter-list [WORD]
ParametersWORD Specify the regular-expression access list name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast filter-list mylist
243
BGP Show Commands
show bgp ipv4 unicast inconsistent-asUse this command to display unicast route information that have inconsistent AS paths within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast inconsistent-as
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast inconsistent-as
244
BGP Show Commands
show bgp ipv4 unicast neighborsUse this command to display unicast route information on TCP and BGP neighbor connections within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast neighbors [A.B.C.D|X:X::X:X] (advertised-routes|received {prefix-filter}|received-routes|routes)
ParametersA.B.C.D Specify an IPv4 address.
X:X::X:X Specify an IPv6 address
advertised-routes
Display the routes advertised to a BGP neighbor.
received Display information received from a BGP neighbor.
prefix-filter
Display the prefix list filter
received-routes
Display routes received from a neighbor. To display all the received routes from the neighbor, configure the BGP soft reconfigure first.
routes Display all accepted routes learned from neighbors.
Command ModePrivileged Exec mode and Exec mode
ExampleThe following output displays detailed information about the neighbor.
ZebOS#show bgp ipv4 unicast neighbors 1.2.3.4 advertised-routes
245
BGP Show Commands
show bgp ipv4 unicast pathsUse this command to display unicast BGP path information within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast paths
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast paths
Address Refcnt Path[0x81fa578:0] (239)
246
BGP Show Commands
show bgp ipv4 unicast prefix-listUse this command to display unicast route information that match the prefix-list within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast prefix-list [WORD]
ParametersWORD Specify the name of the IP prefix list.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast prefix-list mylist
247
BGP Show Commands
show bgp ipv4 unicast quote-regexpUse this command to display unicast routes matching the AS path regular expression in quotes within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast quote-regexp [WORD]
ParametersWORD Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast quote-regexp “IPI”
248
BGP Show Commands
show bgp ipv4 unicast regexpUse this command to display unicast route information that match the AS path regular expression within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast regexp [LINE]
ParametersLINE Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast regexp myexpression
249
BGP Show Commands
show bgp ipv4 unicast route-mapUse this command to display unicast route information that match the specified route-map within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast route-map [WORD]
ParametersWORD Specify a route-map that is matched.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast route-map IPI
250
BGP Show Commands
show bgp ipv4 unicast summaryUse this command to display a unicast route summary of the BGP neighbor status within an IPv4 environment.
Command Syntaxshow bgp ipv4 unicast summary
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv4 unicast summary
251
BGP Show Commands
show bgp ipv6 X:X::X:XUse this command to display IPv6 prefix information.
Command Syntaxshow bgp ipv4 X:X::X:X
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 1:2::3:4
252
BGP Show Commands
show bgp ipv6 X:X::X:X/MUse this command to display IPv6 prefix information along with mask information.
Command Syntaxshow bgp ipv4 X:X::X:X/M
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 1:2::3:4/5
253
BGP Show Commands
show bgp ipv6 communityUse this command to display route information that match communities within an IPv6 environment.
Command Syntaxshow bgp ipv6 [AA:NN|local-AS|no-advertise|no-export] (exact-match)
ParametersAA:NN Specify a valid value for a community number.
local-AS Do not send outside local AS.
no-advertise Do not advertise to any peer.
no-export Do not export to next AS.
exact-matchSpecify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 community 12:34 exact-match
254
BGP Show Commands
show bgp ipv6 community-listUse this command to display route information that match a community-list within an IPv6 environment.
Command Syntaxshow bgp ipv6 community-list [WORD (exact-match)]
ParametersWORD Specify a community-list name
exact-match Specify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 community-list mylist exact-match
255
BGP Show Commands
show bgp ipv6 dampeningUse this command to display detailed information about dampening in IPv6 environments. Enable BGP IPv6 dampening to maintain dampened-path information in memory.
Command Syntaxshow bgp ipv6 dampening [dampened-paths|flap-statistics|parameters]
Parametersdampened-paths Display paths suppressed due to dampening.
flap-statistics
Display flap statistics of routes.
parameters Display details of configured dampening parameters.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 dampening dampened-paths
256
BGP Show Commands
show bgp ipv6 filter-listUse this command to display route information that conform to a filter-list within an IPv6 environment.
Command Syntaxshow bgp ipv6 filter-list [WORD]
ParametersWORD Specify the regular-expression access list name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 filter-list mylist
257
BGP Show Commands
show bgp ipv6 inconsistent-asUse this command to display route information for inconsistent AS paths within an IPv6 environment.
Command Syntaxshow bgp ipv6 multicast inconsistent-as
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 inconsistent-as
258
BGP Show Commands
show bgp ipv6 labeledUse this command to display the labeled IPv6 routes received from the ingress 6PE to the egress 6PE, along with the label value.
Command Syntaxshow bgp ipv6 labeled [X:X::X:X/M (longer-prefixes)]
ParametersX:X::X:X/M IPv6 prefix <network>/<length>, for example, 3ffe:a::/64
longer-prefixes
Display route as well as a specific route.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 labeled 3ffe:a::/64 BGP routing table entry for 3ffe:a::/64 Paths: (1 available, best #1, table Default-IP-Routing-Table) Not advertised to any peer Local ::ffff:114:1414 from 20.20.20.1 (92.92.92.92) Origin incomplete metric 0, localpref 100, label 5420, valid, internal, best Last update: Mon May 26 17:48:18 2008
259
BGP Show Commands
show bgp ipv6 multicastUse this command to display multicast IPv6 routes.
Command Syntaxshow bgp ipv6 multicast [X:X::X:X|X:X::X:X/M (longer-prefixes)]
ParametersX:X::X:X IPv6 prefix <network>, for example, 3ffe:a::
X:X::X:X/M IPv6 prefix <network>/<length>, for example, 3ffe:a::/64
longer-prefixes
Display route as well as a specific routes.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 multicast 3ffe:a::/64
260
BGP Show Commands
show bgp ipv6 neighborsUse this command to display route information on TCP and BGP neighbor connections within an IPv6 environment.
Command Syntaxshow bgp ipv6 neighbors [A.B.C.D|X:X::X:X] (advertised-routes|received {prefix-filter}|received-routes|routes)
ParametersA.B.C.D Specify an IPv4 address.
X:X::X:X Specify an IPv6 address
advertised-routes
Displays the routes advertised to a BGP neighbor.
received Display information received from a BGP neighbor.
prefix-filter
Display the prefix list filter
received-routes
Displays the received routes from neighbor. To display all the received routes from the neighbor, configure the BGP soft reconfigure first.
routes Displays all accepted routes learned from neighbors.
Command ModePrivileged Exec mode and Exec mode
ExampleThe following output displays detailed information about the neighbor.
ZebOS#show bgp ipv6 neighbors 1.2.3.4 advertised-routes
261
BGP Show Commands
show bgp ipv6 pathsUse this command to display BGP path information within an IPv6 environment.
Command Syntaxshow bgp ipv6 paths
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 paths
Address Refcnt Path[0x81fa578:0] (239)
262
BGP Show Commands
show bgp ipv6 prefix-listUse this command to display routes matching the prefix-list within an IPv6 environment.
Command Syntaxshow bgp ipv6 prefix-list [WORD]
ParametersWORD Specify the name of the IP prefix list.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 prefix-list mylist
263
BGP Show Commands
show bgp ipv6 quote-regexpUse this command to display route information for an AS path regular expression within an IPv6 environment. Users must use quotes to enclose the regular expression.
Command Syntaxshow bgp ipv6 quote-regexp [WORD]
ParametersWORD Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 quote-regexp “IPI”
264
BGP Show Commands
show bgp ipv6 route-mapUse this command to display route information that match the specified route-map within an IPv6 environment.
Command Syntaxshow bgp ipv6 route-map [WORD]
ParametersWORD Specify a route-map that is matched.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 route-map IPI
265
BGP Show Commands
show bgp ipv6 summaryUse this command to display a route summary of a BGP neighbor status within an IPv6 environment.
Command Syntaxshow bgp ipv6 summary
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 summary
266
BGP Show Commands
show bgp ipv6 unicastUse this command to display unicast IPv6 routes.
Command Syntaxshow bgp ipv6 unicast [X:X::X:X|X:X::X:X/M (longer-prefixes)]
ParametersX:X::X:X IPv6 prefix <network>, for example, 3ffe:a::
X:X::X:X/M IPv6 prefix <network>/<length>, for example, 3ffe:a::/64
longer-prefixes
Display route as well as a specific route.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 unicast 3ffe:a::/64
267
BGP Show Commands
show bgp ipv6 viewUse this command to display information on a specific BGP view.
Command Syntaxshow bgp ipv6 view [WORD]
ParameterWORD A BGP view name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp ipv6 view myview
268
BGP Show Commands
show bgp neighborsUse this command to display detailed information on TCP and BGP neighbor connections.
Command Syntaxshow bgp neighbors [A.B.C.D|X:X::X:X] (advertised-routes|received {prefix-filter}|received-routes|routes)
ParametersA.B.C.D Specify an IPv4 address.
X:X::X:X Specify an IPv6 address
advertised-routes
Displays the routes advertised to a BGP neighbor.
received Display information received from a BGP neighbor.
prefix-filter
Display the prefix list filter
received-routes
Displays the received routes from neighbor. To display all the received routes from the neighbor, configure the BGP soft reconfigure first.
routes Displays all accepted routes learned from neighbors.
Command ModePrivileged Exec mode and Exec mode
ExampleThe following output displays detailed information about the neighbor.
ZebOS#show bgp neighborsBGP neighbor is fe80::203:47ff:feb0:d72b, remote AS 10, local AS 10, internal link BGP version 4, remote router ID 10.10.10.50 BGP state = Established, up for 00:02:01 Last read 00:00:01, hold time is 180, keepalive interval is 60 seconds Neighbor capabilities: Route refresh: advertised and received (old and new) Address family IPv4 Unicast: advertised and received Address family IPv6 Unicast: advertised and received Received 3 messages, 0 notifications, 0 in queue Sent 5 messages, 0 notifications, 0 in queue Route refresh request: received 0, sent 0 Minimum time between advertisement runs is 5 seconds For address family: IPv4 Unicast Community attribute sent to this neighbor (both) 0 accepted prefixes 0 announced prefixes
269
BGP Show Commands
show bgp nexthop-trackingUse this command to display BGP nexthop-tracking status.
Command Syntaxshow bgp nexthop-tracking
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp nexthop-trackingConfigured NHT: ENABLEDNHT Delay time-interval : 6BGP VRF: (Default) VRF_ID 0BGP Instance: (Default), AS: 100, router-id 4.4.4.40NHT is EnabledRecvd Msg count from NSM: 0NHT delay-timer remaining seconds: 0BGP nexthop(s):Total number of IPV4 nexthops: 0Total number of IPV6 nexthops: 0
BGP VRF: VRF_A VRF_ID 2BGP Instance: (Default), AS: 100, router-id 4.4.4.40NHT is EnabledRecvd Msg count from NSM: 0NHT delay-timer remaining seconds: 0BGP nexthop(s):Total number of IPV4 nexthops: 0Total number of IPV6 nexthops: 0
270
BGP Show Commands
show bgp nexthop-tree-detailsUse this command to display BGP nexthop-tree details.
Command Syntaxshow bgp nexthop-tree-details
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp nexthop-tree-detailsConfigured NHT: ENABLEDNHT Delay time-interval: 6BGP VRF: (Default) VRF_ID 0BGP Instance: (Default), AS: 100, router-id 4.4.4.40NHT is EnabledRecvd Msg count from NSM: 0NHT delay-timer remaining seconds: 0BGP nexthop(s):Total number of IPV4 nexthops: 0Total number of IPV6 nexthops: 0
BGP VRF: VRF_A VRF_ID 2BGP Instance: (Default), AS: 100, router-id 4.4.4.40NHT is EnabledRecvd Msg count from NSM: 0NHT delay-timer remaining seconds: 0BGP nexthop(s):Total number of IPV4 nexthops: 0Total number of IPV6 nexthops: 0
TSUP40#TSUP40#show bgp nexthop-tree-detailsBGP Instance: (Default), AS: 100, router-id 4.4.4.40AFI_IP Nexthop count: 0AFI_IP6 Nexthop count: 0
BGP Instance: (Default), AS: 0, router-id 0.0.0.0AFI_IP Nexthop count: 0AFI_IP6 Nexthop count: 0
BGP Instance: (Default), AS: 100, router-id 4.4.4.40
271
BGP Show Commands
show bgp pathsUse this command to display BGP path information.
Command Syntaxshow bgp paths
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp paths
Address Refcnt Path[0x81fa578:0] (239)
272
BGP Show Commands
show bgp prefix-listUse this command to display routes matching the prefix-list.
Command Syntaxshow bgp prefix-list [WORD]
ParametersWORD Specify the name of the IP prefix list.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp prefix-list mylist
273
BGP Show Commands
show bgp quote-regexpUse this command to display route information for an AS path regular expression. Users must use quotes to enclose the regular expression.
Command Syntaxshow bgp quote-regexp [WORD]
ParametersWORD Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp quote-regexp “IPI”
274
BGP Show Commands
show bgp regexpUse this command to display routes matching the AS path regular expression.
Command Syntaxshow bgp regexp [LINE]
ParametersLINE Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp regexp myexpression
275
BGP Show Commands
show bgp route-mapUse this command to display routes that match the specified route-map.
Command Syntaxshow bgp route-map [WORD]
ParametersWORD Specify a route-map that is matched.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp route-map IPI
276
BGP Show Commands
show bgp summaryUse this command to display a summary of BGP neighbor status.
Command Syntaxshow bgp summary
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show bgp summary
277
BGP Show Commands
show debugging bgpUse this command to display the BGP debugging option set.
Command Syntaxshow debugging bgp
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleThis is a sample output from the show debugging bgp command.
ZebOS#show debugging bgpBGP debugging status: BGP debugging is on BGP events debugging is on BGP updates debugging is on BGP fsm debugging is on
278
BGP Show Commands
show ip bgp A.B.C.DUse this command to display BGP network information for a specific IP address.
Command Syntaxshow ip bgp A.B.C.D
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleThis is a sample output from the show ip bgp command displaying BGP network information.
ZebOS#show ip bgp 192.10.23.67BGP table version is 7, local router ID is 80.80.80.80Status codes: s suppressed, d damped, h history, * valid, > best, i - internal, S StaleOrigin codes: i - IGP, e - EGP,? - incomplete Network Next Hop Metric LocPrf Weight PathS>i10.70.0.0/24 192.10.23.67 0 100 0 ?S>i30.30.30.30/32 192.10.23.67 0 100 0 ?S>i63.63.63.1/32 192.10.23.67 0 100 0 ?S>i67.67.67.67/32 192.10.23.67 0 100 0 ?S>i172.22.10.0/24 192.10.23.67 0 100 0 ?S>i192.10.21.0 192.10.23.67 0 100 0 ?S>i192.10.23.0 192.10.23.67 0 100 0 ?Total number of prefixes 7
279
BGP Show Commands
show ip bgp A.B.C.D/MUse this command to display BGP network information for a specific IP address and length.
Command Syntaxshow ip bgp A.B.C.D/M
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleThis is a sample output from the show ip bgp command displaying BGP network information.
ZebOS#show ip bgp 192.10.23.67/1
280
BGP Show Commands
show ip bgp attribute-infoUse this command to show internal attribute hash information.
Command Syntaxshow ip bgp attribute-info
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleThis is a sample output from the show ip bgp attribute-info command displaying internal attribute information.
ZebOS#show ip bgp attribute-infoattr[1] nexthop 0.0.0.0attr[1] nexthop 10.10.10.10
281
BGP Show Commands
show ip bgp cidr-onlyUse this command to display routes with non-natural network masks.
Command Syntaxshow ip bgp cidr-only
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleThis is a sample output from the show ip bgp cidr-only command.
ZebOS#show ip bgp cidr-onlyBGP table version is 0, local router ID is 10.10.10.50Status codes: s suppressed, d damped, h history, p stale, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Network Next Hop Metric LocPrf Weight Path*> 3.3.3.0/24 10.10.10.10 0 11 iTotal number of prefixes 2
282
BGP Show Commands
show ip bgp communityUse this command to display routes matching the communities.
Command Syntaxshow ip bgp community [AA:NN|local-AS|no-advertise|no-export] (exact-match)
ParametersAA:NN Specify a valid value for a community number.
local-AS Do not send outside local AS.
no-advertise Do not advertise to any peer.
no-export Do not export to next AS.
exact-match Exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp community 10:23 exact-match
283
BGP Show Commands
show ip bgp community-infoUse this command to list all BGP community information.
Command Syntaxshow ip bgp community-info
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp community-info
Address Refcnt Community
284
BGP Show Commands
show ip bgp community-listUse this command to display routes that match the community-list.
Command Syntaxshow ip bgp community-list [WORD (exact-match)]
ParametersWORD Specify the community list name.
exact-match Displays only routes that have exactly the same specified communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp community-list mylist exact-match
285
BGP Show Commands
show ip bgp dampeningUse this command to display detailed information about dampening.
Command Syntaxshow ip bgp dampening [dampened-paths|flap-statistics|parameters]
Parametersdampened-paths Display paths suppressed due to dampening.
flap-statistics
Display flap statistics of routes.
parameters Display details of configured dampening parameters.
Command ModePrivileged Exec mode and Exec mode
ExamplesEnable BGP dampening to maintain dampened-path information in memory. The following is a sample output displaying all the dampening parameters:
ZebOS#show ip bgp dampening parameters dampening 15 750 2000 60 15 Reachability Half-Life time : 15 min Reuse penalty : 750 Suppress penalty : 2000 Max suppress time : 60 min Un-reachability Half-Life time : 15 min Max penalty (ceil) : 11999
This sample output shows that the internal route (i), has flapped 3 times and is now categorized as history (h).
ZebOS#show ip bgp dampening flap-statisticsBGP table version is 1, local router ID is 30.30.30.77Status codes: s suppressed, d damped, h history, * valid, > best, i - internal, S StaleOrigin codes: i - IGP, e - EGP, ? - incomplete Network From Flaps Duration Reuse Path hi1.1.1.0/24 10.100.0.62 3 00:01:20 i
286
BGP Show Commands
show ip bgp filter-listUse this command to display routes conforming to the filter-list.
Command Syntaxshow ip bgp filter-list [WORD]
ParametersWORD Specify the regular-expression access list name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp filter-list mylist
287
BGP Show Commands
show ip bgp inconsistent-asUse this command to display routes with inconsistent AS Paths.
Command Syntaxshow ip bgp inconsistent-as
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExamplesZebOS#show ip bgp inconsistent-asZebOS#show ip bgp ipv4 unicast inconsistent-as
288
BGP Show Commands
show ip bgp ipv4 A.B.C.DUse this command to display either multicast or unicast route information for a single IP in an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] A.B.C.D
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast 1.2.3.4
289
BGP Show Commands
show ip bgp ipv4 A.B.C.D/MUse this command to display either multicast or unicast information for a single IP and length in an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] A.B.C.D/M
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast 1.2.3.4/5
290
BGP Show Commands
show ip bgp ipv4 communityUse this command to display either multicast or unicast route information that match communities within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] (AA:NN|local-AS|no-advertise|no-export) {exact-match}
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
AA:NN Specify a valid value for a community number.
local-AS Do not send outside local AS.
no-advertise Do not advertise to any peer.
no-export Do not export to next AS.
exact-match Specify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast community 12:34 exact-match
291
BGP Show Commands
show ip bgp ipv4 community-listUse this command to display either multicast or unicast route information that match a community-list within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] community-list [WORD (exact-match)]
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
WORD Specify a community-list name.
exact-match Specify that ZebOS display the exact match of the communities.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast community-list mylist exact-match
292
BGP Show Commands
show ip bgp ipv4 dampeningUse this command to display either multicast or unicast dampening information within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] dampening [dampened-paths|flap-statistics|parameters]
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
dampened-paths
Display paths suppressed due to dampening.
flap-statistics
Display flap statistics of routes.
parameters Display details of configured dampening parameters.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast dampening dampened-paths
293
BGP Show Commands
show ip bgp ipv4 filter-listUse this command to display either multicast or unicast route information that conform to a filter-list within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] filter-list [WORD]
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
WORD Specify the regular-expression access list name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast filter-list mylist
294
BGP Show Commands
show ip bgp ipv4 inconsistent-asUse this command to display either multicast or unicast route information for inconsistent AS paths within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] inconsistent-as
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast inconsistent-as
295
BGP Show Commands
show ip bgp ipv4 neighborsUse this command to display either multicast or unicast route information for TCP and BGP neighbor connections within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] neighbors [A.B.C.D|X:X::X:X] (advertised-routes|received {prefix-filter}|received-routes|routes)
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
A.B.C.D Specify an IPv4 address.
X:X::X:X Specify an IPv6 address
advertised-routes
Display the routes advertised to a BGP neighbor.
received Display information received from a BGP neighbor.
prefix-filter
Display the prefix list filter
received-routes
Displays the received routes from neighbor. To display all the received routes from the neighbor, configure the BGP soft reconfigure first.
routes Displays all accepted routes learned from neighbors.
Command ModePrivileged Exec mode and Exec mode
ExampleThe following output displays detailed information about the neighbor.
ZebOS#show ip bgp ipv4 multicast neighbors 1.2.3.4 advertised-routes
296
BGP Show Commands
show ip bgp ipv4 pathsUse this command to display either multicast or unicast route information for BGP paths within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] paths
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 unicast paths
Address Refcnt Path[0x81fa578:0] (239)
297
BGP Show Commands
show ip bgp ipv4 prefix-listUse this command to display either multicast or unicast route information that match a prefix-list within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] prefix-list [WORD]
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
WORD Specify the name of the IP prefix list.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast prefix-list mylist
298
BGP Show Commands
show ip bgp ipv4 quote-regexpUse this command to display either multicast or unicast route information for an AS path regular expression within an IPv4 environment. Users must use quotes to enclose the regular expression.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] quote-regexp [WORD]
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
WORD Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 unicast quote-regexp “IPI”
299
BGP Show Commands
show ip bgp ipv4 regexpUse this command to display either multicast or unicast route information that match the AS path regular expression within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] regexp [LINE]
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
LINE Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast regexp myexpression
300
BGP Show Commands
show ip bgp ipv4 route-mapUse this command to display either multicast or unicast route information that match the specified route-map within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] route-map [WORD]
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
WORD Specify a route-map that is matched.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 unicast route-map IPI
301
BGP Show Commands
show ip bgp ipv4 summaryUse this command to display either multicast or unicast route summary of a BGP neighbor status within an IPv4 environment.
Command Syntaxshow ip bgp ipv4 [multicast|unicast] summary
Parametersmulticast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp ipv4 multicast summary
302
BGP Show Commands
show ip bgp neighborsUse this command to display detailed information on TCP and BGP neighbor connections.
Command Syntaxshow ip bgp neighbors [A.B.C.D|X:X::X:X] (advertised-routes|connection-retrytime|hold-time|keepalive|keepalive-interval|notification|open|rcvd-msgs|received {prefix-filter}|received-routes|routes|sent-msgs|update)
ParametersA.B.C.D Specify an IPv4 address.
X:X::X:X Specify an IPv6 address
advertised-routes
Displays the routes advertised to a BGP neighbor.
connection-retrytime
Display the configured connection-retry-time value of the peer at the session establishment time with the neighbor.
hold-time Display the configured hold-time value of the peer at the session establishment time with the neighbor.
keepalive Display the number of keepalive messages sent to the neighbor from the peer throughout the session.
keepalive-interval
Display the configured keepalive-interval value of the peer at the session establishment time with the neighbor.
notification
Display the number of notification messages sent to the neighbor from the peer throughout the session.
open Display the number of open messages sent to neighbors from peers throughout a session.
rcvd-msgs Display the number of messages received by a neighbor from peers throughout a session.
received Display information received from a BGP neighbor.
prefix-filter
Display the prefix list filter mode
received-routes
Displays the received routes from neighbor. To display all the received routes from the neighbor, configure the BGP soft reconfigure first.
routes Displays all accepted routes learned from neighbors.
sent-msgs Display the number of messages sent to the neighbor from the peer throughout the session.
update Display the number of update messages sent to the neighbor from the peer throughout the session.
Command ModePrivileged Exec mode and Exec mode
303
BGP Show Commands
ExampleThis sample output from the show ip bgp neighbors command displays information about the specified neighbor.
ZebOS#show ip bgp neighborsBGP neighbor is 192.10.23.67, remote AS 1, local AS 1, internal link BGP version 4, remote router ID 172.22.10.10 BGP state = Established, up for 00:00:22 Last read 00:00:22, hold time is 240, keepalive interval is 60 seconds Neighbor capabilities: Route refresh: advertised and received (old and new) Address family IPv4 Unicast: advertised and received Received 3 messages, 0 notifications, 0 in queue Sent 3 messages, 0 notifications, 0 in queue Route refresh request: received 0, sent 0 Minimum time between advertisement runs is 5 seconds For address family: IPv4 Unicast BGP table version 1, neighbor version 1 Index 1, Offset 0, Mask 0x2 AF-dependant capabilities: Graceful restart: advertised, received Community attribute sent to this neighbor (both)
ZebOS#show ip bgp neighbors 3ffe::5 connection-retrytime
ZebOS#show ip bgp neighbors 3ffe::5/64 hold-time
ZebOS#show ip bgp neighbors 3ffe::5 keepalive
ZebOS#show ip bgp neighbors 10.11.4.26 keepalive-interval
ZebOS#show ip bgp neighbors 10.11.4.26 notification
ZebOS#show ip bgp neighbors 10.11.4.26 open
ZebOS#show ip bgp neighbors 10.11.4.26 rcvd-msgs
ZebOS#show ip bgp neighbors 10.11.4.26 sent-msgs
304
BGP Show Commands
show ip bgp pathsUse this command to display BGP path information.
Command Syntaxshow ip bgp paths
ParametersNone
Command ModePrivileged Exec mode
ExampleZebOS#show ip bgp paths
305
BGP Show Commands
show ip bgp prefix-listUse this command to display routes matching the prefix-list.
Command Syntaxshow ip bgp prefix-list [LIST]
ParametersLIST Specify the name of the IP prefix list.
Command ModePrivileged Exec mode
ExampleZebOS#show ip bgp prefix-list mylist
306
BGP Show Commands
show ip bgp quote-regexpUse this command to display routes matching the AS path regular expression in quotes.
Command Syntaxshow ip bgp quote-regexp [WORD]
ParametersWORD Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp quote-regexp “IPI”
307
BGP Show Commands
show ip bgp regexpUse this command to display routes matching the AS path regular expression.
Command Syntaxshow ip bgp regexp [LINE]
ParametersLINE Specify a regular-expression to match the BGP AS paths.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp regexp myexpression
308
BGP Show Commands
show ip bgp route-mapUse this command to display routes that match the specified route-map.
Command Syntaxshow ip bgp route-map [WORD]
ParametersWORD Specify a route-map that is matched.
Command ModePrivileged Exec mode and Exec mode
ExamplesZebOS#show ip bgp route-map IPIZebOS#show ip bgp ipv4 unicast route-map IPI
309
BGP Show Commands
show ip bgp scanUse this command to display BGP scan status.
Command Syntaxshow ip bgp scan
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp scanBGP scan is runningBGP scan interval is 60BGP instance: AS is 11,DEFAULTCurrent BGP nexthop cache:BGP connected route: 10.10.10.0/24 10.10.11.0/24
310
BGP Show Commands
show ip bgp summaryUse this command to display a summary of BGP neighbor status.
Command Syntaxshow ip bgp summary
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleThis is a sample output from the show ip bgp summary command displaying a summary of BGP neighbor status.
ZebOS#show ip bgp summaryBGP router identifier 10.10.15.50, local AS number 650001 BGP AS-PATH entries0 BGP community entries
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd10.10.9.50 4 65000 460 595 0 0 00:17:48 310.10.14.51 4 100 93 120 0 0 0 00:42:16 0
Total number of neighbors 2
311
BGP Show Commands
show ip bgp viewUse this command to view the neighbors of the given instance.
Command Syntaxshow ip bgp view [WORD|A.B.C.D|A.B.C.D/M|ipv4 (multicast|unicast (summary)|neighbors (A.B.C.D|X:X::X:X)|summary]
ParametersWORD Display a BGP view name.
A.B.C.D Network in the BGP routing table to display
A.B.C.D/M IP prefix <network>/<length>, for example, 35.0.0.0/8
ipv4 IPv4 address family.
multicast Set address-family modifier to multicast.
unicast Set address-family modifier to unicast.
summary Summary of BGP neighbor status.
neighbors Detailed information on TCP and BGP neighbor connections.
A.B.C.D IPv4 neighbor to display information about.
X:X::X:X IPv6 neighbor to display information about.
summary Summary of BGP neighbor status.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp view I2BGP table version is 0, local router ID is 10.10.10.50Status codes: s suppressed, d damped, h history, p stale, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path*>i100.156.70.0/24 10.10.10.52 0 0 i*>i100.156.71.0/24 10.10.10.52 0 0 i*>i100.156.72.0/24 10.10.10.52 0 0 i*>i100.156.73.0/24 10.10.10.52 0 0 i*>i100.156.74.0/24 10.10.10.52 0 0 i
Total number of prefixes 5
312
BGP Show Commands
show ip bgp vpnv4Use this command to display VPNv4 NLRI specific information.
Command Syntaxshow ip bgp vpnv4 [all (A.B.C.D|neighbors (A.B.C.D)|summary|tags)] [rd (WORD|A.B.C.D|label|neighbors (A.B.C.D)|summary)] [view (WORD|all)] [vrf (NAME|A.B.C.D|label|summary)]
Parametersall Displays information about all VPNv4 NLRIs.
rd Display information for a route distinguisher.
view Display VPNv4 NLRI-specific information.
WORD BGP view name.
all Display information about all VPNv4 NLRIs.
vrf Display information about VRF VPNv4 NLRIs
NAME VPN Routing/Forwarding instance name
A.B.C.D Network for which information displays in the BGP routing table.
label Display MPLS Labels for prefixes.
neighbors Detailed information about TCP and BGP neighbor connections.
summary Displays summary BGP neighbor status.
tags BGP specifies tags for prefixes.
A.B.C.D Address of the neighbor.
Command ModePrivileged Exec mode and Exec mode
ExampleThis is a sample output from the show ip bgp vpnv4 command displaying VPNv4 specific information
ZebOS#show ip bgp vpnv4 all Network Next Hop Metric LocPrf Weight PathRoute Distinguisher: 100:1 (VRF1)* i 10.10.9.0/24 10.10.0.1 0 141 0 65000 ?*> 10.10.9.0/24 10.10.14.50 0 0 65000 ?*> 10.10.10.0/24 10.10.14.50 0 65000 ?* i 10.10.15.0/24 10.10.0.1 141 0 65000 ?*> 10.10.15.0/24 10.10.14.50 0 0 65000 ?
313
BGP Show Commands
show ip bgp vpnv6Use this command to display VPNv6 NLRI specific information.
Command Syntaxshow ip bgp vpnv6 [all (A:B::C:D|neighbors {A.B.C.D}|summary|tags)] [rd (WORD|X:X:X:X|label|neighbors {A.B.C.D}|summary)] [view (WORD|all)] [vrf (NAME|X:X::X:X|label|summary)]
Parametersall Displays information about all VPNv4 NLRIs.
rd Display information for a route distinguisher
WORD BGP view name.
view Display VPNv4 NLRI-specific information.
all Displays information about all VPNv4 NLRIs.
vrf Display information about VRF VPNv4 NLRIs
NAME VPN Routing/Forwarding instance name
A:B::C:D Network for which information displays in the BGP routing table.
X:X::X:X Network in the BGP routing table to display
label Display MPLS Labels for prefixes.
neighbors Detailed information about TCP and BGP neighbor connections.
summary Displays summary BGP neighbor status.
tags BGP specifies tags for prefixes.
A.B.C.D Address of the neighbor
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip bgp vpnv6 all
314
BGP Show Commands
show ip extcommunity-listUse this command to display a configured extcommunity-list.
Command Syntaxshow ip extcommunity-list [<1-199>|WORD]
Parameters<1-199> Extended community-list number.
WORD Extended community-list name.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip extcommunity-list 33
315
BGP Show Commands
show ip protocols bgpUse this command to display BGP process parameters and statistics.
Command Syntaxshow ip protocols bgp
ParametersNone
Command ModePrivileged Exec mode and Exec mode
ExampleThis is an example of the output from the show ip protocols command:
ZebOS#show ip protocols bgpRouting Protocol is “bgp 100" Sending updates every 30 seconds with +/-50%, next due in 12 seconds Timeout after 180 seconds, garbage collect after 120 seconds Outgoing update filter list for all interface is not set Incoming update filter list for all interface is not set Default redistribution metric is 1 Redistributing: connected static Default version control: send version 2, receive version 2 Interface Send Recv Key-chain eth0 2 2 Routing for Networks: 10.10.0.0/24 Routing Information Sources: Gateway BadPackets BadRoutes Distance Last Update Distance: (default is 120
316
BGP Show Commands
show ip vrfUse this command to display the routing information of the VRF. This command shows VRF related information, such as interface, Route Distinguisher, Route-target, etc.
Command Syntaxshow ip vrf (NAME)
ParameterNAME A name used to identify a VRF.
Command ModePrivileged Exec mode and Exec mode
ExampleZebOS#show ip vrf VRF_AVRF VRF_A; (table=1)
317
BGP Show Commands
318
Appendix A Regular Expressions
This appendix describes regular expression special characters that are used in commands such as ip as-path access-list and ip community-list expanded. You can use these characters in combination to build complex regular expressions.
Symbol Character Meaning
^ Caret Used to match the beginning of the input string. When used at the beginning of a string of characters, it negates a pattern match
$ Dollar sign Used to match the end of the input string
. Period Used to match a single character (white spaces included)
* Asterisk Used to match none or more sequences of a pattern
+ Plus sign Used to match one or more sequences of a pattern
? Question mark Used to match none or one occurrence of a pattern
_ Underscore Used to match spaces, commas, braces, parenthesis, or the beginning and end of an input string
[] Brackets Specify a range of single-characters
- Hyphen Separates the end points of a range
319
Regular Expressions
320
Index
Symbols, meaning in command syntax notation 3, meaning in command syntax notation 3(), meaning in command syntax notation 3|, meaning in command syntax notation 3
Aabbreviated commands 2access-list
see ZebOS NSM Command Referenceaddress family command mode 7address family mode 8address-family ipv6 labeled-unicast 152aggregate-address command 153aggregate-nexthop-check 22angle brackets, meaning in command syntax notation 3auto-summary 21
Bbanner motd
see ZebOS NSM Command Referencebegin 5BGP Commands
address-family 19aggregate-address 20auto-summary 21bgp aggregate-nexthop-check 22bgp always-compare-med 23bgp bestpath as-path ignore 24, 25bgp bestpath compare-confed-aspath 26bgp bestpath compare-routerid 27bgp bestpath med 29bgp client-to-client reflection 31bgp cluster-id 32bgp confederation identifier 33bgp confederation peer 34bgp config-type 35bgp dampening 36bgp default ipv4-unicast 37bgp default local-preference 38bgp deterministic med 39bgp enforce-first-as 40bgp extended-asn-cap 41bgp fast-external-failover 42bgp graceful-restart 43bgp log-neighbor-changes 45bgp multiple-instance 46bgp nexthop delay 48bgp nexthop enable 49bgp nexthop-trigger-count 47
bgp rfc1771-path-select 50bgp rfc1771-strict 51bgp router-id 52bgp scan-time 53bgp update-delay 54clear bgp * 55clear bgp A.B.C.D| X:X::X:X 57, 58, 154clear bgp ASN 56clear bgp external 59, 73, 74, 159clear bgp peer-group 61clear bgp view 62clear ip bgp * 63clear ip bgp A.B.C.D|X:X::X:X 67, 69, 187clear ip bgp ASN 65clear ip bgp dampening 70clear ip bgp external 71clear ip bgp flap-statistics 72clear ip bgp peer-group 75clear ip bgp view 76debug bgp 77distance 78dump bgp all 79dump bgp routes-mrt 80dump bgp updates 81exit address family mode 82ip as-path access-list 83ip community-list 84, 86ip community-list expanded 85, 87ip community-list standard 88ip extcommunity-list
expanded 89, 90, 91standard 92
ip prefix-list 93, 94match
as-path 93, 94mpls-resolution 93, 94neighbor
activate 95, 163, 194advertisement-interval 96capability dynamic 100capability graceful-restart 101capability orf prefix-list 102, 165capability route-refresh 103collide-established 104default-originate 106, 166distribute-list 109dont-capability-negotiate 110ebgp-multihop 111enforce-multihop 112filter-list 113, 114maximum-prefix 116, 169
Index - 1
Index
next-hop-self 117override-capability 118peer-group add 120port 121remote-as 123remove private-as 124restart-time 125route-map 126route-reflector-client 127route-server-client 129send-community 129shutdown 130soft-reconfiguration 131, 177strict-capability-match 132timers 133transparent-as 134transparent-nexthop 135unsuppress-map 136, 178update-source 137version 138weight 139
neighbor attribute-unchanged 98, 164neighbor connection-retry-time 105neighbor disallow-infinite-holdtime 108neighbor passive 119neighbor prefix-list 122network 140network and network backdoor 179redistribute 142restart bgp graceful 143router bgp 144router bgp view 145show
ip bgp attribute-info 281ip bgp cidr-only 282ip bgp community 283ip bgp community-info 284ip bgp community-list 285ip bgp dampened-paths 286ip bgp filter-list 287ip bgp neighbors 303ip bgp paths 305ip bgp prefix-list 306ip bgp regexp 308ip bgp scan 310ip bgp summary 311ip bgp view 312ip protocols 316
show ip bgp inconsistent-as 288show ip bgp neighbors 303show ip bgp nexthop-tracking 305show ip extcommunity-list 315synchronization 147timers 148
bgp dampening 36BGP VPN Commands
address-family ipv4 vrf 182bgp inbound-route-filter 184clear ip bgp * vpnv6 unicast 185clear ip bgp X:X::X:X vpnv6 unicast 188clear ipv6 bgp vrf 189debug bgp mpls 190exit-address-family 191import map 192ip vrf 193neighbor allowas-in 196neighbor allow-egbp-vpn 195neighbor as-origination-interval 197neighbor as-override 198neighbor description 199neighbor remote-as 200neighbor send-community 201neighbor shutdown 202neighbor soo 203redistribute 204route distinguisher 205route-target 206set vpnv4 nexthop 207show ip vrf 317
BGP4+ Commandsaddress-family ipv6 labeled-unicast 152aggregate-address 153match ipv6 peer 94neighbor activate 162neighbor default-originate 166neighbor distribute-list 167neighbor filter-list 168neighbor maximum-prefix 169neighbor next-hop-self 170neighbor peer-group 171neighbor prefix-list 172neighbor remove-private-as 173neighbor route-map 174neighbor route-reflector-client 175neighbor send-community 176neighbor soft-reconfiguration inbound 177neighbor unsuppress-map 178network and network backdoor 179redistribute route-map 180show bgp 212, 213show bgp community 214show bgp community-list 215show bgp dampening 216, 252, 253, 256show bgp filter-list 217show bgp inconsistent-as 218show bgp ipv6 dampening 252, 253, 256show bgp ipv6 labeled 259show bgp neighbors 269show bgp paths 272show bgp prefix-list 273show bgp quote-regexp 274show bgp regexp 275show bgp route-map 276show bgp summary 277show ip bgp vpnv6 314
Index - 2
Index
show ipv6 bgp community 214bgpd command modes
illustration 7braces, meaning in command syntax notation 3
Cclear bgp
* 55A.B.C.D|X:X::X:X 57, 58, 154external 59, 73, 74, 159peer-group 61view 62
clear bgp ASN 56clear bgp ipv6
A.B.C.D| X:X::X:X 57, 58, 154ASN 56external 59, 73, 74, 159peer-group 61view 62
clear ip bgp* 63A.B.C.D|X:X::X:X 67, 69, 187ASN 65external 71peer-group 75view 76X:X::X:X vpnv6 unicast 188
clear ip prefix-listsee ZebOS NSM Command Reference
clear ipv6 bgpvrf 189
collide-established 104command abbreviation 2command abbreviations 2command completion 2command description format 4command line errors 2command line help 1command line interface
syntax 2Command Modes
address family 7, 8illustration bgpd 7route-map 7router 7
command negation 4command reference primer
typographic conventions 3common commands
see ZebOS NSM Command Referenceaccess-listbanner motdclear ip prefix-listconfigure terminalcopy running-config startup-configdisableenableenable password
endexithelphostnameip prefix-listipv6 access-listipv6 prefix-listline-vtylistlog filelog record-prioritylog sysoutlog traploginquitroute-mapservice advanced-vtyservice password-encryptionservice terminal-lengthset aggregatorshow access-listshow clishow historyshow ip prefix-listshow listshow route-mapshow running-configshow startup-configshow versionterminal lengthterminal monitorwrite filewrite memorywrite terminal
configure terminalsee ZebOS NSM Command Reference
Configure, command mode definition 6copy running-config startup-config
see ZebOS NSM Command Reference
Ddebug bgp events 77debug bgp filters 77debug bgp fsm 77debug bgp keepalives 77debug bgp updates 77default-originate 166disable
see ZebOS NSM Command Referencedistance 78distribute-list 167
Eenable
Index - 3
Index
see ZebOS NSM Command Referenceenable password
see ZebOS NSM Command Referenceend
see ZebOS NSM Command Referenceequal sign, meaning in command syntax notation 3Exec, command mode definition 6exit
see ZebOS NSM Command Referenceexit-address-family command 82
Ffast-external-failover 42filter-list 168
Ggraceful restart commands
neighbor capability graceful-restart 101restart bgp graceful 143
graceful-restart 43
Hhelp
see ZebOS NSM Command Referencehostname
see ZebOS NSM Command Reference
IInterface, command mode definition 6ip extcommunity-list
standard 92ip extcommunity-list command
expanded 89, 90, 91ip prefix-list
see ZebOS NSM Command Referenceipv6 access-list
see ZebOS NSM Command Referenceipv6 prefix-list
see ZebOS NSM Command ReferenceIS-IS commands
set-overload-bit 146
LLine, command mode definition 6LINE, meaning in command syntax notation 3line-vty
see ZebOS NSM Command Referencelist
see ZebOS NSM Command Referencelog file
see ZebOS NSM Command Referencelog record-priority
see ZebOS NSM Command Reference
log sysoutsee ZebOS NSM Command Reference
log trapsee ZebOS NSM Command Reference
loginsee ZebOS NSM Command Reference
log-neighbor-changes command 45lowercase, meaning in command syntax notation 3
Mmaximum-prefix 169MED 23monospaced font, meaning in command syntax
notation 3mpls-resolution command 93, 94Multi Exit Discriminator 23multiple-instance 46
Nneighbor
passive 119peer-group add 120remove-private-AS 124unsuppress-map 136, 178
neighbor activate command 162neighbor attribute-unchanged 98, 164neighbor command
advertisement-interval 96capability dynamic 100capability graceful-restart 101capability orf prefix-list 102, 165enforce-multihop 112route-server-client 129, 176
neighbor connection-retry-time 105neighbor disallow-infinite-holdtime 108neighbor send-community 176network backdoor 179network command 140next-hop-self 170no parameter, action of 4
Oother conventions 5
Pparameter expansion 4parenthesis not part of command 3peer-group 171prefix-list 172Privileged Exec, command mode definition 6
Qquit
Index - 4
Index
see ZebOS NSM Command Reference
Rredistribute route-map 180remove-private-as 173restart bgp graceful 143restart-time 125rfc1771-path-select 50rfc1771-strict 51route-map 174
see ZebOS NSM Command Referenceroute-map command mode 7router command mode 7route-reflector-client 175
Sscan-time 53send-community 176service advanced-vty
see ZebOS NSM Command Referenceservice password-encryption
see ZebOS NSM Command Referenceservice terminal-length
see ZebOS NSM Command Referenceset aggregator
see ZebOS NSM Command Referenceset-overload-bit 146show access-list
see ZebOS NSM Command Referenceshow bgp command 212, 213show bgp community command 214show bgp community-list command 215show bgp dampening command 252, 253, 256show bgp filter-list 217show bgp inconsistent-as command 218show bgp ipv6 dampening command 252, 253, 256show bgp ipv6 labeled 259show bgp neighbors 269show bgp neighbors command 269show bgp paths command 272show bgp prefix-list command 273show bgp quote-regexp command 274show bgp regexp command 275show bgp route-map command 276show cli
see ZebOS NSM Command Referenceshow command
ip bgp dampened-paths 286show command options 5
exclude 5include 6redirect 6
show command tokens 5output modifiers 5
show commandsip extcommunity-list 315
show history
see ZebOS NSM Command Referenceshow ip prefix-list
see ZebOS NSM Command Referenceshow ipv6 bgp community 214show list
see ZebOS NSM Command Referenceshow route-map
see ZebOS NSM Command Referenceshow running-config
see ZebOS NSM Command Referenceshow startup-config
see ZebOS NSM Command Referenceshow version
see ZebOS NSM Command Referencesite-of-origin 203soft-reconfiguration 131soft-reconfiguration inbound 177soo 203square brackets, meaning in command syntax notation 3synchronization command 147syntax help
command abbreviations 2command completion 2command line errors 2
Tterminal length
see ZebOS NSM Command Referenceterminal monitor
see ZebOS NSM Command Referencetypographic conventions 3
Uunsuppress-map 178update-delay 54UPPERCASE, meaning in command syntax notation 3
Vvariable parameter expansion 4vertical bar 3VPN command
bgp inbound-route-filter 184debug bgp mpls 190exit-address-family 191import map 192neighbor as-override 198neighbor send-community 201neighbor shutdown 202redistribute 204show ip vrf 317
WWORD, meaning in command syntax notation 3write file
see ZebOS NSM Command Reference
Index - 5
Index
write memorysee ZebOS NSM Command Reference
write terminalsee ZebOS NSM Command Reference
Index - 6