Table Of Contents
service call-home
service image-version efsu
set (EEM)
set mpls-label
show acircuit checkpoint
show archive
show bfd neighbors
show c7300
show call-home
show ccm clients
show ccm queues
show ccm sessions
show cef nsf
show cef state
show clns interface
show clns neighbors
show configuration lock
show dampening interface
show event manager directory user
show event manager environment
show event manager history events
show event manager history traps
show event manager metric processes
show event manager policy available
show event manager policy pending
show event manager policy registered
show event manager session cli username
show glbp
show interface dampening
show ip bgp
show ip bgp labels
show ip bgp neighbors
show ip bgp vpnv4
show ip bgp vpnv4 all sso summary
show ip cef
show ip multicast redundancy state
show ip multicast redundancy statistics
show ip ospf
show ip ospf neighbor
show ip pim interface
service call-home
To enable the call-home service, use the service call-home command in global configuration mode. To disable the call-home service, use the no form of this command.
service call-home
no service call-home
Syntax Description
This command has no arguments or keywords.
Command Default
Call-home service is disabled.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SXH
|
This command was introduced.
|
12.2(33)SRC
|
This command was integrated into Cisco IOS Release 12.2(33)SRC.
|
Examples
This example shows how to enable the call-home service:
Router(config)# service call-home
This example shows how to disable the call-home service:
Router(config)# no service call-home
Related Commands
Command
|
Description
|
call-home (global configuration)
|
Enters call-home configuration mode.
|
call-home test
|
Manually sends a call-home test message.
|
show call-home
|
Displays call-home configuration information.
|
service image-version efsu
To enable Enhanced Fast Software Upgrade (eFSU) functionality, use the no version of the service image-version efsu command in global configuration mode.
no service image-version efsu
Syntax Description
This command has no arguments or keywords.
Defaults
eFSU functionality is not enabled.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(33)SRB
|
This command was introduced.
|
Usage Guidelines
The no service image-version efsu command functionality is similar to that of the service image-version compatibility command. The no service image-version efsu command is used to omit the compatibility matrix creation for Cisco 7600 series router eFSU images.
Examples
The following example enables eFSU functionality:
Router# no service image-version efsu
Related Commands
Command
|
Description
|
issu abortversion
|
Cancels the ISSU upgrade or downgrade process in progress and restores the router to its state before the process had started.
|
issu acceptversion
|
Halts the rollback timer and ensures the new Cisco IOS software image is not automatically aborted during the ISSU process.
|
issu loadversion
|
Starts the ISSU process.
|
issu runversion
|
Forces a switchover of the active to the standby processor and causes the newly active processor to run the new image.
|
service image-version compatibility
|
Enables FSU functionality.
|
set (EEM)
Note
Effective with Cisco IOS Release 12.4(22)T, the set (EEM) command is replaced by the action set (EEM) command. See the action set (EEM) command for more information.
To set the value of a local Embedded Event Manager (EEM) applet variable, use the set command in applet configuration mode. To remove the value of an EEM applet variable, use the no form of this command.
set label variable-name variable-value
no set label variable-name variable-value
Syntax Description
label
|
Unique identifier that can be any string value. Actions are sorted and run in ascending alphanumeric key sequence using the label as the sort key. If the string contains embedded blanks, enclose it in double quotation marks.
|
variable-name
|
The EEM applet variable name. Currently only the _exit_status variable is supported.
|
variable-value
|
Integer value that represents the variable. For the _exit_status variable, this is the value that represents the exit status for the applet. Zero represents a successful exit status, and a nonzero value represents a failed exit status.
|
Command Default
No EEM applet variable values are set.
Command Modes
Applet configuration (config-applet)
Command History
Release
|
Modification
|
12.3(14)T
|
This command was introduced.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
12.4(22)T
|
This command was replaced by the action set command.
|
Usage Guidelines
In EEM applet configuration mode, three types of configuration statements are supported. The event commands are used to specify the event criteria to trigger the applet to run, the action commands are used to specify an action to perform when the EEM applet is triggered, and the set command is used to set the value of an EEM applet variable. Currently only the _exit_status variable is supported for the set command.
Examples
The following example shows how to set the _exit_status variable to represent a successful status after an event has occurred three times and an action has been performed:
Router(config)# event manager applet cli-match
Router(config-applet)# event cli pattern {.*interface loopback*} sync yes occurs 3
Router(config-applet)# action 1.0 cli command "no shutdown"
Router(config-applet)# set 1.0 _exit_status 0
Related Commands
Command
|
Description
|
event manager applet
|
Registers an event applet with the Embedded Event Manager and enters applet configuration mode.
|
set mpls-label
To enable a route to be distributed with a Multiprotocol Label Switching (MPLS) label if the route matches the conditions specified in the route map, use the set mpls-label command in route-map configuration mode. To disable this function, use the no form of this command.
set mpls-label
no set mpls-label
Syntax Description
This command has no arguments or keywords.
Command Default
No route with an MPLS label is distributed.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
12.0(21)ST
|
This command was introduced.
|
12.0(22)S
|
This command was integrated into Cisco IOS Release 12.0(22)S.
|
12.2(11)S
|
This command was integrated into Cisco IOS Release 12.2(11)S.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SRB
|
Support for IPv6 was added.
|
12.2(33)SB
|
This command was integrated into Cisco IOS Release 12.2(33)SB.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Usage Guidelines
This command can be used only with the neighbor route-map out command to manage outbound route maps for a Border Gateway Protocol (BGP) session.
Use the route-map global configuration command with match and set route-map commands to define the conditions for redistributing routes from one routing protocol into another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria—the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions—the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map.
Examples
The following example shows how to create a route map that enables the route to be distributed with a label if the IP address of the route matches an IP address in ACL1:
Router(config-router)# route-map incoming permit 10
Router(config-route-map)# match ip address 1
Router(config-route-map)# set mpls-label
Related Commands
Command
|
Description
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list.
|
match ipv6 address
|
Distributes IPv6 routes that have a prefix permitted by a prefix list or specifies an IPv6 access list to use to match packets for PBR for IPv6.
|
match mpls-label
|
Redistributes routes that contain MPLS labels and match the conditions specified in the route map.
|
neighbor route-map out
|
Manage outbound route maps for a BGP session.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
show acircuit checkpoint
To display checkpointing information for each attachment circuit (AC), use the show acircuit checkpoint command in privileged EXEC mode.
show acircuit checkpoint
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(25)S
|
This command was introduced.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
12.2(33)SRC
|
This command was integrated into Cisco IOS Release 12.2(33)SRC.
|
Usage Guidelines
This command is used for interface-based attachment circuits. For Frame Relay and ATM circuits, use the following commands to show redundancy information:
•
debug atm ha-error
•
debug atm ha-events
•
debug atm ha-state
•
debug atm l2transport
•
debug frame-relay redundancy
Examples
The following show acircuit checkpoint command displays information about the ACs that have been check-pointed. The output varies, depending on whether the command output is for the active or standby Route Processor (RP).
On the active RP, the command displays the following output:
Router# show acircuit checkpoint
AC IW XC Id VCId Switch Segment St Chkpt
---- ---- ---- --- ---- -------- -------- -- -----
HDLC LIKE ATOM 3 100 1000 1000 0 N
VLAN LIKE ATOM 2 1002 2001 2001 3 Y
On the standby RP, the command displays the following output::
Router# show acircuit checkpoint
AC IW XC Id VCId Switch Segment St F-SLP
---- ---- ---- --- ---- -------- -------- -- -----
HDLC LIKE ATOM 3 100 0 0 0 001
VLAN LIKE ATOM 2 1002 2001 2001 2 000
Table 24 describes the significant fields shown in the display.
Table 24 show acircuit checkpoint Field Descriptions
Field
|
Description
|
Last Bulk Sync
|
The number of ACs that were sent to the backup RP during the last bulk synchronization between the active and backup RPs.
|
AC
|
The type of attachment circuit.
|
IW
|
The type of interworking, either like-to-like (AToM) or any-to-any (Interworking).
|
XC
|
The type of cross-connect. Only AToM ACs are checkpointed.
|
ID
|
This field varies, depending on the type of attachment circuit. For Ethernet VLANs, the ID is the VLAN ID. For PPP and High-Level Data Link Control (HDLC), the ID is the AC circuit ID.
|
VCID
|
The configured virtual circuit ID.
|
Switch
|
An ID used to correlate the control plane and data plane contexts for this virtual circuit (VC). This is an internal value that is not for customer use.
|
Segment
|
An ID used to correlate the control plane and data plane contexts for this VC. This is an internal value that is not for customer use.
|
St
|
The state of the attachment circuit. This is an internal value that is not for customer use.
|
Chkpt
|
Whether the information about the AC was checkpointed.
|
F-SLP
|
Flags that provide more information about the state of the AC circuit. These values are not for customer use.
|
Related Commands
Command
|
Description
|
show mpls l2transport vc
|
Displays AToM status information.
|
show mpls l2transport vc checkpoint
|
Displays the status of the checkpointing process for both the active and standby RPs.
|
show archive
To display information about the files saved in the Cisco IOS configuration archive, use the show archive command in privileged EXEC mode.
show archive
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(7)T
|
This command was introduced.
|
12.2(25)S
|
This command was integrated into Cisco IOS Release 12.2(25)S.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(31)SB2
|
This command was implemented on the Cisco 10000 series.
|
12.2(33)SB
|
This command was integrated into Cisco IOS Release 12.2(33)SB and implemented on the Cisco 10000 series.
|
Examples
The following is sample output from the show archive command:
There are currently 1 archive configurations saved.
The next archive file will be named disk0:myconfig-2
1 disk0:myconfig-1 <- Most Recent
The following is sample output from the show archive command after several archive files of the running configuration have been saved. In this example, the maximum number of archive files to be saved is set to three.
There are currently 3 archive configurations saved.
The next archive file will be named disk0:myconfig-8
7 disk0:myconfig-7 <- Most Recent
Table 25 describes the significant fields shown in the displays.
Table 25 show archive Field Descriptions
Field
|
Description
|
Archive #
|
Indicates the number of the running configuration file saved to the Cisco IOS configuration archive. You can set the maximum number of archive files of the running configuration to be saved in the configuration archive. The most recent archive file is the last one shown in the display.
|
Name
|
Indicates the name of the running configuration file saved to the Cisco IOS configuration archive.
|
Related Commands
Command
|
Description
|
archive config
|
Saves a copy of the current running configuration to the Cisco IOS configuration archive.
|
configure confirm
|
Confirms replacement of the current running configuration with a saved Cisco IOS configuration file.
|
configure replace
|
Replaces the current running configuration with a saved Cisco IOS configuration file.
|
maximum
|
Sets the maximum number of archive files of the running configuration to be saved in the Cisco IOS configuration archive.
|
path
|
Specifies the location and filename prefix for the files in the Cisco IOS configuration archive.
|
time-period
|
Sets the time increment for automatically saving an archive file of the current running configuration in the Cisco IOS configuration archive.
|
show bfd neighbors
To display a line-by-line listing of existing Bidirectional Forwarding Detection (BFD) adjacencies, use the show bfd neighbors command in user EXEC or privileged EXEC mode.
show bfd neighbors [client {bgp | eigrp | isis | ospf | rsvp | te-frr} | details | [interface type
number] | internal | ipv4 ip-address | ipv6 ipv6-address | vrf vrf-name]
Syntax Description
client
|
(Optional) Displays neighbors of a specific client.
|
bgp
|
Specifies a Border Gateway Protocol (BGP) client.
|
eigrp
|
Specifies an EIGRP client.
|
isis
|
Specifies an IS-IS client.
|
ospf
|
Specifies an Open Shortest Path First (OSPF) client.
|
rsvp
|
Specifies an RSVP client.
|
te-frr
|
Specifies a TE-FRR client.
|
details
|
(Optional) Displays all BFD protocol parameters and timers for each neighbor.
|
interface type number
|
(Optional) Displays neighbors at a specified interface.
|
internal
|
(Optional) Displays internal BFD information
|
ipv4
|
(Optional) Specifies an IPv4 neighbor. If the ipv4 keyword is used without the optional ip-address argument, all IPv4 sessions are displayed.
|
ip-address
|
(Optional) IP address of a neighbor, in A.B.C.D format.
|
ipv6
|
(Optional) Specifies an IPv6 neighbor. If the ipv6 keyword is used without the optional ipv6-address argument, all IPv6 sessions are displayed.
|
ipv6-address
|
(Optional) IPv6 address of a neighbor, in X:X:X:X::X format.
|
vrf vrf-name
|
(Optional) Displays entries for a specific Virtual Private Network (VPN) routing and forwarding (VRF) instance.
|
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
0S Release
|
Modification
|
12.0(31)S
|
This command was integrated into Cisco IOS Release 12.0(31)S.
|
S Release
|
Modification
|
12.2(18)SXE
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SRC
|
The vrf vrf-name keyword and argument, the client keyword, and the ip-address argument were added in this release.
|
12.2(33)SB
|
This command was integrated into Cisco IOS Release 12.2(33)SB.
|
12.2(33)SRE
|
This command was modified. Support for IPv6 was added.
|
T Release
|
Modification
|
12.4(4)T
|
This command was integrated into Cisco IOS Release 12.4(4)T.
|
12.4(9)T
|
Support for BFD Version 1 and BFD echo mode was added.
|
X Release
|
Modification
|
Cisco IOS XE Release 2.1
|
Support for IPv6 was added.
|
Usage Guidelines
The show bfd neighbors command can be used to help troubleshoot the BFD feature.
The full output for the details keyword is not supported on the Route Processor (RP) for the Cisco 12000 series Internet router. If you want to enter the show bfd neighbors command with the details keyword for the Cisco 12000 series Internet router, you must enter it on the line card. Use the attach slot command to establish a command-line interface (CLI) session with a line card.
Examples
Examples for 12.0(31)S, 12.2(18)SXE, 12.2(33)SRA, 12.2(33)SB, and 12.4(4)T
The following sample output shows the status of the adjacency or neighbor:
Router# show bfd neighbors
OurAddr NeighAddr LD/RD RH Holdown(mult) State Int
172.16.10.1 172.16.10.2 1/6 1 260 (3 ) Up Fa0/1
The following sample output from the show bfd neighbors command entered with the details keyword shows BFD protocol parameters and timers for each neighbor:
Router# show bfd neighbors details
NeighAddr LD/RD RH/RS State Int
10.1.1.2 1/1 1(RH) Up Et0/0
Session state is UP and not using echo function.
Local Diag: 0, Demand mode: 0, Poll bit: 0
MinTxInt: 50000, MinRxInt: 50000, Multiplier: 3 Received MinRxInt: 50000, Received
Multiplier: 3 Holddown (hits): 150(0), Hello (hits): 50(2223) Rx Count: 2212, Rx Interval
(ms) min/max/avg: 8/68/49 last: 0 ms ago Tx Count: 2222, Tx Interval (ms) min/max/avg:
40/60/49 last: 20 ms ago Elapsed time watermarks: 0 0 (last: 0) Registered protocols: CEF
Stub
Last packet: Version: 0 - Diagnostic: 0
I Hear You bit: 1 - Demand bit: 0
Poll bit: 0 - Final bit: 0
Multiplier: 3 - Length: 24
My Discr.: 1 - Your Discr.: 1
Min tx interval: 50000 - Min rx interval: 50000
The following sample output from the RP on a Cisco 12000 series router shows the status of the adjacency or neighbor:
Router# show bfd neighbors
OurAddr NeighAddr LD/RD RH Holdown(mult) State Int
172.16.10.2 172.16.10.1 2/0 0 0 (0 ) Up Fa6/0
The following sample output from the RP on a Cisco 12000 series router shows the status of the adjacency or neighbor with the details keyword:
RouterB# show bfd neighbors details
OurAddr NeighAddr LD/RD RH Holdown(mult) State Int
172.16.10.2 172.16.10.1 2/0 0 0 (0 ) Up Fa6/0
Registered protocols: OSPF
%% BFD Neighbor statistics are not available on RP. Please execute this command on Line
Card.
The following sample output from a line card on a Cisco 12000 series router shows the status of the adjacency or neighbor:
Entering Console for 8 Port Fast Ethernet in Slot: 6
Type "exit" to end this session
Press RETURN to get started!
Router> show bfd neighbors
OurAddr NeighAddr LD/RD RH Holdown(mult) State Int
172.16.10.2 172.16.10.1 2/1 1 848 (5 ) Up Fa6/0
The following sample output from a line card on a Cisco 12000 series router shows the status of the adjacency or neighbor with the details keyword:
Entering Console for 8 Port Fast Ethernet in Slot: 6
Type "exit" to end this session
Press RETURN to get started!
Router> show bfd neighbors details
OurAddr NeighAddr LD/RD RH Holdown(mult) State Int
172.16.10.2 172.16.10.1 2/1 1 892 (5 ) Up Fa6/0
Local Diag: 0, Demand mode: 0, Poll bit: 0
MinTxInt: 50000, MinRxInt: 1000, Multiplier: 3
Received MinRxInt: 200000, Received Multiplier: 5
Holdown (hits): 1000(0), Hello (hits): 200(193745)
Rx Count: 327406, Rx Interval (ms) min/max/avg: 152/248/196 last: 108 ms ago
Tx Count: 193748, Tx Interval (ms) min/max/avg: 204/440/331 last: 408 ms ago
Last packet: Version: 0 - Diagnostic: 0
I Hear You bit: 1 - Demand bit: 0
Poll bit: 0 - Final bit: 0
Multiplier: 5 - Length: 24
My Discr.: 1 - Your Discr.: 2
Min tx interval: 200000 - Min rx interval: 200000
SSO Cleanup Timer called: 0
SSO Cleanup Action Taken: 0
Pseudo pre-emptive process count: 7728507 min/max/avg: 8/16/8 last: 12 ms ago
Example for 12.4(9)T and Later Releases
The following sample output verifies that the BFD neighbor router is also running BFD Version 1 and that the BFD session is up and running in echo mode:
Router# show bfd neighbors details
OurAddr NeighAddr LD/RD RH/RS Holdown(mult) State Int
172.16.1.2 172.16.1.1 1/6 Up 0 (3 ) Up Fa0/1
Session state is UP and using echo function with 50 ms interval.
Local Diag: 0, Demand mode: 0, Poll bit: 0
MinTxInt: 1000000, MinRxInt: 1000000, Multiplier: 3
Received MinRxInt: 1000000, Received Multiplier: 3
Holdown (hits): 3000(0), Hello (hits): 1000(337)
Rx Count: 341, Rx Interval (ms) min/max/avg: 1/1008/882 last: 364 ms ago
Tx Count: 339, Tx Interval (ms) min/max/avg: 1/1016/886 last: 632 ms ago
Registered protocols: EIGRP
Last packet: Version: 1 - Diagnostic: 0
State bit: Up - Demand bit: 0
Poll bit: 0 - Final bit: 0
Multiplier: 3 - Length: 24
My Discr.: 6 - Your Discr.: 1
Min tx interval: 1000000 - Min rx interval: 1000000
Example for Cisco IOS XE Release 2.1 and Later Releases
The following example displays all IPv6 sessions:
Router# show bfd neighbors ipv6 2001::1
OurAddr NeighAddr LD/RD RH/RS Holddown(mult) State Int
1:1::5 1:1::6 2/2 Up 0 (3 ) Up Et0/0
2:2::5 2:2::6 4/4 Up 0 (3 ) Up Et1/0
Table 26 describes the significant fields shown in the display.
Table 26 show bfd neighbors Field Descriptions
Field
|
Description
|
OurAddr
|
IP address of the interface for which the show bfd neighbors command was entered.
|
NeighAddr
|
IPv4 or IPv6 address of the BFD adjacency or neighbor.
|
LD/RD
|
Local discriminator and remote discriminator being used for the session.
|
RH
|
Remote Heard—Indicates that the remote BFD neighbor has been heard.
|
Holdown(mult)
|
The detect timer multiplier that is used for this session.
|
State
|
State of the interface—Up or Down.
|
Int
|
Interface type and slot/port.
|
Session state is UP and using echo function with 50 ms interval.
|
BFD is up and running in echo mode. The 50-millisecond interval has been adopted from the bfd command.
Note BFD Version 1 and echo mode are supported only with Cisco IOS Release 12.4(9)T and later releases.
|
RX Count
|
Number of BFD control packets that have been received from the BFD neighbor.
|
TX Count
|
Number of BFD control packets that have been sent by the BFD neighbor.
|
TX Interval
|
The interval, in milliseconds, between sent BFD packets.
|
Registered protocols
|
Routing protocols that have been registered with BFD.
|
Last packet: Version:
|
BFD version detected and run between the BFD neighbors. The system automatically performs BFD version detection, and BFD sessions between neighbors will run in the highest common BFD version between neighbors. For example, if one BFD neighbor is running BFD Version 0, and the other BFD neighbor is running Version 1, the session will run BFD Version 0.
Note BFD Version 1 and echo mode are supported only with Cisco IOS Release 12.4(9)T and later releases.
|
Diagnostic
|
A diagnostic code specifying the local system's reason for the last transition of the session from Up to some other state.
State values are as follows:
• 0—No Diagnostic
• 1—Control Detection Time Expired
• 2—Echo Function Failed
• 3—Neighbor Signaled Session Down
• 4—Forwarding Plane Reset
• 5—Path Down
• 6—Concentrated Path Down
• 7—Administratively Down
|
I Hear You bit
|
I Hear You Bit. This bit is set to 0 if the transmitting system either is not receiving BFD packets from the remote system or is tearing down the BFD session for some reason. During normal operation the I Hear You bit is set to 1 to signify that the remote system is receiving the BFD packets from the transmitting system.
|
Demand bit
|
Demand Mode bit. If set, the transmitting system wants to operate in demand mode. BFD has two modes—asynchronous and demand. The Cisco implementation of BFD supports only asynchronous mode.
|
Poll bit
|
Poll bit. If the Poll bit is set, the transmitting system is requesting verification of connectivity or of a parameter change.
|
Final bit
|
Final bit. If the Final bit is set, the transmitting system is responding to a received BFD control packet that had a Poll (P) bit set.
|
Multiplier
|
Detect time multiplier. The negotiated transmit interval, multiplied by the detect time multiplier, determines the detection time for the transmitting system in BFD asynchronous mode.
The detect time multiplier is similar to the hello multiplier in Intermediate System-to-Intermediate System (IS-IS), which is used to determine the hold timer: (hello interval) * (hello multiplier) = hold timer. If a hello packet is not received within the hold-timer interval, a failure has occurred.
Similarly, for BFD: (transmit interval) * (detect multiplier) = detect timer. If a BFD control packet is not received from the remote system within the detect-timer interval, a failure has occurred.
|
Length
|
Length of the BFD control packet, in bytes.
|
My Discr.
|
My Discriminator. Unique, nonzero discriminator value generated by the transmitting system used to demultiplex multiple BFD sessions between the same pair of systems.
|
Your Discr.
|
Your Discriminator. The discriminator received from the corresponding remote system. This field reflects the received value of My Discriminator, or is zero if that value is unknown.
|
Min tx interval
|
Minimum transmission interval, in microseconds, that the local system wants to use when sending BFD control packets.
|
Min rx interval
|
Minimum receipt interval, in microseconds, between received BFD control packets that the system can support.
|
Min Echo interval
|
Minimum interval, in microseconds, between received BFD control packets that the system can support. If the value is zero, the transmitting system does not support the receipt of BFD echo packets.
The Cisco implementation of BFD for Cisco IOS Releases 12.2(18)SXE and 12.0(31)S does not support the use of echo packets.
|
Related Commands
Command
|
Description
|
attach
|
Connects to a specific line card for the purpose of executing monitoring and maintenance commands on that line card only.
|
show c7300
To display the types and status of cards installed in a Cisco 7304 router, use the show c7300 command in privileged EXEC mode.
show c7300
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.1(9)EX
|
This command was introduced.
|
12.1(10)EX
|
The output of this command was enhanced to include information about Field-Programmable Gate Array (FPGA) images.
|
12.1(10)EX2
|
The output of this command was enhanced to include information about a standby route processor (RP).
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S.
|
12.2(20)S
|
Support was added for the Cisco 7304 router.
|
12.2(20)S2
|
Support was added for modular services cards (MSCs) and shared port adapters (SPAs) on the Cisco 7304 router.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
Usage Guidelines
This command displays the types and status of cards installed in a Cisco 7304 router (such as network services engines [NSEs], RPs, line cards, MSCs, and SPAs), and information about incompatible FPGA images. When the bundled and current FPGA images are compatible, they are not displayed.
This command also displays whether your system is in compliance with line card configuration guidelines. For NSEs and line cards, empty slots are not displayed in the output. However, for SPAs, several status values are reported, including an empty subslot, which is reported as "missing."
If your system contains an unsupported line card or RP with no matching bundled FPGA image in Cisco IOS software, then this command displays "None" instead of the bundled FPGA version number.
Use this command to display information about the status of the active and standby NSEs.
Examples
The following example displays information about a Cisco 7304 router that has current FPGA images:
Slot Card Type Status Insertion time
---- --------- ------ --------------
0,1 NSE-100 Active 00:13:16 ago
4 1OC48-POS Active 00:01:43 ago
System is compliant with hardware configuration guidelines.
All the FPGAs in the system are up-to-date
Network IO Interrupt Throttling:
throttle count=3, timer count=3
netint usec=3999, netint mask usec=200
The following example displays information about a Cisco 7304 router that has incompatible FPGA images that need to be updated. If your system contains an unsupported line card or RP with no matching bundled FPGA image in Cisco IOS software, "None" is displayed instead of a bundled FPGA version number.
Slot Card Type Status Insertion time
---- --------- ------ --------------
0,1 NSE-100 Active 00:02:26 ago
4 6T3 Active 00:02:23 ago
5 6T3 Active 00:02:23 ago
System is compliant with hardware configuration guidelines.
%WARNING:The following FPGAs in the system may need an update.
Slot Card Type Current FPGA Bundled FPGA
---- --------- ------------ ------------
Network IO Interrupt Throttling:
throttle count=0, timer count=0
netint usec=3999, netint mask usec=200
The following example displays sample output information about the redundancy status of the NSEs installed in the system. In the following example, the active RP is the NSE-100 installed in slot 0 and slot 1. The standby is the NSE-100 installed in slot 2 and slot 3.
Slot Card Type Status Insertion time
---- --------- ------ --------------
0,1 NSE-100 Active 00:02:03 ago
2,3 NSE-100 Standby 00:02:03 ago
4 4OC3-POS Active 00:01:59 ago
5 6T3 Active 00:01:59 ago
System is compliant with hardware configuration guidelines.
Network IO Interrupt Throttling:
throttle count=0, timer count=0
netint usec=3999, netint mask usec=200
The following example displays information about a Cisco 7304 router with an NSE-100, MSC-100s, and 4-Port 10/100 Fast Ethernet SPAs:
Slot Card Type Status Insertion time
---- --------- ------ --------------
0,1 NSE100 Active 00:45:29 ago
2 7304-MSC-100 Active 00:44:36 ago
3 7304-MSC-100 Active 00:44:36 ago
4 7304-MSC-100 Active 00:44:36 ago
5 7304-MSC-100 Active 00:14:39 ago
The FPGA versions for the cards listed above are current
Shared Port Adapter information:
Slot/Subslot SPA Type Status Insertion time
------------ -------- ------ --------------
2/0 SPA-4FE-7304 ok 00:44:36 ago
2/1 SPA-4FE-7304 ok 00:44:36 ago
3/0 SPA-4FE-7304 ok 00:44:35 ago
3/1 not present missing never
4/0 SPA-4FE-7304 ok 00:44:35 ago
4/1 SPA-4FE-7304 ok 00:44:35 ago
5/0 SPA-4FE-7304 ok 00:14:36 ago
5/1 SPA-4FE-7304 ok 00:14:36 ago
Network IO Interrupt Throttling:
throttle count=1, timer count=1
netint usec=3999, netint mask usec=200
Table 27 provides a description for each of the possible status fields for SPAs.
Table 27 SPA Status Field Descriptions
Status Field for SPAs
|
Description
|
booting
|
SPA is initializing.
|
failed
|
SPA is powered off due to five automatic recovery failures.
|
FW mismatch
|
An FPGA version mismatch with the Cisco IOS software has been detected for the SPA.
|
missing
|
SPA is not present in the MSC subslot.
|
not allowed online
|
SPA is not supported.
|
ok
|
SPA is operational.
|
stopped
|
SPA is deactivated by the hw-module subslot stop command.
|
unknown
|
SPA is in unrecognizable state.
|
Related Commands
Command
|
Description
|
show c7300 errorlog
|
Displays error information about a Cisco 7304 router.
|
show diag
|
Displays hardware information for any slot or the chassis.
|
show redundancy (7300)
|
Displays redundancy information for the active and standby NSEs.
|
show version
|
Displays the configuration of the system hardware, the number of each interface type installed, the Cisco IOS software version, the names and sources of configuration files, and the boot images. Displays the configuration of the ROM monitor.
|
show call-home
To display the configured call-home information, use the show call-home command in privileged EXEC mode.
show call-home [alert-group | detail | mail-server | profile {all | name} | statistics]
Syntax Description
alert-group
|
(Optional) Displays the available alert group.
|
detail
|
(Optional) Displays the call-home configuration in detail.
|
mail-server
|
(Optional) Displays the call-home mail server-related information.
|
profile all
|
(Optional) Displays configuration information for all existing profiles.
|
profile name
|
(Optional) Displays configuration information for a specific destination profile.
|
statistics
|
(Optional) Displays the call-home statistics.
|
Command Default
This command has no default settings.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SXH
|
This command was introduced.
|
Examples
The following example displays the configured call-home settings:
Current call home settings:
call home feature : disable
call home message's from address: switch@example.com
call home message's reply-to address: support@example.com
contact person's email address: technical@example.com
contact person's phone number: +1-111-111-1111
street address: 1234 Any Street, Any city, Any state, 12345
Mail-server[1]: Address: smtp.example.com Priority: 1
Mail-server[2]: Address: 192.168.0.1 Priority: 2
Rate-limit: 20 message(s) per minute
Keyword State Description
------------------------ ------- -------------------------------
configuration Disable configuration info
diagnostic Disable diagnostic info
environment Disable environmental info
inventory Enable inventory info
syslog Disable syslog info
The following example displays detailed call-home configuration information:
Router# show call-home detail
Current call home settings:
call home feature : disable
call home message's from address: switch@example.com
call home message's reply-to address: support@example.com
contact person's email address: technical@example.com
contact person's phone number: +1-111-111-1111
street address: 1234 Any Street, Any city, Any state, 12345
Mail-server[1]: Address: smtp.example.com Priority: 1
Mail-server[2]: Address: 192.168.0.1 Priority: 2
Rate-limit: 20 message(s) per minute
Keyword State Description
------------------------ ------- -------------------------------
configuration Disable configuration info
diagnostic Disable diagnostic info
environment Disable environmental info
inventory Enable inventory info
syslog Disable syslog info
Preferred Message Format: long-text
Message Size Limit: 3145728 Bytes
Preferred Transport Method: email
Email address(es): noc@example.com
HTTP address(es): Not yet set up
------------------------ ------------
------------------------ ------------
Preferred Message Format: xml
Message Size Limit: 3145728 Bytes
Preferred Transport Method: email
Email address(es): callhome@cisco.com
HTTP address(es): Not yet set up
Periodic configuration info message is scheduled every 1 day of the month at 09:27
Periodic inventory info message is scheduled every 1 day of the month at 09:12
------------------------ ------------
------------------------ ------------
The following example displays available call home alert groups:
Router# show call-home alert-group
Keyword State Description
------------------------ ------- -------------------------------
configuration Disable configuration info
diagnostic Disable diagnostic info
environment Disable environmental info
inventory Enable inventory info
syslog Disable syslog info
The following example displays e-mail server status information:
Router# show call-home mail-server status
Please wait. Checking for mail server status ...
Translating "smtp.example.com"
Mail-server[1]: Address: smtp.example.com Priority: 1 [Not Available]
Mail-server[2]: Address: 192.168.0.1 Priority: 2 [Not Available]
The following example displays information for all predefined and user-defined profiles:
Router# show call-home profile all
Preferred Message Format: long-text
Message Size Limit: 3145728 Bytes
Preferred Transport Method: email
Email address(es): noc@example.com
HTTP address(es): Not yet set up
------------------------ ------------
------------------------ ------------
Preferred Message Format: xml
Message Size Limit: 3145728 Bytes
Preferred Transport Method: email
Email address(es): callhome@cisco.com
HTTP address(es): Not yet set up
Periodic configuration info message is scheduled every 1 day of the month at 09:27
Periodic inventory info message is scheduled every 1 day of the month at 09:12
------------------------ ------------
------------------------ ------------
The following example displays information for a user-defined destination profile:
Router# show call-home profile campus-noc
Preferred Message Format: long-text
Message Size Limit: 3145728 Bytes
Preferred Transport Method: email
Email address(es): noc@example.com
HTTP address(es): Not yet set up
------------------------ ------------
------------------------ ------------
The following example displays the call-home statistics:
Router# show call-home statistics
Successful Call-Home Events: 0
Dropped Call-Home Events due to Rate Limiting: 0
Related Commands
Command
|
Description
|
call-home (global configuration)
|
Enters call-home configuration mode.
|
call-home send alert-group
|
Sends a specific alert group message.
|
service call-home
|
Enables or disables call home.
|
show ccm clients
To display information about cluster control manager (CCM) clients on high availability (HA), dual Route Processor systems, use the show ccm clients command in privileged EXEC mode.
show ccm clients
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(31)SB2
|
This command was introduced.
|
12.2(33)SRC
|
This command was integrated into Cisco IOS Release 12.2(33)SRC.
|
Usage Guidelines
The CCM manages the capability to synchronize session initiation on the standby processor of a dual Route Processor HA system. Use the show ccm clients command to display information about CCM clients.
Examples
The following is sample output from the show ccm clients command on a router's active processor:
CCM bundles sent since peer up:
Sent Queued for flow control
Client events sent since peer up:
The following is sample output from the show ccm clients command on a router's standby processor:
CCM bundles rcvd since last boot:
Client events extracted since last boot:
Table 28 describes the significant fields shown in the display. Any data not described in Table 28 is used for Cisco internal debugging purposes.
c
Table 28 show ccm clients Field Descriptions
Field
|
Description
|
Sent
|
Number of CCM bundles sent by the active processor since initiation on the standby processor.
|
Queued for flow control
|
Number of the following types of CCM bundles queued on the active processor when flow control is OFF since initiation on the standby processor:
• Sync Session—Synchronization session bundles.
• Update Session—Individual client update to session bundles.
• Active Bulk Sync—Active processor bulk synchronization bundles.
• Session Down—Session down bundles.
• ISSU client msgs—In service software upgrade (ISSU) bundles.
• Dynamic Session Sync—Dynamic cluster update to session bundles.
• Unknown msgs—Unknown message bundles.
. The queued bundles will be sent when flow control is ON again.
|
Client events sent since peer up
|
Number of client events sent since initiation on the standby processor.
|
CCM bundles rcvd since last boot
|
Number of the following types of CCM bundles received by the standby processor since initiation:
• Sync Session—Synchronization session bundles.
• Update Session—Individual client update to session bundles.
• Active Bulk Sync—Active processor bulk synchronization bundles.
• Session Down—Session down bundles.
• ISSU client msgs—ISSU bundles.
• Dynamic Session Sync—Dynamic cluster update to session bundles.
• Unknown msgs—Unknown message bundles.
|
Client events extracted since last boot
|
Number of client events extracted since initiation on the standby processor.
|
Related Commands
Command
|
Description
|
show ccm queues
|
Displays CCM queue statistics.
|
show ccm sessions
|
Displays CCM session information.
|
show ccm queues
To display cluster control manager (CCM) queue statistics for high availability (HA) dual Route Processor systems, use the show ccm queues command in privileged EXEC mode.
show ccm queues
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(31)SB2
|
This command was introduced.
|
12.2(33)SRC
|
This command was integrated into Cisco IOS Release 12.2(33)SRC.
|
Usage Guidelines
The CCM manages the capability to synchronize session initiation on the standby processor of a redundant processor HA system. Use the show ccm queues command to display queue statistics for CCM sessions on active and standby processors. This command is generally used only by Cisco engineers for internal debugging of CCM processes.
Examples
The following is sample output from the show ccm queues command. No field descriptions are provided because command output is used for Cisco internal debugging purposes only.
size max kicks starts false suspends ticks(ms)
4 CCM 0 7 16167 16168 1 0 20
Events Queued MaxQueued Suspends usec/evt max/evt
1 4 Sync Session 0 0 0 0 0 0
2 4 Sync Client 0 0 0 0 0 0
4 4 Session Down 0 0 0 0 0 0
5 4 Bulk Sync Begi 1 0 1 0 0 0
6 4 Bulk Sync Cont 2 0 2 0 0 0
7 4 Bulk Sync End 1 0 1 0 0 0
8 4 Rcv Bulk End 0 0 0 0 0 0
9 4 Dynamic Sync C 0 0 0 0 0 0
10 4 Going Active 0 0 0 0 0 0
11 4 Going Standby 0 0 0 0 0 0
12 4 Standby Presen 1 0 1 0 0 0
13 4 Standby Gone 0 0 0 0 0 0
15 4 CP Message 188 0 7 0 0 0
16 4 Recr Session 0 0 0 0 0 0
17 4 Recr Update 0 0 0 0 0 0
18 4 Recr Sess Down 0 0 0 0 0 0
19 4 ISSU Session N 1 0 1 0 0 0
20 4 ISSU Peer Comm 0 0 0 0 0 0
21 4 Free Session 16103 0 1 0 0 0
22 4 Sync Dyn Sessi 0 0 0 0 0 0
23 4 Recr Dyn Sessi 0 0 0 0 0 0
24 4 Session Ready 0 0 0 0 0 0
Related Commands
Command
|
Description
|
show ccm clients
|
Displays CCM client information.
|
show ccm sessions
|
Displays CCM session information.
|
show ccm sessions
To display information about cluster control manager (CCM) sessions on high availability (HA) dual Route Processor systems, use the show ccm sessions command in privileged EXEC mode.
show ccm sessions
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(31)SB2
|
This command was introduced.
|
12.2(33)SRC
|
This command was integrated into Cisco IOS Release 12.2(33)SRC.
|
Usage Guidelines
The CCM manages the capability to synchronize session initiation on the standby processor of a redundant processor HA system. Use the show ccm sessions command to display information on CCM sessions on active and standby processors, and also to display information on subscriber redundancy policies configured using the subscriber redundancy command.
Examples
The following is sample output from the show ccm sessions command on a Cisco 10000 series router active processor:
Router# show ccm sessions
Global CCM state: CCM HA Active - Dynamic Sync
Global ISSU state: Compatible, Clients Cap 0x0
Number of sessions in state Down: 0
Number of sessions in state Not Ready: 0
Number of sessions in state Ready: 0
Number of sessions in state Dyn Sync: 0
Timeout: Timer Type Delay Remaining Starts CPU Limit CPU Last
------------ -------- --------- --------- --------- --------
Dynamic CPU 00:00:10 - 0 90 0
The following is sample output from the show ccm sessions command on a Cisco 10000 series router standby processor:
Router# show ccm sessions
Global CCM state: CCM HA Standby - Collecting
Global ISSU state: Compatible, Clients Cap 0xFFE
Current Bulk Sent Bulk Rcvd
----------- ----------- -----------
Number of sessions in state Down: 0 0 0
Number of sessions in state Not Ready: 0 0 0
Number of sessions in state Ready: 0 0 0
Number of sessions in state Dyn Sync: 0 0 0
Timeout: Timer Type Delay Remaining Starts CPU Limit CPU Last
------------ -------- --------- ----------- --------- --------
Dynamic CPU 00:00:10 - 0 90 0
Bulk Time Li 00:08:00 - 0 - -
RF Notif Ext 00:00:20 - 0 - -
The following is sample output from the show ccm sessions command on a Cisco 7600 series router active processor:
Router# show ccm sessions
Global CCM state: CCM HA Active - Dynamic Sync
Global ISSU state: Compatible, Clients Cap 0xFFFE
Current Bulk Sent Bulk Rcvd
----------- ----------- -----------
Number of sessions in state Down: 0 0 0
Number of sessions in state Not Ready: 7424 0 0
Number of sessions in state Ready: 0 0 0
Number of sessions in state Dyn Sync: 20002 28001 0
Timeout: Timer Type Delay Remaining Starts CPU Limit CPU Last
------------ -------- --------- ----------- --------- --------
Dynamic CPU 00:00:10 - 0 90 2
Bulk Time Li 00:08:00 - 0 - -
RF Notif Ext 00:00:20 - 18 - -
The following is sample output from the show ccm sessions command on a Cisco 7600 series router standby processor:
Router# show ccm sessions
Global CCM state: CCM HA Standby - Collecting
Global ISSU state: Compatible, Clients Cap 0xFFE
Current Bulk Sent Bulk Rcvd
----------- ----------- -----------
Number of sessions in state Down: 0 0 0
Number of sessions in state Not Ready: 8038 0 0
Number of sessions in state Ready: 20002 0 28001
Number of sessions in state Dyn Sync: 0 0 0
Timeout: Timer Type Delay Remaining Starts CPU Limit CPU Last
------------ -------- --------- ----------- --------- --------
Dynamic CPU 00:00:10 - 0 90 0
Bulk Time Li 00:08:00 - 1 - -
RF Notif Ext 00:00:20 - 0 - -
Table 29 describes the significant fields shown in the display. Any data not described in the table is used for Cisco internal debugging.
Table 29 show ccm sessions Field Descriptions
Field
|
Description
|
Global CCM state
|
Displays the processor's active or standby status and its CCM state. For example:
• CCM HA Active - Dynamic Sync means that this is the active processor, standby is in STANDBY_HOT state, and CCM is ready to synchronize sessions.
• CCM HA Active - Collecting means that this is the active processor and there is no standby processor. CCM can collect sessions but cannot synchronize them to a standby processor.
• CCM HA Active - Bulk Sync means that this is the active processor and a standby processor is booting up. CCM is doing a bulk synchronization of sessions.
• CCM HA Standby- Collecting means that this is the standby processor and is in STANDBY_HOT state. CCM is collecting sessions for synchronizing if a switchover happens.
|
Global ISSU state
|
Compatible, Clients Cap 0xFFFE0 indicates that CCM is compatible for in-service software upgrade (ISSU) clients—that is, ISSU-compatible Cisco IOS versions are running on both processors. It also means that CCM has the client capability for the clients in the bitmask 0xFFFE.
|
Current
|
CCM sessions currently ready for synchronization.
|
Bulk Sent
|
CCM sessions sent during bulk synchronization.
|
Bulk Rcvd
|
CCM sessions received during bulk synchronization.
|
Number of sessions in state Down
|
Sessions in the down state.
|
Number of sessions in state Not Ready
|
Sessions in the not ready state.
|
Number of sessions in state Ready
|
Sessions in the ready state.
|
Number of sessions in state Dyn Sync
|
Sessions in the dynamic synchronization state.
|
Timeout
|
Displays statistics for the following timers:
• Rate—Monitors the number of sessions to be synchronized per configured time period.
• Dynamic CPU—Monitors CPU limit, number of sessions, delay, and allowed calls configured for dynamic synchronization parameters.
• Bulk Time Li—Monitors the time limit configured for bulk synchronization.
• RF Notif Ext—Monitors redundancy facility (RF) active and standby state progressions and events.
Use the subscriber redundancy command to modify parameters that these timers monitor.
|
Delay
|
Timer delay (in hh:mm:ss) for bulk and dynamic synchronization for subscriber sessions.
|
Remaining
|
Indicates remaining time in seconds before the timer expires.
|
Starts
|
Indicates the number of times the timer started.
|
CPU Limit
|
CPU usage percentage, a configurable value; default is 90 percent.
|
CPU Last
|
Indicates the last time that the CPU limit timer was running.
|
Related Commands
Command
|
Description
|
show ccm clients
|
Displays CCM client information.
|
show ccm queues
|
Displays CCM queue information.
|
subscriber redundancy
|
Configures subscriber session redundancy policies.
|
show cef nsf
To show the current Cisco nonstop forwarding (NSF) state of Cisco Express Forwarding on both the active and standby Route Processors (RPs), use the show cef nsf command in privileged EXEC mode.
show cef nsf
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S.
|
12.2(20)S
|
Support for the Cisco 7304 router was added.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Usage Guidelines
If you enter the show cef nsf command before a switchover occurs, no switchover activity is reported. After a switchover occurs, you can enter the show cef nsf command to display details about the switchover as reported by the newly active RP. On the Cisco 12000 and 7500 series Internet routers, details about line card switchover are also provided.
Examples
The following example shows the current NSF state:
Last switchover occurred: 00:01:30.088 ago
Routing convergence duration: 00:00:34.728
FIB stale entry purge durations:00:00:01.728 - Default
Slot Count Type Quiesce Period
No NSF stats available for the following linecards:4 7
Table 30 describes the significant fields shown in the display.
Table 30 show cef nsf Field Descriptions
Field
|
Description
|
Last switchover occurred
|
Time since the last system switchover.
|
Routing convergence duration
|
Time taken after the switchover before the routing protocol signaled Cisco Express Forwarding that they had converged.
|
Stale entry purge
|
Time taken by Cisco Express Forwarding to purge any stale entries in each FIB table. In the example, these are the FIB tables names "Default" and "Red."
|
Switchover
|
Per-line card NSF statistics.
|
Slot
|
Line card slot number.
|
Count
|
Number of times the line card has switched over. This value will always be 1, unless the type is SSO.
|
Type
|
Type of switchover the line card performed last. The type can be SSO, RPR+ or RPR.
|
Quiesce Period
|
Period of time when the line card was disconnected from the switching fabric. During this time, no packet forwarding can take place.
Other system restart requirements may add additional delay until the line card can start forwarding packets.
|
Related Commands
Command
|
Description
|
clear ip cef epoch
|
Begins a new epoch and increments the epoch number for a Cisco Express Forwarding table.
|
show cef state
|
Displays the state of Cisco Express Forwarding on a networking device.
|
show cef state
To display the state of Cisco Express Forwarding on a networking device, use the show cef state command in privileged EXEC mode.
show cef state
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced on Cisco 7500, 10000, and 12000 series Internet routers.
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S on Cisco 7500 series routers.
|
12.2(20)S
|
Support for the Cisco 7304 router was added. The Cisco 7500 series router is not supported in Cisco IOS Release 12.2(20)S.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
12.4(20)T
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Examples
Example for Cisco IOS Releases 12.2(25)S, 12.2(28)SB, 12,2(33)SRA, 12,2(33)SXH, 12.4(20T, and Later Releases
The following example shows the state of Cisco Express Forwarding on the active route processor (RP):
dCEF disabled/not running
CEF switching enabled/running
universal per-destination load sharing algorithm, id A189DD49
dCEF disabled/not running
original per-destination load sharing algorithm, id A189DD49
Table 32 describes the significant fields shown in the display.
Table 31 show cef state Field Description (New)
Field
|
Description
|
RP instance
|
Cisco Express Forwarding status is for the RP.
|
common CEF enabled
|
Common Cisco Express Forwarding is enabled.
|
IPv4 CEF Status
|
Cisco Express Forwarding mode and status is for IPv4.
|
universal per-destination load sharing algorithm
|
IPv4 is using the universal per-destination load sharing algorithm for Cisco Express Forwarding traffic.
|
IPv6 CEF Status
|
Cisco Express Forwarding mode and status is for IPV6.
|
original per-destination load sharing algorithm
|
IPv6 is using the original per-destination load sharing algorithm for Cisco Express Forwarding traffic.
|
Example for Cisco IOS Releases Before Cisco IOS 12.2(25)S
The following example shows the state of Cisco Express Forwarding on the active route processor (RP):
Table 32 describes the significant fields shown in the display.
Table 32 show cef state Field Descriptions
Field
|
Description
|
I am standby RRP: no
|
This RP is not the standby.
|
RF Peer Presence: yes
|
This RP does have RF peer presence.
|
RF PeerComm reached: yes
|
This RP has reached RF peer communication.
|
Redundancy mode: SSO(&)
|
Type of redundancy mode on this RP.
|
CEF NSF: enabled/running
|
States whether Cisco Express Forwarding nonstop forwarding (NSF) is running or not.
|
The following example shows the state of Cisco Express Forwarding on the standby RP:
Related Commands
Command
|
Description
|
clear ip cef epoch
|
Begins a new epoch and increments the epoch number for a Cisco Express Forwarding table.
|
show cef nsf
|
Displays the current NSF state of Cisco Express Forwarding on both the active and standby RPs.
|
show clns interface
To list the CLNS-specific information about each interface, use the show clns interface command in privileged EXEC mode.
show clns interface [type number]
Syntax Description
type
|
(Optional) Interface type.
|
number
|
(Optional) Interface number.
|
Command Modes
Privileged EXEC
Command History
Mainline Release
|
Modification
|
10.0
|
This command was introduced.
|
0S Release
|
|
12.0(31)S
|
Support for the BFD feature was added.
|
S Release
|
|
12.2(18)SXE
|
Support for the Bidirectional Forwarding Detection (BFD) feature was added.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
T Release
|
|
12.4(4)T
|
Support for the BFD feature was added.
|
Examples
The following is sample output from the show clns interface command that includes information for Token Ring and serial interfaces:
Router# show clns interface
TokenRing 0 is administratively down, line protocol is down
CLNS protocol processing disabled
TokenRing 1 is up, line protocol is up
Checksums enabled, MTU 4461, Encapsulation SNAP
ERPDUs enabled, min. interval 10 msec.
RDPDUs enabled, min. interval 100 msec., Addr Mask enabled
Congestion Experienced bit set at 4 packets
CLNS fast switching disabled
DEC compatibility mode OFF for this interface
Next ESH/ISH in 18 seconds
Routing Protocol: ISO IGRP
Routing Domain/Area: <39.0003> <0020>
Serial 2 is up, line protocol is up
Checksums enabled, MTU 1497, Encapsulation HDLC
ERPDUs enabled, min. interval 10 msec.
RDPDUs enabled, min. interval 100 msec., Addr Mask enabled
Congestion Experienced bit set at 4 packets
CLNS fast switching enabled
DEC compatibility mode OFF for this interface
CLNS cluster alias enabled on this interface
Next ESH/ISH in 48 seconds
Level-1 Metric: 10, Priority: 64, Circuit ID: 0000.0C00.2D55.0A
Number of active level-1 adjacencies: 0
Level-2 Metric: 10, Priority: 64, Circuit ID: 0000.0000.0000.00
Number of active level-2 adjacencies: 0
Next IS-IS LAN Level-1 hello in 3 seconds
Next IS-IS LAN Level-2 hello in 3 seconds
Cisco IOS Release 12.2(18)SXE, 12.0(31)S, and 12.4(4)T
The following is sample output from the show clns interface command that verifies that the BFD feature has been enabled on Ethernet interface 3/0. The relevant command output is shown in bold in the output.
Router# show clns interface ethernet 3/0
Ethernet3/0 is up, line protocol is up
Checksums enabled, MTU 1497, Encapsulation SAP
ERPDUs enabled, min. interval 10 msec.
CLNS fast switching enabled
CLNS SSE switching disabled
DEC compatibility mode OFF for this interface
Next ESH/ISH in 42 seconds
Interface number 0x1, local circuit ID 0x2
Level-1 Metric: 10, Priority: 64, Circuit ID: RouterA.02
Number of active level-1 adjacencies: 0
Level-2 Metric: 10, Priority: 64, Circuit ID: RouterA.02
Number of active level-2 adjacencies: 0
Next IS-IS LAN Level-1 Hello in 3 seconds
Next IS-IS LAN Level-2 Hello in 5 seconds
Table 33 describes the significant fields shown in the display.
Table 33 show clns interface Field Descriptions
Field
|
Description
|
TokenRing 0 is administratively down, line protocol is down
|
(First interface). Shown to be administratively down with CLNS disabled.
|
TokenRing 1 is up, line protocol is up
|
(Second interface). Shown to be up, and the line protocol is up.
|
Serial 2 is up, line protocol is up
|
(Third interface). Shown to be up, and the line protocol is up.
|
Checksums enabled
|
Can be enabled or disabled.
|
MTU
|
The number following maximum transmission unit (MTU) is the maximum transmission size for a packet on this interface.
|
Encapsulation
|
Describes the encapsulation used by CLNP packets on this interface.
|
ERPDUs
|
Displays information about the generation of error protocol data units (ERPDUs). They can be either enabled or disabled. If they are enabled, they are sent out no more frequently than the specified interval.
|
RDPDUs
|
Provides information about the generation of redirect protocol data units (RDPDUs). They can be either enabled or disabled. If they are enabled, they are sent out no more frequently than the specified interval. If the address mask is enabled, redirects are sent out with an address mask.
|
Congestion Experienced
|
Tells when CLNS will turn on the congestion experienced bit. The default is to turn this bit on when there are more than four packets in a queue.
|
CLNS fast switching
|
Displays whether fast switching is supported for CLNS on this interface.
|
DEC compatibility mode
|
Indicates whether Digital Equipment Corporation (DEC) compatibility has been enabled.
|
CLNS cluster alias enabled on this interface
|
Indicates that CLNS cluster aliasing has been enabled on this interface.
|
Next ESH/ISH
|
Displays when the next end system (ES) hello or intermediate system (IS) hello will be sent on this interface.
|
Routing Protocol
|
Lists the areas that this interface is in. In most cases, an interface will be in only one area.
|
Circuit Type
|
Indicates whether the interface has been configured for local routing (level 1), area routing (level 2), or local and area routing (level 1-2).
|
Interface number, local circuit ID Level-1 Metric DR ID Level-1 IPv6 Metric Number of active level-1 adjacencies Level-2 Metric DR ID Level-2 IPv6 Metric Number of active level-2 adjacencies Next IS-IS LAN Level-1 Next IS-IS LAN Level-2
|
Last series of fields displays information pertaining to the International Organization for Standardization (ISO) CLNS routing protocols enabled on the interface. For ISO Interior Gateway Routing Protocol (IGRP), the routing domain and area addresses are specified. For IS-IS, the Level 1 and Level 2 metrics, priorities, circuit IDs, and number of active Level 1 and Level 2 adjacencies are specified.
|
BFD enabled
|
BFD has been enabled on the interface.
|
show clns neighbors
To display end system (ES), intermediate system (IS), and multitopology Integrated Intermediate System-to-Intermediate System (M-ISIS) neighbors, use the show clns neighbors command in user EXEC or privileged EXEC mode.
show clns neighbors [process-tag] [interface-type interface-number] [area] [detail]
Syntax Description
process-tag
|
(Optional) A unique name among all International Organization for Standardization (ISO) router processes including IP and Connectionless Network Service (CLNS) router processes for a given router. If a process tag is specified, output is limited to the specified routing process. When null is specified for the process tag, output is displayed only for the router process that has no tag specified. If a process tag is not specified, output is displayed for all processes.
|
interface-type
|
(Optional) Interface type.
|
interface-number
|
(Optional) Interface number.
|
area
|
(Optional) Displays the CLNS multiarea adjacencies.
|
detail
|
(Optional) Displays the area addresses advertised by the neighbor in the hello messages. Otherwise, a summary display is provided.
In IPv6, this keyword displays the address family of the adjacency.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(5)T
|
The area and detail keywords were added.
|
12.2(15)T
|
Support was added for IPv6.
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S.
|
12.0(26)S
|
This command was integrated into Cisco IOS Release 12.0(26)S.
|
12.0(29)S
|
The process-tag argument was added.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(25)SG
|
This command was integrated into Cisco IOS Release 12.2(25)SG.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Cisco IOS XE Release 2.4
|
This command was introduced on Cisco ASR 1000 Series Routers.
|
Usage Guidelines
The show clns neighbors command displays the adjacency that is learned through multitopology IS-IS for IPv6.
Examples
The following is sample output from the show clns neighbors command:
Router# show clns neighbors
System Id Interface SNPA State Holdtime Type Protocol
0000.0000.0007 Et3/3 aa00.0400.6408 UP 26 L1 IS-IS
0000.0C00.0C35 Et3/2 0000.0c00.0c36 Up 91 L1 IS-IS
0800.2B16.24EA Et3/3 aa00.0400.2d05 Up 27 L1 M-ISIS
0800.2B14.060E Et3/2 aa00.0400.9205 Up 8 L1 IS-IS
The following is sample output from the show clns neighbors command using the process-tag argument to display information about the VRF-aware IS-IS instance tag1:
Router# show clns tagRED neighbors
System Id Interface SNPA State Holdtime Type Protocol
igp-03 Fa0/ 200d0.2b7f.9502 Up 9 L2 IS-IS
igp-03 PO2/2.1 DLCI 211 Up 27 L2 IS-IS
igp-02 PO2/0.1 DLCI 131 Up 29 L2 IS-IS
igp-11 Fa0/4 000e.d79d.7920 Up 7 L2 IS-IS
igp-11 Fa0/5 000e.d79d.7921 Up 8 L2 IS-IS
igp-11 PO3/2.1 DLCI 451 Up 24 L2 IS-IS
The following is sample output from the show clns neighbors command using the detail keyword:
Router# show clns neighbors detail
System Id Interface SNPA State Holdtime Type Protocol
0000.0000.0007 Et3/3 aa00.0400.6408 UP 26 L1 IS-IS
IP Address(es): 172.16.0.42*
0000.0C00.0C35 Et3/2 0000.0c00.0c36 Up 91 L1 IS-IS
IP Address(es): 192.168.0.42*
0800.2B16.24EA Et3/3 aa00.0400.2d05 Up 27 L1 M-ISIS
IP Address(es): 192.168.0.42*
IPv6 Address(es): FE80::2B0:8EFF:FE31:EC57
0800.2B14.060E Et3/2 aa00.0400.9205 Up 8 L1 IS-IS
IP Address(es): 192.168.0.30*
The following is sample output from the show clns neighbors command using the process-tag argument to display information about the VRF-aware IS-IS instance tagSecond:
Router# show clns tagSecond neighbors
System Id Interface SNPA State Holdtime Type Protocol
igp-03 Fa0/2 00d0.2b7f.9502 Up 9 L2 IS-IS
igp-03 PO2/2.1 DLCI 211 Up 27 L2 IS-IS
igp-02 PO2/0.1 DLCI 131 Up 29 L2 IS-IS
igp-11 Fa0/4 000e.d79d.7920 Up 7 L2 IS-IS
igp-11 Fa0/5 000e.d79d.7921 Up 8 L2 IS-IS
igp-11 PO3/2.1 DLCI 451 Up 24 L2 IS-IS
Table 34 describes the significant fields shown in the display.
Table 34 show clns neighbors Field Descriptions
Field
|
Description
|
Tag tagSecond
|
Tag name that identifies an IS-IS instance.
|
System Id
|
Six-byte value that identifies a system in an area.
|
Interface
|
Interface from which the system was learned.
|
SNPA
|
Subnetwork Point of Attachment. This is the data-link address.
|
State
|
State of the ES, IS, or M-ISIS.
|
Init
|
System is an IS and is waiting for an IS-IS hello message. IS-IS regards the neighbor as not adjacent.
|
Up
|
Believes the ES or IS is reachable.
|
Holdtime
|
Number of seconds before this adjacency entry times out.
|
Type
|
The adjacency type. Possible values are as follows:
• ES—End-system adjacency either discovered via the ES-IS protocol or statically configured.
• IS—Router adjacency either discovered via the ES-IS protocol or statically configured.
• M-ISIS—Router adjacency discovered via the multitopology IS-IS protocol.
• L1—Router adjacency for Level 1 routing only.
• L1L2—Router adjacency for Level 1 and Level 2 routing.
• L2—Router adjacency for Level 2 only.
|
Protocol
|
Protocol through which the adjacency was learned. Valid protocol sources are ES-IS, IS-IS, ISO IGRP, Static, DECnet, and M-ISIS.
|
Notice that the information displayed in the show clns neighbors detail command output includes everything shown in show clns neighbors command output in addition to the area address associated with the IS neighbor and its uptime. When IP routing is enabled, Integrated-ISIS adds information to the output of the show clns commands. The show clns neighbors detail command output shows the IP addresses that are defined for the directly connected interface and an asterisk (*) to indicate which IP address is the next hop.
show configuration lock
To display information about the lock status of the running configuration file during a configuration replace operation, use the show configuration lock command in privileged EXEC mode.
show configuration lock
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC(#)
Command History
Release
|
Modification
|
12.2(25)S
|
This command was introduced.
|
12.3(14)T
|
This command was integrated into Cisco IOS Release 12.3(14)T.
The output of this command was updated to display the configuration locking class.
|
12.0(31)S
|
The command output was enhanced.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(31)SB2
|
This command was implemented on the Cisco 10000 series.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
12.2(33)SB
|
This command was integrated into Cisco IOS Release 12.2(33)SB and implemented on the Cisco 10000 series.
|
Examples
The following is sample output from the show configuration lock command when the running configuration file is locked by another user.
Cisco IOS Release 12.2(25)S, Release 12.2(28)SB, Release 12.3(14)T, and Later Releases
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# configuration mode exclusive ?
auto Lock configuration mode automatically
manual Lock configuration mode on-demand
Router(config)# configuration mode exclusive auto
Router# show running-config | include configuration
configuration mode exclusive auto
Router# configure terminal !<----------- Acquires the lock
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# show configuration lock
Parser Configure Lock
---------------------
Owner PID : 3
User : unknown
TTY : 0
Type : EXCLUSIVE
State : LOCKED
Class : EXPOSED
Count : 1
Pending Requests : 0
User debug info : configure terminal
Router(config)#
Router(config)# end ! <------------ Releases the lock
The following is sample output from the show configuration lock command when the running configuration file is not locked by another user.
Router# show configuration lock
Parser Configure Lock
---------------------
Owner PID : -1
User : unknown
TTY : -1
Type : NO LOCK
State : FREE
Class : unknown
Count : 0
Pending Requests : 0
User debug info :
Cisco IOS Release 12.0(31)S, 12.2(33)SRA, and Later Releases
Router# show configuration lock
------------------------------------------------------
User debug info : configure terminal
Session idle state : TRUE
No of exec cmds getting executed : 0
No of exec cmds blocked : 0
Config wait for show completion : FALSE
Remote ip address : Unknown
Lock active time (in Sec) : 6
Lock Expiration timer (in Sec) : 593
Table 35 describes the significant fields shown in the displays.
Table 35 show configuration lock Field Descriptions
Field
|
Description
|
Owner PID
|
Process identifier (PID) of the process that owns the lock.
|
User
|
Owner's username.
|
TTY
|
Owner's terminal number.
|
Type
|
Lock type (EXCLUSIVE/COUNTER/NO LOCK).
|
State
|
State of the lock (FREE/LOCKED).
|
Class
|
Classification of users of the lock (EXPOSED/ROLLBACK). Processes other than ROLLBACK belong to the EXPOSED class.
|
Count
|
In the case of a counter lock, total number of processes holding the lock.
|
Pending Requests
|
Total number of processes blocked by the lock.
|
User debug info
|
Any string given by the process (used for debugging only).
|
Session idle state
|
Indicates whether the user in an access session locking session is idle. Displays TRUE or FALSE.
|
No of exec cmds getting executed
|
Total number of EXEC commands (show and clear) being executed simultaneously from different sessions.
|
No of exec cmds blocked
|
Total number of EXEC commands (show and clear) waiting for the configuration command (running from the access session locking session) to complete its execution.
|
Config wait for show completion
|
Indicates whether a configuration command executed in an access session locking session is waiting for the completion of the show command being executed simultaneously from a different session. Displays TRUE or FALSE.
|
Remote ip address
|
IP address of the terminal from which the user telneted to the router.
|
Lock active time (in Sec)
|
Amount of time, in seconds, that elapsed since the lock was acquired.
|
Lock Expiration timer (in Sec)
|
The amount of time, in seconds, that expires before the lock is automatically released.
|
The following example shows how to configure the configuration file for single user auto configuration mode (using the configuration mode exclusive auto command). Use the configure terminal command to enter global configuration mode and lock the configuration mode exclusively. Once the Cisco IOS configuration mode is locked exclusively, you can verify the lock using the show configuration lock command.
Router# configure terminal
Router(config)# configuration mode exclusive auto
Router# configure terminal
Router(config)# show configuration lock
Related Commands
Command
|
Description
|
configuration mode exclusive
|
Enables single-user (exclusive) access functionality for the Cisco IOS CLI.
|
configure replace
|
Replaces the current running configuration with a saved Cisco IOS configuration file.
|
debug configuration lock
|
Enables debugging of the Cisco IOS configuration lock.
|
show dampening interface
To display a summary of dampened interfaces, use the show damping interface command in user EXEC or privileged EXEC mode.
show dampening interface
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(18)SXD
|
This command was integrated into Cisco IOS Release 12.2(18)SXD.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Examples
The following is sample output from the show damping interface command in privileged EXEC mode:
Router# show dampening interface
3 interfaces are configured with dampening.
No interface is being suppressed.
Features that are using interface dampening:
Table 36 describes the significant fields shown in the sample output of the show dampening interface command.
Table 36 show dampening interface Field Descriptions
Field
|
Description
|
... interfaces are configured with dampening.
|
Displays the number of interfaces that are configured for event dampening.
|
No interface is being suppressed.
|
Displays the suppression status of the interfaces that are configured for event dampening.
|
Features that are using interface dampening:
|
Displays the routing protocols that are configured to perceived interface dampening.
|
Related Commands
Command
|
Description
|
clear counters
|
Clears the interface counters.
|
dampening
|
Enables IP event dampening at the interface level.
|
show interface dampening
|
Displays a summary of the dampening parameters and status.
|
show event manager directory user
To display the directory to use for storing user library files or user-defined Embedded Event Manager (EEM) policies, use the show event manager directory user command in privileged EXEC mode.
show event manager directory user [library | policy]
Syntax Description
library
|
(Optional) User library files.
|
policy
|
(Optional) User-defined EEM policies.
|
Command Default
The directories for both user library and user policy files are displayed.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.3(14)T
|
This command was introduced.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
Usage Guidelines
Use the event manager directory user command to specify the directory to use for storing user library or user policy files.
Examples
The following example shows the /usr/fm_policies folder on disk 0 as the directory to use for storing EEM user library files:
Router# show event manager directory user library
Related Commands
Command
|
Description
|
event manager directory user
|
Specifies a directory to use for storing user library files or user-defined EEM policies.
|
show event manager environment
To display the name and value of Embedded Event Manager (EEM) environment variables, use the show event manager environment command in privileged EXEC mode.
show event manager environment [all | variable-name]
Syntax Description
all
|
(Optional) Displays information for all environment variables. This is the default.
|
variable-name
|
(Optional) Displays information about the specified environment variable.
|
Command Default
If no argument or keyword is specified, information for all environment variables is displayed.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(25)S
|
This command was introduced.
|
12.3(14)T
|
This command was integrated into Cisco IOS Release 12.3(14)T.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
Examples
The following is sample output from the show event manager environment command:
Router# show event manager environment
1 _cron_entry 0-59/1 0-23/1 * * 0-7
3 _syslog_pattern .*UPDOWN.*Ethernet1/0.*
4 _config_cmd1 interface Ethernet1/0
5 _config_cmd2 no shutdown
Table 37 describes the significant fields shown in the display.
Table 37 show event manager environment Field Descriptions
Field
|
Description
|
No.
|
The index number assigned to the EEM environment variable.
|
Name
|
The name given to the EEM environment variable when it was created.
|
Value
|
The text content defined for the EEM environment variable when it was created.
|
Related Commands
Command
|
Description
|
event manager environment
|
Sets an EEM environment variable.
|
show event manager history events
To display the Embedded Event Manager (EEM) events that have been triggered, use the show event manager history events command in privileged EXEC mode.
show event manager history events [detailed] [maximum number]
Syntax Description
detailed
|
(Optional) Displays detailed information about each EEM event.
|
maximum
|
(Optional) Specifies the maximum number of events to display.
|
number
|
(Optional) Number in the range from 1 to 50. The default is 50.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(25)S
|
This command was introduced.
|
12.3(14)T
|
This command was integrated into Cisco IOS Release 12.3(14)T.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
12.4(20)T
|
The output was modified to include the Job ID and Status fields.
|
Usage Guidelines
Use the show event manager history events command to track information about the EEM events that have been triggered.
Examples
The following is sample output from the show event manager history events command showing that two types of events, Simple Network Management Protocol (SNMP) and application, have been triggered.
Router# show event manager history events
No. Time of Event Event Type Name
1 Fri Aug13 21:42:57 2004 snmp applet: SAAping1
2 Fri Aug13 22:20:29 2004 snmp applet: SAAping1
3 Wed Aug18 21:54:48 2004 snmp applet: SAAping1
4 Wed Aug18 22:06:38 2004 snmp applet: SAAping1
5 Wed Aug18 22:30:58 2004 snmp applet: SAAping1
6 Wed Aug18 22:34:58 2004 snmp applet: SAAping1
7 Wed Aug18 22:51:18 2004 snmp applet: SAAping1
8 Wed Aug18 22:51:18 2004 application applet: CustApp1
The following is sample output from the show event manager history events command that includes the Job ID and Status fields:
Router# show event manager history events
No. Job ID Status Time of Event Event Type Name
1 1 success Thu Sep 7 02:54:04 2006 syslog applet: two
2 2 success Thu Sep 7 02:54:04 2006 syslog applet: three
3 3 success Thu Sep 7 02:54:04 2006 syslog applet: four
4 4 abort Thu Sep 7 02:54:04 2006 syslog applet: five
5 5 abort Thu Sep 7 02:54:04 2006 syslog applet: six
6 6 abort Thu Sep 7 02:54:04 2006 syslog applet: seven
7 7 abort Thu Sep 7 02:54:04 2006 syslog applet: eight
8 8 cleared Thu Sep 7 02:54:04 2006 syslog applet: nine
9 9 cleared Thu Sep 7 02:54:04 2006 syslog applet: ten
10 10 cleared Thu Sep 7 02:54:04 2006 syslog applet: eleven
The following is sample output from the show event manager history events command using the detailed keyword:
Router# show event manager history events detailed
No. Job ID Status Time of Event Event Type Name
1 1 success Thu Sep 7 02:54:04 2006 syslog applet: two
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
2 2 success Thu Sep 7 02:54:04 2006 syslog applet: three
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
3 3 success Thu Sep 7 02:54:04 2006 syslog applet: four
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
4 4 abort Thu Sep 7 02:54:04 2006 syslog applet: five
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
5 5 abort Thu Sep 7 02:54:04 2006 syslog applet: six
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
6 6 abort Thu Sep 7 02:54:04 2006 syslog applet: seven
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
7 7 cleared Thu Sep 7 02:54:04 2006 syslog applet: eight
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
8 8 cleared Thu Sep 7 02:54:04 2006 syslog applet: nine
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
9 9 cleared Thu Sep 7 02:54:04 2006 syslog applet: ten
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
10 10 success Thu Sep 7 02:54:04 2006 syslog applet: eleven
msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
Table 38 describes the significant fields shown in the displays.
Table 38 show event manager history events Field Descriptions
Field
|
Description
|
No.
|
Event number.
|
Job ID
|
Unique internal EEM scheduler job identification number.
|
Status
|
Policy completion status for the policy scheduled for this event. There are three possible status values:
• Success—Indicates that the policy for this event completed normally.
• Abort—Indicates that the policy for this event terminated abnormally.
• Cleared—Indicates that the policy for this event was removed from execution using the event manager scheduler clear command.
|
Time of Event
|
Day, date, and time when the event was triggered.
|
Event Type
|
Type of event.
|
Name
|
Name of the policy that was triggered.
|
Related Commands
Command
|
Description
|
event manager history size
|
Modifies the size of the EEM history tables.
|
event manager scheduler clear
|
Clears EEM policies that are executing or pending execution.
|
show event manager history traps
To display the Embedded Event Manager (EEM) Simple Network Management Protocol (SNMP) traps that have been sent, use the show event manager history traps command in privileged EXEC mode.
show event manager history traps [server | policy]
Syntax Description
server
|
(Optional) Displays SNMP traps that were triggered from the EEM server.
|
policy
|
(Optional) Displays SNMP traps that were triggered from within an EEM policy.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(25)S
|
This command was introduced.
|
12.3(14)T
|
This command was integrated into Cisco IOS Release 12.3(14)T.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
Usage Guidelines
Use the show event manager history traps command to identify whether the SNMP traps were implemented from the EEM server or from an EEM policy.
Examples
The following is sample output from the show event manager history traps command:
Router# show event manager history traps policy
1 Wed Aug18 22:30:58 2004 policy EEM Policy Director
2 Wed Aug18 22:34:58 2004 policy EEM Policy Director
3 Wed Aug18 22:51:18 2004 policy EEM Policy Director
Table 39 describes the significant fields shown in the display.
Table 39 show event manager history traps Field Descriptions
Field
|
Description
|
No.
|
Trap number.
|
Time
|
Date and time when the SNMP trap was implemented.
|
Trap Type
|
Type of SNMP trap.
|
Name
|
Name of the SNMP trap that was implemented.
|
Related Commands
Command
|
Description
|
event manager history size
|
Modifies the size of the EEM history tables.
|
show event manager metric processes
To display Embedded Event Manager (EEM) reliability metric data for Cisco IOS Software Modularity processes, use the show event manager metric processes command in privileged EXEC mode.
show event manager metric processes {all | process-name}
Syntax Description
all
|
Displays the process metric data for all Cisco IOS Software Modularity processes.
|
process-name
|
Specific process name.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(18)SXF4
|
This command was introduced.
|
Usage Guidelines
Use this command to display the reliability metric data for Cisco IOS Software Modularity processes. The system keeps a record of when processes start and end, and this data is used as the basis for reliability analysis.
The information provided by this command allows you to get availability information for a process or group of processes. A process is considered available when it is running.
Examples
The following is partial sample output from the show event manager metric processes command. In this partial example, the first and last entries showing the metric data for the processes on all the cards inserted in the system are displayed.
Router# show event manager metric processes all
=====================================
process name: devc-pty, instance: 1
sub_system: 0, version: 00.00.0000
--------------------------------
last event type: process start
recent start time: Fri Oct10 20:34:40 2003
recent normal end time: n/a
recent abnormal end time: n/a
number of times started: 1
number of times ended normally: 0
number of times ended abnormally: 0
most recent 10 process start times:
--------------------------
--------------------------
most recent 10 process end times and types:
cumulative process available time: 6 hours 30 minutes 7 seconds 378 milliseconds
cumulative process unavailable time: 0 hours 0 minutes 0 seconds 0 milliseconds
process availability: 0.100000000
number of abnormal ends within the past 60 minutes (since reload): 0
number of abnormal ends within the past 24 hours (since reload): 0
number of abnormal ends within the past 30 days (since reload): 0
=====================================
process name: cdp2.iosproc, instance: 1
sub_system: 0, version: 00.00.0000
--------------------------------
last event type: process start
recent start time: Fri Oct10 20:35:02 2003
recent normal end time: n/a
recent abnormal end time: n/a
number of times started: 1
number of times ended normally: 0
number of times ended abnormally: 0
most recent 10 process start times:
--------------------------
--------------------------
most recent 10 process end times and types:
cumulative process available time: 6 hours 29 minutes 45 seconds 506 milliseconds
cumulative process unavailable time: 0 hours 0 minutes 0 seconds 0 milliseconds
process availability: 0.100000000
number of abnormal ends within the past 60 minutes (since reload): 0
number of abnormal ends within the past 24 hours (since reload): 0
number of abnormal ends within the past 30 days (since reload): 0
Table 40 describes the significant fields shown in the display.
Table 40 show event manager metric processes Field Descriptions
Field
|
Description
|
node name
|
Node name.
|
process name
|
Software Modularity process name.
|
instance
|
Instance number of the Software Modularity process.
|
sub_system
|
Subsystem number.
|
version
|
Version number.
|
show event manager policy available
To display Embedded Event Manager (EEM) policies that are available to be registered, use the show event manager policy available command in privileged EXEC mode.
show event manager policy available [description [policy-name] | [detailed policy-filename]
[system | user]]
Syntax Description
description
|
(Optional) Specifies a brief description of the available policy.
|
policy-name
|
(Optional) Name of the policy.
|
detailed
|
(Optional) Displays the actual sample policy for the specified policy-filename.
|
policy-filename
|
(Optional) Name of sample policy to be displayed.
|
system
|
(Optional) Displays all available system policies.
|
user
|
(Optional) Displays all available user policies.
|
Command Default
If no keyword is specified, information for all available system and user policies is displayed.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(25)S
|
This command was introduced.
|
12.3(14)T
|
The user keyword was added, and this command was integrated into Cisco IOS Release 12.3(14)T.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
The detailed keyword and the policy-filename argument were added, and this command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
12.4(20)T
|
The output was modified to display bytecode scripts with a file extension of .tbc.
|
15.0(1)M
|
The command was modified. The description keyword and policy-name argument were added.
|
Usage Guidelines
This command is useful if you forget the exact name of a policy required for the event manager policy command.
The detailed keyword displays the actual specified sample policy. Use description policy-name to describe a policy. If policy-name is not specified, the output of show command displays the description of all the available policies.
In Cisco IOS Release 12.4(20)T, EEM 2.4 introduced bytecode support to allow storage of Tcl scripts in bytecode format, and the output of this command was modified to display files with a .tbc extension as well as the usual .tcl extension for Tcl scripts.
Examples
The following is sample output from the show event manager policy available command:
Router# show event manager policy available
No. Type Time Created Name
1 system Tue Sep 12 09:41:32 2002 sl_intf_down.tcl
2 system Tue Sep 12 09:41:32 2002 tm_cli_cmd.tcl
Table 41 describes the fields shown in the display.
Table 41 show event manager policy available Field Descriptions
Field
|
Description
|
No.
|
Index number automatically assigned to the policy.
|
Type
|
Indicates whether the policy is a system policy.
|
Time Created
|
Time stamp indicating the date and time when the policy file was created.
|
Name
|
Name of the EEM policy file.
|
The following is sample output from the show event manager policy available command with the detailed keyword and a policy name specified:
Router# show event manager policy available detailed tm_cli_cmd.tcl
::cisco::eem::event_register_timer cron name crontimer2 cron_entry $_cron_entry maxrun 240
#------------------------------------------------------------------
# EEM policy that will periodically execute a cli command and email the
# July 2005, Cisco EEM team
# Copyright (c) 2005 by cisco Systems, Inc.
#------------------------------------------------------------------
### The following EEM environment variables are used:
### _cron_entry (mandatory) - A CRON specification that determines
### when the policy will run. See the
### IOS Embedded Event Manager
### documentation for more information
### on how to specify a cron entry.
### Example: _cron_entry 0-59/1 0-23/1 * * 0-7
### _email_server (mandatory) - A Simple Mail Transfer Protocol (SMTP)
### mail server used to send e-mail.
### Example: _email_server mailserver.customer.com
The following is sample output from the show event manager policy available command showing a Tcl script with a .tcl filename extension and a bytecode script with a filename extension of .tbc. This example is for a Cisco IOS Release 12.4(20)T or later image.
Router# show event manager policy available
No. Type Time Created Name
1 system Tue Jun 10 09:41:32 2008 sl_intf_down.tcl
2 system Tue Jun 10 09:41:32 2008 tm_cli_cmd.tbc
Related Commands
Command
|
Description
|
event manager policy
|
Registers an EEM policy with the EEM.
|
show event manager policy pending
To display Embedded Event Manager (EEM) policies that are pending for execution, use the show event manager policy pending command in privileged EXEC mode.
show event manager policy pending [queue-type {applet | call-home | axp | script} | class
class-options | detailed]
Syntax Description
queue-type
|
(Optional) Specifies the queue type of the EEM policy.
|
applet
|
(Optional) Specifies EEM applet policy.
|
call-home
|
(Optional) Specifies EEM Call-Home policy.
|
axp
|
(Optional) Specifies EEM axp policy.
|
script
|
(Optional) Specifies EEM script policy.
|
class
|
(Optional) Specifies EEM class policy.
|
class-options
|
(Optional) Specifies the EEM policy class. You can specify either one or all of the following:
• class-letter—The class letter assigned for the EEM policy. Letters range from A to Z. Multiple instances of class letter can be specified.
• default—Specifies policies registered with default class.
• range class-letter-range—Specifies the EEM policy class in a range. Multiple instances of range class-letter-range can be specified. The letters used in class-letter-range must be in uppercase.
|
detailed
|
(Optional) Specifies the detailed content of the EEM policies.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(25)S
|
This command was introduced.
|
12.3(14)T
|
This command was integrated into Cisco IOS Release 12.3(14)T.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
12.4(20)T
|
The output was modified to include the Job ID and Status fields.
|
12.4(22)T
|
This command is supported with new options to qualify the policy queues reported in the output display and provides detailed policy information.
|
Usage Guidelines
Pending policies are policies that are pending execution in the EEM server execution queue. When an event is triggered, the policy that is registered to handle the event is queued for execution in the EEM server. Use the show event manager policy pending command to display the policies in this queue and to view the policy details.
Examples
The following is sample output from the show event manager policy pending command:
Router# show event manager policy pending
no. job id p s status time of event event type name
1 12851 N A pend Mon Oct29 20:51:18 2007 timer watchdog loop.tcl
2 12868 N A pend Mon Oct29 20:51:24 2007 timer watchdog loop.tcl
3 12873 N A pend Mon Oct29 20:51:27 2007 timer watchdog loop.tcl
4 12907 N A pend Mon Oct29 20:51:41 2007 timer watchdog loop.tcl
5 13100 N A pend Mon Oct29 20:52:55 2007 timer watchdog loop.tcl
Table 42 describes the significant fields shown in the displays.
Table 42 show event manager policy pending Field Descriptions
Field
|
Description
|
no.
|
Index number automatically assigned to the policy.
|
job id
|
Unique internal EEM scheduler job identification number.
|
p
|
Priority of the policy. There are four priorities:
• L—Indicates that the policy is of low priority.
• H—Indicates that the policy is of high priority.
• N—Indicates that the policy is of normal priority.
• Z—Indicates that the policy is of least priority.
|
s
|
Scheduler node of the policy. There are two nodes:
• A—Indicates that the scheduler node of this policy is active.
• S—Indicates that the scheduler node of this policy is standby.
|
status
|
Scheduling status for the policy. There are six possible status values:
• pend—Indicates that the policy is awaiting execution.
• runn—Indicates that the policy is executing.
• exec—Indicates that the policy has completed executing and is awaiting scheduler cleanup tasks.
• hold—Indicates that the policy is being held.
• wait—Indicates that the policy is waiting for a new event.
• continue—Indicates that the policy receives a new event and is ready to run.
|
time of event
|
Date and time when the policy was queued for execution in the EEM server.
|
event type
|
Type of event.
|
name
|
Name of the EEM policy file.
|
Related Commands
Command
|
Description
|
show event manager
|
Shows the event manager details of an EEM policy.
|
show event manager policy registered
To display Embedded Event Manager (EEM) policies that are already registered, use the show event manager policy registered command in privileged EXEC mode.
show event manager policy registered [description [policy-name] | detailed policy-filename
[system | user] | [event-type event-name] [system | user] [time-ordered | name-ordered]]
Syntax Description
description
|
(Optional) Displays a brief description about the registered policy.
|
policy-name
|
(Optional) Policy name for which the description should be displayed. If policy name is not provided, then description of all registered policies are displayed.
|
detailed
|
(Optional) Displays the contents of the specified policy.
|
system
|
(Optional) Displays the registered system policies.
|
user
|
(Optional) Displays the registered user policies.
|
policy-filename
|
(Optional) Name of policy whose contents are to be displayed.
|
event-type
|
(Optional) Displays the registered policies for the event type specified in the event-name argument. If the event type is not specified, all registered policies are displayed.
|
event-name
|
(Optional) Type of event. The following values are valid:
• application—Application event type.
• cli—Command-line interface (CLI) event type.
• config—Configuration change event type.
• counter—Counter event type.
• env—Environmental event type.
• interface—Interface event type.
• ioswdsysmon—Watchdog system monitor event type.
• none—Manually run policy event type.
• oir—OIR event type.
• rf—Redundancy facility event type.
• snmp—Simple Network Management Protocol (SNMP) event type.
• snmp-object—Snmp object event type.
• syslog—Syslog event type.
• test—Test event type.
• timer-absolute—Absolute timer event type.
• timer-countdown—Countdown timer event type.
• timer-cron—Clock daemon (CRON) timer event type.
• timer-watchdog—Watchdog timer event type.
|
time-ordered
|
(Optional) Displays the policies in the order of the time at which they were registered. This is the default.
|
name-ordered
|
(Optional) Displays the policies, in alphabetical order, by policy name.
|
Command Default
If this command is invoked with no optional keywords, it displays all registered EEM system and user policies for all event types. The policies are displayed according to the time at which they were registered.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.0(26)S
|
This command was introduced.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.2(25)S
|
This command was integrated into Cisco IOS Release 12.2(25)S.
|
12.3(14)T
|
Additional event types and the user keyword were added, and this command was integrated into Cisco IOS Release 12.3(14)T.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
The detailed keyword and the policy-filename argument were added, and this command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
15.0(1)M
|
This command was modified. The description keyword and the policy-name argument were added.
|
Usage Guidelines
The output shows registered policy information in two parts. The first line in each policy description lists the index number assigned to the policy, the policy type (system), the type of event registered, the time when the policy was registered, and the name of the policy file. The remaining lines of each policy description display information about the registered event and how the event is to be handled; the information comes directly from the Tool Command Language (Tcl) command arguments that make up the policy file. Output of the show event manager policy registered command is most helpful to persons who are writing and monitoring EEM policies.
The detailed keyword displays the actual specified sample policy including details about the environment variables used by the policy and instructions for running the policy.
Examples
The following is sample output from the show event manager policy registered command:
Router# show event manager policy registered
No. Class Type Event Type Trap Time Registered Name
1 applet system snmp Off Fri Aug 13 17:42:52 2004 IPSLAping1
oid {1.3.6.1.4.1.9.9.42.1.2.9.1.6.4} get-type exact entry-op eq entry-val {1}
exit-op eq exit-val {2} poll-interval 5.000
action 1.0 syslog priority critical msg Server IPecho Failed: OID=$_snmp_oid_val
action 1.1 snmp-trap strdata EEM detected server reachability failure to 10.1.88.9
action 1.2 publish-event sub-system 88000101 type 1 arg1 10.1.88.9 arg2 IPSLAEcho arg3
fail
action 1.3 counter name _IPSLA1F value 1 op inc
Table 43 describes the significant fields shown in the display.
Table 43 show event manager policy registered Field Descriptions
Field
|
Description
|
No.
|
Index number automatically assigned to the policy.
|
Class
|
Class of policy, either applet or script.
|
Type
|
Identifies whether the policy is a system policy.
|
Event Type
|
Type of event.
|
Trap
|
Identifies whether an SNMP trap is enabled.
|
Time Registered
|
Time stamp indicating the day, date, and time when the policy file was registered.
|
Name
|
Name of the EEM policy file.
|
The following is sample output from the show event manager policy registered command showing the use of the detailed keyword for the policy named tm_cli_cmd.tcl:
Router# show event manager policy registered detailed tm_cli_cmd.tcl
::cisco::eem::event_register_timer cron name crontimer2 cron_entry $_cron_entry maxrun 240
#------------------------------------------------------------------
# EEM policy that will periodically execute a cli command and email the
# July 2005, Cisco EEM team
# Copyright (c) 2005 by cisco Systems, Inc.
#------------------------------------------------------------------
### The following EEM environment variables are used:
### _cron_entry (mandatory) - A CRON specification that determines
### when the policy will run. See the
### IOS Embedded Event Manager
### documentation for more information
### on how to specify a cron entry.
### Example: _cron_entry 0-59/1 0-23/1 * * 0-7
### _email_server (mandatory) - A Simple Mail Transfer Protocol (SMTP)
### mail server used to send e-mail.
### Example: _email_server mailserver.example.com
Related Commands
Command
|
Description
|
event manager policy
|
Registers an EEM policy with the EEM.
|
show event manager session cli username
To display the username associated with Embedded Event Manager (EEM) policies that use the command-line interface (CLI) library, use the show event manager session cli username command in privileged EXEC mode.
show event manager session cli username
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.3(14)T
|
This command was introduced.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(18)SXF4
|
This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(18)SXF5
|
This command was integrated into Cisco IOS Release 12.2(18)SXF5.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
Usage Guidelines
Use this command to display the username associated with a Tool Command Language (Tcl) EEM policy. If you are using authentication, authorization, and accounting (AAA) security and implement authorization on a command basis, you should use the event manager session cli username command to set a username to be associated with a Tcl session. The username is used when a Tcl policy executes a CLI command. TACACS+ verifies each CLI command using the username associated with the Tcl session that is running the policy. Commands from Tcl policies are not usually verified because the router must be in privileged EXEC mode to register the policy.
Examples
The following example shows that the username of eemuser is associated with a Tcl session:
Router# show event manager session cli username
Related Commands
Command
|
Description
|
event manager session cli username
|
Associates a username with EEM policies that use the CLI library.
|
show glbp
To display Gateway Load Balancing Protocol (GLBP) information, use the show glbp command in privileged EXEC mode.
show glbp [capability [interface-type interface-number ]] | [[interface-type interface-number
[group-number] [state] [brief ] [detail] [client-cache [[age number] [forwarder number]] |
[mac-address address] | [summary]]]
Syntax Description
interface-type interface-number
|
(Optional) Interface type and number for which output is displayed.
|
group-number
|
(Optional) GLBP group number in the range from 0 to 1023.
|
state
|
(Optional) State of the GLBP router, one of the following: active, disabled, init, listen, and standby.
|
brief
|
(Optional) Summarizes each virtual gateway or virtual forwarder with a single line of output.
|
detail
|
(Optional) Displays all the status of the GLBP router in detailed format. The available status are: active, disabled, init, listen, speak, and standby.
|
capability
|
(Optional) Displays the GLBP capability interfaces.
|
client-cache
|
(Optional) Displays the GLBP client cache.
|
age number
|
(Optional) Displays the client-cache age in the range from 0 to 1440.
|
forwarder number
|
(Optional) Displays the client forwarder in the range from 1 to 4.
|
mac-address address
|
(Optional) Displays the mac-address of the client.
|
summary
|
(Optional) Displays the summary of the GLBP client caches.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(14)S
|
This command was introduced.
|
12.2(15)T
|
This command was integrated into Cisco IOS Release 12.2(15)T. The client-cache keyword was added.
|
12.3(2)T
|
The output was enhanced to display information about Message Digest 5 (MD5) authentication.
|
12.3(7)T
|
The output was enhanced to display information about assigned redundancy names to specified groups.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(31)SB2
|
This command was enhanced to display information about GLBP support of Stateful Switchover (SSO) mode.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Cisco IOS XE Release 2.1
|
This command was integrated into Cisco IOS XE Release 2.1.
|
12.4(15)T
|
This command was modified. The client-cache keyword was added.
|
12.4(24)T
|
This command was modified. The detail keyword was added.
The output was modified to hide configured passwords when MD5 key-string or text authentication is configured.
|
12.2(33)SXI1
|
This command was modified. The client-cache keyword was added.
The output was modified to hide configured passwords when MD5 key-string or text authentication is configured.
|
12.2(33)SRE
|
The output was modified to hide configured passwords when MD5 key-string or text authentication is configured.
|
Usage Guidelines
Use the show glbp command to display information about GLBP groups on a router. The brief keyword displays a single line of information about each virtual gateway or virtual forwarder. The client-cache keyword displays the client cache details and the capability keyword displays all GLBP-capable interfaces.
Examples
The following is sample output from the show glbp command:
FastEthernet0/0 - Group 10
2 state changes, last state change 23:50:33
Virtual IP address is 10.21.8.10
Hello time 5 sec, hold time 18 sec
Next hello sent in 4.300 secs
Redirect time 600 sec, forwarder time-out 7200 sec
Authentication MD5, key-string
Preemption enabled, min delay 60 sec
Priority 254 (configured)
Weighting 105 (configured 110), thresholds: lower 95, upper 105
Track object 2 state Down decrement 5
Load balancing: host-dependent
There is 1 forwarder (1 active)
1 state change, last state change 23:50:15
MAC address is 0007.b400.0101 (default)
Owner ID is 0005.0050.6c08
Preemption enabled, min delay 60 sec
Active is local, weighting 105
The following is sample output from the show glbp command with the brief keyword specified:
Interface Grp Fwd Pri State Address Active router Standby router
Fa0/0 10 - 254 Active 10.21.8.10 local unknown
Fa0/0 10 1 7 Active 0007.b400.0101 local -
The following is sample output from the show glbp command that displays GLBP group 10:
FastEthernet0/0 - Group 10
2 state changes, last state change 23:50:33
Virtual IP address is 10.21.8.10
Hello time 5 sec, hold time 18 sec
Next hello sent in 4.300 secs
Redirect time 600 sec, forwarder time-out 7200 sec
Authentication MD5, key-string
Preemption enabled, min delay 60 sec
Priority 254 (configured)
Weighting 105 (configured 110), thresholds: lower 95, upper 105
Track object 2 state Down decrement 5
Load balancing: host-dependent
There is 1 forwarder (1 active)
1 state change, last state change 23:50:15
MAC address is 0007.b400.0101 (default)
Owner ID is 0005.0050.6c08
Preemption enabled, min delay 60 sec
Active is local, weighting 105
The following output shows that the redundancy name has been assigned to the "glbp1" group:
Router# show glbp ethernet0/1 1
Ethernet0/1 - Group 1
State is Listen
64 state changes, last state change 00:00:54
Virtual IP address is 10.1.0.7
Hello time 50 msec, hold time 200 msec
Next hello sent in 0.030 secs
Redirect time 600 sec, forwarder time-out 14400 sec
Authentication text, string "authword"
Preemption enabled, min delay 0 sec
Active is 10.1.0.2, priority 105 (expires in 0.184 sec)
Standby is 10.1.0.3, priority 100 (expires in 0.176 sec)
Priority 96 (configured)
Weighting 100 (configured 100), thresholds: lower 95, upper 100
Track object 1 state Up decrement 10
Load balancing: round-robin
IP redundancy name is "glbp1"
Group members:
0004.4d83.4801 (10.0.0.0)
0010.7b5a.fa41 (10.0.0.1)
00d0.bbd3.bc21 (10.0.0.2) local
The following output shows GLBP support for SSO mode on an active RP:
1 state change, last state change 00:00:20
Virtual IP address is 172.24.1.254
Hello time 3 sec, hold time 10 sec
Next hello sent in 0.232 secs
Redirect time 600 sec, forwarder time-out 14400 sec
Active is 172.24.1.2, priority 100 (expires in 7.472 sec)
Weighting 100 (default 100), thresholds: lower 1, upper 100
Load balancing: round-robin
aabb.cc00.0100 (172.24.1.1) local
aabb.cc00.0200 (172.24.1.2)
There are 2 forwarders (1 active)
MAC address is 0007.b400.0101 (learnt)
Owner ID is aabb.cc00.0200
Time to live: 14397.472 sec (maximum 14400 sec)
Preemption enabled, min delay 30 sec
Active is 172.24.1.2 (primary), weighting 100 (expires in 9.540 sec)
1 state change, last state change 00:00:28
MAC address is 0007.b400.0102 (default)
Owner ID is aabb.cc00.0100
Preemption enabled, min delay 30 sec
Active is local, weighting 100
The following output shows GLBP support for SSO mode on a standby RP:
RouterRP-standby# show glbp
State is Init (standby RP, peer state is Standby)
Virtual IP address is 172.24.1.254
Hello time 3 sec, hold time 10 sec
Redirect time 600 sec, forwarder time-out 14400 sec
Weighting 100 (default 100), thresholds: lower 1, upper 100
Load balancing: round-robin
aabb.cc00.0100 (172.24.1.1) local
aabb.cc00.0200 (172.24.1.2)
There are 2 forwarders (0 active)
State is Init (standby RP, peer state is Listen)
MAC address is 0007.b400.0101 (learnt)
Owner ID is aabb.cc00.0200
Preemption enabled, min delay 30 sec
State is Init (standby RP, peer state is Active)
MAC address is 0007.b400.0102 (default)
Owner ID is aabb.cc00.0100
Preemption enabled, min delay 30 sec
GLBP support for Stateful Switchover (SSO) mode is enabled by default but may be disabled by the no glbp sso command. If GLBP support for SSO mode is disabled, the output of the show glbp command on the standby RP will display a warning:
RouterRP-standby# show glbp
State is Init (GLBP SSO disabled) <------ GLBP SSO is disabled.
Virtual IP address is 172.24.1.254
Hello time 3 sec, hold time 10 sec
Redirect time 600 sec, forwarder time-out 14400 sec
Weighting 100 (default 100), thresholds: lower 1, upper 100
Load balancing: round-robin
aabb.cc00.0100 (172.24.1.1) local
There are 2 forwarders (0 active)
State is Init (GLBP SSO disabled)
MAC address is 0007.b400.0101 (learnt)
Owner ID is aabb.cc00.0200
Preemption enabled, min delay 30 sec
State is Init (GLBP SSO disabled)
MAC address is 0007.b400.0102 (default)
Owner ID is aabb.cc00.0100
Preemption enabled, min delay 30 sec
Table 44 describes the significant fields shown in the displays.
Table 44 show glbp Field Descriptions
Field
|
Description
|
FastEthernet0/0 - Group
|
Interface type and number and GLBP group number for the interface.
|
State is
|
State of the virtual gateway or virtual forwarder. For a virtual gateway, the state can be one of the following:
• Active—The gateway is the active virtual gateway (AVG) and is responsible for responding to Address Resolution Protocol (ARP) requests for the virtual IP address.
• Disabled—The virtual IP address has not been configured or learned yet, but another GLBP configuration exists.
• Initial—The virtual IP address has been configured or learned, but virtual gateway configuration is not complete. An interface must be up and configured to route IP, and an interface IP address must be configured.
• Listen—The virtual gateway is receiving hello packets and is ready to change to the "speak" state if the active or standby virtual gateway becomes unavailable.
• Speak—The virtual gateway is attempting to become the active or standby virtual gateway.
• Standby—The gateway is next in line to be the AVG.
|
| |
For a virtual forwarder, the state can be one of the following:
• Active—The gateway is the active virtual forwarder (AVF) and is responsible for forwarding packets sent to the virtual forwarder MAC address.
• Disabled—The virtual MAC address has not been assigned or learned. This is a transitory state because a virtual forwarder changing to a disabled state is deleted.
• Initial—The virtual MAC address is known, but virtual forwarder configuration is not complete. An interface must be up and configured to route IP, an interface IP address must be configured, and the virtual IP address must be known.
• Listen—The virtual forwarder is receiving hello packets and is ready to change to the "active" state if the AVF becomes unavailable.
|
Virtual IP address is
|
The virtual IP address of the GLBP group. All secondary virtual IP addresses are listed on separate lines. If one of the virtual IP addresses is a duplicate of an address configured for another device, it will be marked as "duplicate." A duplicate address indicates that the router has failed to defend its ARP cache entry.
|
Hello time, hold time
|
The hello time is the time between hello packets (in seconds or milliseconds). The hold time is the time (in seconds or milliseconds) before other routers declare the active router to be down. All routers in a GLBP group use the hello- and hold-time values of the current AVG. If the locally configured values are different, the configured values appear in parentheses after the hello- and hold-time values.
|
Next hello sent in
|
The time until GLBP will send the next hello packet (in seconds or milliseconds).
|
Preemption
|
Whether GLBP gateway preemption is enabled. If enabled, the minimum delay is the time (in seconds) for which a higher-priority nonactive router will wait before preempting the lower-priority active router.
This field is also displayed under the forwarder section where it indicates GLBP forwarder preemption.
|
Active is
|
The active state of the virtual gateway. The value can be "local," "unknown," or an IP address. The address (and the expiration date of the address) is the address of the current AVG.
This field is also displayed under the forwarder section where it indicates the address of the current AVF.
|
Standby is
|
The standby state of the virtual gateway. The value can be "local," "unknown," or an IP address. The address (and the expiration date of the address) is the address of the standby gateway (the gateway that is next in line to be the AVG).
|
Weighting
|
The initial weighting value with lower and upper threshold values.
|
Track object
|
The list of objects that are being tracked and their corresponding states.
|
IP redundancy name is
|
The name of the GLBP group.
|
Related Commands
Command
|
Description
|
glbp ip
|
Enables GLBP.
|
glbp timers
|
Configures the time between hello messages and the time before other routers declare the active GLBP router to be down.
|
glbp weighting track
|
Specifies an object to be tracked that affects the weighting of a GLBP gateway.
|
show interface dampening
To display dampened interfaces on the local router, use the show interface dampening command in privileged EXEC mode.
show interface dampening
Syntax Description
This command has no keywords or arguments.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(18)SXD
|
This command was integrated into Cisco IOS Release 12.2(18)SXD.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(31)SB2
|
This command was integrated into Cisco IOS Release 12.2(31)SB2.
|
Examples
The following is sample output from the show interface dampening command:
Router# show interface dampening
Flaps Penalty Supp ReuseTm HalfL ReuseV SuppV MaxSTm MaxP Restart
0 0 FALSE 0 5 1000 2000 20 16000 0
Table 45 describes the significant fields shown in the display.
Table 45 show interface dampening Field Descriptions
Field
|
Description
|
Flaps
|
Displays the number of times that an interface has flapped.
|
Penalty
|
Displays the accumulated penalty.
|
Supp
|
Indicates if the interface is dampened.
|
ReuseTm
|
Displays the reuse timer.
|
HalfL
|
Displays the half-life counter.
|
ReuseV
|
Displays the reuse threshold timer.
|
SuppV
|
Displays the suppress threshold.
|
MaxSTm
|
Displays the maximum suppress.
|
MaxP
|
Displays the maximum penalty.
|
Restart
|
Displays the restart timer.
|
Related Commands
Command
|
Description
|
clear counters
|
Clears the interface counters.
|
dampening
|
Enables IP event dampening at the interface level.
|
show dampening interface
|
Displays a summary of interface dampening.
|
show ip bgp
To display entries in the Border Gateway Protocol (BGP) routing table, use the show ip bgp command in user EXEC or privileged EXEC mode.
show ip bgp [ip-address [mask [longer-prefixes [injected] | shorter-prefixes [length]]] | all |
oer-paths | prefix-list name | route-map name]
Syntax Description
ip-address
|
(Optional) IP address entered to filter the output to display only a particular host or network in the BGP routing table.
|
mask
|
(Optional) Mask to filter or match hosts that are part of the specified network.
|
longer-prefixes
|
(Optional) Displays the specified route and all more specific routes.
|
injected
|
(Optional) Displays more specific prefixes injected into the BGP routing table.
|
shorter-prefix
|
(Optional) Displays the specified route and all less specific routes.
|
length
|
(Optional) Specifies the prefix length. The value for this argument is a number from 0 to 32.
|
all
|
(Optional) Displays all address family information in the BGP routing table.
|
oer-paths
|
(Optional) Displays Optimized Edge Routing (OER) controlled prefixes in the BGP routing table.
|
prefix-list name
|
(Optional) Filters the output based on the specified prefix list.
|
route-map name
|
(Optional) Filters the output based on the specified route map.
|
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
The display of prefix advertisement statistics was added.
|
12.0(6)T
|
The display of a message indicating support for route refresh capability was added.
|
12.0(14)ST
|
The prefix-list, route-map, and shorter-prefixes keywords were added.
|
12.2(2)T
|
The output was modified to display multipaths and a best path to the specified network.
|
12.0(21)ST
|
The output was modified to show the number of Multiprotocol Label Switching (MPLS) labels that arrive at and depart from the prefix.
|
12.0(22)S
|
A new status code indicating stale routes was added to support BGP graceful restart.
|
12.2(14)S
|
A message indicating support for BGP policy accounting was added and this command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(14)SX
|
This command was integrated into Cisco IOS Release 12.2(14)SX.
|
12.2(15)T
|
A new status code indicating stale routes was added to support BGP graceful restart.
|
12.3(2)T
|
The all keyword was added.
|
12.2(17b)SXA
|
This command was integrated into Cisco IOS Release 12.2(17b)SXA.
|
12.3(8)T
|
The oer-paths keyword was added.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(31)SB2
|
This command was integrated into Cisco IOS Release 12.2(31)SB2.
|
12.0(32)S12
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.
|
12.0(32)SY8
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.
|
12.4(24)T
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.
|
Cisco IOS XE Release 2.3
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.
|
12.2(33)SXI1
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.
|
12.0(33)S3
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.
|
Cisco IOS XE Release 2.4
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.
|
12.2(33)SRE
|
This command was modified. The command output was modified to show the backup path and the best external path information. Support for the best external route and backup path was added. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.
|
Usage Guidelines
The show ip bgp command is used to display the contents of the BGP routing table. The output can be filtered to display entries for a specific prefix, prefix length, and prefixes injected through a prefix list, route map, or conditional advertisement.
In Cisco IOS Release 12.0(32)SY8, 12.0(33)S3, 12.2(33)SRE, 12.2(33)SXI1, Cisco IOS XE Release 2.4, and later releases, the Cisco implementation of 4-byte autonomous system numbers uses asplain—65538 for example—as the default regular expression match and output display format for autonomous system numbers, but you can configure 4-byte autonomous system numbers in both the asplain format and the asdot format as described in RFC 5396. To change the default regular expression match and output display of 4-byte autonomous system numbers to asdot format, use the bgp asnotation dot command followed by the clear ip bgp * command to perform a hard reset of all current BGP sessions.
In Cisco IOS Release 12.0(32)S12, 12.4(24)T, and Cisco IOS XE Release 2.3, the Cisco implementation of 4-byte autonomous system numbers uses asdot—1.2 for example—as the only configuration format, regular expression match, and output display, with no asplain support.
oer-paths Keyword
In Cisco IOS Release 12.3(8)T, and later releases, BGP prefixes that are monitored and controlled by OER are displayed by entering the show ip bgp command with the oer-paths keyword.
Examples
•
show ip bgp: Example
•
show ip bgp (4-Byte Autonomous System Numbers): Example
•
show ip bgp ip-address: Example
•
show ip bgp all: Example
•
show ip bgp longer-prefixes: Example
•
show ip bgp shorter-prefixes: Example
•
show ip bgp prefix-list: Example
•
show ip bgp route-map: Example
show ip bgp: Example
The following example output shows the BGP routing table:
BGP table version is 22, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
r RIB-failure, S Stale, m multipath, b backup-path, x best-external
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.1.1.1/32 0.0.0.0 0 32768 i
*>i10.2.2.2/32 172.16.1.2 0 100 0 i
*bi10.9.9.9/32 192.168.3.2 0 100 0 10 10 i
* i172.16.1.0/24 172.16.1.2 0 100 0 i
*> 192.168.1.0 0.0.0.0 0 32768 i
*>i192.168.3.0 172.16.1.2 0 100 0 i
*bi192.168.9.0 192.168.3.2 0 100 0 10 10 i
*bi192.168.13.0 192.168.3.2 0 100 0 10 10 i
Table 46 describes the significant fields shown in the display.
Table 46 show ip bgp Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
• s—The table entry is suppressed.
• d—The table entry is dampened.
• h—The table entry history.
• *—The table entry is valid.
• >—The table entry is the best entry to use for that network.
• i—The table entry was learned via an internal BGP (iBGP) session.
• r—The table entry is a RIB-failure.
• S—The table entry is stale.
• m—The table entry has multipath to use for that network.
• b—The table entry has backup path to use for that network.
• x—The table entry has best external route to use for the network.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
• i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
• e—Entry originated from an Exterior Gateway Protocol (EGP).
• ?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
(stale)
|
Indicates that the following path for the specified autonomous system is marked as "stale" during a graceful restart process.
|
show ip bgp (4-Byte Autonomous System Numbers): Example
The following example output shows the BGP routing table with 4-byte autonomous system numbers, 65536 and 65550, shown under the Path field. This example requires Cisco IOS Release 12.0(32)SY8, 12.0(33)S3, 12.2(33)SRE, 12.2(33)SXI1, Cisco IOS XE Release 2.4, or a later release.
BGP table version is 4, local router ID is 172.17.1.99
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.1.1.0/24 192.168.1.2 0 0 65536 i
*> 10.2.2.0/24 192.168.3.2 0 0 65550 i
*> 172.17.1.0/24 0.0.0.0 0 32768 i
show ip bgp ip-address: Example
The following example displays information about the 192.168.1.0 entry in the BGP routing table:
Router# show ip bgp 192.168.1.0
BGP routing table entry for 192.168.1.0/24, version 22
Paths: (2 available, best #2, table default)
Advertised to update-groups:
192.168.3.2 from 172.16.1.2 (10.2.2.2)
Origin IGP, metric 0, localpref 100, valid, internal, backup/repair
192.168.1.2 from 192.168.1.2 (10.3.3.3)
Origin IGP, localpref 100, valid, external, best , recursive-via-connected
Router# show ip bgp 10.3.3.3 255.255.255.255
BGP routing table entry for 10.3.3.3/32, version 35
Paths: (3 available, best #2, table default)
Advertised to update-groups:
10.71.8.165 from 10.71.8.165 (192.168.0.102)
Origin incomplete, localpref 100, valid, external, backup/repair
Only allowed to recurse through connected route
10.71.11.165 from 10.71.11.165 (192.168.0.102)
Origin incomplete, localpref 100, weight 100, valid, external, best
Only allowed to recurse through connected route
10.71.10.165 from 10.71.10.165 (192.168.0.104)
Origin incomplete, localpref 100, valid, external,
Only allowed to recurse through connected route
Table 47 describes the significant fields shown in the display.
Table 47 show ip bgp Field Descriptions
Field
|
Description
|
BGP routing table entry for
|
IP address or network number of the routing table entry.
|
version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
Paths
|
The number of available paths, and the number of installed best paths. This line displays "Default-IP-Routing-Table" when the best path is installed in the IP routing table.
|
Multipath
|
This field is displayed when multipath loadsharing is enabled. This field will indicate if the multipaths are iBGP or eBGP.
|
Advertised to update-groups
|
The number of each update group for which advertisements are processed.
|
Origin
|
Origin of the entry. The origin can be IGP, EGP, or incomplete. This line displays the configured metric (0 if no metric is configured), the local preference value (100 is default), and the status and type of route (internal, external, multipath, best).
|
Extended Community
|
This field is displayed if the route carries an extended community attribute. The attribute code is displayed on this line. Information about the extended community is displayed on a subsequent line.
|
show ip bgp all: Example
The following example output from the show ip bgp command entered with the all keyword. Information about all configured address families is displayed.
For address family: IPv4 Unicast *****
BGP table version is 27, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.1.1.0/24 0.0.0.0 0 32768 ?
*> 10.13.13.0/24 0.0.0.0 0 32768 ?
*> 10.15.15.0/24 0.0.0.0 0 32768 ?
*>i10.18.18.0/24 172.16.14.105 1388 91351 0 100 e
*>i10.100.0.0/16 172.16.14.107 262 272 0 1 2 3 i
*>i10.100.0.0/16 172.16.14.105 1388 91351 0 100 e
*>i10.101.0.0/16 172.16.14.105 1388 91351 0 100 e
*>i10.103.0.0/16 172.16.14.101 1388 173 173 100 e
*>i10.104.0.0/16 172.16.14.101 1388 173 173 100 e
*>i10.100.0.0/16 172.16.14.106 2219 20889 0 53285 33299 51178 47751 e
*>i10.101.0.0/16 172.16.14.106 2219 20889 0 53285 33299 51178 47751 e
* 10.100.0.0/16 172.16.14.109 2309 0 200 300 e
*> 172.16.14.108 1388 0 100 e
* 10.101.0.0/16 172.16.14.109 2309 0 200 300 e
*> 172.16.14.108 1388 0 100 e
*> 10.102.0.0/16 172.16.14.108 1388 0 100 e
*> 172.16.14.0/24 0.0.0.0 0 32768 ?
*> 192.168.5.0 0.0.0.0 0 32768 ?
*> 10.80.0.0/16 172.16.14.108 1388 0 50 e
*> 10.80.0.0/16 172.16.14.108 1388 0 50 e
For address family: VPNv4 Unicast *****
BGP table version is 21, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
Route Distinguisher: 1:1 (default for vrf vpn1)
*> 10.1.1.0/24 192.168.4.3 1622 0 100 53285 33299 51178
{27016,57039,16690} e
*> 10.1.2.0/24 192.168.4.3 1622 0 100 53285 33299 51178
{27016,57039,16690} e
*> 10.1.3.0/24 192.168.4.3 1622 0 100 53285 33299 51178
{27016,57039,16690} e
*> 10.1.4.0/24 192.168.4.3 1622 0 100 53285 33299 51178
{27016,57039,16690} e
*> 10.1.5.0/24 192.168.4.3 1622 0 100 53285 33299 51178
{27016,57039,16690} e
*>i172.17.1.0/24 10.3.3.3 10 30 0 53285 33299 51178 47751 ?
*>i172.17.2.0/24 10.3.3.3 10 30 0 53285 33299 51178 47751 ?
*>i172.17.3.0/24 10.3.3.3 10 30 0 53285 33299 51178 47751 ?
*>i172.17.4.0/24 10.3.3.3 10 30 0 53285 33299 51178 47751 ?
*>i172.17.5.0/24 10.3.3.3 10 30 0 53285 33299 51178 47751 ?
For address family: IPv4 Multicast *****
BGP table version is 11, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.40.40.0/26 172.16.14.110 2219 0 21 22 {51178,47751,27016} e
* 10.1.1.1 1622 0 15 20 1 {2} e
*> 10.40.40.64/26 172.16.14.110 2219 0 21 22 {51178,47751,27016} e
* 10.1.1.1 1622 0 15 20 1 {2} e
*> 10.40.40.128/26 172.16.14.110 2219 0 21 22 {51178,47751,27016} e
* 10.1.1.1 2563 0 15 20 1 {2} e
*> 10.40.40.192/26 10.1.1.1 2563 0 15 20 1 {2} e
*> 10.40.41.0/26 10.1.1.1 1209 0 15 20 1 {2} e
*>i10.102.0.0/16 10.1.1.1 300 500 0 5 4 {101,102} e
*>i10.103.0.0/16 10.1.1.1 300 500 0 5 4 {101,102} e
For address family: NSAP Unicast *****
BGP table version is 1, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* i45.0000.0002.0001.000c.00
* i46.0001.0000.0000.0000.0a00
* i47.0001.0000.0000.000b.00
* i47.0001.0000.0000.000e.00
show ip bgp longer-prefixes: Example
The following is example output from the show ip bgp command entered with the longer-prefixes keyword:
Router# show ip bgp 10.92.0.0 255.255.0.0 longer-prefixes
BGP table version is 1738, local router ID is 192.168.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.92.0.0 10.92.72.30 8896 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.1.0 10.92.72.30 8796 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.11.0 10.92.72.30 42482 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.14.0 10.92.72.30 8796 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.15.0 10.92.72.30 8696 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.16.0 10.92.72.30 1400 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.17.0 10.92.72.30 1400 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.18.0 10.92.72.30 8876 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.19.0 10.92.72.30 8876 32768 ?
* 10.92.72.30 0 109 108 ?
show ip bgp shorter-prefixes: Example
The following is example output from the show ip bgp command entered with the shorter-prefixes keyword. An 8-bit prefix length is specified.
Router# show ip bgp 172.16.0.0/16 shorter-prefixes 8
*> 172.16.0.0 10.0.0.2 0 ?
show ip bgp prefix-list: Example
The following is example output from the show ip bgp command entered with the prefix-list keyword:
Router# show ip bgp prefix-list ROUTE
BGP table version is 39, local router ID is 10.0.0.1
Status codes:s suppressed, d damped, h history, * valid, > best, i -
Origin codes:i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 192.168.1.0 10.0.0.2 0 ?
show ip bgp route-map: Example
The following is example output from the show ip bgp command entered with the route-map keyword:
Router# show ip bgp route-map LEARNED_PATH
BGP table version is 40, local router ID is 10.0.0.1
Status codes:s suppressed, d damped, h history, * valid, > best, i -
Origin codes:i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 192.168.1.0 10.0.0.2 0 ?
Related Commands
Command
|
Description
|
bgp asnotation dot
|
Changes the default display and the regular expression match format of BGP 4-byte autonomous system numbers from asplain (decimal values) to dot notation.
|
router bgp
|
Configures the BGP routing process.
|
show ip bgp labels
To display information about Multiprotocol Label Switching (MPLS) labels from the external Border Gateway Protocol (eBGP) route table, use the show ip bgp labels command in privileged EXEC mode.
show ip bgp labels
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(21)ST
|
This command was introduced.
|
12.0(22)S
|
This command was integrated into Cisco IOS Release 12.0(22)S.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB and implemented on the Cisco 10000 series router.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Usage Guidelines
Use this command to display eBGP labels associated with an Autonomous System Boundary Router (ASBR).
This command displays labels for BGP routes in the default table only. To display labels in the Virtual Private Network (VPN) routing and forwarding (VRF) tables, use the show ip bgp vpnv4 {all | vrf vrf-name} command with the optional labels keyword.
Examples
The following example shows output for an ASBR using BGP as a label distribution protocol:
Router# show ip bgp labels
Network Next Hop In Label/Out Label
10.3.0.0/16 0.0.0.0 imp-null/exp-null
10.15.15.15/32 10.15.15.15 18/exp-null
10.16.16.16/32 0.0.0.0 imp-null/exp-null
10.17.17.17/32 10.0.0.1 20/exp-null
10.18.18.18/32 10.0.0.1 24/31
10.18.18.18/32 10.0.0.1 24/33
Table 48 describes the significant fields shown in the display.
Table 48 show ip bgp labels Field Descriptions
Field
|
Description
|
Network
|
Displays the network address from the eGBP table.
|
Next Hop
|
Specifies the eBGP next hop address.
|
In Label
|
Displays the label (if any) assigned by this router.
|
Out Label
|
Displays the label assigned by the BGP next hop router.
|
Related Commands
Command
|
Description
|
show ip bgp vpnv4
|
Displays VPN address information from the BGP table.
|
show ip bgp neighbors
To display information about Border Gateway Protocol (BGP) and TCP connections to neighbors, use the show ip bgp neighbors command in user or privileged EXEC mode.
show ip bgp neighbors [ip-address [advertised-routes | dampened-routes | flap-statistics |
paths [reg-exp] | received prefix-filter | received-routes | routes | policy [detail]]]
Syntax Description
ip-address
|
(Optional) IP address of a neighbor. If this argument is omitted, information about all neighbors is displayed.
|
advertised-routes
|
(Optional) Displays all routes that have been advertised to neighbors.
|
dampened-routes
|
(Optional) Displays the dampened routes received from the specified neighbor.
|
flap-statistics
|
(Optional) Displays the flap statistics of the routes learned from the specified neighbor (for external BGP peers only).
|
paths reg-exp
|
(Optional) Displays autonomous system paths learned from the specified neighbor. An optional regular expression can be used to filter the output.
|
received prefix-filter
|
(Optional) Displays the prefix-list (outbound route filter [ORF]) sent from the specified neighbor.
|
received-routes
|
(Optional) Displays all received routes (both accepted and rejected) from the specified neighbor.
|
routes
|
(Optional) Displays all routes that are received and accepted. The output displayed when this keyword is entered is a subset of the output displayed by the received-routes keyword.
|
policy
|
(Optional) Displays the policies applied to this neighbor per address family.
|
detail
|
(Optional) Displays detailed policy information such as route maps, prefix lists, community lists, access control lists (ACLs), and autonomous system path filter lists.
|
Command Default
The output of this command displays information for all neighbors.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
0S Release
|
Modification
|
12.0(18)S
|
The output was modified to display the no-prepend configuration option, and this command was integrated into Cisco IOS Release 12.0(18)S.
|
12.0(21)ST
|
The output was modified to display Multiprotocol Label Switching (MPLS) label information.
|
12.0(22)S
|
Support for the BGP graceful restart capability was integrated into the output. Support for the Cisco 12000 series routers (Engine 0 and Engine 2) was also added.
|
12.0(25)S
|
The policy and detail keywords were added.
|
12.0(27)S
|
The command output was modified to support the BGP TTL Security Check feature and to display explicit-null label information.
|
12.0(31)S
|
Support for the Bidirectional Forwarding Detection (BFD) feature was integrated into the output.
|
12.0(32)S12
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.
|
12.0(32)SY8
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.
|
12.0(33)S3
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.
|
S Release
|
Modification
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(17b)SXA
|
This command was integrated into Cisco IOS Release 12.2(17b)SXA.
|
12.2(18)SXE
|
Support for the Bidirectional Forwarding Detection (BFD) feature was integrated into the output.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA, and the output was modified to support BGP TCP path MTU discovery.
|
12.2(33)SRB
|
Support for the policy and detail keywords was integrated into Cisco IOS Release 12.2(33)SRB.
|
12.2(33)SXH
|
The output was modified to support BGP dynamic neighbors.
|
12.2(33)SRC
|
The output was modified to support BGP graceful restart per peer.
|
12.2(33)SB
|
The output was modified to support the BFD and the BGP graceful restart per peer features, and support for the policy and detail keywords was integrated into Cisco IOS Release 12.2(33)SB.
|
12.2(33)SXI1
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.
|
12.2(33)SRE
|
This command was modified. The command output was modified to support the BGP best external and BGP additional path features. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.
|
Mainline and T Release
|
Modification
|
10.0
|
This command was introduced.
|
11.2
|
The received-routes keyword was added.
|
12.2(4)T
|
The received and prefix-filter keywords were added, and this command was integrated into Cisco IOS Release 12.2(4)T.
|
12.2(15)T
|
Support for the BGP graceful restart capability was integrated into the output.
|
12.3(7)T
|
The command output was modified to support the BGP TTL Security Check feature and to display explicit-null label information.
|
12.4(4)T
|
Support for the Bidirectional Forwarding Detection (BFD) feature was integrated into the output.
|
12.4(11)T
|
Support for the policy and detail keywords was integrated into Cisco IOS Release 12.4(11)T.
|
12.4(20)T
|
The output was modified to support BGP TCP path MTU discovery.
|
12.4(24)T
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.
|
Cisco IOS XE Release 2
|
Modification
|
Cisco IOS XE Release 2.1
|
This command was integrated into Cisco IOS XE Release 2.1.
|
Cisco IOS XE Release 2.4
|
This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.
|
Usage Guidelines
Use the show ip bgp neighbors command to display BGP and TCP connection information for neighbor sessions. For BGP, this includes detailed neighbor attribute, capability, path, and prefix information. For TCP, this includes statistics related to BGP neighbor session establishment and maintenance.
Prefix activity is displayed based on the number of prefixes that are advertised and withdrawn. Policy denials display the number of routes that were advertised but then ignored based on the function or attribute that is displayed in the output.
In Cisco IOS Release 12.0(32)SY8, 12.0(33)S3, 12.2(33)SRE, 12.2(33)SXI1, Cisco IOS XE Release 2.4, and later releases, the Cisco implementation of 4-byte autonomous system numbers uses asplain—65538 for example—as the default regular expression match and output display format for autonomous system numbers, but you can configure 4-byte autonomous system numbers in both the a