Table Of Contents
Cisco MWR 2941-DC Router RAN-O Command Reference
backup delay
backup peer
cdp enable
cem-group
class cem
clear gsm-abis
clear ip rtp header-compression
dejitter-buffer
gsm-abis congestion abate
gsm-abis congestion critical
gsm-abis congestion enable
gsm-abis congestion onset
gsm-abis jitter
gsm-abis local
gsm-abis lost-recovery
gsm-abis remote
gsm-abis retransmit
gsm-abis set dscp
idle-pattern
ima-group
interface atm ima
ip local interface
ip rtp header-compression
ip tcp header-compression
ipran-mib backhaul-notify-interval
ipran-mib location
ipran-mib snmp-access
ipran-mib threshold-acceptable
ipran-mib threshold-overloaded
ipran-mib threshold-warning
keepalive
load-interval
match ip dscp
mpls ip
network-clock-select hold_timeout
network-clock-select input-stratum4
network-clock-select mode
network-clock-select priority
payload-size
pseudowire-class
ptp announce
ptp clock-source
ptp clock-destination
ptp delay-req
ptp domain
ptp enable
ptp master
ptp mode
ptp priority1
ptp priority2
ptp slave
ptp sync interval
ptp sync limit
pw-pvc
recovered-clock slave
recovered-clock recovered
set network-clocks
show atm cell-packing
show cem circuit
show cem platform
show connection
show controller
show gsm-abis efficiency
show gsm-abis errors
show gsm-abis packets
show gsm-abis peering
show gsm-abis traffic
show interface switchport backup
show ip rtp header-compression
show mpls l2transport vc
show network-clocks
show platform hardware
show ptp clock
show ptp foreign-master-record
show ptp parent
show ptp port
show ptp time-property
show xconnect all
snmp-server enable traps ipran
snmp-server enable traps ipran alarm-gsm
snmp-server enable traps ipran util
switchport backup interface
xconnect
xconnect logging redundancy
Cisco MWR 2941-DC Router RAN-O Command Reference
This appendix contains an alphabetical listing of new and revised commands specific to the Cisco MWR 2941-DC router in a RAN-O solution.
•
backup delay
•
backup peer
•
cdp enable
•
cem-group
•
class cem
•
clear gsm-abis
•
clear ip rtp header-compression
•
dejitter-buffer
•
gsm-abis congestion abate
•
gsm-abis congestion critical
•
gsm-abis congestion enable
•
gsm-abis congestion onset
•
gsm-abis jitter
•
gsm-abis local
•
gsm-abis lost-recovery
•
gsm-abis remote
•
gsm-abis retransmit
•
gsm-abis set dscp
•
idle-pattern
•
ima-group
•
interface atm ima
•
ip local interface
•
ip rtp header-compression
•
ip tcp header-compression
•
ipran-mib backhaul-notify-interval
•
ipran-mib location
•
ipran-mib snmp-access
•
ipran-mib threshold-acceptable
•
ipran-mib threshold-overloaded
•
ipran-mib threshold-warning
•
keepalive
•
load-interval
•
match ip dscp
•
mpls ip
•
network-clock-select hold_timeout
•
network-clock-select input-stratum4
•
network-clock-select mode
•
network-clock-select priority
•
payload-size
•
pseudowire-class
•
ptp announce
•
ptp clock-source
•
ptp clock-destination
•
ptp delay-req
•
ptp domain
•
ptp enable
•
ptp master
•
ptp mode
•
ptp priority1
•
ptp priority2
•
ptp slave
•
ptp sync interval
•
ptp sync limit
•
pw-pvc
•
recovered-clock slave
•
recovered-clock recovered
•
set network-clocks
•
show atm cell-packing
•
show cem circuit
•
show cem platform
•
show connection
•
show controller
•
show gsm-abis efficiency
•
show gsm-abis errors
•
show gsm-abis packets
•
show gsm-abis peering
•
show gsm-abis traffic
•
show interface switchport backup
•
show ip rtp header-compression
•
show mpls l2transport vc
•
show network-clocks
•
show platform hardware
•
show ptp clock
•
show ptp foreign-master-record
•
show ptp parent
•
show ptp port
•
show ptp time-property
•
show xconnect all
•
snmp-server enable traps ipran
•
snmp-server enable traps ipran alarm-gsm
•
snmp-server enable traps ipran util
•
switchport backup interface
•
xconnect
•
xconnect logging redundancy
backup delay
To specify how long a backup pseudowire (PW) virtual circuit (VC) should wait before resuming operation after the primary PW VC goes down, use the backup delay command in interface configuration mode or xconnect configuration mode. To return to the default so that as soon as the primary fails, the secondary is immediately brought up without delay, use the no form of this command.
backup delay enable-delay {disable-delay | never}
no backup delay enable-delay {disable-delay | never}
Syntax Description
enable-delay
|
Number of seconds that elapse after the primary PW VC goes down before the Cisco IOS software activates the secondary PW VC. The range is 0 to 180. The default is 0.
|
disable-delay
|
Number of seconds that elapse after the primary PW VC comes up before the Cisco IOS software deactivates the secondary PW VC. The range is 0 to 180. The default is 0.
|
never
|
The secondary PW VC does not fall back to the primary PW VC if the primary PW VC becomes available again, unless the secondary PW VC fails.
|
Defaults
If a failover occurs, the xconnect redundancy algorithm immediately switches over or falls back to the backup or primary member in the redundancy group.
Command Modes
Interface configuration
Xconnect configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows a Multiprotocol Label Switching (MPLS) xconnect with one redundant peer. After a switchover to the secondary VC occurs, there is no fallback to the primary VC unless the secondary VC fails.
Router(config)# pseudowire-class mpls
Router(config-pw-class)# encapsulation mpls
Router(config-pw-class)# exit
Router(config)# interface atm1/0
Router(config-if)# xconnect 10.0.0.1 50 pw-class mpls
Router(config-if-xconn)# backup peer 10.0.0.2 50
Router(config-if-xconn)# backup delay 0 never
Router(config-if-xconn)# exit
The following example shows an MPLS xconnect with one redundant peer. The switchover does not begin unless the PW has been down for 3 seconds. After a switchover to the secondary VC occurs, there is no fallback to the primary until the primary VC has been reestablished and is up for 10 seconds.
Router(config)# pseudowire-class mpls
Router(config-pw-class)# encapsulation mpls
Router(config-pw-class)# exit
Router(config)# interface atm1/0
Router(config-if)# xconnect 10.0.0.1 50 pw-class mpls
Router(config-if-xconn)# backup peer 10.0.0.2 50
Router(config-if-xconn)# backup delay 3 10
Router(config-if-xconn)# exit
Related Commands
Command
|
Description
|
backup peer
|
Configures a redundant peer for a PW VC.
|
backup peer
To specify a redundant peer for a pseudowire (PW) virtual circuit (VC), use the backup peer command in interface configuration mode or xconnect configuration mode. To remove the redundant peer, use the no form of this command.
backup peer peer-router-ip-addr vcid [pw-class pw-class-name]
no backup peer peer-router-ip-addr vcid
Syntax Description
peer-router-ip- addr
|
IP address of the remote peer.
|
vcid
|
The 32-bit identifier of the VC between the routers at each end of the layer control channel.
|
pw-class
|
(Optional) PW type. If not specified, the PW type is inherited from the parent xconnect.
|
pw-class-name
|
(Optional) Name of the PW you created when you established the PW class.
|
Defaults
No redundant peer is established.
Command Modes
Interface configuration
Xconnect configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
The combination of the peer-router-ip-addr and vcid arguments must be unique on the router.
Examples
The following example shows an MPLS xconnect with one redundant peer:
Router(config)# pseudowire-class mpls
Router(config-pw-class)# encapsulation mpls
Router(config-pw-class)# exit
Router(config)# interface atm1/0
Router(config-if)# xconnect 10.0.0.1 100 pw-class mpls
Router(config-if-xconn)# backup peer 10.0.0.2 200
Router(config-if-xconn)# exit
The following example shows a backup peer configuration for an ATM interface:
Router(config)# pseudowire-class mpls
Router(config-pw-class)# encapsulation mpls
Router(config-pw-class)# exit
Router(config)# interface atm0/1
Router(config-if)# xconnect 10.0.0.2 1 pw-class mpls
Router(config-if-xconn)# backup peer 10.0.0.2 100 pw-class mpls
Router(config-if-xconn)# exit
Related Commands
Command
|
Description
|
backup delay
|
Specifies how long the backup PW VC should wait before resuming operation after the primary PW VC goes down.
|
cdp enable
To enable Cisco Discovery Protocol (CDP) on an interface, use the cdp enable command in interface configuration mode. To disable CDP on an interface, use the no form of this command.
cdp enable
no cdp enable
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled at the global level and on all supported interfaces.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
CDP is enabled by default at the global level and on each supported interface in order to send or receive CDP information. However, some interfaces, such as ATM interfaces, do not support CDP.
Note
The cdp enable, cdp timer, and cdp run commands affect the operation of the IP on demand routing feature (that is, the router odr global configuration command). For more information on the router odr command, see the "On-Demand Routing Commands" chapter in the Cisco IOS Command Reference, Volume 2 of 3: Routing Protocols document.
Examples
In the following example, CDP is disabled on the Ethernet 0 interface only:
Sending CDP packets every 60 seconds
Sending a holdtime value of 180 seconds
Sending CDPv2 advertisements is enabled
Router(config)# interface ethernet 0
Router(config-if)# no cdp enable
Related Commands
Command
|
Description
|
cdp run
|
Reenables CDP on a Cisco device.
|
cdp timer
|
Specifies how often the Cisco IOS software sends CDP updates.
|
router odr
|
Enables on-demand routing on a hub router.
|
cem-group
To create a circuit emulation (CEM) channel from one or more time slots of a T1 or E1 line, use the cem-group command in controller configuration mode. To remove a CEM group and release the associated time slots, use the no form of this command.
cem-group group-number {unframed | timeslots time-slot-range}
no cem-group group-number
Syntax Description
group-number
|
CEM identifier to be used for this group of time slots:
• For T1 ports, the range is from 0 to 23.
• For E1 ports, the range is from 0 to 30.
|
unframed
|
Specifies that a single CEM channel is being created, including all time slots, without specifying the framing structure of the line.
|
timeslots
|
Specifies that a list of time slots is to be used as specified by the time-slot-range argument.
time-slot-range—Specifies the time slots to be included in the CEM channel. The list of time slots may include commas and hyphens with no spaces between the numbers.
|
Defaults
No CEM groups are defined.
Command Modes
Controller configuration
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was incorporated.
|
Usage Guidelines
Use this command to create CEM channels on the T1 or E1 port.
Examples
The following example shows how to create a CEM channel:
SATOP
Router(config)# controller el 0/0
Router(config-controller)# cem-group 0 unframed
Router(config-controller)# exit
Router(config)# interface cem 0/0
Router(config-if-cem)# xconnect 10.10.10.10 200 encapsulation mpls
Router(config-if-cem-xconn)# exit
Router(config-if-cem)# exit
CESoPSN
Router(config)# controller el 0/1
Router(config-controller)# cem-group 0 timeslots 1-31
Router(config-controller)# exit
Router(config)# interface cem 0/1
Router(config-if-cem)# xconnect 10.10.10.10 200 encapsulation mpls
Router(config-if-cem-xconn)# exit
Router(config-if-cem)# exit
Related Commands
Command
|
Description
|
cem
|
Enters circuit emulation configuration mode.
|
class cem
To configure CEM interface parameters in a class that is applied to CEM interfaces together, use the class cem command in global configuration mode. This command works in the same manner for CEM interfaces as the pseudowire-class command does for xconnect.
class cem class-name
Syntax Description
class-name
|
The name of a CEM interface parameters class.
|
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was incorporated.
|
Usage Guidelines
The class cem command allows you to configure CEM interface parameters in a class that is applied to CEM interfaces together. A class cem command includes the following configuration settings:
•
dejitter-buffer dejitter-in-ms
•
idle-pattern 8-bit-idle-pattern
•
payload-size payload-size-in-ms
Note
You can improve the performance of packet reordering on TDM/PWE connections by using the increasing the size of the dejitter buffer using the dejitter-buffer parameter.
Examples
The following example shows how to configure CEM interface parameters:
Router(config)# class cem mycemclass
Router(config-cem-class)# dejitter-buffer 10
Router(config-cem-class)# sample-rate 32
Router(config-cem-class)# exit
Router(config)# interface cem 0/0
Router(config-if)# no ip address
Router(config-if-cem)# xconnect 10.10.10.10 200 encapsulation mpls
Router(config-if-cem-xconn)# cem class mycemclass
Router(config-if-cem)# exit
Related Commands
Command
|
Description
|
dejitter-buffer
|
Specifies the size of the dejitter buffer used for network jitter in CEM configuration mode.
|
idle-pattern
|
Specifies the data pattern to transmit on the T1/E1 line when missing packets are detected on the PWE3 circuit in CEM configuration mode.
|
sample-rate
|
Specifies in milliseconds the rate hardware samples the data on the attached circuit in CEM circuit configuration mode.
|
cem
|
Enters circuit emulation configuration mode.
|
clear gsm-abis
To clear the statistics displayed by the show gsm-abis commands, use the clear gsm-abis command in privileged EXEC mode.
clear gsm-abis [serial serial-number interface-number]
Syntax Description
serial
|
|
serial-number
|
(Optional) The serial number range is from 0 to 6.
|
interface-number
|
(Optional) The interface number range is from 0 to 6.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to clear statistics:
Router# clear gsm-abis serial 0/0:0
Related Commands
Command
|
Description
|
show gsm-abis efficiency
|
Displays the history of GSM compression/decompression efficiency averages at intervals of 1 second, 5 seconds, 1 minute, 5 minutes, and 1 hour.
|
show gsm-abis errors
|
Displays error statistics counters.
|
show gsm-abis packets
|
Displays packet statistics counters.
|
show gsm-abis peering [details]
|
Displays peering status, statistics, and history.
|
clear ip rtp header-compression
To clear Real-Time Transport Protocol (RTP) header compression structures and statistics, use the clear ip rtp header-compression privileged EXEC command.
clear ip rtp header-compression [type number]
Syntax Description
type number
|
(Optional) Interface type and number.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
If this command is used without an interface type and number, the command clears all RTP header compression structures and statistics.
Examples
The following example clears the RTP header compression structures and statistics for multilink interface 1:
Router# clear ip rtp header-compression multilink1
Related Commands
Command
|
Description
|
ip rtp header-compression
|
Enables RTP header compression.
|
dejitter-buffer
To configure the size of the dejitter buffer, use the dejitter-buffer command in CEM configuration mode. To restore the dejitter buffer to its default size, use the no form of this command.
dejitter-buffer size
no dejitter-buffer
Syntax Description
size
|
Specifies the size of the dejitter buffer in milliseconds. The range is 4 to 500 ms; the default is 4 ms.
|
Defaults
The default dejitter-buffer size is 4 milliseconds.
Command Modes
CEM configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to specify the size of the dejitter buffer:
Router(config)# interface cem 0/0
Router(config-if)# no ip address
Router(config-if-cem)# dejitter-buffer 10
Router(config-if-cem)# xconnect 10.10.10.10 200 encapsulation mpls
Router(config-if-cem-xconn)# exit
Router(config-if-cem)# exit
Related Commands
Command
|
Description
|
cem
|
Enters circuit emulation configuration mode.
|
cem class
|
Applies the CEM interface parameters defined in the given CEM class name to the circuit.
|
class cem
|
Configures CEM interface parameters in a class that's applied to CEM interfaces together in global configuration mode.
|
gsm-abis congestion abate
To set the congestion abatement detection level at which the remote router stops suppressing time slots because congestion has been alleviated, use the gsm-abis congestion abate interface configuration command. The abatement detection level is defined as x milliseconds of continuous congestion abatement (that is, no congestion indications).
gsm-abis congestion abate ms
Syntax Description
ms
|
Sets the number of milliseconds for the abatement detection level.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the abatement detection level to 250 ms:
Router(config)# interface Serial10/2:0
Router(config-if)# no ip address
Router(config-if)# encapsulation gsm-abis
Router(config-if)# load-interval 30
Router(config-if)# gsm-abis local 10.10.10.2 6661
Router(config-if)# gsm-abis remote 10.10.10.1 5553
Router(config-if)# gsm-abis congestion enable
Router(config-if)# gsm-abis congestion abate 250
Router(config-if)# no keepalive
Related Commands
Command
|
Description
|
gsm-abis congestion critical
|
Defines the critical time slots that are exempt from suppression during congestion onset.
|
gsm-abis congestion enable
|
Sets the congestion detection algorithm to monitor the transmit jitter buffer and to send congestion indicator signals to the remote router when congestion is detected.
|
gsm-abis congestion onset
|
Sets the congestion onset detection level at which the remote router starts suppressing all time slots that are not defined as critical in an effort to alleviate congestion.
|
gsm-abis jitter
|
Sets the amount of transmit jitter delay for the GSM-Abis interface.
|
gsm-abis local
|
Configures the local parameters for an IP/UDP backhaul connection.
|
gsm-abis remote
|
Configures the remote parameters for an IP/UDP backhaul connection.
|
gsm-abis congestion critical
To define the critical time slots that are exempt from suppression during congestion onset, use the gsm-abis congestion critical interface configuration command. These time slots contain signaling and control information exchanged between the BSC and BTS.
gsm-abis congestion critical time-slot-range
Syntax Description
time-slot-range
|
Specifies a value or range of values for time slots that are exempt from suppression during congestion onset. Use a hyphen to indicate a range.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the time-slot range:
Router(config)# interface Serial10/2:0
Router(config-if)# no ip address
Router(config-if)# encapsulation gsm-abis
Router(config-if)# load-interval 30
Router(config-if)# gsm-abis local 10.10.10.2 6661
Router(config-if)# gsm-abis remote 10.10.10.1 5553
Router(config-if)# gsm-abis congestion enable
Router(config-if)# gsm-abis congestion critical 2-3
Router(config-if)# no keepalive
Related Commands
Command
|
Description
|
gsm-abis congestion abate
|
Sets the congestion abatement detection level at which the remote router stops suppressing time slots because congestion has been alleviated.
|
gsm-abis congestion enable
|
Sets the congestion detection algorithm to monitor the transmit jitter buffer and to send congestion indicator signals to the remote router when congestion is detected.
|
gsm-abis congestion onset
|
Sets the congestion onset detection level at which the remote router starts suppressing all time slots that are not defined as critical in an effort to alleviate congestion.
|
gsm-abis jitter
|
Sets the amount of transmit jitter delay for the GSM-Abis interface.
|
gsm-abis local
|
Configures the local parameters for an IP/UDP backhaul connection.
|
gsm-abis remote
|
Configures the remote parameters for an IP/UDP backhaul connection.
|
gsm-abis congestion enable
To enable the congestion detection algorithm, use the gsm-abis congestion enable interface configuration command. The congestion detection algorithm monitors the transmit jitter buffer and sends congestion indicator signals to the remote when congestion is detected. The remote router suppresses all time slots that are not defined as critical in an effort to alleviate congestion. The goal of the congestion detection algorithm is to save the critical time slots from loss of data.
gsm-abis congestion enable
Syntax Description
This command has no arguments or keywords.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to enable the congestion detection algorithm:
Router(config)# interface Serial10/2:0
Router(config-if)# no ip address
Router(config-if)# encapsulation gsm-abis
Router(config-if)# load-interval 30
Router(config-if)# gsm-abis local 10.10.10.2 6661
Router(config-if)# gsm-abis remote 10.10.10.1 5553
Router(config-if)# gsm-abis congestion enable
Router(config-if)# no keepalive
Related Commands
Command
|
Description
|
gsm-abis congestion abate
|
Sets the congestion abatement detection level at which the remote router stops suppressing time slots because congestion has been alleviated.
|
gsm-abis congestion critical
|
Defines the critical time slots that are exempt from suppression during congestion onset.
|
gsm-abis congestion onset
|
Sets the congestion onset detection level at which the remote router starts suppressing all time slots that are not defined as critical in an effort to alleviate congestion.
|
gsm-abis jitter
|
Sets the amount of transmit jitter delay for the GSM-Abis interface.
|
gsm-abis local
|
Configures the local parameters for an IP/UDP backhaul connection.
|
gsm-abis remote
|
Configures the remote parameters for an IP/UDP backhaul connection.
|
gsm-abis congestion onset
To set the congestion onset detection level at which the remote router starts suppressing all time slots that are not defined as critical in an effort to alleviate congestion, use the gsm-abis congestion onset interface configuration command. The onset detection level is defined as x milliseconds of continuous congestion detected.
gsm-abis congestion onset ms
Syntax Description
ms
|
Sets the number of milliseconds for the onset detection level.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the onset detection level at 50 ms:
Router(config)# interface Serial10/2:0
Router(config-if)# no ip address
Router(config-if)# encapsulation gsm-abis
Router(config-if)# load-interval 30
Router(config-if)# gsm-abis local 10.10.10.2 6661
Router(config-if)# gsm-abis remote 10.10.10.1 5553
Router(config-if)# gsm-abis congestion enable
Router(config-if)# gsm-abis congestion onset 100
Router(config-if)# no keepalive
Related Commands
Command
|
Description
|
gsm-abis congestion abate
|
Sets the congestion abatement detection level at which the remote router stops suppressing time slots because congestion has been alleviated.
|
gsm-abis congestion critical
|
Defines the critical time slots that are exempt from suppression during congestion onset.
|
gsm-abis congestion enable
|
Sets the congestion detection algorithm to monitor the transmit jitter buffer and to send congestion indicator signals to the remote router when congestion is detected.
|
gsm-abis jitter
|
Sets the amount of transmit jitter delay for the GSM-Abis interface.
|
gsm-abis local
|
Configures the local parameters for an IP/UDP backhaul connection.
|
gsm-abis remote
|
Configures the remote parameters for an IP/UDP backhaul connection.
|
gsm-abis jitter
To set the amount of transmit jitter delay for the GSM-Abis interface, use the gsm-abis jitter interface configuration command. If the transmit jitter is set to 4 ms, data received on the backhaul with a time equal to 0 ms will be stored in the jitter buffer and transmitted with a time equal to 4 ms. The transmit jitter buffer allows some amount of jitter in the arrival of data on the backhaul to be tolerated without introducing errors into the stream of data.
gsm-abis jitter ms
Syntax Description
ms
|
Sets the number of milliseconds for the jitter. The default value is 4 ms. Valid values are 4-500 ms.
|
Defaults
The default jitter value is 4 ms.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the jitter level to 8 ms:
Router(config)# interface Serial10/2:0
Router(config-if)# no ip address
Router(config-if)# encapsulation gsm-abis
Router(config-if)# load-interval 30
Router(config-if)# gsm-abis local 10.10.10.2 6661
Router(config-if)# gsm-abis remote 10.10.10.1 5553
Router(config-if)# gsm-abis jitter 8
Router(config-if)# no keepalive
Related Commands
Command
|
Description
|
gsm-abis congestion abate
|
Sets the congestion abatement detection level at which the remote router stops suppressing time slots because congestion has been alleviated.
|
gsm-abis congestion critical
|
Defines the critical time slots that are exempt from suppression during congestion onset.
|
gsm-abis congestion enable
|
Sets the congestion detection algorithm to monitor the transmit jitter buffer and to send congestion indicator signals to the remote router when congestion is detected.
|
gsm-abis congestion onset
|
Sets the congestion onset detection level at which the remote router starts suppressing all time slots that are not defined as critical in an effort to alleviate congestion.
|
gsm-abis local
|
Configures the local parameters for an IP/UDP backhaul connection.
|
gsm-abis remote
|
Configures the remote parameters for an IP/UDP backhaul connection.
|
gsm-abis local
To configure the local parameters required to establish an Internet Protocol/User Data Protocol (IP/UDP) backhaul connection, use the gsm-abis local interface configuration command.
gsm-abis local [ip-address] [port]
Syntax Description
ip-address
|
(Optional) The IP address for the entry you want to establish.
|
port
|
(Optional) The port you want to use for the entry you want to establish.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to configure the local parameters:
Router(config)# interface Serial10/2.0
Router(config-if)# encapsulation gsm-abis
Router(config-if)# gsm-abis local 10.10.10.2 5502
Related Commands
Command
|
Description
|
gsm-abis remote
|
Configures the remote parameters for an IP/UDP backhaul connection.
|
gsm-abis lost-recovery
This command allows you to control the speed at which the router retransmits subrate data for lost packets. This method of retransmission prevents large retransmission packets from delaying subsequent backhaul packets.
To set the retransmission rate for subrate data for the lost packets, use the gsm-abis lost-recovery configuration command.
gsm-abis lost-recovery milliseconds
Syntax Description
milliseconds
|
The retransmission rate for subrate data, in milliseconds. Range is 0-5000.
Note Any value under 40 causes the router to send all subrates at once when lost packet is indicated, effectively disabling the feature.
|
Defaults
The default setting is gsm-abis lost-recovery 1250.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to configure the remote parameters:
Router(config)# interface Serial10/2.0
Router(config-if)# encapsulation gsm-abis
Router(config-if)# gsm-abis remote 10.10.10.1 5504
Router(config)# gsm-abis lost-recovery 1250
Related Commands
Command
|
Description
|
gsm-abis retransmit
|
Enables retransmission of a repetitive subrate sample.
|
gsm-abis remote
To configure the remote parameters required to establish an Internet Protocol/User Data Protocol (IP/UDP) backhaul connection, use the gsm-abis remote interface configuration command.
gsm-abis remote [ip-address] [port]
Syntax Description
ip-address
|
(Optional) The IP address for the entry you want to establish.
|
port
|
(Optional) The port you want to use for the entry you want to establish.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to configure the remote parameters:
Router(config)# interface Serial10/2.0
Router(config-if)# encapsulation gsm-abis
Router(config-if)# gsm-abis remote 10.10.10.1 5504
Related Commands
Command
|
Description
|
gsm-abis local
|
Configures the local parameters for an IP/UDP backhaul connection.
|
gsm-abis retransmit
To enable retransmission of a repetitive subrate sample, use the gsm-abis retransmit interface configuration command. This command is useful when the latency introduced by the characteristics of the backhaul network is excessive. Examples of excessive latency include the use of satellite transmission facilities or multiple router hops on the backhaul network.
gsm-abis retransmit sample-delay
Syntax Description
sample-delay
|
The number of duplicate samples that must be observed before the duplicate sample is retransmitted. The delay range is 5 to 255 or 100 to 5100 ms at 20-ms intervals.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set a retransmit delay of 100 ms:
Router(config)# interface Serial10/2.0
Router(config-if)# encapsulation gsm-abis
Router(config-if)# gsm-abis local 10.10.10.1 5504
Router(config-if)# gsm-abis remote 10.10.10.2 5504
Router(config-if)# gsm-abis retransmit 5
Related Commands
Command
|
Description
|
gsm-abis local
|
Configures the local parameters for an IP/UDP backhaul connection.
|
gsm-abis remote
|
Configures the remote parameters for an IP/UDP backhaul connection.
|
show gsm-abis packet
|
Displays packet statistics counters of the GSM compression/decompression.
|
show gsm-abis packet | include retransmit
|
Displays packet statistics counters of the GSM compression/decompression to include the repetitive subrate samples retransmitted.
|
gsm-abis set dscp
To mark a packet by setting the differential services code point (DSCP) for GSM-Abis, use the gsm-abis set dscp interface configuration command.
gsm-abis set dscp value
Note
Use this command when configuring GSM shorthaul interfaces.
Syntax Description
value
|
A number from 0 to 63 that sets the GSM-Abis DSCP value.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to mark a packet:
Router(config)# interface Serial10/2.0
Router(config-if)# encapsulation gsm-abis
Router(config-if)# gsm-abis local 10.10.10.1 5504
Router(config-if)# gsm-abis remote 10.10.10.2 5504
Router(config-if)# gsm-abis set dscp cs2
idle-pattern
To specify the data pattern transmitted on the T1/E1 line when missing packets are detected on the PWE3 circuit, use the idle-pattern command in CEM configuration mode. To stop sending idle pattern data, use the no form of this command.
idle-pattern [pattern]
no idle-pattern
Syntax Description
pattern
|
(Optional) An 8-bit hexadecimal number that is transmitted as the idle pattern. T1 and E1 channels require only this argument.
|
Defaults
For T1 or E1 channels, the default idle pattern is 0xFF.
Command Modes
CEM circuit configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
The idle-pattern data is sent to replace the data from missing packets.
Examples
The following example shows how to specify a data pattern:
Router(config)# interface cem 0/0
Router(config-if)# no ip address
Router(config-if-cem)# idle-pattern 0x55
Router(config-if-cem)# xconnect 10.10.10.10 200 encapsulation mpls
Router(config-if-cem-xconn)# exit
Router(config-if-cem)# exit
Related Commands
Command
|
Description
|
cem
|
Enters circuit emulation configuration mode.
|
cem class
|
Applies the CEM interface parameters defined in the given CEM class name to the circuit.
|
class cem
|
Configures CEM interface parameters in a class that's applied to CEM interfaces together in global configuration mode.
|
ima-group
To define physical links as inverse multiplexing over ATM (IMA) group members, use the ima-group command in interface configuration mode. When you first perform the configuration or when you change the group number, the interface is automatically disabled, moved to the new group, and then enabled. To remove the group, use the no form of this command.
ima-group group-number
no ima-group group-number
Syntax Description
group-number
|
Specifies an IMA group number from 0 to 3. IMA groups can span multiple ports on a port adapter or shared port adapter (SPA) but cannot span port adapters or SPAs.
|
Defaults
No IMA groups are defined.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
Use the ima-group interface command to configure a T1/E1 IMA port adapter interface as part of an IMA group.
Examples
The following example shows how to define an IMA group:
Router(config)# interface ATM0/0
Router(config-if)# no ip address
Router(config-if)# no atm ilmi-keepalive
Router(config-if)# ima-group 0
Related Commands
Command
|
Description
|
interface atm
|
Configures an ATM interface.
|
interface atm ima
|
Configures an ATM IMA group.
|
show ima interface atm
|
Provides information about all configured IMA groups or a specific IMA group.
|
interface atm ima
To configure an ATM IMA group and enter interface configuration mode, use the interface atm ima global configuration command. If the group does not exist when the command is issued, the command automatically creates the group.
interface atm slot/imagroup-number
Syntax Description
slot
|
Specifies the slot location of the ATM IMA port adapter.
|
group-number
|
Specifies an IMA group number from 0 to 3. You can create up to four groups.
|
Defaults
The interface includes individual ATM links, but no IMA groups.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
When a port is configured for IMA functionality, it no longer operates as an individual ATM link. Specifying ATM links as members of a group using the ima-group interface command does not enable the group. You must use the interface atm slot/imagroup-number command to create the group.
Examples
The following example shows the how to create the IMA group:
Router(config)# interface ATM0/IMA0
Router(config-if)# no ip address
Related Commands
Command
|
Description
|
ima-group
|
Configures the physical links as IMA group members; execute this interface configuration command for each physical link that you include in an IMA group.
|
ima group-id
|
Enables the user to configure the IMA Group ID for the IMA interface.
|
interface atm
|
Configures physical links for an ATM interface.
|
show ima interface atm
|
Displays general and detailed information about IMA groups and the links they include.
|
ip local interface
To configure the IP address of the provider edge (PE) router interface to be used as the source IP address for sending tunneled packets, use the ip local interface command in pseudowire-class configuration mode. To remove the IP address, use the no form of this command.
ip local interface interface-name
no ip local interface interface-name
Syntax Description
interface-name
|
Name of the PE interface whose IP address is used as the source IP address for sending tunneled packets over a Layer 2 PW.
|
Defaults
No IP address is configured.
Command Modes
Pseudowire-class configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
Use the same local interface name for all pseudowire-classes configured between a pair of PE routers. It is highly recommended that you configure a loopback interface with this command. If you do not, the router chooses the "best available local address," which could be any IP address configured on a core-facing interface. This configuration could prevent a control channel from being established.
Examples
The following example shows how to configure the IP address of the local loopback 0 as the source IP address for sending packets through an MPLS session:
Router(config)# pseudowire-class mpls
Router(config-pw-class)# ip local interface loopback 0
Router(config-pw-class)# exit
Related Commands
Command
|
Description
|
ima-group
|
Configures the physical links as IMA group members, which executes the interface configuration command for each physical link included in an IMA group.
|
ima group-id
|
Enables the user to configure the IMA Group ID for the IMA interface.
|
interface atm
|
Configures physical links for an ATM interface.
|
show ima interface atm
|
Displays general and detailed information about IMA groups and the links they include.
|
ip rtp header-compression
To enable Real-Time Transport Protocol (RTP) header compression, use the ip rtp header-compression command in interface configuration mode. To disable RTP header compression, use the no form of this command.
ip rtp header-compression [passive | iphc-format | ietf-format] [periodic-refresh]
no ip rtp header-compression [passive | iphc-format | ietf-format] [periodic-refresh]
Syntax Description
passive
|
(Optional) Compresses outgoing RTP packets only if incoming RTP packets on the same interface are compressed. If you do not specify the passive keyword, all RTP packets are compressed.
|
iphc-format
|
(Optional) Indicates that the IP Header Compression (IPHC) format of header compression will be used.
|
ietf-format
|
(Optional) Indicates that the Internet Engineering Task Force (IETF) format of header compression will be used.
|
periodic-refresh
|
(Optional) Indicates that the compressed IP header will be refreshed periodically.
|
Defaults
Disabled.
For PPP interfaces, the default format for header compression is the IPHC format.
For High-Level Data Link Control (HDLC) and Frame Relay interfaces, the default format for header compression is the original proprietary Cisco format. The maximum number of compression connections for the proprietary Cisco format is 256.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
You can compress IP/User Datagram Protocol (UDP)/RTP headers to reduce the size of your packets. Compressing headers is especially useful for RTP because RTP payload size can be as small as 20 bytes, and the uncompressed header is 40 bytes.
passive Keyword
By default, the ip rtp header-compression command compresses outgoing RTP traffic. If you specify the passive keyword, outgoing RTP traffic is compressed only if incoming RTP traffic on the same interface is compressed. If you do not specify the passive keyword, all outgoing RTP traffic is compressed.
The passive keyword is ignored on PPP interfaces. PPP interfaces negotiate the use of header compression, regardless of whether the passive keyword is specified. Therefore, on PPP interfaces, the passive keyword is replaced by the IPHC format, the default format for PPP interfaces.
iphc-format Keyword
The iphc-format keyword indicates that the IPHC format of header compression that will be used. For PPP and HDLC interfaces, when the iphc-format keyword is specified, TCP header compression is also enabled. For this reason, the ip tcp header-compression command appears in the output of the show running-config command. Because both RTP header compression and TCP header compression are enabled, both UDP packets and TCP packets are compressed.
The iphc-format keyword includes checking whether the destination port number is even and is in the ranges of 16,385 to 32,767 (for Cisco audio) or 49,152 to 65,535 (for Cisco video). Valid RTP packets that meet the criteria (that is, the port number is even and is within the specified range) are compressed using the compressed RTP packet format. Otherwise, packets are compressed using the less-efficient compressed non-TCP packet format.
The iphc-format keyword is not available for interfaces that use Frame Relay encapsulation.
Note
The header compression format (in this case, IPHC) must be the same at both ends of the network. That is, if you specify the iphc-format keyword on the local router, you must also specify the iphc-format keyword on the remote router.
ietf-format Keyword
The ietf-format keyword indicates that the IETF format of header compression will be used. For HDLC interfaces, the ietf-format keyword compresses only UDP packets. For PPP interfaces, when the ietf-format keyword is specified, TCP header compression is also enabled. For this reason, the ip tcp header-compression command appears in the output of the show running-config command. Because both RTP header compression and TCP header compression are enabled, both UDP packets and TCP packets are compressed.
With the ietf-format keyword, any even destination port number higher than 1024 can be used. Valid RTP packets that meet the criteria (that is, the port number is even and is higher than 1024) are compressed using the compressed RTP packet format. Otherwise, packets are compressed using the less-efficient compressed non-TCP packet format.
The ietf-format keyword is not available for interfaces that use Frame Relay encapsulation.
Note
The header compression format (in this case, IETF) must be the same at both ends of the network. That is, if you specify the ietf-format keyword on the local router, you must also specify the ietf-format keyword on the remote router.
Support for Serial Lines
RTP header compression is supported on serial lines using Frame Relay, HDLC, or PPP encapsulation. You must enable compression on both ends of a serial connection.
Unicast or Multicast RTP Packets
This command can compress unicast or multicast RTP packets; consequently, multicast backbone (MBONE) traffic can also be compressed over slow links. The compression scheme is beneficial only when you have small payload sizes, as in audio traffic.
Examples
The following example enables RTP header compression on the Serial1/0 interface and limits the number of RTP header compression connections to 10. In this example, the optional iphc-format keyword of the ip rtp header-compression command is specified.
Router# configure terminal
Router(config)# interface Serial1/0
Router(config-if)# encapsulation ppp
Router(config-if)# ip rtp header-compression iphc-format
Router(config-if)# ip rtp compression-connections 10
The following example enables RTP header compression on the Serial1/0 interface and limits the number of RTP header compression connections to 20. In this example, the optional iphc-format keyword of the ip rtp header-compression command is specified.
Router# configure terminal
Router(config)# interface Serial1/0
Router(config-if)# encapsulation ppp
Router(config-if)# ip rtp header-compression iphc-format
Router(config-if)# ip rtp compression-connections 20
In the following example, RTP header compression is enabled on the Serial1/0 interface and the optional periodic-refresh keyword of the ip rtp header-compression command is specified:
Router# configure terminal
Router(config)# interface Serial1/0
Router(config-if)# encapsulation ppp
Router(config-if)# ip rtp header-compression iphc-format periodic-refresh
Router(config-if)# ip rtp compression-connections 10
Related Commands
Command
|
Description
|
clear ip rtp header-compression
|
Clears RTP header compression structures and statistics.
|
iprtp compression-connections
|
Specifies the total number of RTP header compression connections that can exist on an interface.
|
show ip rtp header-compression
|
Displays RTP header compression statistics.
|
show running-config
|
Displays the contents of the currently running configuration file or the configuration for a specific interface, or map class information.
|
ip tcp header-compression
To enable Transmission Control Protocol (TCP) header compression, use the ip tcp header-compression command in interface configuration mode. To disable compression, use the no form of this command.
ip tcp header-compression [passive] [iphc-format] [ietf-format]
no ip tcp header-compression [passive] [iphc-format] [ietf-format]
Syntax Description
passive
|
(Optional) Compresses outgoing TCP packets only if incoming TCP packets on the same interface are compressed. If you do not specify the passive keyword, all TCP packets are compressed.
|
iphc-format
|
(Optional) Indicates that the IP Header Compression (IPHC) format of header compression will be used.
|
ietf-format
|
(Optional) Indicates that the Internet Engineering Task Force (IETF) format of header compression will be used.
|
Defaults
Disabled.
For PPP interfaces, the default format for header compression is the IPHC format.
For High-Level Data Link Control (HDLC) and Frame Relay interfaces, the default format is as described in RFC 1144, Compressing TCP/IP Headers for Low-Speed Serial Links.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
You can compress the headers of your TCP/IP packets in order to reduce the size of your packets. TCP header compression is supported on serial lines using Frame Relay, HDLC, or PPP encapsulation. You must enable compression on both ends of a serial connection. Compressing the TCP header can speed up Telnet connections dramatically.
In general, TCP header compression is advantageous when your traffic consists of many small packets, not for traffic that consists of large packets. Transaction processing (usually using terminals) tends to use small packets and file transfers use large packets. This feature only compresses the TCP header, so it has no effect on User Datagram Protocol (UDP) packets or other headers.
passive Keyword
By default, the ip tcp header-compression command compresses outgoing TCP traffic. This command includes an optional passive keyword. If you specify the passive keyword, outgoing TCP traffic is compressed only if incoming TCP traffic on the same interface is compressed. If you do not specify the passive keyword, all TCP traffic is compressed.
For PPP interfaces, the passive keyword is ignored. PPP interfaces negotiate the use of header compression, regardless of whether the passive keyword is specified. Therefore, on PPP interfaces, the passive keyword is replaced by the IPHC format, the default format for PPP interfaces.
iphc-format Keyword
This command includes the iphc-format keyword. The iphc-format keyword indicates the type of header compression that will be used. For PPP and HDLC interfaces, when the iphc-format keyword is specified, Real-Time Protocol (RTP) header compression is also enabled. For this reason, the ip rtp header-compression command appears in the output of the show running-config command. Because both TCP and RTP header compression are enabled, both TCP and UDP packets are compressed.
Note
For Frame Relay interfaces, the iphc-format keyword is not available.
ietf-format Keyword
This command includes the ietf-format keyword. The ietf-format keyword indicates the type of header compression that will be used. For HDLC interfaces, the ietf-format keyword compresses only TCP packets. For PPP interfaces, when the ietf-format keyword is specified, RTP header compression is also enabled. For this reason, the ip rtp header-compression command appears in the output of the show running-config command. Because both TCP and RTP header compression are enabled, both TCP and UDP packets are compressed.
Note
For Frame Relay interfaces, the ietf-format keyword is not available.
Examples
The following example sets the first serial interface for header compression with a maximum of 10 cache entries:
Router(config)# interface serial 0
Router(config-if)# ip tcp header-compression
Router(config-if)# ip tcp compression-connections 10
The following example enables RTP header compression on the Serial1/0.0 subinterface and limits the number of RTP header compression connections to 10. In this example, the optional iphc-format keyword of the ip tcp header-compression command is specified.
Router(config)# interface serial1/0.0
Router(config-if)# encapsulation ppp
Router(config-if)# ip tcp header-compression iphc-format
Router(config-if)# ip tcp compression-connections 10
The following example enables RTP header compression on the Seria1/0.0 subinterface and limits the number of RTP header compression connections to 20. In this example, the optional ietf-format keyword of the ip tcp header-compression command is specified.
Router(config)# interface serial1/0.0
Router(config-if)# ip tcp header-compression ietf-format
Router(config-if)# ip tcp compression-connections 20
Related Commands
Command
|
Description
|
ip tcp compression-connections
|
Specifies the total number of TCP header compression connections that can exist on an interface.
|
show ip tcp header-compression
|
Displays TCP header compression statistics.
|
show running-config
|
Displays the contents of the currently running configuration file or the configuration for a specific interface, or map class information.
|
ipran-mib backhaul-notify-interval
To specify the interval used to suppress the generation of the ciscoIpRanBackHaulRcvdUtil and the ciscoIpRanBackHaulSentUtil notifications from the CISCO-IP-RAN-BACKHAUL-MIB, use the ipran-mib backhaul-notify-interval command in global configuration mode. To remove the interval, use the no form of the command.
ipran-mib backhaul-notify-interval interval
no ipran-mib backhaul-notify-interval interval
Notifications are suppressed for the number of seconds specified. Notifications are not suppressed when this keyword is set to zero. The minimum interval is 1 minute and the maximum is 15 minutes. When suppression is enabled, notifications are generated when a worse state is encountered. For example, the following transitions generate notifications:
•
"acceptable" to "warning"
•
"warning" to "overloaded"
Later transitions to lesser states are suppressed. For example, the following transitions do not generate notifications:
•
"warning" to "acceptable"
•
"overloaded" to "warning"
•
"overloaded" to "acceptable"
At the end of the specified interval, a notification is generated if the current state is different from the state reported by the last notification.
Syntax Description
interval
|
60 to 900 seconds, or 0 (zero).
|
Defaults
The default interval is 0 (notifications are not suppressed).
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the notification-suppression interval:
Router(config)# ipran-mib backhaul-notify-interval 60
Router(config)# ipran-mib backhaul-notify-interval 900
Router(config)# no ipran-mib backhaul-notify-interval
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ipran-mib threshold-acceptable
|
Specifies the acceptable level of traffic.
|
ipran-mib threshold-overloaded
|
Specifies the amount of traffic that indicates the backhaul is overloaded.
|
ipran-mib threshold-warning
|
Specifies the amount of traffic that indicates the backhaul is carrying traffic sufficient to impact performance, but is not overloaded.
|
ipran-mib location
To define the location of the device, use the ipran-mib location command in global configuration mode. The command is also used to assist the network management system in properly displaying the topology of the system.
ipran-mib location {addSite | cellSite | undefined}
Syntax Description
addSite
|
Locates the device at a BSC or RNC site.
|
cellSite
|
Locates the device at a BTS or Node B site.
|
undefined
|
Specifies an undefined location for the device.
|
Defaults
The default location is cellSite.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to define the device location:
Router(config)# ipran-mib location aggSite
Router(config)# ipran-mib location cellSite
Router(config)# ipran-mib location undefined
Router(config)# no ipran-mib location
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ipran-mib snmp-access
|
Defines the type of connectivity between the device and the network management system.
|
ipran-mib snmp-access
To define the type of connectivity between the device and the network management system, use the ipran-mib snmp-access command in global configuration mode. The command is used to limit the amount of traffic while the network is in the process of in-band polling.
ipran-mib snmp-access {inBand | outOfBand | undefined}
Syntax Description
inBand
|
Defines in-band SNMP connectivity.
|
outOfBand
|
Defines out-of-band SNMP connectivity.
|
undefined
|
Specifies undefined connectivity.
|
Defaults
The default access type is inBand.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to define the connectivity type:
Router(config)# ipran-mib snmp-access inBand
Router(config)# ipran-mib snmp-access outOfBand
Router(config)# ipran-mib snmp-access undefined
Router(config)# no ipran-mib snmp-access
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ipran-mib location
|
Defines the location of the device. It is also used to assist the network management system in properly displaying the topology of the system.
|
ipran-mib threshold-acceptable
To specify a level of traffic below which the instances of the cirbhBackHaulRcvdUtilState and cirbhBackHaulSentUtilState objects are marked as "acceptable," use the ipran-mib threshold-acceptable command in global configuration mode. All changes to this threshold take effect at the end of the current interval. The value for this object must be less than the values specified by the ipran-mib threshold-warning and ipran-mib threshold-overloaded commands. This parameter corresponds to the cirbhBackHaulAcceptableThreshold object.
ipran-mib threshold-acceptable [utilization-percentage]
Syntax Description
utilization-percentage
|
(Optional) Specifies the utilization threshold as a percentage. The range is 20 to 100 percent.
|
Defaults
The default threshold is 60 percent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the utilization threshold:
Router(config)# ipran-mib threshold-acceptable 50
Router(config)# ipran-mib threshold-acceptable 70
Router(config)# no ipran-mib threshold-acceptable
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ipran-mib threshold-overloaded
|
Specifies the amount of traffic that indicates the backhaul is overloaded.
|
ipran-mib threshold-warning
|
Specifies the amount of traffic that indicates the backhaul is carrying traffic sufficient to impact performance, but is not overloaded.
|
ipran-mib backhaul-notify-interval
|
Specifies the interval used to suppress the generation of utilization notifications.
|
ipran-mib threshold-overloaded
To specify a level of traffic where the instances of the cirbhBackHaulRcvdUtilState and cirbhBackHaulSentUtilState objects are marked as "overloaded," use the ipran-mib threshold-overloaded command in global configuration mode. Changes to this threshold take effect at the end of the current interval. The value for this object must be greater than the value specified for the cirbhBackHaulAcceptableThreshold object. Also, the value for this object must be greater than or equal to the value of the cirbhBackHaulWarningThreshold object.
ipran-mib threshold-overloaded [utilization-percentage]
Syntax Description
utilization-percentage
|
(Optional) Specifies the utilization threshold as a percentage. The range is 40 to 100 percent.
|
Defaults
The default threshold is 80 percent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the utilization threshold:
Router(config)# ipran-mib threshold-overloaded 60
Router(config)# ipran-mib threshold-overloaded 80
Router(config)# no ipran-mib threshold-warning
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ipran-mib threshold-acceptable
|
Specifies the acceptable level of traffic.
|
ipran-mib backhaul-notify-interval
|
Specifies the interval used to suppress the generation of utilization notifications.
|
ipran-mib threshold-warning
|
Specifies the amount of traffic that indicates the backhaul is carrying traffic sufficient to impact performance, but is not overloaded.
|
ipran-mib threshold-warning
To specify a level of traffic where the instances of the cirbhBackHaulRcvdUtilState and cirbhBackHaulSentUtilState objects are marked as "warning," use the ipran-mib threshold-warning command in global configuration mode
All changes to this threshold take effect at the end of the current interval. The value for this object must be greater than the value specified for the ipran-mib threshold-acceptable command. Also, the value for this object must be less than or equal to the value of the cirbhBackHaulOverloadedThreshold object. This parameter corresponds to the cirbhBackHaulWarningThreshold object.
ipran-mib threshold-warning [utilization-percentage]
Syntax Description
utilization-percentage
|
(Optional) Specifies the utilization threshold as a percentage. The range is 30 to 100 percent.
|
Defaults
The default threshold is 70 percent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to set the utilization threshold:
Router(config)# ipran-mib threshold-warning 60
Router(config)# ipran-mib threshold-warning 80
Router(config)# no ipran-mib threshold-warning
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ipran-mib threshold-acceptable
|
Specifies the acceptable level of traffic.
|
ipran-mib threshold-overloaded
|
Specifies the amount of traffic that indicates the backhaul is overloaded.
|
ipran-mib backhaul-notify-interval
|
Specifies the interval used to suppress the generation of utilization notifications.
|
keepalive
To enable keepalive packets and to specify the number of times that the Cisco IOS software tries to send keepalive packets without a response before bringing down the interface or before bringing the tunnel protocol down for a specific interface, use the keepalive command in interface configuration mode.
When the keepalive function is enabled, a keepalive packet is sent at the specified time interval to keep the interface active. To turn off keepalive packets entirely, use the no form of this command.
keepalive [period [retries]]
no keepalive [period [retries]]
Syntax Description
period
|
(Optional) Integer value in seconds, that represents the time interval between messages sent by the Cisco IOS software to ensure that a network interface is alive. The value must be greater than 0, and the default is 10.
|
retries
|
(Optional) Number of times that the device will continue to send keepalive packets without response before bringing the interface down. The integer value is greater than 1 and less than 255. If omitted, the value that was previously set is used; if no value was specified previously, the default value of 5 is used.
If this command is used with a tunnel interface, then this variable specifies the number of times that the device will continue to send keepalive packets without response before bringing the tunnel interface protocol down.
|
Defaults
period: 10 seconds
retries: 5
If you enter the keepalive command with no arguments, the defaults for both arguments are used.
If you enter the keepalive command and the timeout (period) argument, the default number of retries (5) is used.
If you enter the no keepalive command, keepalive packets are disabled on the interface.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
Keepalive Time Interval
You can configure the keepalive time interval, which is the frequency at which the Cisco IOS software sends messages to itself (Ethernet and Token Ring) or to the other end (serial and tunnel), to ensure that a network interface is alive. The interval is adjustable in 1-second increments, down to a minimum of 1 second. An interface is declared down after three update intervals have passed without receiving a keepalive packet unless the retry value is set higher.
Setting the keepalive timer to a low value is useful for quickly detecting Ethernet interface failures (such as a transceiver cable disconnecting, or cable that is not terminated).
Line Failure
A typical serial line failure involves losing the Carrier Detect (CD) signal. Because this sort of failure is typically noticed within a few milliseconds, adjusting the keepalive timer for quicker routing recovery is generally not useful.
Keepalive Packets with Tunnel Interfaces
GRE keepalive packets may be sent either from both sides of a tunnel or from just one side. If they are sent from both sides, the period and retries arguments can be different at each side of the link. If you configure keepalives on only one side of the tunnel, the tunnel interface on the sending side might perceive the tunnel interface on the receiving side to be down because the sending interface is not receiving keepalives. From the receiving side of the tunnel, the link appears normal because no keepalives were enabled on the second side of the link.
Dropped Packets
Because keepalive packets are treated as ordinary packets, it is possible that they will be dropped. To reduce the possibility that dropped keepalive packets will cause the tunnel interface to be taken down, increase the number of retries.
Note
When adjusting the keepalive timer for a very-low-bandwidth serial interface, large datagrams can delay the smaller keepalive packets long enough to cause the line protocol to go down. You may need to experiment to determine the best values to use for the timeout and the number of retry attempts.
Examples
The following example shows how to set the keepalive interval to 3 seconds:
Router(config)# interface ethernet 0
Router(config-if)# keepalive 3
The following example shows how to set the keepalive interval to 3 seconds and the retry value to 7:
Router(config)# interface tunnel 1
Router(config-if)# keepalive 3 7
load-interval
To change the length of time for which data is used to compute load statistics, use the load-interval interface configuration command. Use the no form of this command to revert to the default setting.
load-interval seconds
no load-interval seconds
Syntax Description
seconds
|
Length of time for which data is used to compute load statistics. Specify a value that is a multiple of 30, from 30 to 600 (30, 60, 90, 120, and so forth).
|
Defaults
The default is 300 seconds (5 minutes).
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
If you want load computations to be more reactive to short bursts of traffic, rather than averaged over 5-minute periods, you can shorten the length of time over which load averages are computed.
If the load interval is set to 30 seconds, new data is used for load calculations over a 30-second period. This data is used to compute load statistics, including input rate in bits and packets per second, output rate in bits and packets per second, load, and reliability.
Load data is gathered every 5 seconds. This data is used for a weighted average calculation in which more-recent load data has more weight in the computation than older load data. If the load interval is set to 30 seconds, the average is computed for the last 30 seconds of load data.
The load-interval command allows you to change the default interval of 5 minutes to a shorter or longer period of time. if you change it to a shorter period of time, the input and output statistics that are displayed when you use the show interface command will be more current, and based on more instantaneous data, rather than reflecting a more average load over a longer period of time.
This command is often used for dial backup purposes, to increase or decrease the likelihood of a backup interface being implemented, but it can be used on any interface.
Examples
In the following example, the default 5-minute average is set to a 30-second average. A burst in traffic that would not trigger a dial backup for an interface configured with the default 5-minute interval might trigger a dial backup for this interface that is set for a shorter, 30-second interval.
Router(config)# interface serial 0
Router(config-if)# load-interval 30
Related Commands
Command
|
Description
|
show interfaces
|
Displays ALC information.
|
match ip dscp
To identify a specific IP differentiated service code point (DSCP) value as a match criterion, use the match ip dscp class-map configuration command. To remove a specific IP DSCP value from a class map, use the no form of this command.
match ip dscp ip-dscp-value [ip-dscp-value ip-dscp-value ip-dscp-value ip-dscp-value
ip-dscp-value ip-dscp-value ip-dscp-value]
no match ip dscp ip-dscp-value [ip-dscp-value ip-dscp-value ip-dscp-value ip-dscp-value
ip-dscp-value ip-dscp-value ip-dscp-value]
Syntax Description
ip-dscp-value
|
Specifies the exact value from 0 to 63 used to identify an IP DSCP value.
|
Command Modes
Class-map configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
Up to eight IP DSCP values can be matched in one match statement. For example, if you wanted the IP DSCP values of 0, 1, 2, 3, 4, 5, 6, or 7 (note that only one of the IP DSCP values must be a successful match criterion, not all of the specified IP DSCP values), enter the match ip dscp 0 1 2 3 4 5 6 7 command.
This command is used by the class map to identify a specific IP DSCP value marking on a packet. The ip-dscp-value arguments are used as markings only. The IP DSCP values have no mathematical significance. For instance, the ip-dscp-value of 2 is not greater than 1. The value simply indicates that a packet marked with an ip-dscp-value of 2 is different from a packet marked with an ip-dscp-value of 1. The treatment of these marked packets is defined by the user through the setting of QoS policies in policy-map class configuration mode.
Examples
The following example shows how to configure the service policy called priority55 and attach service policy priority55 to an interface. In this example, the class map called ipdscp15 evaluates all packets entering interface Fast Ethernet 0/0 for an IP DSCP value of 15. If the incoming packet has been marked with the IP DSCP value of 15, the packet is treated with a priority level of 55.
Router(config)# class-map ipdscp15
Router(config-cmap)# match ip dscp 15
Router(config-cmap)# exit
Router(config)# policy-map priority55
Router(config-pmap)# class ipdscp15
Router(config-pmap-c)# priority55
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# interface fa0/0
Router(config-if)# service-policy input priority55
Related Commands
Command
|
Description
|
class-map
|
Creates a class map to be used for matching packets to a specified class.
|
policy-map
|
Creates or modifies a policy map that can be attached to one or more interfaces to specify a service policy.
|
service-policy
|
Attaches a policy map to an input interface or VC, or an output interface or VC, to be used as the service policy for that interface or VC.
|
set ip dscp
|
Marks the IP DSCP value for packets within a traffic class.
|
show class-map
|
Displays all class maps and their matching criteria.
|
mpls ip
To enable Multiprotocol Label Switching (MPLS) forwarding of IPv4 packets along normally routed paths for a specified interface, use the mpls ip command in interface configuration mode. To disable this feature, use the no form of this command.
mpls ip
no mpls ip
Syntax Description
This command has no arguments or keywords.
Defaults
MPLS forwarding of IPv4 packets along normally routed paths for the interface is disabled.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
MPLS forwarding of IPv4 packets along normally routed paths is sometimes called dynamic label switching. If dynamic label switching has been enabled for the platform when this command is issued on an interface, label distribution for the interface begins with the periodic transmission of neighbor discovery Hello messages on the interface. When the outgoing label for a destination routed through the interface is known, packets for the destination are labeled with that outgoing label and forwarded through the interface.
The no form of this command causes packets routed out through the interface to be sent unlabeled; this form of the command also terminates label distribution for the interface. However, the no form of the command does not affect the sending of labeled packets through any LSP tunnels that might use the interface.
For an LC-ATM interface, the no form of this command prevents the establishment of label virtual circuits (LVCs) beginning at, terminating at, or passing through the interface.
Examples
The following example shows that label switching is enabled on the specified Ethernet interface:
Router(config)# configure terminal
Router(config-if)# interface Ethernet 0/2
Router(config-if)# mpls ip
Related Commands
Command
|
Description
|
mpls ldp maxhops
|
Limits the number of hops permitted in an LSP established by the downstream-on-demand method of label distribution.
|
show mpls interfaces
|
Displays information about one or more interfaces that have been configured for label switching.
|
network-clock-select hold_timeout
The network-clock-select hold_timeout command specifies how long the router waits before reevaluating the network clock entry. To remove a network-clock-select hold_timeout configuration, use the no form of this command.
network-clock-select hold_timeout {timeout | infinite}
no network-clock-select hold_timeout {timeout | infinite}
Syntax Description
timeout
|
A value in seconds that specifies how long the router waits before reevaluating the network clock entry. Valid values are a number from 0-86400.
|
infinite
|
Specifies an infinite holdover.
|
Defaults
The default setting is network-clock-select hold_timeout infinite.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to use the network-clock-select command:
Router(config)# network-clock-select hold_timeout 2000
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
set network-clock-select force-reselect
|
Forces the router to re-select the network clock.
|
network-clock-select input-stratum4
The network-clock-select input-stratum4 command allows you to downgrade a clock source from Stratum3 to Stratum 4. To configure a clock source as Stratum 3, use the no form of this command.
network-clock-select input-stratum4
no network-clock-select input-stratum4
Defaults
The default setting is for onboard E1/T1 ports is Stratum 3; the default setting for E1/T1 HWIC ports is Stratum 4.
Note
You cannot configure E1/T1 HWIC ports as Stratum3.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to use the network-clock-select command:
Router(config)# network-clock-select input-stratum4
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
set network-clock-select force-reselect
|
Forces the router to re-select the network clock.
|
network-clock-select mode
The network-clock-select mode command specifies the router switching mode. To remove a network-clock-select mode configuration, use the no form of this command.
network-clock-select mode {revert | nonrevert}
no network-clock-select mode {revert | nonrevert}
Syntax Description
nonrevert
|
Sets the network clock to non-revertive mode.
|
revert
|
Sets the network clock to revertive mode.
|
Defaults
The default setting is network-clock-select mode nonrevert.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to use the network-clock-select command:
Router(config)# network-clock-select mode revert
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
set network-clock-select force-reselect
|
Forces the router to re-select the network clock.
|
network-clock-select priority
The network-clock-select command names a source to provide timing for the network clock and to specify the selection priority for the clock source. To remove a network-clock-select configuration, use the no form of this command.
network-clock-select priority {bits | synce {port} | packet_timing} {E1 | T1 slot/port}
no network-clock-select priority {bits | synce {port} | packet_timing} {E1 | T1 slot/port}
Syntax Description
priority
|
A numeric value from 1-22 that specifies the priority of the clock source.
|
bits
|
Specifies timing from a BITS port clock.
|
synce
|
Specifies timing using synchronous Ethernet.
|
port
|
Specifies the port on which synchronous Ethernet is enabled.
|
packet_timing
|
Enables packet timing using the RTM module.
|
E1
|
Specifies clocking via an E1 interface.
|
T1
|
Specifies clocking via a T1 interface.
|
slot/port
|
Specifies the slot and port of the interface used for timing.
|
Defaults
There is no default setting.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to use the network-clock-select command:
Router(config)# network-clock-select 1 packet_timing
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
set network-clock-select force-reselect
|
Forces the router to re-select the network clock.
|
payload-size
Specifies the size of the payload for packets on a structured CEM channel.
payload-size [payload-size]
Syntax Description
payload-size
|
Specifies the size of the payload for packets on a structured CEM channel. Valid values are 32-512. The default payload size for a T1 is 192 bytes; the default size for an E1 is 256 bytes.
Note The payload size must be a multiple of the number of timeslots for the CEM channel.
The default payload size is calculated as follows:
8 x number of timeslots x 1 ms packetization delay
|
Defaults
The default payload size for a structured CEM channel depends on the number of timeslots that constitute the channel. The default payload size for a T1 is 192 bytes; the default size for an E1 is 256 bytes.
Command Modes
CEM circuit configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
The Cisco MWR 2941-DC only supports a payload size of 486 (625 packets per second) or 243 (1250 packets per second).
Examples
The following example shows how to specify a sample rate:
Router(config)# interface cem 0/0
Router(config-if)# no ip address
Router(config-if-cem)# payload-size 256
Router(config-if-cem)# xconnect 10.10.10.10 200 encapsulation mpls
Router(config-if-cem-xconn)# exit
Router(config-if-cem)# exit
Related Commands
Command
|
Description
|
dejitter-buffer
|
Configures the size of the dejitter buffer on a CEM channel.
|
idle-pattern
|
Specifies the data pattern transmitted on the T1/E1 line when missing packets are detected on the PWE3 circuit.
|
pseudowire-class
To specify the name of a Layer 2 pseudowire-class and enter pseudowire-class configuration mode, use the pseudowire-class command in global configuration mode. To remove a pseudowire class configuration, use the no form of this command.
pseudowire-class pw-class-name
no pseudowire-class pw-class-name
Syntax Description
pw-class-name
|
The name of a Layer 2 pseudowire-class.If you want to configure more than one pseudowire class, define a class name using the pw-class-name parameter.
|
Defaults
No pseudowire-class is defined.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
The pseudowire-class command configures a pseudowire-class template that consists of configuration settings used by all attachment circuits bound to the class. A pseudowire-class includes the following configuration settings:
•
Data encapsulation type
•
Control protocol
•
IP address of the local Layer 2 interface
•
Type of service (ToS) value in IP headers
The local interface name for each pseudowire class configured between a pair of PE routers can be the same or different.
After entering the pseudowire-class command, the router switches to pseudowire-class configuration mode where PW settings can be configured.
Examples
The following example shows how to enter pseudowire-class configuration mode to configure a PW configuration template named "ether-pw":
Router(config)# pseudowire-class mpls
Router(config-pw-class)# encapsulation mpls
Router(config-pw-class)# exit
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
pseudowire
|
Binds an attachment circuit to a Layer 2 PW for an xconnect service.
|
xconnect
|
Binds an attachment circuit to an Layer 2 PW for an xconnect service and then enters xconnect configuration mode.
|
ptp announce
Sets interval and timeout values for PTP announcement packets.
ptp announce interval interval-value timeout timeout-value
no ptp announce interval interval-value timeout timeout-value
Syntax Description
interval
|
Specifes the interval for PTP announce messages. The intervals are set using log base 2 values, as follows:
4—1 packet every 16 seconds
3—1 packet every 8 seconds
2—1 packet every 4 seconds
1—1 packet every 2 seconds
0—1 packet every second
-1—1 packet every 1/2 second, or 2 packets per second
-2—1 packet every 1/4 second, or 4 packets per second
-3—1 packet every 1/8 second, or 8 packets per second
-4—1 packet every 1/16 seconds, or 16 packets per second.
-5—1 packet every 1/32 seconds, or 32 packets per second.
-6—1 packet every 1/64 seconds, or 64 packets per second.
The recommended value is -6.
|
timeout
|
Specifies the number of PTP announcement intervals before the session times out. Valid values are 2-10.
|
Defaults
The default interval value is 1. The default timeout value is 3.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
The recommended interval value is -6.
Examples
The following example shows how to configure a PTP announcement:
Router(config)# interface vlan 10
Router(config-if)# ptp announce interval 3
Related Commands
Command
|
Description
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp clock-source
Specifies the IP address of the clock source. This command only applies when the router is in PTP slave mode.
ptp clock-source clock-ip-address
no ptp clock-source clock-ip-address
Syntax Description
clock-ip-address
|
The IP address of the clock source.
|
Defaults
The default setting is no ptp clock-source.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to configure a PTP clock source:
Router(config)# interface vlan 10
Router(config-if)# ptp clock-source 192.168.1.1
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp mode
|
Specifies the PTP mode.
|
ptp slave
|
Sets an interface to slave clock mode for PTP clocking.
|
ptp clock-destination
Specifies the IP address of a clock destination. This command applies only when the router is in PTP master unicast mode.
ptp clock-destination clock-ip-address
no ptp clock-destination clock-ip-address
Syntax Description
clock-ip-address
|
The IP address of the clock destination.
|
Defaults
There is no default setting.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
If the router is set to ptp master unicast, you can only configure a single destination. If the router is set to ptp master unicast negotiation, you can configure up to 128 clock destinations.
Examples
The following example shows how to configure a PTP announcement:
Router(config)# interface vlan 10
Router(config-if)# ptp clock-destination 192.168.1.2
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp master
|
Sets an interface in master clock mode for PTP clocking
|
ptp mode
|
Specifies the PTP mode.
|
ptp delay-req
Specifies the delay request interval, the time recommended to member devices to send delay request messages when an interface is in PTP master mode.
ptp delay-req interval interval-value
no ptp delay-req interval interval-value
Syntax Description
interval
|
Specifies the interval for delay request messages. The intervals are set using log base 2 values, as follows:
4—1 packet every 16 seconds
3—1 packet every 8 seconds
2—1 packet every 4 seconds
1—1 packet every 2 seconds
0—1 packet every second
-1—1 packet every 1/2 second, or 2 packets per second
-2—1 packet every 1/4 second, or 4 packets per second
-3—1 packet every 1/8 second, or 8 packets per second
-4—1 packet every 1/16 seconds, or 16 packets per second.
-5—1 packet every 1/32 seconds, or 32 packets per second.
-6—1 packet every 1/64 seconds, or 64 packets per second.
The recommended value is -6.
|
Defaults
The default setting is 0.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
The recommended interval value is -6.
Examples
The following example shows how to configure a PTP announcement:
Router(config)# interface vlan 10
Router(config-if)# ptp delay-req interval -4
Related Commands
Command
|
Description
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp master
|
Sets an interface in master clock mode for PTP clocking
|
ptp mode
|
Specifies the PTP mode.
|
ptp domain
PTP domains allow you to use multiple independent PTP clocking subdomains on a single network. Use this command to specify the PTP domain number that the router uses.
ptp domain domain-number
no ptp domain domain-number
Syntax Description
domain-number
|
The PTP domain that the router applies to PTP traffic. Valid values are from 0-127.
|
Defaults
The default setting is ptp domain 0.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to set the ptp domain:
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp mode
|
Specifies the PTP mode.
|
ptp enable
Enables PTP mode on an interface.
ptp enable
no ptp enable
Defaults
PTP is disabled by default.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to configure a PTP announcement:
Router(config)# interface vlan 10
Router(config-if)# ptp enable
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ptp master
|
Sets an interface in master clock mode for PTP clocking
|
ptp mode
|
Specifies the PTP mode.
|
ptp slave
|
Sets an interface to slave clock mode for PTP clocking.
|
ptp master
Sets an interface in master clock mode for PTP clocking. To enable ordinary master clock mode, use the ptp master command in interface configuration mode. To disable this feature, use the no form of this command.
ptp master multicast {unicast | unicast negotiation}
no ptp master multicast {unicast | unicast negotiation}
Syntax Description
multicast
|
Sets the interface to use multicast mode for PTP clocking.
|
unicast
|
Sets the interface to use unicast mode for PTP clock.
Note If the router is set to ptp master unicast, you can only configure a single destination.
|
unicast negotiation
|
Sets the interface to negotiate unicast mode for PTP clocking.
Note If the router is set to ptp master unicast negotiation, you can configure up to 128 clock destinations.
|
Defaults
There is no default setting.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
For unicast and unicast negotiation, you must configure the ip address of the remote slave using the ptp clock-destination command before enabling PTP.
Examples
The following example shows how to enable ptp master multicast mode:
Router(config-if)# ptp master multicast
Related Commands
Command
|
Description
|
ptp clock-destination
|
Specifies the IP address of a clock destination when the router is in PTP master mode.
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp mode
|
Specifies the PTP mode.
|
ptp mode
Specifies the PTP mode.
ptp mode [ordinary]
no ptp mode [ordinary]
Note
The Cisco MWR 2941-DC does not currently support other PTP modes such as boundary or transport mode.
Syntax Description
ordinary
|
Sets the interface to PTP clocking mode to ordinary.
|
Defaults
The default setting is ptp mode ordinary.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to enable ptp mode:
Router(config)# ptp mode ordinary
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp master
|
Sets an interface in master clock mode for PTP clocking
|
ptp slave
|
Sets an interface to slave clock mode for PTP clocking.
|
ptp priority1
Sets the preference level for a clock; slave devices use the priority1 value when selecting a master clock. The priority1 value is considered above all other clock attributes. Use the following commands to set the ptp priority1 value.
ptp priority1 priorityvalue
no ptp priority1 priorityvalue
Syntax Description
priorityvalue
|
Valid values are from 0-255. The default value is 128.
|
Defaults
The default value is 128.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to enable ptp priority1 value:
Router(config-if)# ptp priority1 128
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
ptp priority2
Sets a secondary preference level for a clock; slave devices use the priority2 value when selecting a master clock. The priority2 value is considered only when the router is unable to use priority2 and other clock attributes to select a clock. Use the following commands to set the ptp priority2 value.
ptp priority2 priorityvalue
no ptp priority2 priorityvalue
Syntax Description
priorityvalue
|
Valid values are from 0-255. The default value is 128.
|
Defaults
The default value is 128.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to configure the ptp priority2 value:
Router(config-if)# ptp priority2 128
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
ptp slave
Sets an interface to slave clock mode for PTP clocking. To enable ordinary slave clock mode, use the ptp slave command in interface configuration mode. To disable this feature, use the feature, use the no form of this command.
ptp slave {multicast | unicast | unicast negotiation}
no ptp slave {multicast | unicast | unicast negotiation}
Syntax Description
multicast
|
Sets the interface to use multicast mode for PTP clocking.
|
unicast
|
Sets the interface to use unicast mode for PTP clocking.
|
unicast negotiation
|
Sets the interface to negotiate unicast mode for PTP clocking.
|
Defaults
There is no default setting.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
You must configure the IP address of the remote timing device before enabling PTP.
Examples
The following example shows how to enable ptp slave multicast mode:
Router(config-if)# ptp slave multicast
Related Commands
Command
|
Description
|
ptp clock-source
|
Specifies the IP address of the clock source. This command only applies when the router is in PTP slave mode.
|
ptp enable
|
Enables PTP mode on an interface.
|
ptp mode
|
Specifies the PTP mode.
|
ptp sync interval
Defines the interval that the router uses to send PTP synchronization messages.
ptp sync interval interval-value
no ptp sync interval interval-value
Syntax Description
interval-value
|
Specifies the interval at which the router sends announcement packets. The intervals are set using log base 2 values, as follows:
4—1 packet every 16 seconds
3—1 packet every 8 seconds
2—1 packet every 4 seconds
1—1 packet every 2 seconds
0—1 packet every second
-1—1 packet every 1/2 second, or 2 packets per second
-2—1 packet every 1/4 second, or 4 packets per second
-3—1 packet every 1/8 second, or 8 packets per second
-4—1 packet every 1/16 seconds, or 16 packets per second.
-5—1 packet every 1/32 seconds, or 32 packets per second.
-6—1 packet every 1/64 seconds, or 64 packets per second.
The recommended value is -6.
|
Defaults
There is no default setting.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
We do not recommend that you alter the default value for the limit parameter.
Examples
The following example shows how to configure a PTP announcement:
Router(config)# interface vlan 10
Router(config-if)# ptp sync interval -4
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ptp sync limit
|
Defines the offset values that the router uses to send PTP synchronization messages.
|
ptp sync limit
Defines the offset values that the router uses to send PTP synchronization messages.
ptp sync limit limit-value
no ptp sync limit limit-value
Syntax Description
limit-value
|
Specifies the maximum clock offset value before PTP attempts to resynchronize. Values are in nanoseconds; the default value is 8000.
|
Defaults
The default value is 8000.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
We do not recommend that you alter the default value for the limit parameter unless suggested by Cisco support.
Examples
The following example shows how to configure a PTP announcement:
Router(config)# interface vlan 10
Router(config-if)# ptp sync limit 8000
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
ptp sync interval
|
Defines the interval that the router uses to send PTP synchronization messages.
|
pw-pvc
To configure PVC mapping or rewrite the PW configured for a PVC, use the pw-pvc command. This command specifies the PW-side VPI/VCI value to be used inside the PW packet payload in sending and receiving PW packets for a specified PVC.
pw-pvc pw-vpi/pw-vci
Syntax Description
pw-vpi
|
Pseudowire-side vpi value
|
pw-vci
|
Pseduowire-side vci value
|
Defaults
The PW-side VPI/VCI value is the same as the attachment circuit-side VPI/VCI value.
Command Modes
l2transport VC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to use the pw-pvc command:
Router(config-if)# pvc 0/40 l2transport
Router(config-if-atm-l2trans-pvc)# encapsulation aal0
Router(config-if-atm-l2trans-pvc)# pw-pvc 1/40
Router(config-if-atm-l2trans-pvc)# xconnect 1.1.1.1 40 encapsulation mpls
Router(config-if-atm-l2trans-pvc-xconn)# exit
Router(config-if-atm-l2trans-pvc)# exit
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
xconnect
|
Binds an attachment circuit to a PW in one of the supported configuration modes.
|
recovered-clock slave
To configure out-of-band clock recovery, use the recovered-clock slave command. This command automatically creates a virtual-cem interface. To access the virtual-cem interface, use the command interface virtual-cem 0/24. To disable this feature, use the feature, use the no form of this command.
recovered-clock slave
no recovered-clock slave
Defaults
There is no default setting.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to use the recovered-clock slave command and how to configure the virtual-cem interface:
Router(config)# recovered-clock slave
Router(config-if)# interface virtual-cem 0/24
Router(config-if)# payload-size 486
Router(config-if)# xconnect 10.10.10.2 7600 encap mpls
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
recovered-clock recovered
|
Configures adaptive clock recovery.
|
recovered-clock recovered
The recovered-clock recovered command allows you to configure in-band pseudowire-based active clock recovery on a CEM interface. To disable this feature, use the feature, use the no form of this command.
recovered-clock recovered adaptive cem subslot-number port-number cem-group-number
no recovered-clock recovered adaptive cem subslot-number port-number cem-group-number
Syntax Description
adaptive
|
Specifies the clock recovery type.
|
cem
|
Specifies the Circuit emulation (CEM) interface for the recovered clock.
|
subslot-number
|
The subslot of the CEM interface for the recovered clock.
|
port-number
|
The port number of the CEM interface for the recovered clock.
|
cem-group-number
|
The CEM group to which the clock applies.
|
Defaults
There is no default setting.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Usage Guidelines
For more information about adaptive clock recovery, see Configuring Network Clocking Support, page 4-6.
Examples
The following example shows how to use the recovered-clock recovered command:
Router(config)# recovered-clock recovered adaptive cem 0 0 0
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
recovered-clock slave
|
Allows you to configure out-of-band clock recovery,
|
set network-clocks
This command causes the router to reselect a network clock; the router selects a new clock based on clock priority.
set network-clock-select [force-reselect | next-select]
Syntax Description
force-reselect
|
Forces the router to select a new network clock.
|
next-select
|
Forces the router to select the next available network clock.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was introduced.
|
Examples
The following example shows how to use the set network-clock-select force-reselect command:
Router# set network-clock-select force-reselect
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
show network-clocks
|
Displays information about all clocks configured on the router.
|
show atm cell-packing
To display cell packing information for the Layer 2 attachment circuits (ACs) configured on your system, use the show atm cell-packing command in privileged EXEC mode.
show atm cell-packing
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows output from the show atm cell-packing command:
Router# show atm cell-packing
Circuit local cells/pkt negotiated cells/pkt MCPT
Type MNCP rcvd MNCP sent (us)
ATM0/2/0/1.200 vc 1/200 1 0 1 0 50
ATM0/2/0/1.300 vc 1/300 1 0 1 0 50
Related Commands
Command
|
Description
|
cell-packing
|
Packs multiple ATM cells into each MPLS or L2TPv3 packet.
|
atm cell-packing
|
Packs multiple ATM cells into each MPLS or L2TPv3 packet.
|
show cem circuit
To display a summary of CEM circuits, use the show cem circuit command in privileged EXEC mode.
show cem circuit [cem-id]
Syntax Description
cem-id
|
(Optional) Identifies the circuit configured with the cem-group command.
|
Command Modes
Privileged EXEC
Command HistoryGlobal configuration
Release
|
Modification
|
12.4(12)MR2
|
This command was introduced.
|
Examples
The following examples show the output generated by this command;
CEM Int. ID Ctrlr Admin Circuit AC
--------------------------------------------------------------
CEM0/0 0 UP UP Enabled UP
CEM0/1 1 UP UP Enabled UP
CEM0/2 2 UP UP Enabled UP
CEM0/3 3 UP UP Enabled UP
CEM0/4 4 UP UP Enabled UP
CEM0/5 5 UP UP Enabled UP
Router# show cem circuit 5
CEM0/5, ID: 5, Line: UP, Admin: UP, Ckt: Enabled
Idle Pattern: 0xFF, Idle cas: 0x8
Dejitter: 4, Sample Rate: 1, Payload Size: 192
Framing: Framed, (DS0 channels: 1-24)
Ingress Pkts: 527521938 Dropped: 0
Egress Pkts: 527521938 Dropped: 0
Input Errors: 0 Output Errors: 0
Pkts Missing: 0 Pkts Reordered: 0
Misorder Drops: 0 JitterBuf Underrun: 0
Error Sec: 0 Severly Errored Sec: 0
Unavailable Sec: 0 Failure Counts: 0
Related Commands
Command
|
Description
|
show cem circuit detail
|
Displays detailed information about all CEM circuits.
|
show cem platform
|
Displays platform-specific error counters for all CEM circuits.
|
show cem platform errors
|
Displays platform-specific error counters for all CEM circuits.
|
show cem platform
To display platform-specific error counters for all CEM circuits, use the show cem platform command in privileged EXEC mode.
show cem platform [interface]
Syntax Description
interface
|
(Optional) Identifies the CEM interface (for example, CEM0/1).
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was introduced.
|
Examples
The following examples show the output generated by this command:
Router# show cem platform
net2cem_drops =============== 50/527658758
net2cem_drops_underflow === 26
net2cem_drops_overflow ==== 24
net2cem_drops =============== 50/527658759
net2cem_drops_underflow === 25
net2cem_drops_overflow ==== 25
net2cem_drops =============== 2/526990836
net2cem_drops_overflow ==== 2
net2cem_drops =============== 1/526982274
net2cem_drops_overflow ==== 1
net2cem_drops =============== 51/527658758
net2cem_drops_underflow === 26
net2cem_drops_overflow ==== 25
net2cem_drops =============== 48/527660498
net2cem_drops_underflow === 24
net2cem_drops_overflow ==== 24
Router# show cem platform cem0/1
net2cem_drops =============== 50/527678398
net2cem_drops_underflow === 25
net2cem_drops_overflow ==== 25
Related Commands
Command
|
Description
|
show cem circuit
|
Displays a summary of CEM circuits.
|
show cem circuit detail
|
Displays detailed information about all CEM circuits.
|
show cem platform errors
|
Displays platform-specific error counters for all CEM circuits.
|
show connection
To display the status of interworking connections, use the show connection command in privileged EXEC mode.
show connection [all | element | id ID | name name | port port]
Syntax Description
all
|
(Optional) Displays information about all interworking connections.
|
element
|
(Optional) Displays information about the specified connection element.
|
id ID
|
(Optional) Displays information about the specified connection identifier.
|
name name
|
(Optional) Displays information about the specified connection name.
|
port port
|
(Optional) Displays information about all connections on an interface. (In Cisco IOS Release 12.0S, only ATM, serial, and Fast Ethernet connections are shown.)
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the local interworking connections on a router:
ID Name Segment 1 Segment 2 State
========================================================================
1 conn1 ATM 1/0/0 AAL5 0/100 ATM 2/0/0 AAL5 0/100 UP
2 conn2 ATM 2/0/0 AAL5 0/300 Serial0/1 16 UP
3 conn3 ATM 2/0/0 AAL5 0/400 FA 0/0.1 10 UP
4 conn4 ATM 1/0/0 CELL 0/500 ATM 2/0/0 CELL 0/500 UP
5 conn5 ATM 1/0/0 CELL 100 ATM 2/0/0 CELL 100 UP
Table A-1 describes the significant fields shown in the display.
Table A-1 show connection Field Descriptions
Field
|
Description
|
ID
|
Arbitrary connection identifier assigned by the operating system.
|
Name
|
Name of the connection.
|
Segment 1
Segment 2
|
Information about the interworking segments, including:
• Interface name and number.
• Segment state, interface name and number, and channel ID. Segment state displays nothing if the segment state is UP, "-" if the segment state is DOWN, and "***Card Removed***" if the segment state is DETACHED.
• Type of encapsulation (if any) assigned to the interface.
• Permanent virtual circuit (PVC) assigned to the ATM interface, data-link connection identifier (DLCI) assigned to the serial interface, or VLAN ID assigned to the Ethernet interface.
|
State or Status
|
Status of the connection, which is one of the following: INVALID, UP, ADMIN UP, ADMIN DOWN, OPER DOWN, COMING UP, NOT VERIFIED, ERR.
|
Related Commands
Command
|
Description
|
connect (L2VPN local switching)
|
Connects two different or similar interfaces on a router.
|
show atm pvc
|
Displays the status of ATM PVCs and SVCs.
|
show frame-relay pvc
|
Displays the status of Frame Relay interfaces.
|
show controller
Use the show controller command to display the status of an interface.
show controller {ATM | Async | BITS | CEM | E1 | GigabitEthernet | J1 | T1 | RTM} slot / port
Syntax Description
ATM
|
Displays the status of the ATM controller.
|
Async
|
Displays the status of the async controller.
|
BITS
|
Displays the status of the BITS controller.
|
CEM
|
Displays the status of the CEM controller.
|
E1
|
Displays the status oft the E1 controller.
|
GigabitEthernet
|
Displays the status of the Gigabit Ethernet controller.
|
J1
|
Displays the status of the J1 controller.
|
T1
|
Displays the status of the T1 controller.
|
RTM
|
Displays the status of the RTM controller.
|
slot
|
The slot number of the interface.
|
port
|
The port number of the interface.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
Router# show controller e1 0/2
Applique type is Channelized E1 - balanced
Version info Firmware: 20050421, FPGA: 13, spm_count = 0
Daughter card FPGA version: 0x16, source: Bundled
Framing is NO-CRC4, Line Code is HDB3, Clock Source is Line.
CRC Threshold is 320. Reported from firmware is 320.
Link noise monitor disabled
Data in current interval (330 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
243 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
Note
The last line of the example shows 243 Slip Secs, indicating a possible clocking issue.
Related Commands
Command
|
Description
|
show atm pvc
|
Displays the status of ATM PVCs and SVCs.
|
show frame-relay pvc
|
Displays the status of Frame Relay interfaces.
|
show gsm-abis efficiency
To display a history of the GSM compression/decompression efficiency averages at intervals of 1 second, 5 seconds, 1 minute, 5 minutes, and 1 hour, use the show gsm-abis efficiency command in privileged EXEC mode. Efficiency is defined as the percentage of bandwidth savings obtained by using the compression/decompression algorithm to suppress GSM data.
show gsm-abis efficiency [history]
Syntax Description
history
|
(Optional) Creates a graph display of the efficiency.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following examples show the output generated by this command:
Router# show gsm-abis efficiency ser0/2:0
GSM-Abis(Serial0/2:0): efficiency (1sec/5sec/1min/5min/1hr) units(%%)
compression efficiency (091/091/091/091/---) estimate
decompression efficiency (091/091/091/091/---)
Router# sh gsm eff history ser0/2:0
mwr1 04:00:00 PM Tuesday Apr 8 2008 est
9999999999999999999999999999999999999999999999999999999999
1111111111111111111111111111111111111111111111111111111111
90 ************************************************************
80 ************************************************************
70 ************************************************************
60 ************************************************************
50 ************************************************************
40 ************************************************************
30 ************************************************************
20 ************************************************************
10 ************************************************************
0....5....1....1....2....2....3....3....4....4....5....5....
GSM-Abis(Serial0/2:0) compression efficiency%/sec (last 60 secs)
0....5....1....1....2....2....3....3....4....4....5....5....
GSM-Abis(Serial0/2:0) compression efficiency%/min (last 60 mins)
* = maximum eff% # = average eff%
0....5....1....1....2....2....3....3....4....4....5....5....6....6....7.
0 5 0 5 0 5 0 5 0 5 0 5 0
GSM-Abis(Serial0/2:0) compression efficiency%/hr (last 72 hrs)
* = maximum eff% # = average eff%
mwr1 04:00:03 PM Tuesday Apr 8 2008 est
9999999999999999999999999999999999999999999999999999999999
1111111111111111111111111111111111111111111111111111111111
90 ************************************************************
80 ************************************************************
70 ************************************************************
60 ************************************************************
50 ************************************************************
40 ************************************************************
30 ************************************************************
20 ************************************************************
10 ************************************************************
0....5....1....1....2....2....3....3....4....4....5....5....
GSM-Abis(Serial0/2:0) decompression efficiency%/sec (last 60 secs)
0....5....1....1....2....2....3....3....4....4....5....5....
GSM-Abis(Serial0/2:0) decompression efficiency%/min (last 60 mins)
* = maximum eff% # = average eff%
0....5....1....1....2....2....3....3....4....4....5....5....6....6....7.
0 5 0 5 0 5 0 5 0 5 0 5 0
GSM-Abis(Serial0/2:0) decompression efficiency%/hr (last 72 hrs)
* = maximum eff% # = average eff%
Related Commands
Command
|
Description
|
clear gsm-abis
|
Clears the statistics displayed.
|
show gsm-abis errors
To display error statistics counters of GSM compression/decompression, use the show gsm-abis errors command in privileged EXEC mode.
show gsm-abis errors
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the output generated by this command:
Router# show gsm-abis errors
GSM-Abis(Serial0/2:0): backhaul_rxLostPakInd =========== 1/431956
GSM-Abis(Serial0/2:0): backhaul_txLostPakInd =========== 1/432539
GSM-Abis(Serial0/2:0): backhaul_missedPaks ============= 654/431956
GSM-Abis(Serial0/2:0): backhaul_latePaks =============== 591
GSM-Abis(Serial0/2:0): backhaul_lostPaks =============== 1
GSM-Abis(Serial0/2:0): backhaul_txReset ================= 33
GSM-Abis(Serial0/2:0): backhaul_overrun ================= 29
GSM-Abis(Serial0/2:0): compression_failures ============ 39661
GSM-Abis(Serial0/2:0): backhaul_congestion_drops ======= 39661
GSM-Abis(Serial0/2:0): backhaul_congestion_events ====== 1
GSM-Abis(Serial0/2:0): backhaul_congestion_duration(sec) == 80
GSM-Abis(Serial0/2:0): backhaul_congestion_bytes ========== 16498976
Table A-2 show gsm-abis errors Field Descriptions
Field
|
Description
|
tx_gsmPak_failures
|
Send GSM-Abis packet failed.
|
txPtcl_no_memory
|
No particles available (for example, getparticle() failure).
|
backhaul_peer_not_ready
|
Backhaul peer not ready for input.
|
backhaul_peer_not_active
|
Backhaul peer is not active.
Backhaul peer is marked active when first.
Backhaul peer is received from peer.
|
backhaul_invalid_pak
|
Received backhaulPak is invalid.
Returns errCode to identify reason.
|
backhaul_rxLostPakInd
|
Receive backhaul_lostPak indicator.
|
backhaul_txLostPakInd
|
Transmit backhaul_lostPak indicator.
|
backhaul_missedPak
|
Received backhaulPak is missed or dropped.
|
backhaul_latePaks
|
No backhaul packet arrived in time to fill txParticles with data (backhaul packet was lost or late).
|
backhaul_lostPaks
|
Backhaul packet was lost.
|
backhaul_txPtcl_no_memory
|
No particles available (for example, getparticle () failure).
|
backhaul_txReset
|
Packets lost due to txBufferRing reset.
|
decompression_failures
|
Decompression of input backhaulPak failed.
|
compression_failures
|
Compression of input GSM packet failed.
|
no-backhaul_pak_available
|
No memory for backhaulPak buffer.
|
no-backhaul_interface
|
Could not find an output interface that corresponds to configured remote IP address.
|
backhaul_interface_down
|
Interface used for backhaul is not active.
|
backhaul_encap_failures
|
The pak-encap failed.
|
backhaul_qos_classify_drops
|
QoS classification drops.
|
rxInterrupt_failures
|
Count number of Abis packets missed because of unexpected rxInterrupt.
|
abis_late
|
GSM-Abis rxInterrupt arrived too late.
|
abis_early
|
GSM-Abis rxInterrupt arrived too early.
|
Table A-2 describes the significant fields shown in the display.
Related Commands
Command
|
Description
|
clear gsm-abis
|
Clears the statistics displayed.
|
show gsm-abis packets
To display packet statistics counters of GSM compression/decompression, use the show gsm-abis packets command in privileged EXEC mode. Include the include retransmit keyword to see the repetitive subrate samples at a specific configuration level (100 ms to 5100 ms).
show gsm-abis packets
show gsm-abis packets | include retransmit
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following show gsm-abis packets example shows the output generated by this command:
Router# show gsm-abis packets
GSM-Abis(Serial0/2:0): packets:
rxGSM_count =================== 164011
txGSM_count ================= 164011
rxBackhaul_packets ========== 163428
txBackhaul_packets ========== 164011
rxBackhaul_bytes ============ 7649833
txBackhaul_bytes ============ 7638262
rx_sampleCount ============== 40674728
rx_suppressedCount ======== 36629047
rx_retransmittedCount ===== 0
rx_all_presentCount ======= 29
tx_sampleCount ============== 4053144
tx_presentCount =========== 66522
tx_all_presentCount ======= 8
backhaul_forced_inclusions == 1
The following show gsm-abis packets | include retransmit example shows the output generated by this command:
Router# show gsm-abis packet | include retransmit
rx-retransmittedCount ====== 71405
Related Commands
Command
|
Description
|
clear gsm-abis
|
Clears the statistics displayed.
|
show gsm-abis peering
To display the peering status, statistics, and history of GSM compression/decompression, use the show gsm-abis peering command in privileged EXEC mode.
show gsm-abis peering [details]
Syntax Description
details
|
(Optional) Provides detailed information about peering.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following examples show the output generated by this command:
Router# show gsm-abis peering ser0/2:0
GSM-Abis(Serial0/2:0): Peering Information
GSM-Abis(Serial0/2:0): Local (10.10.10.1:5555) States:
GSM-Abis(Serial0/2:0): Connect State Is: CONNECTED
GSM-Abis(Serial0/2:0): Local Alarm Is: CLEAR (NO ALARM)
GSM-Abis(Serial0/2:0): Redundancy State: ACTIVE
GSM-Abis(Serial0/2:0): Local Peer Version: 1.0
GSM-Abis(Serial0/2:0): Remote (10.10.10.2:5555) States:
GSM-Abis(Serial0/2:0): Remote Alarm Is: CLEAR (NO ALARM)
GSM-Abis(Serial0/2:0): Remote Peer Version: 1.0
Router# show gsm-abis peering details ser0/2:0
GSM-Abis(Serial0/2:0): Peering Information (Version 1.0) History with current state at the
bottom GSM Peering History:
Connect State Is: System Time
------------------ -------------------
DISCONNECT *Apr 26 19:00:20.303
SND_CONNECT *Apr 26 15:48:30.568
ACK_CONNECT *Apr 26 15:48:31.572
**CONNECTED *Apr 26 15:50:57.113
Local Peer Is: Conn Info System Time
---------------------- ---------- -------------------
CLEAR (NO ALARM) DISCONNECT *Mar 1 19:00:20.303
SENDING AIS DISCONNECT *Apr 24 15:48:31.980
**CLEAR (NO ALARM) CONNECTED *Apr 26 15:51:04.113
Remote Peer Is: Conn Info Local Redundancy System Time
---------------------- ---------- ---------------- -------------------
UNAVAILABLE DISCONNECT STANDBV *Mar 1 19:00:20.303
UNAVAILABLE DISCONNECT ACTIVE *Mar 1 15:50:57.113
RX LOF RED) ALARM CONNECTED ACTIVE *Apr 26 15:50:57.117
**CLEAR (NO ALARM) CONNECTED ACTIVE *Apr 26 15:50:57.117
Current System Time: *Apr 26 16:00:33.133 est
No Backhaul Interface ======= 0 packets
Backhaul Encap Failures ===== 0 packets
Get CtrlPak Failures ======== 0 packets
RX Ctrl Paks ================ 7 packets
TX Ctrl Paks ================ 11 packets
Out Of Sequence Paks ======== 1 packets
Out Of Sequence Paks ====== 0 packets
Unsolicited Connect Paks ==== 1 (times)
Unsolicited Connect Paks == 0 (times)
Remove Retransmit Errors ==== 8 (error)
Backhaul QOS classify drops = 0 packets
Unknown Ctrl Types ========== 0 (times)
Invalid Ctrl Lens =========== 0 (times)
Missed Keepalives =========== 0 (times)
Extra Keepalives ============ 0 (times)
Peer Restarts =============== 5 (times)
Due to Cfg Change ========= 2(times)
Due to Internal Err ======= 1(times)
Due to Lost Keepalive ===== 0 (times)
Due to Interface Down ===== 0 (times)
Due to Critical Pak Lost == 0 (times)
Due to Interface Cleanup == 0 (times)
Due to Excess Seq No Err == 0 (times)
peer_enable ================= 1 (on/off)
peer_ready ================== 1 (on/off)
connecting ================== 0 (on/off)
detectAlmErr ================ 1 (on/off)
Retransmition Contexts Used = 1 (in use)
Data Buffers Used =========== 0 (in use)
Seq Num: tx_fsn/tx_bsn ====== 4/4
Seq Num: rx_fsn/rx_bsn ====== 4/4
Adjacent serial number: `FTX1021A44Q'
Related Commands
Command
|
Description
|
clear gsm-abis
|
Clears the statistics displayed.
|
show gsm-abis traffic
To display traffic rates, in bits per second, at intervals of 1 second, 5 seconds, 1 minute, 5 minutes, and 1 hour, for GSM data transmitted and received over the backhaul, use the show gsm-abis traffic command in privileged EXEC mode.
show gsm-abis traffic
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the output generated by this command:
Router# show gsm-abis traffic
GSM-Abis(Serial1/2:0): traffic (1sec/5sec/1min/5min/1hr) units(bps)
compression traffic( 964000/ 966758/ 965928/ 965937/ 48831)
decompression traffic( 132000/ 136774/ 134428/ 134430/ 6799)
Related Commands
Command
|
Description
|
clear gsm-abis
|
Clears the statistics displayed.
|
show interface switchport backup
Displays status information about the backup switchport.
show interface switchport backup [detail]
Syntax Description
detail
|
Provides additional information about the backup interface.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the output generated by this command:
Router# show interface switchport backup
Switch Backup Interface Pairs:
Active Interface Backup Interface State
------------------------------------------------------------------------
GigabitEthernet0/0 GigabitEthernet0/5 Active Down/Backup Down
Related Commands
Command
|
Description
|
switchport backup interface
|
Configures a backup interface pair.
|
show ip rtp header-compression
To show Real-Time Transport Protocol (RTP) header compression statistics, use the show ip rtp header-compression privileged EXEC command.
show ip rtp header-compression [type number] [detail]
Syntax Description
type number
|
(Optional) Interface type and number.
|
detail
|
(Optional) Displays details of each connection.
Note This keyword is not supported on the Cisco MWR 2941-DC router. See "Usage Guidelines."
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
The detail keyword is not available with the show ip rtp header-compression command on a Route Switch Processor (RSP). However, the detail keyword is available with the show ip rtp header-compression command on a Versatile Interface Processor (VIP). Enter the show ip rtp header-compression type number detail command on a VIP to retrieve detailed information about RTP header compression on a specific interface.
Examples
The following example shows output from the show ip rtp header-compression command:
Router# show ip rtp header-compression
RTP/UDP/IP header compression statistics:
Interface Multilink1 (compression off, IETF, RTP)
Rcvd: 0 total, 0 compressed, 0 errors
0 dropped, 0 buffer copies, 0 buffer failures
Sent: 430 total 429 compressed
15122 bytes saved, 0 bytes sent
0 efficiency improvement factor
Connect: 16 rx slots, 16 tx slots, 0 long searches, 1 misses
99% hit ratio, five minute miss rate 0 misses/sec, 0 max.
Table A-3 describes the significant fields shown in the display.
Table A-3 show ip rtp header-compression Field Descriptions
Field
|
Description
|
Interface
|
Type and number of the interface.
|
Rcvd: total
|
Number of packets received on the interface.
|
compressed
|
Number of packets with compressed headers.
|
errors
|
Number of errors.
|
dropped
|
Number of dropped packets.
|
buffer copies
|
Not applicable to the Cisco MWR 2941-DC router.
|
buffer failures
|
Not applicable to the Cisco MWR 2941-DC router.
|
Sent: total
|
Total number of packets sent.
|
compressed
|
Number of packets sent with compressed headers.
|
bytes saved
|
Total savings in bytes as a result of compression.
|
bytes sent
|
Not applicable to the Cisco MWR 2941-DC router.
|
efficiency improvement factor
|
Efficiency achieved through compression.
|
Connect: rx slots
|
Total number of receive slots.
|
tx slots
|
Total number of transmit slots.
|
long searches
|
Not applicable to the Cisco MWR 2941-DC router.
|
misses
|
Number of new states that were created.
|
hit ratio
|
Number of times that existing states were revised.
|
five minute miss rate
|
Average miss rate.
|
max.
|
Maximum miss rate.
|
negative cache
|
Not applicable to the Cisco MWR 2941-DC router.
|
Related Commands
Command
|
Description
|
ip rtp compression-connections
|
Specifies the total number of RTP header compression connections that can exist on an interface.
|
ip rtp header-compression
|
Enables RTP header compression.
|
show mpls l2transport vc
To display information about Any Transport over MPLS (AToM) virtual circuits (VCs) that have been enabled to route Layer 2 packets on a router, use the show mpls l2transport vc command in privileged EXEC mode.
show mpls l2transport vc [vcid vc-id] | [vcid vc-id-min vc-id-max]} [interface name
[local-circuit-id]] [destination ip-address | name] [detail]
Syntax Description
vcid
|
(Optional) Allows you to enter a specific VC ID to display.
|
vc-id
|
(Optional) The VC ID number.
|
vc-id-min vc-id-max
|
(Optional) Allows you to enter a range of VCs to display. The range is from 1 to 4294967295. (This argument is primarily used for legacy implementations.)
|
interface
|
(Optional) The interface or subinterface of the router that has been enabled to transport Layer 2 packets. This keyword lets you display information about the VCs that have been assigned VC IDs on that interface or subinterface.
|
name
|
(Optional) The name of the interface or subinterface.
|
local-circuit-id
|
(Optional) The number assigned to the local circuit. This argument value is supported only by the following transport types:
• For ATM adaptation layer 5 (AAL5) and cell relay, enter the virtual path identifier (VPI)/virtual channel identifier (VCI) of the PVC.
• For Ethernet VLANs, enter the VLAN number.
|
destination
|
(Optional) Information about the VCs that have been assigned VC IDs for the remote router you specify.
|
ip-address
|
(Optional) The IP address of the remote router.
|
name
|
(Optional) The name assigned to the remote router.
|
detail
|
(Optional) Detailed information about the VCs that have been assigned VC IDs.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
If you do not specify any keywords or arguments, the command displays a summary of all the VCs.
Examples
The output of the commands varies, depending on the type of Layer 2 packets being transported over the AToM VCs.
The following example shows information about the interfaces and VCs that have been configured to transport various Layer 2 packets on the router:
Router# show mpls l2transport vc
Local intf Local circuit Dest address VC ID Status
------------- ------------------ --------------- ---------- ----------
AT4/0 ATM AAL5 0/100 10.0.0.1 100 UP
AT4/0 ATM AAL5 0/200 10.0.0.1 200 UP
AT4/0.300 ATM AAL5 0/300 10.0.0.1 300 UP
Table A-4 describes the significant fields shown in the display.
Table A-4 show mpls l2transport vc Field Descriptions
Field
|
Description
|
Local intf
|
The interface on the local router that has been enabled to transport Layer 2 packets.
|
Local circuit
|
The type and number (if applicable) of the local circuit. The output shown in this column varies, depending on the transport type:
• For ATM cell relay and AAL5, the output shows the VPI/VCI of the PVC.
• For Ethernet VLANs, the output shows the VLAN number.
|
Dest address
|
The IP address of the remote router's interface that is the other end of the VC.
|
VC ID
|
The VC identifier assigned to one of the interfaces on the router.
|
Status
|
The status of the VC. The status can be one of the following conditions:
• UP—The VC is in a state where it can carry traffic between the two VC endpoints. A VC is up when both imposition and disposition interfaces are programmed.
– The disposition interface is programmed if the VC has been configured and the client interface is up.
– The imposition interface is programmed if the disposition interface is programmed and you have a remote VC label and an Interior Gateway Protocol (IGP) label. The IGP label can be implicit null in a back-to-back configuration. An IGP label means there is a Label Switched Path (LSP) to the peer.
• DOWN—The VC is not ready to carry traffic between the two VC endpoints. Use the detail keyword to determine the reason that the VC is down.
• ADMIN DOWN—The VC has been disabled by a user.
• RECOVERING—The VC is recovering from a stateful switchover.
|
The following example shows information about the NSF/SSO and graceful restart capability. The SSO portion indicates when checkpointing data has either been sent (on active) or received (on standby). When SSO data has not been successfully sent or has been released, the SSO information is not shown.
Router# show mpls l2transport vc detail
Local interface: Fa0/1.1 down, line protocol down, Eth VLAN 2 up
Destination address: 10.55.55.2, VC ID: 1002, VC status: down
Output interface: Fa0/0, imposed label stack {16}
Preferred path: not configured
Tunnel label: imp-null, next hop point2point
Create time: 02:03:29, last status change time: 02:03:26
Signaling protocol: LDP, peer 10.55.55.2:0 down
MPLS VC labels: local 16, remote unassigned
Group ID: local 0, remote unknown
MTU: local 1500, remote unknown
Remote interface description:
Sequencing: receive disabled, send disabled
SSO Descriptor: 10.55.55.2/1002, local label: 16
SSM segment/switch IDs: 12290/8193, PWID: 8193
packet totals: receive 0, send 0
byte totals: receive 0, send 0
packet drops: receive 0, send 0
Table A-5 describes the significant fields shown in the display.
Table A-5 show mpls l2transport vc Field Descriptions
Field
|
Description
|
Local interface
|
Interface on the local router that has been enabled to send and receive Layer 2 packets. The interface varies, depending on the transport type. The output also shows the status of the interface.
|
line protocol
|
Status of the line protocol on the edge-facing interface.
|
Destination address
|
IP address of the remote router specified for this VC. Specify the destination IP address as part of the mpls l2transport route command.
|
VC ID
|
VC identifier assigned to the interface on the router.
|
VC status
|
Status of the VC, which is one of the following conditions:
UP—The VC is in a state where it can carry traffic between the two VC endpoints. A VC is up when both imposition and disposition interfaces are programmed.
• The disposition interface is programmed if the VC has been configured and the client interface is up.
• The imposition interface is programmed if the disposition interface is programmed and a remote VC label and an IGP label exist. The IGP label can be an implicit null in a back-to-back configuration. (An IGP label means there is an LSP to the peer.)
DOWN—The VC is not ready to carry traffic between the two VC endpoints.
ADMIN DOWN—The VC has been disabled by a user.
|
Output interface
|
Interface on the remote router that has been enabled to transmit and receive Layer 2 packets.
|
imposed label stack
|
Summary of the MPLS label stack used to direct the VC to the PE router.
|
Preferred path
|
Path that was assigned to the VC and the status of that path. The path can be an MPLS traffic engineering tunnel or an IP address or hostname of a PE router.
|
Default path
|
Status of the default path, which can be disabled or active.
By default, if the preferred path fails, the router uses the default path. However, you can disable the router from using the default path when the preferred path fails by specifying the disable-fallback keyword with the preferred-path command.
|
Create time
|
Time when the VC was provisioned.
|
last status change time
|
Last time the VC state changed.
|
Signaling protocol
|
Type of protocol used to send the MPLS labels. The output also shows the status of the peer router.
|
MPLS VC labels
|
Local VC label is a disposition label, which determines the egress interface of an arriving packet from the MPLS backbone. The remote VC label is a disposition VC label of the remote peer router.
|
Group ID
|
Local group ID is used to group VCs locally. The remote group ID is used by the peer to group several VCs.
|
MTU
|
Maximum transmission unit specified for the local and remote interfaces.
|
Remote interface description
|
Interface on the remote router that has been enabled to transmit and receive Layer 2 packets.
|
Tunnel label
|
An IGP label used to route the packet over the MPLS backbone to the destination router with the egress interface. The first part of the output displays the type of label. The second part of the output displays the route information.
The tunnel label information can display any of the following states:
• imp-null—The provider (P) router is absent and the tunnel label is not to be used. Alternatively, imp-null can signify traffic engineering tunnels between the PE routers.
• unassigned—The label has not been assigned.
• no route—The label is not in the routing table.
• no adjacency—The adjacency for the next hop is missing.
• not ready, no route—An IP route for the peer does not exist in the routing table.
• not ready, not a host table—The route in the routing table for the remote peer router is not a host route.
• not ready, Cisco Express Forwarding disabled—Cisco Express Forwarding is disabled.
• not ready, label forwarding information base (LFIB) disabled—The MPLS switching subsystem is disabled.
• not ready, LFIB entry present—The tunnel label exists in the LFIB, but the VC is down.
|
SSO Descriptor
|
Identifies the VC for which the information was checkpointed.
|
local label
|
The value of the local label that was checkpointed (that is, sent on the active Route Processor [RP], and received on the standby RP).
|
SSM segment/switch IDs
|
The IDs used to refer to the control plane and data plane contexts for this VC. This data is not for customer use but for Cisco personnel for troubleshooting purposes. When the source specific multicast (SSM) IDs are followed by the word "used," the checkpointed data has been successfully sent and not released.
|
PWID
|
The PW ID used in the data plane to correlate the switching context for the segment mentioned with the MPLS switching context. This data is not for customer use but for Cisco personnel for troubleshooting purposes.
|
packet totals
|
Number of packets sent and received. Received packets are those AToM packets received from the MPLS core. Sent packets are those AToM packets sent to the MPLS core. This number does not include dropped packets.
|
byte totals
|
Number of bytes sent and received from the core-facing interface, including the payload, control word if present, and AToM VC label.
|
packet drops
|
Number of dropped packets.
|
Related Commands
Command
|
Description
|
show mpls l2transport summary
|
Displays summary information about VCs that have been enabled to route AToM Layer 2 packets on a router.
|
show network-clocks
To display information about the network clocks configured on the router, use the show network-clocks command. The command shows the priority and state of all configured clocks and the currently selected clock.
show network-clocks
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows how to use the set network-clock-select force-reselect command:
Router# show network-clocks
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
set network-clock-select force-reselect
|
This command causes the router to reselect a network clock.
|
show platform hardware
To display the status of hardware devices on the Cisco MWR 2941-DC, use the show platform hardware command. The command displays information about hardware devices on the Cisco MWR 2941-DC for troubleshooting and debugging purposes.
show platform hardware {adrian | bits | cpld | cpu | ethernet | fio | hwic | rtm | stratum | ufe
winpath} [detail] [stats]
Syntax Description
adrian
|
Displays information about the adrian hardware.
|
bits
|
Displays information about the BITS hardware.
|
cpld
|
Displays information about the CPLD hardware.
|
cpu
|
Displays information about the CPU.
|
ethernet
|
Displays information about the ethernet interfaces on the Cisco MWR 2941-DC.
|
fio
|
Displays information about the FIO fpga hardware.
|
hwic
|
Displays information about the HWICs installed on the Cisco MWR 2941-DC.
|
rtm
|
Displays information about the RTM Module (ASM-M2900-TOP daughter card).
|
stratum
|
Displays information about the stratum hardware.
|
ufe
|
Displays information about the UFE hardware.
|
winpath
|
Displays information about the Winpath hardware.
|
detail
|
Display additional detail about Cisco MWR 2941-DC hardware.
|
stats
|
Displays RTM statistics.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Related Commands
Related Commandspvc 0/40 l2transport
Related Commands encapsulation aal0
Related Commands pw-pvc 1/40
Related Commands xconnect 1.1.1.1 40 encapsulation mpls
Command
|
Description
|
show controller
|
Displays the status of system controllers.
|
show ptp clock
Displays information about the PTP clock.
show ptp clock
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was introduced.
|
Usage Guidelines
Use the show ptp clock command to display information about the PTP clock.
Examples
PTP Device Type: Ordinary clock
Clock Identity: 0x0:1E:4A:FF:FF:96:A9:9E
Offset (log variance): 52592
Local clock time: 19:58:40 UTC Oct 30 2000
Related Commands
show ptp foreign-master-record
To display the PTP foreign master record set, use the show ptp foreign-master-record command in user EXEC mode.
show ptp foreign-master-record
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was introduced.
|
Usage Guidelines
Use the show ptp foreign-master-record command to display the PTP foreign master records.
Examples
The following example shows output from the show ptp foreign-master-record command:
Router# show ptp foreign-master-record
PTP FOREIGN MASTER RECORDS
Number of foreign records 1, max foreign records 5
Foreign master port identity: clock id: 0x0:1E:4A:FF:FF:96:D2:A9
Foreign master port identity: port num: 1
Number of Announce messages: 8
Number of Current Announce messages: 6
Time stamps: 1233935406, 664274927
Related Commands
show ptp parent
To display the properties of the PTP parent, use the show ptp parent command in user EXEC mode.
show ptp parent
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was introduced.
|
Usage Guidelines
Use the show ptp parent command to display the properties of the PTP parent.
Examples
The following example shows output from the show ptp parent command:
Parent Clock Identity: 0x0:1E:4A:FF:FF:96:A9:9E
Observed Parent Offset (log variance): N/A
Observed Parent Clock Phase Change Rate: 0
Grandmaster Clock Identity: 0x0:1E:4A:FF:FF:96:A9:9E
Grandmaster Clock Quality:
Accuracy: Greater than 10s
Offset (log variance): 52592
Related Commands
show ptp port
To display the PTP port properties, use the show ptp port command in user EXEC mode.
show ptp port
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was introduced.
|
Usage Guidelines
Use the show ptp port command to o display the PTP port properties.
Examples
The following example shows output from the show ptp port command:
Port identity: clock identity: 0x0:1E:4A:FF:FF:96:A9:9E
Port identity: port number: 1
Delay request interval(log mean): 0
Announce receipt time out: 0
Announce interval(log mean): 0
Sync interval(log mean): 0
Delay Mechanism: End to End
Peer delay request interval(log mean): 0
Related Commands
show ptp time-property
To display the PTP clock time properties, use the show ptp time-property command in user EXEC mode.
show ptp time-property
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Command History
Release
|
Modification
|
12.4(12)MR2
|
This command was introduced.
|
Usage Guidelines
Use the show ptp time-property command to display PTP clock time properties.
Examples
The following example shows output from the ptp time-property command:
Router# show ptp time-property
Current UTC offset valid: 1
Related Commands
show xconnect all
To display information about xconnect attachment circuits and pseudowires (PWs), use the show xconnect all command in privileged EXEC mode.
show xconnect {all | interface interface | peer ip-address {all | vcid vcid}} [detail]
Syntax Description
all
|
Displays information about all xconnect attachment circuits and PWs.
|
interface interface
|
Displays information about xconnect attachment circuits and PWs on the specified interface. Valid values for the argument are as follows:
• atm number—Displays xconnect information for a specific ATM interface or subinterface.
• atm number vp vpi-value—Displays virtual path (VP) xconnect information for a specific ATM virtual path identifier (VPI). This command does not display information about virtual connect (VC) xconnects using the specified VPI.
• atm number vp vpi-value/vci-value—Displays VC xconnect information for a specific ATM VPI and virtual circuit identifier (VCI) combination.
• ethernet number—Displays port-mode xconnect information for a specific Ethernet interface or subinterface.
• gigabitethernet number—Displays port-mode xconnect information for a specific Fast Ethernet interface or subinterface.
• serial number—Displays xconnect information for a specific serial interface.
• serial number dlci-number—Displays xconnect information for a specific Frame Relay data-link connection identifier (DLCI).
|
peer ip-address {all | vcid vcid}
|
Displays information about xconnect attachment circuits and PWs associated with the specified peer IP address.
• all—Displays all xconnect information associated with the specified peer IP address.
• vcid vcid—Displays xconnect information associated with the specified peer IP address and the specified VC ID.
|
detail
|
(Optional) Displays detailed information about the specified xconnect attachment circuits and PWs.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
The show xconnect all command can be used to display, sort, and filter basic information about all xconnect attachment circuits and PWs.
You can use the show xconnect all command output to help determine the appropriate steps to troubleshoot an xconnect configuration problem. More specific information about a particular type of xconnect can be displayed using the commands listed in the "Related Commands" table.
Examples
The following example shows show xconnect all command output in the brief (default) display format. The output shows information about the interfaces and VCs that have been configured to transport various Layer 2 packets on the router.
Router# show xconnect all
Legend: XC ST=Xconnect State, S1=Segment1 State, S2=Segment2 State
UP=Up, DN=Down, AD=Admin Down, IA=Inactive, NH=No Hardware
XC ST Segment 1 S1 Segment 2 S2
ST Segment 1 S1 Segment 2 S2
------+---------------------------------+--+---------------------------------+--
UP ac Et0/0(Ethernet) UP mpls 10.55.55.2:1000 UP
UP ac Et1/0.1:200(Eth VLAN) UP mpls 10.55.55.2:5200 UP
IA pri ac Et1/0.2:100(Eth VLAN) UP ac Et2/0.2:100(Eth VLAN) UP
UP sec ac Et1/0.2:100(Eth VLAN) UP mpls 10.55.55.3:1101 UP
Table A-6 describes the significant fields shown in the display.
Table A-6 show xconnect all Field Descriptions
Field
|
Description
|
XC ST
|
• State of the xconnect attachment circuit or PW. Valid states are:
• UP—The xconnect attachment circuit or PW is up. Both segment 1 and segment 2 must be up for the xconnect to be up.
• DN—The xconnect attachment circuit or PW is down. Either segment 1, segment 2, or both segments are down.
• IA—The xconnect attachment circuit or PW is inactive. This state is valid only when PW redundancy is configured.
• NH—One or both segments of this xconnect no longer has the required hardware resources available to the system.
|
Segment 1
or
Segment 2
|
Information about the type of xconnect, the interface type, and the IP address the segment is using. Types of xconnects are:
• ac—Attachment circuit.
• pri ac—Primary attachment circuit.
• sec ac—Secondary attachment circuit.
• mpls—Multiprotocol Label Switching.
• l2tp—Layer 2 Tunnel Protocol.
|
S1
or
S2
|
State of the segment. Valid states are:
• UP—The segment is up.
• DN—The segment is down.
• AD—The segment is administratively down.
|
The following example shows show xconnect all command output in the detailed display format:
Router# show xconnect all detail
Legend: XC ST=Xconnect State, S1=Segment1 State, S2=Segment2 State
UP=Up, DN=Down, AD=Admin Down, IA=Inactive, NH=No HardwareXC
ST Segment 1 S1 Segment 2 S2
------+---------------------------------+--+---------------------------------+--
UP ac Et0/0(Ethernet) UP mpls 10.55.55.2:1000 UP
Interworking: ip Local VC label 16
UP ac Et1/0.1:200(Eth VLAN) UP mpls 10.55.55.2:5200 UP
Interworking: ip Local VC label 17
IA pri ac Et1/0.2:100(Eth VLAN) UP ac Et2/0.2:100(Eth VLAN) UP
Interworking: none Interworking: none
UP sec ac Et1/0.2:100(Eth VLAN) UP mpls 10.55.55.3:1101 UP
Interworking: none Local VC label 23
The additional fields displayed in the detailed output are self-explanatory.
Related Commands
Command
|
Description
|
show atm pvc
|
Displays all ATM PVCs and traffic information.
|
show atm vc
|
Displays all ATM PVCs and SVCs and traffic information.
|
show atm vp
|
Displays the statistics for all VPs on an interface or for a specific VP.
|
show connect
|
Displays configuration information about drop-and-insert connections that have been configured on a router.
|
show frame-relay pvc
|
Displays statistics about PVCs for Frame Relay interfaces.
|
show interfaces
|
Displays statistics for all interfaces configured on the router or access server.
|
show mpls l2transport binding
|
Displays VC label binding information.
|
show mpls l2transport vc
|
Displays information about AToM VCs that have been enabled to route Layer 2 packets on a router.
|
snmp-server enable traps ipran
To enable all ipran notifications through Simple Network Management Protocol (SNMP) notifications (traps) available on your system, use the snmp-server enable traps ipran command in global configuration mode. To disable ipran notifications, use the no form of this command.
snmp-server enable traps ipran
no snmp-server enable traps ipran
Related Commands
This command has no arguments or keywords.
Defaults
This command is disabled by default. No notifications are sent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the output generated by this command:
Router(config)# snmp-server enable traps ipran
Related Commands
Command
|
Description
|
snmp-server enable traps ipran alarm-gsm
|
Provides information alarms associated with GSM-Abis interfaces.
|
snmp-server enable traps ipran util
|
Provides information on backhaul utilization.
|
snmp-server enable traps ipran alarm-gsm
To provide information alarms associated with GSM-Abis interfaces through Simple Network Management Protocol (SNMP) notifications (traps) available on your system, use the snmp-server enable traps ipran alarm-gsm command in global configuration mode. To disable ipran alarm-gsm notifications, use the no form of this command.
snmp-server enable traps ipran alarm-gsm
no snmp-server enable traps ipran alarm-gsm
This statement controls the generation of the cisco IpRanBackHaulGsmAlarm notification from the CISCO-IP-RAN-BACKHAUL-MIB.
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default. No notifications are sent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the output generated by this command:
Router(config)# snmp-server enable traps ipran alarm-gsm
Related Commands
Command
|
Description
|
snmp-server enable traps ipran util
|
Provides information on backhaul utilization.
|
snmp-server enable traps ipran
|
Enables all notifications.
|
snmp-server enable traps ipran util
To provide information alarms associated with backhaul utilization through Simple Network Management Protocol (SNMP) notifications (traps) available on your system, use the snmp-server enable traps ipran util command in global configuration mode. To disable ipran utilization notifications, use the no form of this command.
snmp-server enable traps ipran util
no snmp-server enable traps ipran util
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default. No notifications are sent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the output generated by this command:
Router(config)# snmp-server enable traps ipran util
Related Commands
Command
|
Description
|
snmp-server enable traps ipran alarm-gsm
|
Provides information alarms associated with GSM-Abis interfaces.
|
snmp-server enable traps ipran
|
Enables all notifications.
|
ipran-mib backhaul-notify-interval
|
Specifies the interval used to calculate the utilization.
|
ipran-mib threshold-acceptable
|
Specifies the acceptable level of traffic.
|
ipran-mib threshold-overloaded
|
Specifies the amount of traffic that indicates the backhaul is overloaded.
|
ipran-mib threshold-warning
|
Specifies the amount of traffic that indicates the backhaul is carrying traffic sufficient to impact performance, but is not overloaded.
|
switchport backup interface
Use the switchport backup interface interface configuration command on a Layer 2 interface to configure Flex Links, a pair of interfaces that provide backup to each other. Use the no form of this command to remove the Flex Links configuration.
switchport backup interface {interface-id} preemption {delay delay-time | mode {bandwidth |
forced | off}}
no switchport backup interface {interface-id} preemption {delay delay-time | mode {bandwidth
| forced | off}}
Syntax Description
interface-id
|
The Layer 2 interface that acts as a backup link to the interface being configured. The interface can be a physical interface or port channel. The port-channel range is 1-486.
|
preemption
|
Configures a preemption scheme for a backup interface pair.
|
delay
|
(Optional) Specifies a preemption delay.
|
delay-time
|
(Optional) Specifies the length of the preemption delay; valid values are 1-300 seconds.
|
mode
|
Specifies the preemption mode as bandwidth, forced, or off.
|
bandwidth
|
(Optional) Specifies that the interface with the higher available bandwidth always preempts the backup.
|
forced
|
(Optional) Specifies that the interface always preempts the backup.
|
off
|
(Optional) Specifies that no preemption occurs from backup to active.
|
Defaults
There is no default setting.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Examples
The following example shows the output generated by this command:
Router(config)# interface gigabitethernet0/3
Router(config-if)# switchport backup interface gigabitethernet0/4
Related Commands
Command
|
Description
|
show interface switchport backup
|
Displays status information about the backup switchport.
|
xconnect
To bind an attachment circuit to a pseudowire, use the xconnect command in one of the supported configuration modes. To restore the default values, use the no form of this command.
xconnect peer-ip-address | vcid | pseudowire-parameters [ignore-vpi-vci]
no xconnect
Syntax Description
peer-ip-address
|
IP address of the remote provider edge (PE) peer. The remote router ID can be any IP address, as long as it is reachable.
|
vcid
|
The 32-bit identifier of the virtual circuit (VC) between the PE routers.
|
pseudowire-parameters
|
Encapsulation and pseudowire-class parameters to be used for the attachment circuit. At least one of the following PW parameters must be configured:
• encapsulation {l2tpv3 | mpls}— Specifies the tunneling method to encapsulate the data in the PW:
– l2tpv3—Specifies L2TPv3 as the tunneling method.
– mpls—Specifies MPLS as the tunneling method.
Note L2TP is not currently supported on the Cisco MWR 2941-DC.
• pw-class pw-class-name—Specifies the pseudowire-class configuration from which the data encapsulation type is taken. This option is mandatory if you select an encapsulation method.
|
transmit
|
Sequences data packets received from the attachment circuit.
|
receive
|
Sequences data packets sent into the attachment circuit.
|
both
|
Sequences data packets that are both sent and received from the attachment circuit.
|
one-to-one
|
Applies only when the xconnect command is configured under the AAL0 encapsulation PVC. The keyword specifies the PW type as a one-to-one VCC cell relay.
|
ignore-vpi-vci
|
This parameter sets the Cisco MWR 2941-DC to ignore the VPI/VCI value in the PW packet and rewrite the egress ATM cell header with VPI/VCI value of the locally configured (attachment side) PVC.
Note You can only use this parameter for a 1-to-1 pseudowire, for which you apply the xconnect command to a PVC.
|
Defaults
The attachment circuit is not bound to the PW.
Command Modes
CEM circuit configuration
Interface configuration
Subinterface configuration
l2transport configuration (for ATM)
Connect configuration
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
The combination of the peer-ip-address and vcid arguments must be unique on the router. Each xconnect configuration must have a unique combination of peer IP address and VCID configuration.
Note
If the remote router is a Cisco 12000 series Internet router, the peer-ip-address argument must specify a loopback address on the router.
The same vcid value that identifies the attachment circuit must be configured using the xconnect command on the local and remote PE routers. The vcid argument creates the binding between a PW and an attachment circuit.
The pw-class pw-class-name value binds the xconnect configuration of an attachment circuit to a specific pseudowire-class. In this way, the pseudowire-class configuration serves as a template that contains settings used by all attachment circuits bound to it with the xconnect command.
Note
If you specify the encapsulation keywords, you must specify the pw-class keyword.
ignore-vpi-vci Keyword
Using the xconnect command with the ignore-vpi-vci keyword provides benefits over using the pw-pvc command for PVC mapping.
Originally, PVC mapping was done through the pw-pvc pw-vpi/pw-vci command. When the MWR received the MPLS PW packet, it decoded the PW payload and looked up the PW VPI/VCI value to see if it matched any local configured PVC values. If a match was made, the PW-VPI/PW-VCI was translated to the AC-side VPI/VCI and the cell was sent to the local PVC. Without a match, the MWR dropped the received PW packet. When the MWR generated the PW packet, it used configured pw-vpi/pw-vci values. In this case, the PVC mapping was done completely on the MWR and was transparent to the remote end.
The process changes when the ignore-vpi-vci keyword is configured. For N:1 with N=1 special case, when the PW packet is received from the MWR, the receiving router ignores the VPI/VCI value contained in the PW payload. It does a blind rewrite to use the AC-side VPI/VCI and sends the cell to the AC side PVC.
The xconnect command with the ignore-vpi-vci keyword results in the PVC mapping being done in a cooperative way if the MWR works the same way as the receiving router. Without this command, the MWR checks the VPI/VCI value inside the PW packet for matches against the local configured PVC or PVC-mapping. With the ignore-vpi-vci keyword configured, the MWR ignores the VPI/VCI header inside the received PW packet and does a blind rewrite with the local configured AC-side PVC's VPI/VCI value.
Note
This process applies only to N:1 VCC PW with N=1 special case.
Examples
The following example configures xconnect service for an ATM interface by binding the ATM circuit to the PW named 123 with a remote peer 10.0.3.201. The configuration settings in the pseudowire class named ATM-xconnect are used.
Router(config)# interface ATM 0/0
Router(config-if)# xconnect 10.0.3.201 123 pw-class ATM-xconnect
Router(config-if-xconn)# exit
The following example illustrates PVC mapping using the ignore-vpi-vci keyword with the xconnect command. The example shows both the MWR and remote end (7600) routers.
MWR:
Router(config)# interface ATM 0/0
Router(config-if)# pvc 0/10 12transport
Router(config-if-atm-12trans-pvc)# encapsulation aa10
Router(config-if-atm-12trans-pvc)# xconnect 10.10.10.10 100 encapsulation mpls ignore-vpi-vci
Router(config-if-atm-12trans-pvc-xconn)# exit
Router(config-if-atm-12trans-pvc)# exit
7600:
Router(config)# interface ATM 0/0
Router(config-if)# pvc 2/20 12transport
Router(config-if-atm-12trans-pvc)# encapsulation aa10
Router(config-if-atm-12trans-pvc)# xconnect 20.20.20.20 100 encapsulation mpls
Router(config-if-atm-12trans-pvc-xconn)# exit
Router(config-if-atm-12trans-pvc)# exit
Related Commands
Command
|
Description
|
pseudowire-class
|
Configures a template of PW configuration settings used by the attachment circuits transported over a PW.
|
show xconnect
|
Displays information about xconnect attachment circuits and PWs.
|
xconnect logging redundancy
To enable system message log (syslog) reporting of the status of the xconnect redundancy group, use the xconnect logging redundancy command in global configuration mode. To disable syslog reporting of the status of the xconnect redundancy group, use the no form of this command.
xconnect logging redundancy
no xconnect logging redundancy
Syntax Description
This command has no arguments or keywords.
Defaults
Syslog reporting of the status of the xconnect redundancy group is disabled.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.4(19)MR2
|
This command was incorporated.
|
Usage Guidelines
Use this command to enable syslog reporting of the status of the xconnect redundancy group.
Examples
The following example enables syslog reporting of the status of the xconnect redundancy group and shows the messages that are generated during switchover events:
Router(config)# xconnect logging redundancy
Activating the Primary Member
00:01:07: %XCONNECT-5-REDUNDANCY: Activating primary member 10.55.55.2:1000
Activating the Backup Member:
00:01:05: %XCONNECT-5-REDUNDANCY: Activating secondary member 10.55.55.3:1001
Related Commands
Command
|
Description
|
xconnect
|
Binds an Ethernet, 802.1q VLAN, or Frame Relay attachment circuit to an Layer 2 PW for xconnect service and enters xconnect configuration mode.
|