Cisco Nexus 3548 series Command Reference Manual
Read Online
Read the Cisco Nexus 3548 series Command Reference Manual online using the built-in PDF viewer.
Text of the manual
Cisco Systems, Inc.
www.cisco.com
Cisco has more than 200 offices worldwide.
Addresses, phone numbers, and fax numbers
are listed on the Cisco website at
www.cisco.com/go/offices.
Cisco Nexus 3548 Switch NX-OS Unicast
Routing Command Reference
May 2013
Text Part Number: OL-27852-01
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display
output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in
illustrative content is unintentional and coincidental.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
©2012-2013 Cisco Systems, Inc. All rights reserved.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
C O N T E N T S
New and Changed Information
xv
Preface
xvii
Audience
xvii
Document Conventions
xvii
Related Documentation
xviii
Documentation Feedback
xix
Obtaining Documentation and Submitting a Service Request
xix
Unicast Routing Commands
1
additional-paths receive
2
additional-paths selection
4
additional-paths send
6
address (VRRP)
8
address-family (BGP neighbor)
10
address-family (BGP router)
12
address-family (EIGRP)
14
address-family (RIP)
15
advertise-map (BGP)
16
advertisement-interval (VRRP)
18
aggregate-address (BGP)
20
area authentication (OSPF)
23
area default-cost (OSPF)
25
area filter-list (OSPF)
26
area filter-list (OSPFv3)
28
area nssa (OSPF)
30
area range (OSPF)
32
area stub (OSPF)
34
area virtual-link (OSPF)
36
authentication (HSRP)
38
authentication (OSPF virtual link)
40
authentication (VRRP)
42
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
authentication key-chain (EIGRP)
43
authentication mode (EIGRP)
45
authentication-key (OSPF virtual link)
46
auto-cost (OSPF)
47
autonomous-system
48
bestpath (BGP)
49
bestpath as-path multipath-relax (BGP)
51
capability additional-paths receive
52
capability additional-paths send
54
clear bgp
56
clear bgp dampening
57
clear bgp flap-statistics
59
clear bgp policy statistics aggregate-address
61
clear bgp policy statistics dampening
62
clear bgp policy statistics neighbor
63
clear bgp policy statistics redistribute
64
clear forwarding route
66
clear forwarding inconsistency
67
clear ip adjacency statistics
68
clear ip arp
69
clear ip bgp
71
clear ip bgp dampening
73
clear ip bgp flap-statistics
75
clear ip eigrp accounting
76
clear ip eigrp neighbors
77
clear ip eigrp redistribution
79
clear ip eigrp traffic
80
clear ip interface statistics
81
clear ip ospf neighbor
82
clear ip ospf policy statistics
84
clear ip ospf redistribution
86
clear ip ospf statistics
87
clear ip ospf traffic
88
clear ip rip policy statistics redistribute
89
clear ip rip statistics
91
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
clear ip route
92
clear ip traffic
93
clear sockets statistics
94
clear vrrp
95
client-to-client reflection
96
confederation
97
dampening (BGP)
98
dead-interval (OSPF virtual link)
100
default-information originate (EIGRP)
102
default-information originate (OSPF)
104
default-information originate (RIP)
106
default-metric (EIGRP)
107
default-metric (OSPF)
109
default-metric (RIP)
111
delay minimum
113
delay
114
distance (EIGRP)
115
distance (OSPF)
117
distance (RIP)
118
ebgp-multihop
119
eigrp log-neighbor-changes
120
eigrp log-neighbor-warnings
121
eigrp router-id
122
eigrp stub
123
feature bgp
125
feature eigrp
126
feature hsrp
127
feature ospf
128
feature rip
129
feature vrrp
130
flush-routes (EIGRP)
131
flush-routes (OSPF)
132
hardware ip glean throttle
133
hardware ip glean throttle maximum
134
hardware ip glean throttle syslog
135
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
hardware ip glean throttle timeout
137
hello-interval (OSPF virtual link)
138
hsrp
139
hsrp delay
140
ip (HSRP)
142
ip address
144
ip arp
146
ip arp gratuitous
148
ip arp syslog-threshold
149
ip arp timeout
150
ip as-path access-list
151
ip authentication key-chain eigrp
153
ip authentication mode eigrp
154
ip bandwidth eigrp
156
ip bandwidth-percent eigrp
157
ip community-list
158
ip delay eigrp
161
ip directed-broadcast
162
ip distribute-list eigrp
164
ip eigrp shutdown
165
ip extcommunity-list
166
ip hello-interval eigrp
169
ip hold-time eigrp
170
ip load-sharing address
171
ip local-proxy-arp
172
ip next-hop-self eigrp
173
ip offset-list eigrp
174
ip ospf authentication
176
ip ospf authentication-key
178
ip ospf cost
180
ip ospf dead-interval
181
ip ospf hello-interval
182
ip ospf message-digest-key
183
ip ospf mtu-ignore
185
ip ospf network
186
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
ip ospf passive-interface
187
ip ospf priority
188
ip ospf retransmit-interval
189
ip ospf shutdown
190
ip ospf transmit-delay
191
ip passive-interface eigrp
192
ip port-unreachable
193
ip prefix-list
194
ip prefix-list description
196
ip proxy-arp
197
ip rip authentication key-chain
198
ip rip authentication mode
199
ip rip metric-offset
200
ip rip offset-list
201
ip rip passive-interface
202
ip rip poison-reverse
203
ip rip route-filter
204
ip rip summary-address
205
ip route
206
ip router eigrp
208
ip router ospf area
209
ip router ospf multi-area
210
ip router rip
211
ip split-horizon eigrp
212
ip summary-address eigrp
213
ip tcp path-mtu-discovery
215
ip unreachables
216
log-adjacency-changes (EIGRP)
217
log-adjacency-changes (OSPF)
218
log-neighbor-warnings
219
low-memory exempt
220
mac-list
221
match as-number
223
match as-path
225
match community
227
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
match extcommunity
229
match interface
231
match ip address
233
match ip multicast
235
match ip next-hop prefix-list
237
match ip route-source prefix-list
239
match metric
241
match mac-list
243
match route-type
245
match tag
247
match vlan
249
max-metric router-lsa (OSPF)
251
maxas-limit
253
maximum-paths (BGP)
254
maximum-paths (EIGRP)
255
maximum-paths (RIP)
256
maximum-paths (OSPF)
257
maximum-prefix (BGP)
258
message-digest-key (OSPF virtual link)
261
metric maximum-hops
262
metric weights
263
neighbor
265
network
268
nexthop route-map
269
next-hop-self
271
nexthop trigger-delay
272
no switchport
273
object
274
password (BGP)
276
platform ip verify
278
platform ip verify address
279
platform ip verify length
281
policy statistics enable (OSPF)
283
preempt (HSRP)
284
preempt (VRRP)
286
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
priority (HSRP)
288
priority (VRRP)
290
protocol shutdown (OSPF)
292
redistribute (BGP)
293
redistribute (EIGRP)
295
redistribute (OSPF)
297
redistribute (RIP)
299
redistribute maximum-prefix (EIGRP)
301
redistribute maximum-prefix (OSPF)
303
remote-as
305
restart bgp
306
restart eigrp
307
restart ospf
308
restart rip
309
retransmit-interval (OSPF virtual link)
310
rfc1583compatibility
311
route-map
312
route-reflector-client (BGP)
315
router bgp
316
router eigrp
318
router ospf
319
router rip
320
router-id (EIGRP)
321
router-id (OSPF)
322
routing-context vrf
323
send-community
324
set as-path
325
set comm-list delete
327
set community
329
set dampening
331
set extcommunity
333
set extcomm-list delete
335
set forwarding-address
337
set ip next-hop peer-address
339
set level
340
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
set local-preference
342
set metric
344
set metric-type
346
set origin
348
set path-selection all advertise
350
set tag
351
set weight
353
shutdown (BGP)
355
shutdown (EIGRP)
356
shutdown (OSPF)
357
shutdown (VRRP)
358
soft-reconfiguration inbound (BGP)
359
stub
360
summary-address (OSPF)
362
suppress-inactive
364
template (BGP)
365
test forwarding distribution perf
368
test forwarding inconsistency
369
threshold percentage
370
threshold weight
372
timers active-time
374
timers basic
375
timers lsa-arrival (OSPF)
377
timers lsa-group-pacing (OSPF)
378
timers nsf converge
380
timers nsf route-hold
381
timers nsf signal
383
timers throttle lsa (OSPF)
384
timers throttle spf (OSPF)
386
track (VRRP)
388
track interface
389
track interface (VRRP)
391
track ip route
393
track list
394
transmit-delay (OSPF virtual link)
396
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
vrf context (Layer 2)
397
vrf
399
vrf context (Layer 3)
401
vrf member
402
vrrp
404
Unicast Routing Show Commands
407
show bgp
408
show bgp community
409
show bgp community-list
410
show bgp extcommunity
411
show bgp extcommunity-list
412
show bgp neighbors
413
show bgp sessions
415
show bgp statistics
416
show forwarding
418
show forwarding distribution
420
show forwarding inconsistency
421
show hsrp
422
show hsrp delay
424
show hsrp summary
425
show interface vlan counter
426
show ip adjacency
427
show ip adjacency summary
428
show ip arp
429
show ip arp summary
430
show ip bgp
431
show ip bgp all
433
show ip bgp community
436
show ip bgp community exact-match
438
show ip bgp community-list
439
show ip bgp dampening
440
show ip bgp extcommunity
441
show ip bgp extcommunity-list
442
show ip bgp filter-list
443
show ip bgp flap-statistics
444
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
show ip bgp neighbors
445
show ip bgp nexthop
446
show ip bgp nexthop-database
447
show ip bgp paths
448
show ip bgp peer-policy
449
show ip bgp peer-session
450
show ip bgp peer-template
451
show ip bgp prefix-list
452
show ip bgp received-paths
453
show ip bgp route-map
454
show ip bgp summary
455
show ip client
456
show ip community-list
457
show ip eigrp
458
show ip eigrp accounting
459
show ip eigrp interfaces
460
show ip eigrp neighbors
462
show ip eigrp route
464
show ip eigrp route-map statistics
466
show ip eigrp topology
468
show ip eigrp traffic
470
show ip fib
471
show ip fib distribution
472
show ip interface
473
show ip load-sharing
474
show ip ospf
475
show ip ospf border-routers
476
show ip ospf database
477
show ip ospf interface
480
show ip ospf lsa-content-changed-list
482
show ip ospf neighbors
483
show ip ospf policy statistics area
485
show ip ospf policy statistics redistribute
487
show ip ospf request-list
489
show ip ospf retransmission-list
490
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
show ip ospf route
491
show ip ospf statistics
492
show ip ospf summary-address
493
show ip ospf traffic
494
show ip ospf virtual-links
495
show ip prefix-list
496
show ip process
497
show ip rip
498
show ip rip interface
499
show ip rip neighbor
500
show ip rip policy statistics
501
show ip rip route
503
show ip rip statistics
504
show ip route
505
show ip static-route
506
show ip traffic
507
show mac-list
508
show routing
509
show routing hash
511
show routing memory estimate
512
show routing-context
513
show routing hash
514
show running-config
515
show running-config arp
517
show running-config bgp
519
show running-config eigrp
521
show running-config ospf
522
show sockets client
523
show sockets connection
524
show sockets statistics
525
show startup-config arp
526
show track
527
show vlan id counter
528
show vrrp
530
Cisco Nexus 3548 NX-OS Unicast Routing Command Reference
OL-27852-01
New and Changed Information
This chapter provides release-specific information for each new and changed feature in the Cisco Nexus
3548 NX-OS Unicast Routing Command Reference. The latest version of this document is available at
the following Cisco website:
http://www.cisco.com/en/US/products/ps11541/tsd_products_support_series_home.html
To check for additional information about this Cisco NX-OS Release, see the Cisco Nexus 3548 Switch
Release Notes available at the following Cisco website:
http://www.cisco.com/en/US/products/ps11541/prod_release_notes_list.html
Table 1 summarizes the new and changed features for Cisco NX-OS Release 6.x and tells you where they
are documented.
Table 1
New and Changed Information
Feature
Description
Changed in
Release
Where Documented
BGP Additional Path
commands
Added description for several new
commands in support of BGP Additional
Path features.
6.0(2)A1(1)
additional-paths receive
additional-paths selection
additional-paths send
capability additional-paths receive
capability additional-paths send
set path-selection all advertise
Cisco Nexus 3548 NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter New and Changed Information
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Preface
This preface describes the audience, organization, and conventions of the Cisco Nexus 3548 Switch
NX-OS Unicast Routing Command Reference . It also provides information on how to obtain related
documentation.
This preface includes the following sections:
•
Audience, page xvii
•
Document Conventions, page xvii
•
Related Documentation, page xviii
•
Obtaining Documentation and Submitting a Service Request, page xix
Audience
This publication is for experienced network administrators who configure and maintain Cisco Nexus
Series switches.
Document Conventions
Command descriptions use these conventions:
Convention
Description
boldface font
Commands and keywords are in boldface.
italic font
Arguments for which you supply values are in italics.
[ ]
Elements in square brackets are optional.
[ x | y | z ]
Optional alternative keywords are grouped in brackets and separated by vertical
bars.
string
A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Screen examples use these conventions:
This document uses the following conventions:
Note
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Caution
Means reader be careful. In this situation, you might do something that could result in equipment
damage or loss of data.
Related Documentation
Documentation for the Cisco Nexus 3000 Series Switch is available at the following URL:
http://www.cisco.com/en/US/products/ps11541/tsd_products_support_series_home.html
The documentation set is divided into the following categories:
Release Notes
The release notes are available at the follwing URL:
http://www.cisco.com/en/US/products/ps11541/prod_release_notes_list.html
Installation and Upgrade Guides
The installation and upgrade guides are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/prod_installation_guides_list.html
Command References
The command references are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/prod_command_reference_list.html
Technical References
The technical references are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/prod_technical_reference_list.html
screen font
Terminal sessions and information that the switch displays are in screen font.
boldface screen
font
Information that you must enter is in boldface screen font.
italic screen font Arguments for which you supply values are in italic screen font.
< >
Nonprinting characters, such as passwords, are in angle brackets.
[ ]
Default responses to system prompts are in square brackets.
!, #
An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter
Configuration Guides
The configuration guides are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/products_installation_and_configuration_guides_list.h
tml
Error and System Messages
The system message reference guide is available at the following URL:
http://www.cisco.com/en/US/products/ps11541/products_system_message_guides_list.html
Documentation Feedback
To provide technical feedback on this document, or to report an error or omission, please send your
comments to [email protected]. We appreciate your feedback.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as an RSS feed and set content to be
delivered directly to your desktop using a reader application. The RSS feeds are a free service. Cisco currently
supports RSS Version 2.0.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Unicast Routing Commands
This chapter describes the Cisco NX-OS unicast routing commands available on the Cisco Nexus 3548
switch.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
additional-paths receive
additional-paths receive
To enable BGP additional paths for a prefix to be received from a capable peer, use the additional-paths
receive command in address family configuration mode. To disable receiving additional-path capability
for the address family, use the no form of this command.
additional-paths receive
no additional-paths receive
Syntax Description
This command has no arguments or keywords.
Command Default
Capability of receiving additional paths is disabled for address family.
Command Modes
Address family configuration (config-router-af)
VRF Neighbor address family configuration
Neighbor VPN address family configuration
Neighbor IPv6 labeled-unicast address-family configuration
Command History
Usage Guidelines
The additional-paths receive command enables the additional path receive capability for an address
family, after successful negotiation with a neighbor. The ability to send and receive additional paths is
negotiated between two BGP neighbors during session establishment.
This command controls whether the local device can receive additional paths from all neighbors within
an address family. This capability applies to all neighbors under the specified address family unless the
capability is explicitly disabled with the neighbor additional-paths receive disable command, which
overrides the configuration for the address family or template.
Use the show ip bgp neighbors command to display whether neighbors are capable of sending or
receiving additional paths. Use the show ip bgp command with a network address to display the path
selections, path IDs, and the capabilities for advertising and receiving additional paths.
Examples
In the following example, BGP negotiates with all neighbors in the IPv6 unicast address family to send
and receive additional paths:
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths send
switch (config-router-af)# additional-paths receive
Release
Modification
6.0(2)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
additional-paths receive
In the following example, the send and receive capability of the neighbor overrides the receive-only
capability of the address family:
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths receive
switch (config-router-af)# additional-paths selection route-map add_path4
switch (config-router-af)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send
switch (config-router-neighbor-af)# capability additional-paths receive
Related Commands
Command
Description
additional-paths send
Enables BGP additional paths for a prefix to be sent to a capable
peer.
capability additional-paths
receive
Configures the receive additional paths capability for the specified
neighbor.
show ip bgp
Displays information about BGP networks, including path
selections and path IDs.
show ip bgp neighbors
Displays information about the TCP and BGP connections to
neighbors.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
additional-paths selection
additional-paths selection
To enable additional paths selection capability for a prefix, use the additional-paths selection command
in address family configuration mode. To disable configuring additional paths selection for a prefix, use
the no form of this command.
additional-paths selection route-map map-name
no additional-paths selection route-map map-name
Syntax Description
This command has no arguments or keywords.
Command Default
Additional paths selection capability is disabled.
Command Modes
Address family configuration (config-router-af)
VRF address family configuration
VPN address family configuration
IPv6 labeled-unicast address-family configuration
Command History
Usage Guidelines
Use the additional-paths selection command to enable additional paths selection mode for some or all
prefixes. Specify an appropriate route map to calculate backup paths and to enable Prefix Independent
Convergence (PIC) functionality. You can optionally configure the set path-selection all advertise
command in the route map to advertise all.
Examples
The following example shows how to enable the selection of additional paths:
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths receive
switch (config-router-af)# additional-paths selection route-map add_path4
switch (config-router-af)# neighbor 2001:DB8::1037!
switch (config-router-neighbor)# route-map add_path4 permit 10
switch (config-router-neighbor)# set path-selection all advertise
Release
Modification
6.0(2)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
additional-paths selection
Related Commands
Command
Description
set path-selection all advertise Advertises all BGP paths as additional paths to peers if the receive
capability is enabled.
show ip bgp
Displays information about BGP networks, including path
selections and path IDs.
show ip bgp neighbors
Displays information about the TCP and BGP connections to
neighbors.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
additional-paths send
additional-paths send
To enable BGP additional paths for a prefix to be sent to a capable peer, use the additional-paths send
command in address family configuration mode. To disable the sending of additional-paths for the
address family, use the no form of this command.
additional-paths send
no additional-paths send
Syntax Description
This command has no arguments or keywords.
Command Default
Capability of sending additional paths is disabled for address family.
Command Modes
Address family configuration (config-router-af)
VRF Neighbor address family configuration
Neighbor VPN address family configuration
Neighbor IPv6 labeled-unicast address-family configuration
Command History
Usage Guidelines
The additional-paths send command enables the additional path send capability for an address family,
after successful negotiation with a neighbor. The ability to send and receive additional paths is
negotiated between two BGP neighbors during session establishment.
This command controls whether the local device can send additional paths to all neighbors within an
address family. This capability applies to all neighbors under the specified address family unless the
capability is explicitly disabled with the capability additional-paths send disable command, which
overrides the configuration for the address family or template.
Use the show ip bgp neighbors command to display whether neighbors are capable of sending or
receiving additional paths. Use the show ip bgp command with a network address to display the path
selections, path IDs, and the capabilities for advertising and receiving additional paths.
Examples
In the following example, BGP negotiates with each neighbor in the IPv6 unicast address family to send
and receive additional paths:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths send
Release
Modification
6.0(2)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
additional-paths send
In the following example, the send and receive capability of the neighbor overrides the send-only
capability of the address family:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths send
switch (config-router-af)# additional-paths selection route-map add_path4
switch (config-router-af)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send
switch (config-router-neighbor-af)# capability additional-paths receive
Related Commands
Command
Description
additional-paths receive
Enables BGP additional paths for a prefix to be received from a
capable peer.
capability additional-paths
send
Configures the send additional paths capability for the specified
neighbor.
show ip bgp
Displays information about BGP networks, including path
selections and path IDs.
show ip bgp neighbors
Displays information about the TCP and BGP connections to
neighbors.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address (VRRP)
address (VRRP)
To add a single, primary IP address to a virtual router, use the address command. To remove an IP
address from a virtual router, use the no form of this command.
address ip-address [secondary]
no address [ip-address [secondary]]
Syntax Description
Command Default
None
Command Modes
VRRP configuration mode
Command History
Usage Guidelines
You can configure one virtual router IP address for a virtual router. If the configured IP address is the
same as the interface IP address, this switch automatically owns the IP address. You can configure an
IPv4 address only.
The master VRRP router drops the packets addressed to the virtual router's IP address because the virtual
router is only intended as a next-hop router to forward packets. In NX-OS devices, some applications
require that packets addressed to the virtual router's IP address be accepted and delivered. By using the
secondary option to the virtual router IPv4 address, the VRRP router will accept these packets when it
is the master.
This command requires the LAN Base Services license.
Examples
This example shows how to configure a virtual router IP address:
switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# vrrp 250
switch(config-if-vrrp)# address 10.0.0.10
This example shows how to remove all the IP addresses (primary and secondary) using a single
command:
switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# vrrp 250
ip-address
Virtual router address (IPv4). This address should be in the same subnet as
the interface IP address.
secondary
(Optional) Specifies a secondary virtual router address.
Release
Modified
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address (VRRP)
switch(config-if-vrrp)# no address
switch(config-if-vrrp)# show running-config interface ethernet 9/10
Related Commands
Command
Description
clear vrrp
Clears all the software counters for the specified virtual router.
show vrrp
Displays VRRP configuration information.
vrrp
Configures a VRRP group.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address-family (BGP neighbor)
address-family (BGP neighbor)
To enter the neighbor address family mode address-family mode and configure submode commands for
the Border Gateway Protocol (BGP), use the address-family command. To disable the address family
submode for configuring routing protocols, use the no form of this command.
address-family ipv4 {multicast | unicast}
no address-family ipv4 {multicast | unicast}
Syntax Description
Command Default
This command has no default settings.
Command Modes
Neighbor configuration mode
Command History
Usage Guidelines
Use the address-family command to enter various address family configuration modes while
configuring BGP routing. When you enter the address-family command from neighbor configuration
mode, you enable the neighbor address family and enter the neighbor address family configuration mode.
The prompt changes to switch(config-router-neighbor-af)#.
You must configure the address families if you are using route redistribution, load balancing, and other
advanced features. IPv4 neighbor sessions support IPv4 unicast and multicast address families.
This command requires the LAN Enterprise Services license.
Examples
This example shows how to activate IPv4 multicast for neighbor 192.0.2.1 and place the device in
neighbor address family configuration mode for the IPv4 multicast address family:
switch# configure terminal
switch(config)# feature bgp
switch(config)# router bgp 64496
switch(config-router)# neighbor 192.0.2.1 remote-as 64496
switch(config-router-neighbor)# address-family ipv4 multicast
switch(config-router-neighbor-af)
ipv4
Specifies the IPv4 address family.
multicast
Specifies multicast address support.
unicast
Specifies unicast address support.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address-family (BGP neighbor)
Related Commands
Command
Description
advertise-map
Configures BGP conditional advertisement.
default-originate (BGP)
Configures a BGP routing process to distribute a default route.
feature bgp
Enables BGP configuration.
maximum-prefix
Controls how many prefixes can be received from a neighbor.
route-reflector-client
Configures the router as a BGP route reflector.
soft-reconfiguration
inbound
Configures the switch software to start storing BGP peer updates.
suppress-inactive
Advertises only active routes to peer.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address-family (BGP router)
address-family (BGP router)
To enter the address family mode or a virtual routing and forwarding (VRF) address-family mode and
configure submode commands for the Border Gateway Protocol (BGP), use the address-family
command. To disable the address family submode for configuring routing protocols, use the no form of
this command.
address-family ipv4 {multicast | unicast}
no address-family ipv4 {multicast | unicast}
Syntax Description
Command Default
This command has no default settings.
Command Modes
Router configuration mode
VRF configuration mode
Command History
Usage Guidelines
Use the address-family command to enter various address family configuration modes while
configuring BGP routing. When you enter the address-family command from router configuration
mode, you enable the address family and enter global address family configuration mode. The prompt
changes to switch(config-router-af)#.
You must configure the address families if you are using route redistribution, address aggregation, load
balancing, and other advanced features. IPv4 neighbor sessions support IPv4 unicast and multicast
address families.
This command requires the LAN Enterprise Services license.
Examples
This example shows how to place the router in global address family configuration mode for the IPv4
unicast address family:
switch# configure terminal
switch(config)# feature bgp
switch(config)# router bgp 64496
switch(config-router)# address-family ipv4 unicast
switch(config-router-af)#
ipv4
Specifies the IPv4 address family.
multicast
Specifies multicast address support.
unicast
Specifies unicast address support.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address-family (BGP router)
Related Commands
Command
Description
aggregate-address
Configures BGP summary addresses.
client-to-client reflection
Configures route reflection.
dampening
Configures route flap dampening.
default-metric (BGP)
Configures the default metric for routes redistributed into BGP.
distance (BGP)
Configures the administrative distance.
feature bgp
Enables BGP configuration.
maximum-paths (BGP)
Configures the maximum number of equal-cost paths.
network
Configures an IP prefix to advertise.
nexthop route-map
Configures route policy filtering for next hops.
nexthop trigger-delay
Configures the BGP delay for triggering next-hop calculations.
redistribute (BGP)
Configures route redistribution for BGP.
suppress-inactive
Advertises active routes to a BGP peer.
timers (BGP)
Configures the BGP timers.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address-family (EIGRP)
address-family (EIGRP)
To configure an address family for the Enhanced Interior Gateway Routing Protocol (EIGRP), use the
address-family command. To remove an address family, use the no form of this command.
address-family ipv4 unicast
no address-family ipv4 unicast
Syntax Description
Command Default
None
Command Modes
Router configuration mode
Address family configuration mode
Command History
Usage Guidelines
This command requires the LAN Base Services license.
Examples
This example shows how to set the IPv4 unicast address family for an EIGRP instance:
switch# configure terminal
switch(config)# router eigrp 201
switch(config-router)# address-family ipv4 unicast
switch(config-router)#
Related Commands
ipv4
Specifies the IPv4 address family.
unicast
Specifies unicast address support.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
default-information
Controls the distribution of a default route.
default-metric
Configures the default metric for routes redistributed into EIGRP.
distance
Configures the administrative distance.
maximum-paths
Configures the maximum number of equal-cost paths.
redistribute
Configures route redistribution for EIGRP.
router-id
Configures the router ID.
show ip eigrp
Displays EIGRP information.
timers
Configures the EIGRP timers.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
address-family (RIP)
address-family (RIP)
To configure an address family for the Routing Information Protocol (RIP), use the address-family
command in router configuration mode.
address-family ipv4 unicast
Syntax Description
Command Default
This command has no default settings.
Command Modes
Router configuration mode
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to set the IPv4 unicast address family for a RIP instance:
switch# configure terminal
switch(config)# router rip Enterprise
switch(config-router)# address-family ipv4 unicast
switch(config-router)#
Related Commands
ipv4
Specifies the IPv4 address family.
unicast
Specifies unicast address support.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
default-information
Controls the distribution of a default route.
default-metric
Configures the default metric for routes redistributed into RIP.
distance
Configures the administrative distance.
maximum-paths
Configures the maximum number of equal-cost paths.
redistribute
Configures route redistribution for RIP.
show ip rip
Displays a summary of RIP information for all RIP instances.
timers
Configures the RIP timers.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
advertise-map (BGP)
advertise-map (BGP)
To configure Border Gateway Protocol (BGP) conditional advertisement, use the advertise-map
command. To remove BGP conditional advertisement, use the no form of this command.
advertise-map adv-map {exist-map exist-rmap | non-exist-map nonexist-rmap}
Syntax Description
Command Default
None
Command Modes
BGP neighbor address-family command mode
Command History
Usage Guidelines
Use the advertise-map command to conditionally advertise selected routes. The routes or prefixes that
BGP conditionally advertises are defined in two route maps, the adv-map and an exist-map or
nonexist-map. The exist-map or nonexist-map specifies the prefix that the BGP tracks. The adv-map
specifies the prefix that BGP advertises to the specified neighbor when the condition is met.
This command requires the LAN Enterprise Services license.
Examples
This example shows how to configure BGP conditional advertisement:
switch# configure terminal
switch(config)# router bgp 65536
switch(config-router)# neighbor 192.0.2.2 remote-as 65537
switch(config-router-neighbor)# address-family ipv4 unicast
switch(config-router-neighbor-af)# advertise-map advertise exist-map exist
switch(config-router-neighbor-af)# exit
switch(config-router-neighbor)# exit
switch(config-router)# exit
switch(config)# route-map advertise
switch(config-route-map)# match as-path pathList
switch(config-route-map)# exit
switch(config)# route-map exit
switch(config-route-map)# match ip address prefix-list plist
adv-map
Route map with match statements that the route must pass before BGP passes
theroute to the next route map. The adv-map is a case-sensitive, alphanumeric
string up to 63 characters.
exist-map
exist-rmap
Specifies a route map with match statements for a prefix list. A prefix in the BGP
table must match a prefix in the prefix list before BGP will advertise the route.
The exist-rmap is a case-sensitive, alphanumeric string up to 63 characters.
non-exist-map
nonexist-rmap
Specifies a route map with match statements for a prefix list. A prefix in the BGP
table must not match a prefix in the prefix list before BGP will advertise the route.
The nonexist-rmap is a case-sensitive, alphanumeric string up to 63 characters.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
advertise-map (BGP)
switch(config-route-map)# exit
switch(config)# ip prefix-list plist permit 209.165.201.0/27
switch(config)#
Related Commands
Command
Description
feature bgp
Enables BGP.
neighbor
Configures a BGP peer.
show ip bgp
Displays BGP configuration information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
advertisement-interval (VRRP)
advertisement-interval (VRRP)
To specify the time interval between the advertisement packets that are being sent to other Virtual Router
Redundancy Protocol (VRRP) routers in the same group, use the advertisement-interval command. To
return to the default interval value of 1 second, use the no form of this command.
advertisement-interval seconds
no advertisement-interval [seconds]
Syntax Description
Command Default
1 second
Command Modes
VRRP configuration mode
Command History
Usage Guidelines
VRRP advertisements communicate the priority and state of the virtual router master. The
advertisements are encapsulated in IP packets and are sent to the IPv4 multicast address that is assigned
to the VRRP group.
VRRP uses a dedicated Internet Assigned Numbers Authority (IANA) standard multicast address
(224.0.0.18) for VRRP advertisements. This addressing scheme minimizes the number of routers that
must service the multicasts and allows test equipment to accurately identify VRRP packets on a segment.
The IANA-assigned VRRP IP protocol number is 112.
This command does not require a license.
Examples
This example shows how to specify an advertisement interval of 200 seconds for VRRP group 250:
switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# vrrp 250
switch(config-if-vrrp)# advertisement-interval 200
switch(config-if-vrrp)#
Related Commands
seconds
Number of seconds between advertisement frames being sent. For IPv4, the
range is from 1 to 255 seconds.
Release
Modified
5.0(3)A1(1)
This command was introduced.
Command
Description
clear vrrp
Clears all the software counters for the specified virtual router.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
advertisement-interval (VRRP)
show vrrp
Displays VRRP configuration information.
vrrp
Configures a VRRP group.
Command
Description
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
aggregate-address (BGP)
aggregate-address (BGP)
To create a summary address in a Border Gateway Protocol (BGP) routing table, use the
aggregate-address command. To remove the summary address, use the no form of this command.
aggregate-address address/length [advertise-map map-name] [as-set] [attribute-map map-name]
[summary-only] [suppress-map map-name]
no aggregate-address address/length [advertise-map map-name] [as-set] [attribute-map
map-name] [summary-only] [suppress-map map-name]
Syntax Description
Command Default
The atomic aggregate attribute is set automatically when an aggregate route is created with this
command unless the as-set keyword is specified.
Command Modes
Address-family configuration mode
Command History
Usage Guidelines
You can implement aggregate routing in BGP either by redistributing an aggregate route into BGP, or by
using the conditional aggregate routing feature.
Using the aggregate-address command with no keywords will create an aggregate entry in the BGP
routing table if any more-specific BGP routes are available that fall within the specified range. (A longer
prefix which matches the aggregate must exist in the RIB.) The aggregate route will be advertised as
coming from your autonomous system and will have the atomic aggregate attribute set to show that
information might be missing. (By default, the atomic aggregate attribute is set unless you specify the
as-set keyword.)
address/length
Aggregate IPv4 address and mask length. Valid value for length is 1
to 32.
advertise-map map-name
(Optional) Specifies the name of the route map used to select attribute
information from specific routes.
as-set
(Optional) Generates the autonomous system set path information
and community information from the contributing paths.
attribute-map map-name
(Optional) Specifies the name of the route map used to set the
attribute information for specific routes. The map-name is an
alphanumeric string up to 63 characters.
summary-only
(Optional) Filters all more-specific routes from updates.
suppress-map map-name
(Optional) Specifies the name of the route map used to conditionally
filter more specific routes. The map-name is an alphanumeric string
up to 63 characters.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
aggregate-address (BGP)
Using the as-set keyword creates an aggregate entry using the same rules that the command follows
without this keyword, but the path advertised for this route will be an AS_SET consisting of all elements
contained in all paths that are being summarized. Do not use this form of the aggregate-address
command when aggregating many paths, because this route must be continually withdrawn and updated
as autonomous system path reachability information for the summarized routes changes.
Using the summary-only keyword not only creates the aggregate route (for example, 192.*.*.*) but also
suppresses advertisements of more-specific routes to all neighbors. If you want to suppress only
advertisements to certain neighbors, you may use the neighbor distribute-list command, with caution.
If a more-specific route leaks out, all BGP routers will prefer that route over the less-specific aggregate
you are generating (using longest-match routing).
Using the suppress-map keyword creates the aggregate route but suppresses advertisement of specified
routes. You can use the match clauses of route maps to selectively suppress some more-specific routes
of the aggregate and leave others unsuppressed. IP access lists and autonomous system path access lists
match clauses are supported.
Using the advertise-map keyword selects specific routes that will be used to build different components
of the aggregate route, such as AS_SET or community. This form of the aggregate-address command
is useful when the components of an aggregate are in separate autonomous systems and you want to
create an aggregate with AS_SET, and advertise it back to some of the same autonomous systems. You
must remember to omit the specific autonomous system numbers from the AS_SET to prevent the
aggregate from being dropped by the BGP loop detection mechanism at the receiving router. IP access
lists and autonomous system path access lists match clauses are supported.
Using the attribute-map keyword allows attributes of the aggregate route to be changed. This form of
the aggregate-address command is useful when one of the routes forming the AS_SET is configured
with an attribute such as the community no-export attribute, which would prevent the aggregate route
from being exported. An attribute map route map can be created to change the aggregate attributes.
This command requires the LAN Enterprise Services license.
Examples
AS-Set Example
This example shows how to create an aggregate BGP address in router configuration mode. The path
advertised for this route will be an AS_SET consisting of all elements contained in all paths that are
being summarized.
switch# configure terminal
switch(config)# router bgp 64496
switch(config-router)# aggregate-address 10.0.0.0 255.0.0.0 as-set
switch(config-router)#
Summary-Only Example
This example shows how to create an aggregate BGP address in address family configuration mode and
apply it to the multicast database (SAFI) under the IP Version 4 address family. Because the
summary-only keyword is configured, more-specific routes are filtered from updates.
switch# configure terminal
switch(config)# router bgp 64496
switch(config-router)# address-family ipv4 multicast
switch(config-router-af)# aggregate-address 10.0.0.0 255.0.0.0 summary-only
switch(config-router-af)#
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
aggregate-address (BGP)
Conditional Aggregation Example
This example shows how to create a route map called MAP-ONE to match on an as-path access list. The
path advertised for this route will be an AS_SET consisting of elements contained in paths that are
matched in the route map.
switch# configure terminal
switch(config)# ip as-path access-list 1 deny ^1234_
switch(config)# ip as-path access-list 1 permit .*
switch(config)# route-map MAP-ONE
switch(config-route-map)# match ip as-path 1
switch(config-route-map)# exit
switch(config)# router bgp 64496
switch(config-router)# address-family ipv4
switch(config-router-af)# aggregate-address 10.0.0.0 255.0.0.0 as-set advertise-map
MAP-ONE
switch(config-router-af)# end
switch(config-router-af)#
Related Commands
Command
Description
route-map map-name
Creates a route map.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area authentication (OSPF)
area authentication (OSPF)
To enable authentication for an Open Shortest Path First (OSPF) area, use the area authentication
command. To remove authentication for an area, use the no form of this command.
area area-id authentication [message-digest]
no area area-id authentication [message-digest]
Syntax Description
Command Default
No authentication
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area authentication command to configure the authentication mode for the entire OSPF area.
The authentication type and authentication password must be the same for all OSPF devices in an area.
Use the ip ospf authentication-key command in interface configuration mode to specify this password.
If you enable MD5 authentication with the message-digest keyword, you must configure a password
with the ip ospf message-digest-key command in interface configuration mode.
This command requires the LAN Base Services license.
Examples
This example shows how to configure authentication for area 0 of OSPF routing process 201:
switch# configure terminal
switch(config)# router ospf 201
switch(config-router)# area 0 authentication message-digest
switch(config-router)# interface ethernet 1/1
switch(config-if)# ip ospf area 0
switch(config)-if# ip ospf message-digest-key 10 md5 0 adcdefgh
switch(config-if)#
area-id
Identifier for the OSPF area where you want to enable authentication. Specify
as either a positive integer value or an IP address.
message-digest
(Optional) Enables Message Digest 5 (MD5) authentication on the area
specified by the area-id argument.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area authentication (OSPF)
Related Commands
Command
Description
copy running-config
startup-config
Saves the configuration changes to the startup configuration file.
ip ospf authentication-key
Assigns a password for simple password authentication for OSPF.
ip ospf message-digest-key
Assigns a password for OSPF MD5 authentication.
show ip ospf interface
Displays OSPF interface-related information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area default-cost (OSPF)
area default-cost (OSPF)
To specify a cost for the default summary route sent into an Open Shortest Path First (OSPF) stub or
not-so-stubby area (NSSA), use the area default-cost command. To remove the assigned default route
cost, use the no form of this command.
area area-id default-cost cost
no area area-id default-cost cost
Syntax Description
Command Default
The summary route cost is based on the area border router that generated the summary route.
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area default-cost command on an Area Border Router (ABR) attached to a stub or NSSA to
configure the metric for the summary default route generated by the ABR into the stub area.
This command requires the LAN Base Services license.
Examples
This example shows how to set a default cost of 20 to stub network 192.0.2.0:
switch# configure terminal
switch(config)# router ospf 201
switch(config-router)# area 192.0.2.0 stub
switch(config-router)# area 192.0.2.0 default-cost 20
switch(config-router)#
Related Commands
area-id
Identifier for the OSPF area where you want to configure the default
cost. The area ID can be from 0 to 4294967295 or an IP address.
cost
Cost for the default summary route used for a stub or NSSA. The
range is from 0 to 16777215.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
area stub
Defines an area as a stub area.
copy running-config
startup-config
Saves the configuration changes to the startup configuration file.
show ip ospf
Displays OSPF information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area filter-list (OSPF)
area filter-list (OSPF)
To filter prefixes advertised in type 3 link-state advertisements (LSAs) between Open Shortest Path First
(OSPF) areas of an Area Border Router (ABR), use the area filter-list command. To change or cancel
the filter, use the no form of this command.
area area-id filter-list route-map map-name {in | out}
no area area-id filter-list route-map map-name {in | out}
Syntax Description
Command Default
None
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area filter-list command to filter Type 3 LSAs. If you apply the route map with the in keyword,
the route map filters all Type 3 LSAs originated by the ABR to this area, including Type 3 LSAs that
originated as a result of the area range command in another area.
If you apply the route map with the out keyword, the route map filters all Type 3 LSAs that are
advertised by the ABR to all other areas including Type 3 LSAs that originate locally as a result of the
area range command configured in this area.
Cisco NX-OS implicitly denies any prefix that does not match an entry in the route map.
This command requires the LAN Base Services license.
Examples
This example shows how to filter prefixes that are sent from all other areas to area 1:
switch# configure terminal
switch(config)# router ospf 202
switch(config-router)# area 1 filter-list route-map FilterExternal in
switch(config-router)#
area-id
Identifier for the OSPF area where you want to configure filtering. Specify as
either a positive integer value or an IP address.
route-map
map-name
Specifies the name of a route map used as the filter policy. The map-name
argument can be any alphanumeric string of up to 63 characters.
in
Filters networks sent to this area.
out
Filters networks sent from this area.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area filter-list (OSPF)
Related Commands
Command
Description
area range
Consolidates and summarizes routes at an area boundary.
copy running-config
startup-config
Saves the configuration changes to the startup configuration file.
route-map
Defines the conditions for redistributing routes from one routing protocol
into another.
show ip ospf policy
statistics area
Displays OSPF policy statistics for an area.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area filter-list (OSPFv3)
area filter-list (OSPFv3)
To filter prefixes that are advertised in type 3 link-state advertisements (LSAs) between Open Shortest
Path First (OSPF) areas of an Area Border Router (ABR), use the area filter-list command. To change
or cancel the filter, use the no form of this command.
area area-id filter-list route-map map-name {in | out}
no area area-id filter-list route-map map-name {in | out}
Syntax Description
Defaults
None
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area filter-list command to filter Type 3 LSAs. If you apply the route map with the in keyword,
the route map filters all Type 3 LSAs that are originated by the ABR to this area, including Type 3 LSAs
that originated as a result of the area range command in another area.
If you apply the route map with the out keyword, the route map filters all Type 3 LSAs that are advertised
by the ABR to all other areas including Type 3 LSAs that originate locally as a result of the area range
command configured in this area.
The Cisco NX-OS software implicitly denies any prefix that does not match an entry in the route map.
This command requires the LAN Base Services license.
Examples
This example shows how to filter prefixes that are sent from all other areas to 0.0.0.10:
switch# configure terminal
switch(config)# router ospfv3 123
switch(config-router)# address-family ipv4 unicast
switch(config-router-af)# area 0.0.0.10 filter-list route-map LSA-Filter in
switch(config-router-af)#
This example shows how change or cancel the filter:
area-id
Area ID as a numeric value or the IP address.
route-map
Specifies the route map policy name.
map-name
Route map name. A route map name can be any alphanumeric string up to
63 characters.
in
Filters networks sent to this area.
out
Filters networks sent from this area.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area filter-list (OSPFv3)
switch(config-router-af)# no area 0.0.0.10 filter-list route-map LSA-Filter in
switch(config-router-af)#
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area nssa (OSPF)
area nssa (OSPF)
To configure an area as an Open Shortest Path First (OSPF) not-so-stubby (NSSA) area, use the area
nssa command. To remove the NSSA area, use the no form of this command.
area area-id nssa [default-information-originate [route-map map-name]] [no-redistribution]
[no-summary] [translate type7 [always | never] [suppress-fa]]
no area area-id nssa [default-information-originate [route-map map-name]] [no-redistribution]
[no-summary] [translate type7 [always | never] [suppress-fa]]
Syntax Description
Command Default
None
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area nssa command to create an NSSA area in an OSPF autonomous system. We recommend
that you understand the network topology before configuring forwarding address suppression for
translated LSAs. Suboptimal routing might result because there might be better paths to reach the
destination’s forwarding address.
This command requires the LAN Base Services license.
area-id
Identifier for the OSPF NSSA area. The area ID can be from 0 to 4294967295
or an IP address.
default-information-
originate
(Optional) Generates a Type 7 default into the NSSA area. This keyword takes
effect only on NSSA area border router (ABR) or NSSA autonomous system
border router (ASBR).
route-map
map-name
(Optional) Filters the Type 7 default generation based on the route map. The
map-name argument can be any alphanumeric string up to 63 characters.
no-redistribution
(Optional) Blocks redistributed link-state advertisements (LSAs) from
entering this NSSA area. Use this keyword when the router is both an NSSA
ASBR and an NSSA ABR and you want the redistribute command to import
routes into the normal areas but not into the NSSA area.
no-summary
(Optional) Allows an area to be an NSSA area but not have summary routes
injected into it.
translate type7
(Optional) Translates Type 7 LSAs to type 5 LSAs.
always
(Optional) Always translates LSAs.
never
(Optional) Never translates LSAs.
suppress-fa
(Optional) Suppresses the forwarding address in translated LSAs. The ABR
uses 0.0.0.0 as the forwarding IPv4 address.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area nssa (OSPF)
Examples
This example shows how to configure area 1 as an NSSA area:
switch# configure terminal
switch(config)# router ospf 10
switch(config-router)# area 1 nssa
switch(config-router)#
This example shows how to configure area 1 as an NSSA area and translate Type 7 LSAs from area 1 to
Type 5 LSAs, but not place the Type 7 forwarding address into the Type 5 LSAs. (OSPF places 0.0.0.0
as the forwarding address in the Type 5 LSAs.)
switch# configure terminal
switch(config)# router ospf 2
switch(config-router)# area 1 nssa translate type7 suppress-fa
switch(config-router)#
Related Commands
Command
Description
copy running-config
startup-config
Saves the configuration changes to the startup configuration file.
redistribute
Redistributes routes learned from one routing protocol to another routing
protocol domain.
show ip ospf
Displays OSPF information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area range (OSPF)
area range (OSPF)
To consolidate and summarize routes at an Open Shortest Path First (OSPF) area boundary, use the area
range command. To disable this function, use the no form of this command.
area area-id range ip-prefix [not-advertise] [cost cost]
no area area-id range ip-prefix [not-advertise] [cost cost]
Syntax Description
Command Default
Disabled
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area range command only with Area Border Routers (ABRs) to consolidate or summarize
routes for an area. The ABR advertises that a single summary route is advertised to other areas and
condenses routing information at area boundaries.
You can configure OSPF to summarize addresses for many different sets of address ranges by
configuring multiple area range commands.
This command requires the LAN Base Services license.
Examples
This example shows how to configure one summary route to be advertised by the ABR to other areas for
all hosts on network 192.0.2.0:
switch# configure terminal
switch(config-if)# interface ethernet 1/2
switch(config-if)# ip address 192.0.2.201 255.255.255.0
switch(config-if)# ip ospf area 201
switch(config-router)# area 0 range 192.0.2.0 255.255.0.0
switch(config-router)#
area-id
Identifier for the OSPF area where you want to summarize routes. The
area ID can be from 0 to 4294967295 or an IP address.
cost
(Optional) Specifies the cost to use during shortest path first (SPF)
calculation for the summarized route.
cost-value
Cost value. The range is from 0 to 16777215.
ip-prefix
IP prefix specified as IP address/subnet mask length (A.B.C.D/LEN).
not-advertise
(Optional) Sets the address range status to DoNotAdvertise. The Type
3 summary LSA is suppressed, and the component networks remain
hidden from other networks.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area range (OSPF)
Related Commands
Command
Description
copy running-config
startup-config
Saves the configuration changes to the startup configuration file.
show ip ospf
Displays OSPF information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area stub (OSPF)
area stub (OSPF)
To define an area as an Open Shortest Path First (OSPF) stub area, use the area stub command. To
remove the area, use the no form of this command.
area area-id stub [no-summary]
no area area-id stub [no-summary]
Syntax Description
Command Default
None
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area stub command to configure all devices attached to the stub area. Use the area default-cost
command on an area border router (ABR) attached to the stub area. The area default-cost command
provides the metric for the summary default route generated by the ABR into the stub area.
To further reduce the number of link-state advertisements (LSAs) sent into a stub area, you can configure
the no-summary keyword on the ABR to prevent it from sending Summary LSAs (Type 3 LSAs3) into
the stub area.
This command requires the LAN Base Services license.
Examples
This example shows how to create stub area 33 in OSPF 209:
switch# configure terminal
switch(config)# router ospf 201
switch(config-router)# area 33 stub
switch(config-router)#
Related Commands
area-id
Identifier for the OSPF stub area. The area ID can be from 0 to 4294967295 or
an IP address.
no-summary
(Optional) Prevents an Area Border Router (ABR) from sending summary link
advertisements into the stub area.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
area default-cost
Specifies a cost for the default summary route sent into a stub area.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area stub (OSPF)
copy running-config
startup-config
Saves the configuration changes to the startup configuration file.
show ip ospf
Displays OSPF information.
Command
Description
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area virtual-link (OSPF)
area virtual-link (OSPF)
To define an Open Shortest Path First (OSPF) virtual link, use the area virtual-link command. To
remove a virtual link, use the no form of this command.
area area-id virtual-link router-id
no area area-id virtual-link router-id
Syntax Description
Command Default
None
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the area virtual-link command to establish a virtual link from a remote area to the backbone area.
In OSPF, all areas must be connected to a backbone area. If the connection to the backbone is lost, it can
be repaired by establishing a virtual link.
Use the area virtual-link command to enter the virtual link configuration mode where you can use the
following commands:
•
authentication [key-chain | message-digest | null]
•
authentication-key [0 | 3] key
•
dead-interval seconds
•
hello-interval seconds
•
message-digest-key key-id md5 key
•
retransmit-interval seconds
•
transmit-delay seconds
See each command for syntax and usage details.
You must configure both sides of a virtual link with the same area ID and the corresponding virtual link
neighbor router ID. To see the router ID, use the show ip ospf neighbors command in any mode.
Note
You cannot configure a virtual link on a not-so-stubby (NSSA) area.
area-id
Identifier for the OSPF area assigned to the transit area for the virtual
link. The area ID can be from 0 to 4294967295 or an IP address.
router-id
Router ID associated with the virtual link neighbor. Specify as an IP
address. The router ID appears in the show ip ospf neighbors
display.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
area virtual-link (OSPF)
This command requires the LAN Base Services license.
Examples
This example shows how to establish a virtual link between two devices, A, and B, with default values
for all optional parameters:
Device A:
switch# configure terminal
switch(config)# router ospf 1
switch(config-router)# router-id 192.0.2.2
switch(config-router)# area 1 virtual-link 192.0.2.1
switch(config-router-vlink)#
Device B:
switch# configure terminal
switch(config# router ospf 209
switch(config-router)# router-id 192.0.2.1
switch(config-router)# area 1 virtual-link 192.0.2.2
switch(config-router-vlink)#
Related Commands
Command
Description
authentication (OSPF
virtual link)
Enables authentication for an OSPF virtual link.
authentication-key
(OSPF virtual link)
Assigns a password to be used by neighboring routers that are using the
simple password authentication of OSPF.
copy running-config
startup-config
Saves the configuration changes to the startup configuration file.
dead-interval (OSPF
virtual link)
Configures the dead interval for an OSPF virtual link.
hello-interval (OSPF
virtual link)
Configures the hello interval for an OSPF virtual link.
message-digest-key
(virtual link)
Enables OSPF MD5 authentication in an OSPF virtual link.
retransmit-interval
(OSPF virtual link)
Configures the retransmit interval for an OSPF virtual link.
show ip ospf
neighbors
Displays OSPF neighbor information.
show ip ospf
virtual-link
Displays OSPF virtual link information.
transmit-delay (OSPF
virtual link)
Configures the transmit delay for an OSPF virtual link.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication (HSRP)
authentication (HSRP)
To configure authentication for the Hot Standby Router Protocol (HSRP), use the authentication
command. To disable authentication, use the no form of this command.
authentication {string | md5 {key-chain key-chain | key-string {0 | 7} text [timeout seconds]} |
text string}
no authentication {string | md5 {key-chain key-chain | key-string {0 | 7} text [timeout seconds]}
| text string}
Syntax Description
Command Default
Disabled
Command Modes
HSRP configuration or HSRP template mode
Command History
Usage Guidelines
Use the authentication text command to prevent misconfigured routers from participating in HSRP
groups that they are not intended to participate in. The authentication string is sent unencrypted in all
HSRP messages. The same authentication string must be configured on all routers in the same group to
ensure interoperation. HSRP protocol packets that do not authenticate are ignored.
Caution
If you configure two routers with identical HSRP IP addresses but with different authentication strings,
then neither router is aware of the duplication.
This command does not require a license.
md5
Specifies the Message Digest 5 (MD5) authentication.
key-chain key-chain
Identifies a group of authentication keys.
key-string
Specifies the secret key for MD5 authentication.
0
Specifies a clear text string.
7
Specifies an encrypted string.
text
Secret key for MD5 authentication. The range is from 1 to 255 characters.
We recommend that you use at least 16 characters.
timeout seconds
(Optional) Specifies the authentication timeout value. The range is from 0
to 32767.
text string
Specifies an authentication string. The range is from 1 to 255 characters. The
default string is “cisco”.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication (HSRP)
Examples
This example shows how to configure an authentication string for HSRP group 2:
switch# configure terminal
switch(config)# interface ethernet 0/1
switch(config-if)# no switchport
switch(config-if)# ip address 10.0.0.1 255.255.255.0
switch(config-if)# hsrp 2
switch(config-if-hsrp)# priority 110
switch(config-if-hsrp)# preempt
switch(config-if-hsrp)# authentication text sanjose
switch(config-if-hsrp)# ip 10.0.0.3
switch(config-if-hsrp)# end
switch(config-if-hsrp)#
Related Commands
Command
Description
feature hsrp
Enables HSRP and enters HSRP configuration mode.
hsrp group
Creates an HSRP group.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication (OSPF virtual link)
authentication (OSPF virtual link)
To specify the authentication type for an Open Shortest Path First (OSPF) virtual link, use the
authentication command. To remove the authentication type for a virtual link, use the no form of this
command.
authentication [key-chain key-name | message-digest | null]
no authentication
Syntax Description
Command Default
Defaults to password authentication if you configure authentication with none of the optional keywords.
Command Modes
OSPF virtual link configuration mode
Command History
Usage Guidelines
Use the authentication command in virtual link configuration mode to configure the authentication
method used on the virtual link. Use the message-digest keyword to configure MD5 message digest
authentication and use the message-digest-key command to complete this authentication configuration.
Use the key-chain keyword to configure password authentication using key chains and use the key chain
command to complete this authentication configuration. Use the authentication command with no
keywords to configure a password for the virtual link, and use the authentication-key command to
complete this authentication configuration.
This command requires the LAN Base Services license.
Examples
This example shows how to enable message-digest authentication:
switch# configure terminal
switch(config)# router ospf 22
switch(config-router)# area 99 virtual-link 192.0.2.12
switch(config-router-vlink)# authentication message-digest
switch(config-router-vlink)# message-digest key 4 md5 0 abcd
key-chain key-name
(Optional) Specifies the key-chain to use. The key-name argument
can be any alphanumeric string up to 63 characters.
message-digest
(Optional) Specifies to use message-digest authentication.
null
(Optional) Specifies no authentication is used. Disables
authentication if configured for an area.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication (OSPF virtual link)
Related Commands
Command
Description
area authentication
Enables authentication for an OSPF area.
authentication-key
(OSPF virtual link)
Assigns a password to be used by neighboring routers that are using the
password authentication of OSPF.
key chain
Creates a key chain for managing authentication keys.
message-digest-key
(OSPF virtual link)
Enables OSPF MD5 authentication.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication (VRRP)
authentication (VRRP)
To configure an authentication for the Virtual Router Redundancy Protocol (VRRP), use the
authentication command. To disable authentication, use the no form of this command.
authentication text password
no authentication [text password]
Syntax Description
Command Default
No authentication
Command Modes
VRRP configuration mode
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to configure md5 authentication for VRRP:
switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# vrrp 250
switch(config-if-vrrp)# authentication text mypwasswd
switch(config-if-vrrp)#
Related Commands
text password
Specifies to use a simple text password of up to eight alphanumeric
characters.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
clear vrrp
Clears all the software counters for the specified virtual router.
show vrrp
Displays VRRP configuration information.
vrrp
Configures a VRRP group.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication key-chain (EIGRP)
authentication key-chain (EIGRP)
To enable authentication for the Enhanced Interior Gateway Routing Protocol (EIGRP) packets and to
specify the set of keys that can be used on an interface, use the authentication key-chain command. To
prevent authentication, use the no form of this command.
authentication key-chain name-of-chain
no authentication key-chain name-of-chain
Syntax Description
Command Default
No authentication is provided for EIGRP packets.
Command Modes
Router configuration mode
Address family configuration mode
Router VRF configuration mode
Command History
Usage Guidelines
Set the authentication mode using the authentication mode command in VRF configuration mode. You
must separately configure a key chain using the key-chain command to complete the authentication
configuration for an interface.
This command requires the LAN Base Services license.
Examples
This example shows how to configure the interface to accept and send any key that belongs to the
key-chain trees:
switch# configure terminal
switch(config)# router eigrp 209
switch(config-router)# vrf red
switch(config-router-vrf)# authentication key-chain trees
switch(config-router-vrf)#
Related Commands
name-of-chain
Group of keys that are valid.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
authentication mode
(EIGRP)
Sets the authentication mode for EIGRP in a VRF.
ip authentication
key-chain eigrp
Enables authentication for EIGRP and specifies the set of keys that can be
used on an interface.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication key-chain (EIGRP)
key-chain
Creates a set of keys that can be used by an authentication method.
show ip eigrp
Displays EIGRP information.
Command
Description
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication mode (EIGRP)
authentication mode (EIGRP)
To specify the type of authentication used in the Enhanced Interior Gateway Routing Protocol (EIGRP)
packets, use the authentication mode command. To remove authentication, use the no form of this
command.
authentication mode md5
no authentication mode md5
Syntax Description
Command Default
None
Command Modes
Router configuration mode
Address family configuration mode
VRF configuration mode
Command History
Usage Guidelines
This command requires the LAN Base Services license.
Examples
This example shows how to configure the interface to use MD5 authentication:
switch# configure terminal
switch(config)# router eigrp 209
switch(config-router)# vrf red
switch(config-router-vrf)# authentication mode md5
switch(config-router-vrf)#
Related Commands
md5
Specifies Message Digest 5 (MD5) authentication.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
authentication key-chain eigrp
Enables authentication for EIGRP and specifies the set of
keys that can be used on an interface.
ip authentication mode eigrp
Configures the authentication mode for EIGRP on an
interface.
key chain
Creates a set of keys that can be used by an authentication
method.
show ip eigrp
Displays EIGRP information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
authentication-key (OSPF virtual link)
authentication-key (OSPF virtual link)
To assign a password to be used by an Open Shortest Path First (OSPF) virtual link, use the
authentication-key command. To remove a previously assigned OSPF password, use the no form of this
command.
authentication-key [0 | 3] password
no authentication-key
Syntax Description
Command Default
Unencrypted password
Command Modes
OSPF virtual link configuration mode
Command History
Usage Guidelines
Use the authentication-key command to configure the password for password authentication on an
OSPF virtual link. All devices on the same virtual link must have the same password to be able to
exchange OSPF information.
This command requires the LAN Base Services license.
Examples
This example shows how to enable the authentication key with the string yourpass:
switch# configure terminal
switch(config)# router ospf 22
switch(config-router)# area 99 virtual-link 192.0.2.12
switch(config-router-vlink)# authentication
switch(config-router-vlink)# authentication-key yourpass
switch(config-router-vlink)#
Related Commands
0
(Optional) Specifies an unencrypted authentication key.
3
(Optional) Specifies a 3DES encrypted authentication key.
password
Any continuous string of characters that can be entered from the
keyboard up to 8 bytes.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
authentication
(virtual link)
Enables authentication for an OSPF virtual link.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
auto-cost (OSPF)
auto-cost (OSPF)
To control how Open Shortest Path First (OSPF) calculates default metrics for an interface, use the
auto-cost command. To assign the default reference bandwidth of 40 Gb/s, use the no form of this
command.
auto-cost reference-bandwidth bandwidth [Gbps | Mbps]
no auto-cost reference-bandwidth
Syntax Description
Command Default
40 Gb/s. The bandwidth defaults to Gb/s if you do not specify the Gpbs or Mbps keyword.
Command Modes
Router configuration mode
Command History
Usage Guidelines
Use the auto-cost command to set the reference bandwidth used by the OSPF cost-metric calculation.
The value set by the ip ospf cost command overrides the cost that results from the auto-cost command.
This command requires the LAN Base Services license.
Examples
This example shows how to set the reference bandwidth for all local interfaces in an OSPF instance:
switch# configure terminal
switch(config)# router ospf 201
switch(config-router)# auto-cost reference-bandwidth 10
switch(config-router)#
Related Commands
reference-bandwidth
bandwidth
Sets the reference bandwidth used to calculate the default metrics for
an interface. The range depends on whether you use the Gbps or
MBps keywords.
Gbps
(Optional) Specifies the rate in Gbps (bandwidth). The range is from
1 to 4000; the default is 40.
Mbps
(Optional) Specifies the rate in Mbps (bandwidth). The range is from
1 to 4000000; the default is 40000.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
ip ospf cost
Explicitly specifies the cost of sending a packet on an interface.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
autonomous-system
autonomous-system
To configure the autonomous system (AS) number for an Enhanced Interior Gateway Routing Protocol
(EIGRP) address family, use the autonomous-system command. To revert to default, use the no form of
this command.
autonomous-system as-number
no autonomous-system [as-number]
Syntax Description
Command Default
None
Command Modes
Address family configuration mode
Command History
Usage Guidelines
Use the autonomous-system command to set a common AS number for all EIGRP instances in an
address family.
This command requires the LAN Base Services license.
Examples
This example shows how to set an AS number for EIGRP for IPv4 unicast:
switch# configure terminal
switch(config)# router eigrp 201
switch(config-router)# address-family ipv4 unicast
switch(config-router-af)# autonomous-system 64496
switch(config-router-af)#
Related Commands
as-number
Autonomous system number. The range is from 1 to 65535.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
address-family
(EIGRP)
Enters the address family configuration mode for EIGRP.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
bestpath (BGP)
bestpath (BGP)
To change the default best-path selection algorithm, use the bestpath command. To return the Border
Gateway Protocol (BGP) routing process to the default operation, use the no form of this command.
bestpath {always-compare-med | compare-routerid | {med {missing-as-worst |
non-deterministic}}
no bestpath {always-compare-med | compare-routerid | {med {missing-as-worst |
non-deterministic}}
Syntax Description
Command Default
The default settings are as follows:
med missing-as-worst: A value of 0 is assigned to the missing MED
med non-deterministic: Disabled
Command Modes
Router BGP configuration mode
Command History
Usage Guidelines
Before you use this command, ensure that BGP is enabled on the switch by using the feature bgp
command.
To enable the comparison of the MED for paths from neighbors in different autonomous systems, use
the bgp always-compare-med command.
This command requires the LAN Enterprise Services license.
Examples
This example shows how to change the default best-path selection algorithm to compare the MED on
paths from different autonomous systems:
switch# configure terminal
switch(config)# router bgp 64496
switch(config-router)# bestpath always-compare-med
always-compare-med
Compares the Multi-Exit Discriminator (MED) on paths from a different
autonomous system (AS).
compare-routerid
Configures a BGP routing process to compare identical routes received from
different external peers during the best path selection process and to select
the route with the lowest router ID as the best path.
med missing-as-worst
Assigns the value of infinity to received routes that do not carry the MED
attribute, making these routes the least desirable.
med non-deterministic Specifies that the best-MED path among paths is not picked from the same
AS.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
bestpath (BGP)
switch(config-router)#
Related Commands
Command
Description
feature bgp
Enables BGP globally.
show ip bgp
Displays information about BGP routes.
show running-config bgp
Displays the running configuration for BGP for IPv4 networks.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
bestpath as-path multipath-relax (BGP)
bestpath as-path multipath-relax (BGP)
To configure a Border Gateway Protocol (BGP) routing process to consider the different autonomous
system (AS) paths and load balance multiple paths during best path route selection, use the bestpath
as-path multipath-relax command. To return the BGP routing process to the default operation, use the
no form of this command.
bestpath as-path multipath-relax
no bestpath as-path multipath-relax
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Router BGP configuration mode
VRF configuration mode
Command History
Usage Guidelines
Before you use this command, ensure that BGP is enabled on the switch by using the feature bgp
command.
This command requires the LAN Enterprise Services license.
Examples
This example shows how to configure multipath load sharing on paths from different autonomous
systems in router mode:
switch# configure terminal
switch(config)# router bgp 120
switch(config-router)# bestpath as-path multipath-relax
switch(config-router)#
Related Commands
Release
Modification
5.0(3)U1(2)
This command was introduced.
Command
Description
feature bgp
Enables BGP globally.
show ip bgp
Displays information about BGP routes.
show running-config bgp
Displays the running configuration for BGP for IPv4 networks.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
capability additional-paths receive
capability additional-paths receive
To configure the receive additional paths capability for the specified neighbor, use the capability
additional-paths receive command in neighbor address family configuration mode or peer policy
template configuration mode. To disable the capability of receiving additional paths, use the no form of
this command.
capability additional-paths receive [disable]
no capability additional-paths receive [disable]
Syntax Description
Command Default
Capability of receiving additional paths is disabled.
Command Modes
Neighbor address family configuration (config-router-af)
VRF Neighbor address family configuration
Neighbor VPN address family configuration
Neighbor IPv6 labeled-unicast address-family configuration
Peer policy template configuration (config-router-ptmp)
Command History
Usage Guidelines
Use the capability additional-paths receive command to selectively enable or disable the additional
paths receive capability negotiation for a particular neighbor. The ability to send and receive additional
paths is negotiated between two BGP neighbors during session establishment.
To advertise additional paths, you also need to:
•
Configure the additional-paths receive command in global address-family configuration mode.
•
Advertise the paths (other than best-path) by using the set path-selection command.
Use the capability additional-paths receive disable command to override template or address family
configurations that enable receiving additional paths.
Use the show ip bgp neighbors command to display whether neighbors are capable of sending or
receiving additional paths.
Any changes to this command take effect only after the next session is established and does not cause
the tear down of any currently established sessions. You must restart any currently established BGP
sessions for the new configuration to take effect. Use the clear bgp command to restart sessions.
disable
(Optional) Overrides any address family configuration that enables
receiving additional paths.
Release
Modification
6.0(2)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
capability additional-paths receive
Examples
In the following example, additional paths can be sent and received for the specified neighbor:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send
switch (config-router-neighbor-af)# capability additional-paths receive
In the following example, additional paths can be sent and received for the address family, but the
specified neighbor is disabled from sending or receiving additional paths:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths send
switch (config-router-af)# additional-paths receive
switch (config-router-af)# additional-paths selection route-map add_path4
switch (config-router-af)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send disable
switch (config-router-neighbor-af)# capability additional-paths receive disable
In the following example, the send and receive capability of the neighbor overrides the receive-only
capability of the address family:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths receive
switch (config-router-af)# additional-paths selection route-map add_path4
switch (config-router-af)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send
switch (config-router-neighbor-af)# capability additional-paths receive
In the following example, additional paths can be sent and received by a neighbor using the specified
template:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# template peer-policy rr-client-pt1
switch (config-router-ptmp)# capability additional-paths send
switch (config-router-ptmp)# capability additional-paths receive
Related Commands
Command
Description
additional-paths receive
Enables BGP additional paths for a prefix to be received from a
capable peer.
set path-selection all advertise Advertises all BGP paths as additional paths to peers if the receive
capability is enabled.
show ip bgp
Displays information about BGP networks, including path
selections and path IDs.
show ip bgp neighbors
Displays information about the TCP and BGP connections of
neighbors.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
capability additional-paths send
capability additional-paths send
To configure the send additional paths capability for the specified neighbor, use the capability
additional-paths send command in neighbor address family configuration mode or peer policy template
configuration mode. To disable the capability of sending additional paths, use the no form of the
command.
capability additional-paths send [disable]
no capability additional-paths send [disable]
Syntax Description
Command Default
Capability of sending additional paths is disabled.
Command Modes
Neighbor address family configuration (config-router-af)
VRF Neighbor address family configuration
Neighbor VPN address family configuration
Neighbor IPv6 labeled-unicast address-family configuration
Peer policy template configuration (config-router-ptmp)
Command History
Usage Guidelines
Use the capability additional-paths send command to selectively enable or disable the additional paths
send capability negotiation for a particular neighbor. The ability to send and receive additional paths is
negotiated between two BGP neighbors during session establishment.
To advertise additional-paths, you also need to:
•
Configure the additional-path send command in global address-family configuration mode.
•
Advertise the paths (other than best-path) by using the set path-selection command.
Use the capability additional-paths send disable command to override template or address family
configurations that enable the sending of additional paths.
Use the show ip bgp neighbors command to display whether neighbors are capable of sending or
receiving additional paths.
Any changes to this command take effect only after the next session is established and do not cause any
currently established sessions to be torn down. You must restart any currently established BGP sessions
for the new configuration to take effect. Use the clear bgp command to restart sessions.
disable
(Optional) Overrides any address family configuration that enables sending
additional paths.
Release
Modification
6.0(2)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
capability additional-paths send
Examples
In the following example, additional paths can be sent and received by the specified neighbor:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send
switch (config-router-neighbor-af)# capability additional-paths receive
In the following example, additional paths can be sent and received for the address family, but the
specified neighbor is disabled from sending or receiving additional paths:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths send
switch (config-router-af)# additional-paths receive
switch (config-router-af)# additional-paths selection route-map add_path4
switch (config-router-af)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send disable
switch (config-router-neighbor-af)# capability additional-paths receive disable
In the following example, the send and receive capability of the neighbor overrides the send-only
capability of the address family:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# address-family ipv6 unicast
switch (config-router-af)# additional-paths send
switch (config-router-af)# additional-paths selection route-map add_path4
switch (config-router-af)# neighbor 2001:db8::1037
switch (config-router-neighbor)# address-family ipv6 unicast
switch (config-router-neighbor-af)# capability additional-paths send
switch (config-router-neighbor-af)# capability additional-paths receive
In the following example, additional paths can be sent and received by a neighbor using the specified
template:
switch# configure terminal
switch (config)# router bgp 65000
switch (config-router)# template peer-policy rr-client-pt1
switch (config-router-ptmp)# capability additional-paths send
switch (config-router-ptmp)# capability additional-paths receive
Related Commands
Command
Description
additional-paths send
Enables BGP additional paths for a prefix to be sent to a capable
peer.
set path-selection all advertise Advertises all BGP paths as additional paths to peers if the receive
capability is enabled.
show ip bgp
Displays information about BGP neighbors, including path
selections and path IDs.
show ip bgp neighbors
Displays information about the TCP and BGP connections to
neighbors.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp
clear bgp
To clear Border Gateway Protocol (BGP) routes from the BGP table, use the clear bgp command.
clear bgp {ipv4 {multicast | unicast} | all} {neighbor | * | as-number | peer-template name |
prefix} [vrf vrf-name]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear all BGP entries:
switch# clear bgp all *
Related Commands
ipv4
Clears the BGP information for the IPv4 address family.
multicast
Clears BGP information for the multicast address family.
unicast
Clears BGP information for the unicast address family.
all
Clears the BGP information for all address families.
neighbor
Network address. The format is A.B.C.D for IPv4.
*
Clears all neighbors.
as-number
Autonomous system number. The range is from 1 to 65535.
peer-template name
Specifies a BGP peer template. The name can be any case-sensitive,
alphanumeric string up to 63 characters.
prefix
Prefix from the selected address family. The format is
A.B.C.D/length for IPv4.
vrf vrf-name
(Optional) Specifies a particular virtual routing and forwarding
(VRF) context name or all VRF instances. The VRF name can be any
case-sensitive, alphanumeric string up to 32 characters.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show bgp
Displays BGP routes.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp dampening
clear bgp dampening
To clear Border Gateway Protocol (BGP) route flap dampening information, use the clear bgp
dampening command.
clear bgp {ipv4 {unicast | multicast} | all} dampening [neighbor | prefix] [vrf vrf-name | all |
default | management]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear BGP route flap dampening information:
switch# clear bgp all dampening
ipv4
Clears BGP information for the IPv4 address family.
unicast
Clears BGP information for the unicast address family.
multicast
Clears BGP information for the multicast address family.
all
Clears BGP information for all address families.
neighbor
(Optional) Neighbor from the selected address family. The format is
A.B.C.D for IPv4.
prefix
(Optional) Prefix from the selected address family. The format is
A.B.C.D/length for IPv4.
vrf vrf-name
(Optional) Specifies a particular virtual routing and forwarding
(VRF) instance. The VRF name can be any case-sensitive,
alphanumeric string up to 32 characters.
all
(Optional) Clears BGP information from all VRFs.
default
(Optional) Clears BGP information from the default VRF.
management
(Optional) Clears BGP information from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp dampening
Related Commands
Command
Description
show ip bgp
dampening
Displays BGP dampening information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp flap-statistics
clear bgp flap-statistics
To clear Border Gateway Protocol (BGP) route flap statistics, use the clear bgp flap-statistics
command.
clear bgp {ipv4 {multicast | unicast} | all} flap-statistics [neighbor | prefix] [vrf vrf-name | all |
default | management]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear BGP route flap statistics:
switch# clear bgp ipv4 multicast flap-statistics
ipv4
Clears BGP information for the IPv4 address family.
unicast
Clears BGP information for the unicast address family.
multicast
Clears BGP information for the multicast address family.
all
Clears BGP information for all address families.
neighbor
(Optional) Neighbor from the selected address family. The format is
A.B.C.D for IPv4.
prefix
(Optional) Prefix from the selected address family. The format is
A.B.C.D/length for IPv4.
vrf vrf-name
(Optional) Specifies a particular virtual routing and forwarding
(VRF) instance. The VRF name can be any case-sensitive,
alphanumeric string up to 32 characters.
all
(Optional) Clears BGP information from all VRFs.
default
(Optional) Clears BGP information from the default VRF.
management
(Optional) Clears BGP information from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp flap-statistics
Related Commands
Command
Description
show ip bgp
flap-statistics
Displays BGP flap statistics.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp policy statistics aggregate-address
clear bgp policy statistics aggregate-address
To clear policy statistics for the Border Gateway Protocol (BGP) topology table, use the clear bgp policy
statistics aggregate-address command.
clear bgp policy statistics aggregate-address prefix {advertise-map | suppress-map}
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear policy statistics for an aggregate address:
switch# clear bgp policy statistics aggregate-address 192.0.2.0/8
Related Commands
prefix
Summary address. The format is x.x.x.x or x.x.x.x/length. The range is from
1 to 32.
advertise-map
Clears policy statistics for the advertise policy.
suppress-map
Clears policy statistics for the suppress policy.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show bgp policy statistics
Displays BGP policy statistics.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp policy statistics dampening
clear bgp policy statistics dampening
To clear policy statistics for the Border Gateway Protocol (BGP) dampening, use the clear bgp policy
statistics dampening command.
clear bgp policy statistics dampening
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear policy statistics for dampening:
switch# clear bgp policy statistics dampening
Related Commands
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show bgp policy statistics
Displays BGP policy statistics.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp policy statistics neighbor
clear bgp policy statistics neighbor
To clear policy statistics for the Border Gateway Protocol (BGP) neighbor, use the clear bgp policy
statistics neighbor command.
clear bgp policy statistics neighbor prefix [default-originate | {filter-list | prefix-list |
route-map} {in | out}]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear policy statistics for an aggregate address:
switch# clear bgp policy statistics neighbor 192.0.2.1 filter-list in
Related Commands
prefix
Neighbor address. The format is x.x.x.x.
default-originate
(Optional) Clears policy statistics for the default originate policy.
filter-list
Clears policy statistics for the neighbor filter list.
prefix-list
Clears policy statistics for the neighbor prefix list.
route-map
Clears policy statistics for the neighbor route map.
in
(Optional) Clears inboud policy statistics.
out
(Optional) Clears outbound policy statistics.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show bgp policy statistics
Displays BGP policy statistics.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp policy statistics redistribute
clear bgp policy statistics redistribute
To clear policy statistics for the Border Gateway Protocol (BGP) topology table, use the clear bgp policy
statistics redistribute command.
clear bgp policy statistics redistribute {direct | eigrp id | ospf id | rip id | static} [vrf {vrf-name
| all | default | management}]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear policy statistics for RIP:
switch# clear bgp policy statistics redistribute rip 201
direct
Clears policy statistics for directly connected routes only.
eigrp
Clears policy statistics for Enhanced Interior Gateway Routing Protocol
(EIGRP).
ospf
Clears policy statistics for the Open Shortest Path First (OSPF) protocol.
rip
Clears policy statistics for the Routing Information Protocol (RIP).
static
Clears policy statistics for IP static routes.
id
For the eigrp keyword, an EIGRP instance name from which routes are to
be redistributed. The value takes the form of a string. You can enter a
decimal number, but Cisco NX-OS stores it internally as a string.
For the ospf keyword, an OSPF instance name from which routes are to be
redistributed. The value takes the form of a string. You can enter a decimal
number, but Cisco NX-OS stores it internally as a string.
vrf vrf-name
Specifies a particular virtual routing and forwarding (VRF) instance. The
VRF name is an alphanumeric string of up to 32 characters.
all
(Optional) Specifies the “all” VRF instance.
default
(Optional) Specifies the default VRF.
management
(Optional) Specifies the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear bgp policy statistics redistribute
Related Commands
Command
Description
show bgp policy statistics
Displays BGP policy statistics.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear forwarding route
clear forwarding route
To clear forwarding information, use the clear forwarding route command.
clear forwarding {ip | ipv4} route [* | prefix] [vrf vrf-name]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command does not require a license.
We recommend that you use the clear ip route command after using the clear forwarding route
command.
Examples
This example shows how to clears a route from the FIB:
switch# clear forwarding ip route 10.0.0.1/8
Related Commands
ip
Clears an IPv4 route.
ipv4
Clears an IPv4 route.
*
(Optional) Clears all routes.
prefix
(Optional) IPv4 prefix. The IPv4 format is x.x.x.x/length.
vrf vrf-name
(Optional) Specifies a particular virtual routing and forwarding
(VRF) instance. The VRF name can be any case-sensitive,
alphanumeric string up to 32 characters.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
clear ip route
Clears individual routes from the unicast RIB.
show forwarding
Displays the forwarding information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear forwarding inconsistency
clear forwarding inconsistency
To clear the Layer 3 inconsistency checker for the Forwarding Information Base (FIB), use the clear
forwarding inconsistency command.
clear forwarding inconsistency
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to clear the Layer 3 inconsistency checker for all modules:
switch# clear forwarding inconsistency module all
Related Commands
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show forwarding
inconsistency
Displays information about the FIB inconsistencies.
test forwarding
inconsistency
Triggers the forwarding inconsistency checker.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip adjacency statistics
clear ip adjacency statistics
To clear adjacency statistics, use the clear ip adjacency statistics command.
clear ip adjacency statistics
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to clear the adjacency statistics:
switch# clear ip adjacency statistics
Related Commands
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show ip adjacency
Displays adjacency information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip arp
clear ip arp
To clear the Address Resolution Protocol (ARP) information, use the clear ip arp command.
clear ip arp [ip-addr | ethernet slot/port[.sub_if] | loopback if_number | port-channel
number[.sub_if_number]] [force-delete | statistics] [vrf vrf-name | all | default | management]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to clear the ARP table:
switch# clear ip arp
ip-addr
(Optional) IPv4 source address. The format is x.x.x.x.
ethernet
slot/port
(Optional) Specifies the Ethernet interface and the slot number and port number. The
slot number is from 1 to 255, and the port number is from 1 to 128.
sub_if
(Optional) Specifies the Ethernet subinterface port number. The range is from 1 to
48.
loopback
if_number
(Optional) Specifies the loopback interface. The loopback interface number is from
0 to 1023.
port-channel
number
(Optional) Specifies the EtherChannel interface and EtherChannel number. The
range is from 1 to 4096.
sub_if-number
(Optional) Subinterface number. The range is from 1 to 4093.
force-delete
(Optional) Clears the entries from the ARP table without a refresh.
statistics
(Optional) Clears ARP statistics.
vrf vrf-name
(Optional) Specifies the virtual routing and forwarding (VRF) context name. The
name can be any case-sensitive, alphanumeric string up to 32 characters.
all
(Optional) Clears the ARP information from all VRF entries.
default
(Optional) Clears the ARP information from the default VRF.
management
(Optional) Clears the ARP information from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip arp
Related Commands
Command
Description
show ip arp
Displays information about ARP.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip bgp
clear ip bgp
To clear Border Gateway Protocol (BGP) routes from the BGP table, use the clear ip bgp command.
clear ip bgp {ipv4 {unicast | multicast} | all} {neighbor | * | as-number | peer-template name |
prefix} [vrf vrf-name | all | default | management]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear all BGP entries for the IPv4 address family:
switch# clear ip bgp *
ipv4
(Optional) Clears BGP information for the IPv4 address family.
unicast
Clears BGP information for the unicast address family.
multicast
Clears BGP information for the multicast address family.
all
Clears the BGP information for all address families.
neighbor
Network address. The format is A.B.C.D for IPv4.
*
Clears all BGP routes.
as-number
Autonomous system (AS) number. The range is from 1 to 65535.
peer-template name
Specifies a BGP peer template. The name can be any case-sensitive,
alphanumeric string up to 63 characters.
prefix
Prefix from the selected address family. The format is
A.B.C.D/length for IPv4.
vrf vrf-name
(Optional) Specifies a particular VPN routing and forwarding (VRF)
instance. The VRF name can be any case-sensitive, alphanumeric
string up to 32 characters.
all
(Optional) Clears the BGP information from all VRF entries.
default
(Optional) Clears the BGP information from the default VRF.
management
(Optional) Clears the BGP information from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip bgp
Related Commands
Command
Description
show ip bgp
Displays entries in the BGP table.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip bgp dampening
clear ip bgp dampening
To clear Border Gateway Protocol (BGP) route flap dampening information, use the clear ip bgp
dampening command.
clear ip bgp [ipv4 {unicast | multicast} | all] dampening [neighbor | prefix] [vrf vrf-name | all |
default | management]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear BGP route flap dampening information:
switch# clear ip bgp dampening
ipv4
(Optional) Clears BGP information for the IPv4 address family.
unicast
(Optional) Clears BGP information for the unicast address family.
multicast
(Optional) Clears BGP information for the multicast address family.
all
(Optional) Clears the BGP information for all address families.
neighbor
(Optional) Neighbor from the selected address family. The format is
A.B.C.D for IPv4.
prefix
(Optional) Prefix from the selected address family. The format is
A.B.C.D/length for IPv4.
vrf vrf-name
(Optional) Specifies a particular virtual routing and forwarding
(VRF) instance. The VRF name can be any case-sensitive,
alphanumeric string up to 32 characters.
all
(Optional) Clears the BGP information from all VRF entries.
default
(Optional) Clears the BGP information from the default VRF.
management
(Optional) Clears the BGP information from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip bgp dampening
Related Commands
Command
Description
show ip bgp
dampening
Displays BGP dampening information.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip bgp flap-statistics
clear ip bgp flap-statistics
To clear Border Gateway Protocol (BGP) route flap statistics, use the clear ip bgp flap-statistics
command.
clear ip bgp flap-statistics [neighbor | prefix] [vrf vrf-name | all | default | management]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Enterprise Services license.
Examples
This example shows how to clear BGP route flap statistics:
switch# clear ip bgp flap-statistics
Related Commands
neighbor
(Optional) Neighbor from the selected address family. The format is
A.B.C.D for IPv4.
prefix
(Optional) Prefix from the selected address family. The format is
A.B.C.D/length for IPv4.
vrf vrf-name
(Optional) Specifies a particular virtual routing and forwarding
(VRF) instance. The VRF name can be any case-sensitive,
alphanumeric string up to 32 characters.
all
(Optional) Clears the BGP information from all VRF entries.
default
(Optional) Clears the BGP information from the default VRF.
management
(Optional) Clears the BGP information from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show ip bgp
flap-statistics
Displays BGP flap statistics.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip eigrp accounting
clear ip eigrp accounting
To clear the prefix accounting information for the Enhanced Interior Gateway Routing Protocol (EIGRP)
processes, use the clear ip eigrp accounting command.
clear ip eigrp accounting [vrf {vrf-name | all | default | management}]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Base Services license.
Examples
This example shows how to clear the EIGRP accounting information:
switch# clear ip eigrp accounting
Related Commands
vrf vrf-name
(Optional) Specifies the name of the virtual routing and forwarding (VRF)
instance. The vrf-name argument can be specified as any case-sensitive,
alphanumeric string up to 32 characters. The strings “default” and “all” are
reserved VRF names.
all
(Optional) Clears the EIGRP accounting information from all VRF
instances.
default
(Optional) Clears the EIGRP accounting information from the default VRF.
management
(Optional) Clears the EIGRP accounting information from the management
VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show ip eigrp
accounting
Displays prefix accounting information for the EIGRP processes.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip eigrp neighbors
clear ip eigrp neighbors
To remove and reestablish the Enhanced Interior Gateway Routing Protocol (EIGRP) neighbor entries
from the appropriate table, use the clear ip eigrp neighbors command.
clear ip eigrp neighbors [* | ip-address | ethernet slot/port | loopback if_number | port-channel
number] [soft] [vrf {vrf-name | all | default | management}]
Syntax Description
Command Default
When no autonomous system number, interface, or VRF instance is specified, all EIGRP neighbor
entries are cleared from the table.
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Base Services license.
Examples
This example shows how to clear all EIGRP entries for neighbors on Ethernet interface 2/1:
switch# clear ip eigrp neighbors ethernet 2/1 vrf *
*
(Optional) Clears all neighbors.
ip-address
(Optional) Address of the neighbor.
ethernet slot/port
(Optional) Clears the Ethernet interface from the neighbor table. The
slot number is from 1 to 255, and the port number is from 1 to 128.
loopback if_number
(Optional) Clears the loopback interface from the neighbor table. The
loopback interface number is from 0 to 1023.
port-channel number
(Optional) Clears the EtherChannel interface and EtherChannel
number from the neighbor table. The range is from 1 to 4096.
soft
(Optional) Specifies soft reset for the neighbors.
vrf vrf-name
(Optional) Specifies a virtual routing and forwarding (VRF) instance.
The VRF name is an alphanumeric string of up to 32 characters.
all
(Optional) Clears the EIGRP neighbor information from all VRF
instances.
default
(Optional) Clears the EIGRP neighbor information from the default
VRF.
management
(Optional) Clears the EIGRP neighbor information from the
management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip eigrp neighbors
Related Commands
Command
Description
show ip eigrp interfaces
Displays information about interfaces configured for EIGRP.
show ip eigrp neighbors
Displays the neighbors discovered by EIGRP.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip eigrp redistribution
clear ip eigrp redistribution
To clear redistribution information for the Enhanced Interior Gateway Routing Protocol (EIGRP), use
the clear ip eigrp redistribution command.
clear ip eigrp redistribution [vrf {vrf-name | all | default | management}]
Syntax Description
Command Default
None
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Base Services license.
Examples
This example shows how to clear redistribution information:
switch# clear ip eigrp redistribution
Related Commands
vrf vrf-name
(Optional) Specifies a particular virtual routing and forwarding (VRF)
instance. The VRF name is a case-sensitive, alphanumeric string of up to 32
characters.
all
(Optional) Clears the redistribution information from all VRF instances.
default
(Optional) Clears the redistribution information from the default VRF.
management
(Optional) Clears the redistribution information from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
feature eigrp
Enables the EIGRP feature.
Cisco Nexus 3548 Switch NX-OS Unicast Routing Command Reference
OL-27852-01
Chapter Unicast Routing Commands
clear ip eigrp traffic
clear ip eigrp traffic
To clear the Enhanced Interior Gateway Routing Protocol (EIGRP) traffic statistics, use the clear ip
eigrp traffic command.
clear ip eigrp traffic [vrf {vrf-name | all | default | management}]
Syntax Description
Command Default
This command clears information for the default VRF if no VRF is specified.
Command Modes
Any command mode
Command History
Usage Guidelines
This command requires the LAN Base Services license.
Examples
This example shows how to clear the EIGRP traffic statistics:
switch# clear ip eigrp traffic
Related Commands
vrf vrf-name
(Optional) Specifies the name of the virtual routing and forwarding
(VRF) instance. The vrf-name argument can be specified as any
case-sensitive, alphanumeric string up to 32 characters.
all
(Optional) Clears the traffic statistics from all VRF instances.
default
(Optional) Clears the traffic statistics from the default VRF.
management
(Optional) Clears the traffic statistics from the management VRF.
Release
Modification
5.0(3)A1(1)
This command was introduced.
Command
Description
show ip eigrp traffic
Displays the number of EIGRP packets sent and received.