-
Cisco IOS IP Application Services Command Reference
-
Introduction
-
carrier-delay (tracking) through forwarding-agent
-
ip accounting through ip sctp authenticate
-
ip tcp adjust-mss through ipv6 tcp adjust-mss
-
mls ip install-threshold through platform trace runtime process forwarding-manager module wccp
-
sctp through show ip sctp statistics
-
show ip sockets through show sockets
-
show tcp through start-forwarding agent
-
threshold metric through track timer
-
Index
-
Feedback
Contents
carrier-delay (tracking) through forwarding-agent
- carrier-delay (tracking)
- clear ip accounting
- clear ip icmp rate-limit
- clear ip sctp statistics
- clear ip tcp header-compression
- clear ip traffic
- clear ip wccp
- clear mls acl counters
- clear platform software wccp
- clear sctp statistics
- clear sockets
- clear tcp statistics
- clear time-range ipc
- clear wccp
- default (tracking)
- default-state
- delay (tracking)
- forwarding-agent
carrier-delay (tracking)
To enable Enhanced Object Tracking (EOT) to consider the carrier-delay timer when tracking the status of an interface, use the carrier-delay command in tracking configuration mode. To disable EOT from considering the carrier-delay timer when tracking the status of an interface, use the no form of this command.
Command Default
EOT does not consider the carrier-delay timer configured on an interface when tracking the status of the interface.
Usage Guidelines
If a link fails, by default there is a two-second timer that must expire before an interface and the associated routes are declared down. If a link goes down and comes back up before the carrier delay timer expires, the down state is effectively filtered, and the rest of the software on the switch is not aware that a link-down event occurred. You can configure the carrier-delay seconds command in interface configuration mode to extend the timer up to 60 seconds.
When Enhanced Object Tracking (EOT) is configured on an interface, the tracking may detect the interface is down before a configured carrier-delay timer has expired. This is because EOT looks at the interface state and does not consider the carrier-delay timer.
Examples
The following example shows how to configure the tracking module to wait for the interface carrier-delay timer to expire before notifying clients of a state change:
Router(config)# track 101 interface ethernet1/0 line-protocol Router(config-track)# carrier-delayRelated Commands
Command
Description
carrier-delay
Sets the carrier delay on an interface.
show track
Displays information about objects that are tracked by the tracking process.
track interface
Configures an interface to be tracked and to enter tracking configuration mode.
track ip route
Tracks the state of an IP route and enters tracking configuration mode.
track ip sla
Tracks the state of a Cisco IOS SLAs operation and enters tracking configuration mode.
track list
Specifies a list of objects to be tracked and the thresholds to be used for comparison.
track resolution
Specifies resolution parameters for a tracked object.
track timer
Specifies the interval that a tracking process polls a tracked object.
clear ip accounting
To clear the active or checkpointed database when IP accounting is enabled, use the clear ip accounting command in privileged EXEC mode.
Command History
Release
Modification
10.0
This command was introduced.
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
The clear ip accounting EXEC command clears the active database and creates the checkpointed database.
Examples
The following example clears the active database when IP accounting is enabled:
Router# clear ip accountingRelated Commands
Command
Description
ip accounting
Enables IP accounting on an interface.
ip accounting-list
Defines filters to control the hosts for which IP accounting information is kept.
ip accounting-threshold
Sets the maximum number of accounting entries to be created.
ip accounting-transit
Controls the number of transit records that are stored in the IP accounting database.
show ip accounting
Displays the active accounting or checkpointed database or displays access list violations.
clear ip icmp rate-limit
To clear all Internet Control Message Protocol (ICMP) unreachable rate-limiting statistics or all statistics for a specified interface, use the clear ip icmp rate-limit command in privileged EXEC mode.
Syntax Description
interface-type
(Optional) Type of interface to be configured. Refer to the interface command in the Cisco IOS Interface and Hardware Component Command Reference for a list of valid interface types.
interface-number
(Optional) Port, connector, or interface card number. On Cisco 4700 series routers, specifies the network interface module (NIM) or network processor module (NPM) number. The numbers are assigned at the factory at the time of installation or when added to a system, and can be displayed with the show interfaces command.
clear ip sctp statistics
NoteEffective with Cisco IOS Release 12.4(11)T, the clear ip sctp statistics command is replaced by the clear sctp statistics command. See the clear sctp statistics command for more information.
To clear statistics counts for Stream Control Transmission Protocol (SCTP) activity, use the clear ip sctp statistics command in privileged EXEC mode.
Command Default
This command has no default value. If this command is not entered, statistics counts for SCTP activity continue to be logged.
Command History
Release
Modification
12.2(2)T
This command was introduced.
12.2(4)T
This command was integrated into Cisco IOS Release 12.2(4)T.
12.2(8)T
This command was integrated into Cisco IOS Release 12.2(8)T and implemented on the following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 7200 series. Support for the Cisco AS5300, Cisco AS5350, Cisco AS5400, and Cisco AS5850 is not included in this release.
12.2(11)T
This command was implemented on the Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850.
12.4(11)T
This command was replaced by the clear sctp statistics command.
12.4(15)T
This command was moved to the Cisco IOS IP Application Services Command Reference.
Examples
The following command shows how to empty the buffer that holds SCTP statistics. No output is generated from this command.
Router# clear ip sctp statisticsRelated Commands
Command
Description
debug ip sctp api
Reports SCTP diagnostic information and messages.
show ip sctp association list
Displays a list of all current SCTP associations.
show ip sctp association parameters
Displays the parameters configured for the association defined by the association identifier.
show ip sctp association statistics
Displays the current statistics for the association defined by the association identifier.
show ip sctp errors
Displays error counts logged by SCTP.
show ip sctp instances
Displays all currently defined SCTP instances.
show ip sctp statistics
Displays overall statistics counts for SCTP.
show iua as
Displays information about the current condition of an application server.
show iua asp
Displays information about the current condition of an application server process.
clear ip tcp header-compression
To clear the TCP, UDP, and IP header-compression statistics, use the clear ip tcp header-compression command in privileged EXEC mode.
Command History
Release
Modification
15.0(1)M
This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
12.2(33)SRC
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SRC.
12.2(33)SXI
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXI.
Cisco IOS XE Release 2.1
This command was integrated into Cisco IOS XE Release 2.1.
clear ip traffic
To clear the global or system-wide IP traffic statistics for one or more interfaces, use the clear ip traffic command in privileged EXEC mode.
Command Default
Using the clear ip traffic command with no keywords or arguments clears the global or system-wide IP traffic statistics for all interfaces.
Command History
Release
Modification
12.4(2)T
This command was introduced.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2.
Cisco IOS XE Release 2.1
This command was integrated into Cisco IOS XE Release 2.1.
Cisco IOS XE Release 3.1S
This command was modified to include the optional interface keyword and associated type and number arguments. These modifications were made to provide support for the IPv4 MIBs as described in RFC 4293, Management Information Base for the Internet Protocol (IP) .
15.1(4)M
This command was modified. The optional interface keyword and associated type and number arguments were added. These modifications were made to provide support for the IPv4 MIBs as described in RFC 4293, Management Information Base for the Internet Protocol (IP) .
Usage Guidelines
Using the clear ip traffic command with the optional interface keyword clears the ipIfStatsTable counters displayed for the specified interface and also clears the counters displayed by the show ip traffic interface command.
Examples
The following example clears the global or system-wide IP traffic statistics on all interfaces:
Router# clear ip trafficThe following example shows how to clear the IP traffic statistics on Ethernet interface 0/0:
Router# clear ip traffic interface ethernet 0/0The following is sample output from the show ip traffic command for Ethernet interface 0/0 after clearing the traffic using the clear ip traffic command:
Router# show ip traffic Ethernet0/0 IP-IF statistics : Rcvd: 0 total, 0 total_bytes 0 format errors, 0 hop count exceeded 0 bad header, 0 no route 0 bad destination, 0 not a router 0 no protocol, 0 truncated 0 forwarded 0 fragments, 0 total reassembled 0 reassembly timeouts, 0 reassembly failures 0 discards, 0 delivers Sent: 0 total, 0 total_bytes 0 discards 0 generated, 0 forwarded 0 fragmented into, 0 fragments, 0 failed Mcast: 0 received, 0 received bytes 0 sent, 0 sent bytes Bcast: 0 received, 0 sentclear ip wccp
To remove IPv4 Web Cache Communication Protocol (WCCP) statistics (counts) maintained on the router for a particular service, use the clear ip wccp command in privileged EXEC mode.
Syntax Description
vrf vrf-name
(Optional) Specifies a virtual routing and forwarding (VRF) instance to associate with a service group.
service-number
(Optional) Number of the cache service to be removed. The number can be from 0 to 254.
web-cache
(Optional) Directs the router to remove statistics for the web cache service.
Command History
Release
Modification
11.1CA
This command was introduced for Cisco 7200 and 7500 platforms.
11.2P
Support for this command was added to a variety of Cisco platforms.
12.0(3)T
This command was expanded to be explicit about service using the web-cache keyword and the service-number argument.
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.
Cisco IOS XE Release 2.2
This command was integrated into Cisco IOS XE Release 2.2.
15.0(1)M
This command was modified. The vrf keyword and vrf-name argument were added.
12.2(33)SRE
This command was modified. The vrf keyword and vrf-name argument were added.
12.2(50)SY
This command was modified. The vrf keyword and vrf-name argument were added.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOS XE Release 3.3SG.
Cisco IOS XE 3.3SE
This command was implemented in Cisco IOS XE Release 3.3SE.
Usage Guidelines
Use the show ip wccp and show ip wccp detail commands to display WCCP statistics. If Cisco Cache Engines are used in your service group, the reverse proxy service is indicated by a value of 99.
Use the clear ip wccp command to clear the WCCP counters for all WCCP services in all VRFs.
clear mls acl counters
To clear the multilayer switching (MLS) access control list (ACL) counters, use the clear mls acl counters command in privileged EXEC mode.
clear mls acl counters { all [ module num ] | interface interface interface-number [ loopback interface-number | null interface-number | port-channel number | vlan vlan-id ] }
Syntax Description
all
Clears all the MLS ACL counters for all interfaces.
module num
(Optional) Clears all the MLS ACL counters for the specified DFC.
interface interface
Clears counters that are associated with the specified interface; possible valid values are ethernet, fastethernet, gigabitethernet, and tengigabitethernet. See the “Usage Guidelines” section for additional valid values.
interface-number
Module and port number; see the “Usage Guidelines” section for valid values.
loopback interface-number
(Optional) Specifies the loopback interface; valid values are from 0 to 2147483647.
null interface-number
(Optional) Specifies the null interface; the valid value is 0
port-channel number
(Optional) Specifies the channel interface; valid values are a maximum of 64 values ranging from 1 to 256.
vlan vlan-id
(Optional) Specifies the VLAN ID; valid values are from 1 to 4094.
Usage Guidelines
The valid values for interface include the ge-wan, atm, and pos keywords that are supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
This command is supported on Cisco 7600 series routers that are configured with a WS-F6K-DFC3B-XL, release 2.1 and later.
If you enter the clear mls acl counters all module num command, all the MLS ACL counters for the specified DFC only are cleared. If you enter the clear mls acl counters all command without entering the module num keyword and argument, all the MLS ACL counters for only the non-DFC modules and the supervisor engines are cleared.
The interface-number argument designates the module and port number. Valid values for interface-number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.
clear platform software wccp
To clear Web Cache Communication Protocol version 2 statistics on the Cisco ASR 1000 Series Routers, use the clear platform software wccpcommand in privileged EXEC mode.
Syntax Description
clear sctp statistics
To clear statistics counts for Stream Control Transmission Protocol (SCTP) activity, use the clear sctp statistics command in privileged EXEC mode.
Command Default
This command has no default value. If this command is not entered, statistics counts for SCTP activity continue to be logged.
Examples
The following command shows how to empty the buffer that holds SCTP statistics. No output is generated from this command.
Router# clear sctp statisticsRelated Commands
Command
Description
debug ip sctp api
Reports SCTP diagnostic information and messages.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association parameters
Displays the parameters configured for the association defined by the association identifier.
show sctp association statistics
Displays the current statistics for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp instances
Displays all currently defined SCTP instances.
show sctp statistics
Displays overall statistics counts for SCTP.
show iua as
Displays information about the current condition of an application server.
show iua asp
Displays information about the current condition of an application server process.
clear sockets
To close all IP sockets and clear the underlying transport connections and data structures, use the clear sockets command in privileged EXEC mode.
Usage Guidelines
Using this command results in an abortive close for TCP connections and Stream Control Transfer Protocol (SCTP) associations. When this command is entered, TCP connections abort by sending an RST (restore) and SCTP associations abort by sending an ABORT signal to the peer.
Use the show processescommand to display the list of running processes and their associated process IDs.
You can use the show sockets detail command to confirm all open sockets have been cleared.
clear tcp statistics
Command History
Release
Modification
11.3
This command was introduced.
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.
clear time-range ipc
To clear the time-range interprocess communications (IPC) message statistics and counters between the Route Processor and the line card, use the clear time-range ipc command in privileged EXEC mode.
clear wccp
To remove all (IPv4 and IPv6) Web Cache Communication Protocol (WCCP) statistics (counts) maintained on the router for a particular service, use the clear wccp command in privileged EXEC mode.
Syntax Description
vrf vrf-name
(Optional) Directs the router to remove statistics for a specific virtual routing and forwarding (VRF) instance.
service-number
(Optional) Number of the cache service to be removed. The number can be from 0 to 254.
web-cache
(Optional) Directs the router to remove statistics for the web cache service.
default
(Optional) Directs the router to remove statistics for the default routing table.
Usage Guidelines
Use the show wccp and show wccp detail commands to display WCCP statistics. If Cisco Cache Engines are used in your service group, the reverse proxy service is indicated by a value of 99.
Use the clear wccp command to clear the WCCP counters for all WCCP services in all VRFs.
default (tracking)
To set the default values for a tracked list, use the default command in tracking configuration mode. To disable the defaults, use the no form of this command.
default { delay | object object-number | threshold percentage }
no default { delay | object object-number | threshold percentage }
Command History
Release
Modification
12.3(8)T
This command was introduced.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
15.1(3)T
This command was modified. The valid range for the object-number argument increased to 1000.
15.1(1)S
This command was modified. The valid range for the object-number argument increased to 1000.
12.2(50)SY
This command was modified. The valid range for the object-number argument increased to 1000.
Usage Guidelines
As of Cisco IOS Release 15.1(3)T, 15.1(1)S and 12.2(50)SY, a maximum of 1000 objects can be tracked. Although 1000 tracked objects can be configured, each tracked object uses CPU resources. The amount of available CPU resources on a router is dependent upon variables such as traffic load and how other protocols are configured and run. The ability to use 1000 tracked objects is dependent upon the available CPU. Testing should be conducted on site to ensure that the service works under the specific site traffic conditions.
Examples
The following example shows how to configure a default threshold percentage:
Router(config)# track 3 list Router(config-track)# default threshold percentageRelated Commands
Command
Description
show track
Displays tracking information.
threshold weight
Specifies a threshold weight for a tracked list.
track list threshold percentage
Tracks a list of objects as to the up and down object states using a threshold percentage.
track list threshold weight
Tracks a list of objects as to the up and down object states using a threshold weight.
default-state
To set the default state for a stub object, use the default-state command in tracking configuration mode. To reset the default state to its internal default state, use the no form of this command.
Command History
Release
Modification
12.4(2)T
This command was introduced.
12.2(31)SB3
This command was integrated into Cisco IOS Release 12.2(31)SB3.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB.
Cisco IOS XE Release 2.1
This command was integrated into Cisco IOS XE Release 2.1.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI.
Cisco IOS XE 3.3SE
This command was implemented in Cisco IOS XE Release 3.3SE.
Usage Guidelines
Use the default-state command to set the default state of a stub object that has been created by the track stub command. The stub object can be tracked and manipulated by an external process, Embedded Event Manager (EEM).
EEM is a distributed, scalable, and customized approach to event detection and recovery offered directly in a Cisco IOS device. EEM offers the ability to monitor events and take informational or corrective action when the monitored events occur or when a threshold is reached. An EEM policy is an entity that defines an event and the actions to be taken when that event occurs.
delay (tracking)
To specify a period of time to delay communicating state changes of a tracked object, use the delay command in tracking configuration mode. To disable the delay period, use the no form of this command.
delay { up seconds | [ down seconds ] | up seconds | [ down seconds ] }
no delay { up seconds | [ down seconds ] | up seconds | [ down seconds ] }
Command History
Release
Modification
12.2(15)T
This command was introduced.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)B.
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.
Cisco IOS XE Release 2.1
This command was integrated into Cisco IOS XE Release 2.1.
15.3(3)M
This command was integrated into Cisco IOS Release 15.3(3)M.
Cisco IOS XE 3.3SE
This command was implemented in Cisco IOS XE Release 3.3SE.
Usage Guidelines
This command is available to all tracked objects.
If you specify, for example, delay up 10 down 30, then if the object state changes from down to up, clients tracking that object are notified after 10 seconds. If the object state changes from up to down, then clients tracking that object are notified after 30 seconds.
Examples
In the following example, the tracking process is tracking the IP-route threshold metric. The delay period to communicate the tracked object state changing to down is set to 30 seconds.
Router(config)# track 1 ip route 10.22.0.0/16 metric threshold Router(config-track)# threshold metric up 16 down 20 Router(config-track)# delay down 30forwarding-agent
To specify the port on which the forwarding agent will listen for wildcard and fixed affinities, use the forwarding-agent command in CASA-port configuration mode. To disable listening on that port, use the no form of this command.
Syntax Description
port-number
Port numbers on which the forwarding agent will listen for wildcards broadcast from the services manager. This must match the port number defined on the services manager.
password
(Optional) Text password used for generating the MD5 digest.
timeout
(Optional) Duration (in seconds) during which the Forwarding Agent will accept the new and old password. Valid range is from 0 to 3600 seconds. The default is 180 seconds.
Command Default
The default password timeout is 180 seconds.
The default port for the services manager is 1637.
Command History
Release
Modification
12.0(5)T
This command was introduced.
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.
