BNG PPP Commands
This module describes the Cisco IOS XR software commands used to configure the PPP commands forBroadband Network Gateway (BNG) on the Cisco ASR 9000 Series Router. For details regarding the relatedconfigurations, refer to the Cisco ASR 9000 Series Aggregation Services Router Broadband Network GatewayConfiguration Guide.
• ppp authentication (BNG), page 2
• ppp chap, page 5
• ppp ipcp, page 7
• ppp lcp, page 9
• ppp max-bad-auth (BNG), page 11
• ppp max-configure (BNG), page 13
• ppp max-failure (BNG), page 15
• ppp ms-chap, page 17
• ppp timeout, page 19
• show ppp interfaces (BNG), page 21
• show ppp statistics, page 29
• show ppp summary, page 32
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 1
ppp authentication (BNG)To enable Challenge Handshake Authentication Protocol (CHAP), MS-CHAP, or Password AuthenticationProtocol (PAP), and to specify the order in which CHAP, MS-CHAP, and PAP authentication is selected onthe interface, use the ppp authentication command an appropriate configuration mode. To disable PPPauthentication, use the no form of this command.
ppp authentication protocol [protocol [ protocol ]] {list-name| default}
no ppp authentication
Syntax Description Name of the authentication protocol used for PPP authentication. See Table 1: PPPAuthentication Protocols for Negotiation, on page 3 for the appropriate keyword. Youmay select one, two, or all three protocols, in any order.
protocol
(Optional) Used with authentication, authorization, and accounting (AAA). Name of alist of methods of authentication to use. If no list name is specified, the system uses thedefault. The list is created with the aaa authentication ppp command.
list-name
(Optional) Specifies the name of the list of methods created with the aaa authenticationppp command.
default
Command Default PPP authentication is not enabled.
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 3.9.0
This command was supported in the dynamic template configurationmode for BNG.
Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate taskIDs. If the user group assignment is preventing you from using a command, contact your AAA administratorfor assistance.
When you enable CHAP or PAP authentication (or both), the local router requires the remote device to proveits identity before allowing data traffic to flow. PAP authentication requires the remote device to send a nameand a password, which is checked against a matching entry in the local username database or in the remotesecurity server database. CHAP authentication sends a challenge message to the remote device. The remotedevice encrypts the challenge value with a shared secret and returns the encrypted value and its name to the
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
2 OL-28446-03
BNG PPP Commandsppp authentication (BNG)
local router in a response message. The local router attempts to match the remote device’s name with anassociated secret stored in the local username or remote security server database; it uses the stored secret toencrypt the original challenge and verify that the encrypted values match.
You can enable CHAP, MS-CHAP, or PAP in any order. If you enable all three methods, the first methodspecified is requested during link negotiation. If the peer suggests using the second method, or refuses thefirst method, the second method is tried. Some remote devices support only one method. Base the order inwhich you specify methods on the remote device’s ability to correctly negotiate the appropriate method, andon the level of data line security you require. PAP usernames and passwords are sent as clear text strings,which can be intercepted and reused.
To enter the dynamic template configuration mode, run dynamic-template command in the GlobalConfiguration mode.
If you use a list-name value that was not configured with the aaa authentication ppp command, thenauthentication does not complete successfully and the line does not come up.
Note
Table 1: PPP Authentication Protocols for Negotiation, on page 3 lists the protocols used to negotiate PPPauthentication.
Table 1: PPP Authentication Protocols for Negotiation
DescriptionProtocol
Enables CHAP on an interface.chap
Enables Microsoft’s version of CHAP (MS-CHAP)on an interface.
ms-chap
Enables PAP on an interface.pap
Enabling or disabling PPP authentication does not affect the ability of the local router to authenticate itself tothe remote device.
MS-CHAP is the Microsoft version of CHAP. Like the standard version of CHAP, MS-CHAP is used forPPP authentication. In this case, authentication occurs between a personal computer usingMicrosoftWindowsNT or Microsoft Windows 95 and a Cisco router or access server acting as a network access server.
Enabling or disabling PPP authentication does not affect the local router authenticating itself to the remotedevice.
Task ID OperationsTask ID
read, writeppp
read, writeaaa
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 3
BNG PPP Commandsppp authentication (BNG)
Examples This is an example of configuring the ppp authentication command:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp authentication chap ms-chap pap
Related Commands DescriptionCommand
Configures the PPP chap hostname.ppp chap, on page 5
Sets IPCP negotiation options.ppp ipcp, on page 7
Configures the lcp global configure for PPP protocol.ppp lcp, on page 9
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
4 OL-28446-03
BNG PPP Commandsppp authentication (BNG)
ppp chapTo enable a router calling a collection of routers to configure a common Challenge Handshake AuthenticationProtocol (CHAP) for PPP interfaces, use the ppp chap command in the dynamic template configuration mode.To disable this feature, use the no form of this command.
ppp chap hostname chap_hostname
no ppp chap
Syntax Description Sets the CHAP hostname.hostname
Specifies the CHAP hostname.chap_hostname
Command Default None
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate taskIDs. If the user group assignment is preventing you from using a command, contact your AAA administratorfor assistance.
Use the dynamic-template type ppp command to enter the ppp dynamic template type configuration mode.
Task ID OperationTask ID
read, writeppp
Examples This is an example of configuring the ppp chap command in the dynamic template configuration mode:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp chap hostname host1
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 5
BNG PPP Commandsppp chap
Related Commands DescriptionCommand
Sets PPP link authentication method.ppp authentication (BNG), on page 2
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
6 OL-28446-03
BNG PPP Commandsppp chap
ppp ipcpTo set Internet Protocol Control Protocol (IPCP) negotiation options, use the ppp ipcp command in thedynamic template configuration mode. To disable this feature, use the no form of this command.
ppp ipcp [ dns{ primary_ip_address| secondary_ip_address } |mask peer_netmask_address | peer-address{default| peer_ipaddress| pool| pool_name } | renegotiation ignore | wins |primary_ipaddress|secondary_ipaddress ]
no ppp ipcp
Syntax Description Configures the dns options.dns
Specifies the primary DNS IP addresses.primary_ip_address
Specifies the secondary DNS IP addresses.secondary_ip_address
Specifies the IPv4 netmask to use for the peer.mask
Specifies the peer netmask address.peer_netmask_address
Specifies the change in peer-address configuration.peer-address
Specifies the default peer IP address.default
Specifies the peer IP address.peer_ipaddress
Configures the pool options.pool
Specifies the pool name.pool_name
Specifies the peer negotiation options.renegotiation
Specifies the WINS options.wins
Command Default None
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 4.2.0
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 7
BNG PPP Commandsppp ipcp
Usage Guidelines Use the dynamic-template type ppp command to enter the ppp dynamic template type configuration mode.
Task ID OperationTask ID
read, writeppp
read, writeaaa
Examples This is an example of configuring the ppp ipcp command in the dynamic template configuration mode:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp ipcp
Related Commands DescriptionCommand
Sets PPP link authentication method.ppp authentication (BNG), on page 2
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
8 OL-28446-03
BNG PPP Commandsppp ipcp
ppp lcpTo enable the link control protocol (LCP) on PPP interfaces, use the ppp lcp command in the dynamic templateconfiguration mode. To disable this feature, use the no form of this command.
ppp lcp [ delay delay_seconds delay_milliseconds | renegotiation ignore ]
no ppp lcp
Syntax Description Sets the time to delay before starting active LCP negotiations.delay
Specifies the delay time in seconds. The value ranges from 0-255.delay_seconds
Specifies the delay time in milliseconds. The value ranges from 0-999.delay_milliseconds
Specifies the peer renegotiation options.renegotiation
Specifies the number of attempts that can be ignored by the peer torenegotiate LCP.
ignore
Command Default None
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 4.2.0
Usage Guidelines Use the dynamic-template type ppp command to enter the ppp dynamic template type configuration mode.
Task ID OperationTask ID
read, writeppp
read, writeaaa
Examples This is an example of configuring the ppp lcp command in the dynamic template configuration mode:
RP/0/RSP0/CPU0:router# configure
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 9
BNG PPP Commandsppp lcp
RP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp lcp delay 45 890
Related Commands DescriptionCommand
Sets PPP link authentication method.ppp authentication (BNG), on page 2
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
10 OL-28446-03
BNG PPP Commandsppp lcp
ppp max-bad-auth (BNG)To configure a PPP interface not to reset itself immediately after an authentication failure but instead to allowa specified number of authentication retries, use the ppp max-bad-auth command in the appropriateconfiguration mode. To reset to the default of immediate reset, use the no form of this command.
ppp max-bad-auth retries
no ppp max-bad-auth
Syntax Description Number of retries after which the interface is to reset itself. Range is from 0 to 10.Default is 0 retries.
retries
Command Default retries: 0
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 3.9.0
This command was supported in the dynamic template configurationmode for BNG.
Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate taskIDs. If the user group assignment is preventing you from using a command, contact your AAA administratorfor assistance.
The ppp max-bad-auth command applies to any interface on which PPP encapsulation is enabled.
To enter the dynamic template configuration mode, run dynamic-template command in the GlobalConfiguration mode.
Task ID OperationsTask ID
read, writeppp
read, writeaaa
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 11
BNG PPP Commandsppp max-bad-auth (BNG)
Examples This example shows how to allow two additional retries after an initial authentication failure in the dynamictemplate configuration mode:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp max-configure 5
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
12 OL-28446-03
BNG PPP Commandsppp max-bad-auth (BNG)
ppp max-configure (BNG)To specify the maximum number of configure requests to attempt (without response) before stopping therequests, use the pppmax-configure command in an appropriate configurationmode. To disable the maximumnumber of configure requests and return to the default, use the no form of this command.
ppp max-configure retries
no ppp max-configure
Syntax Description Maximum number of retries. Range is 4 through 20. Default is 10.retries
Command Default retries: 10
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 3.9.0
This command was supported in the dynamic template configurationmode for BNG.
Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate taskIDs. If the user group assignment is preventing you from using a command, contact your AAA administratorfor assistance.
Use the ppp max-configure command to specify how many times an attempt is made to establish a LinkControl Protocol (LCP) session between two peers for a particular interface. If a configure request messagereceives a reply before the maximum number of configure requests are sent, further configure requests areabandoned.
To enter the dynamic template configuration mode, run dynamic-template command in the GlobalConfiguration mode.
Task ID OperationsTask ID
read, writeppp
read, writeaaa
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 13
BNG PPP Commandsppp max-configure (BNG)
Examples This example shows how a limit of four configure requests is specified in the dynamic template configurationmode:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp ipcp
Related Commands DescriptionCommand
Configures the maximum number of consecutive CONFNAKs topermit before terminating a negotiation.
ppp max-failure (BNG), on page 15
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
14 OL-28446-03
BNG PPP Commandsppp max-configure (BNG)
ppp max-failure (BNG)To configure the maximum number of consecutive Configure Negative Acknowledgments (CONFNAKs) topermit before terminating a negotiation, use the ppp max-failure command in an appropriate configurationmode. To disable the maximum number of CONFNAKs and return to the default, use the no form of thiscommand.
ppp max-failure retries
no ppp max-failure
Syntax Description Maximum number of CONFNAKs to permit before terminating a negotiation. Rangeis from 2 to 10. Default is 5.
retries
Command Default retries: 5
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 3.9.0
This command was supported in the dynamic template configurationmode for BNG.
Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate taskIDs. If the user group assignment is preventing you from using a command, contact your AAA administratorfor assistance.
To enter the dynamic template configuration mode, run dynamic-template command in the GlobalConfiguration mode.
Task ID OperationsTask ID
read, writeppp
read, writeaaa
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 15
BNG PPP Commandsppp max-failure (BNG)
Examples This example shows how no more than three CONFNAKs are permitted before terminating the negotiationin the dynamic template configuration mode:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp max-failure 4
Related Commands DescriptionCommand
Specifies the maximum number of configure requests to attempt(without response) before stopping the requests.
ppp max-configure (BNG), on page 13
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
16 OL-28446-03
BNG PPP Commandsppp max-failure (BNG)
ppp ms-chapTo configure CHAP using the point-to-point protocol, use the pppms-chap command in the dynamic templateconfiguration mode. To disable this feature, use the no form of this command.
ppp ms-chap hostname chap_hostname
no ppp ms-chap
Syntax Description Sets the MS-CHAP hostname.hostname
Specifies the name of the MS-CHAP hostname.chap_hostname
Command Default None
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate taskIDs. If the user group assignment is preventing you from using a command, contact your AAA administratorfor assistance.
Use the dynamic-template command to enter the dynamic template configuration mode.
Task ID OperationTask ID
read, writeppp
read, writeaaa
Examples This is an example of configuring the ppp ms-chap command in the dynamic template configuration mode:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp ms-chap hostname host1
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 17
BNG PPP Commandsppp ms-chap
Related Commands DescriptionCommand
Sets PPP link authentication method.ppp authentication (BNG), on page 2
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
18 OL-28446-03
BNG PPP Commandsppp ms-chap
ppp timeoutTo configure timeouts for PPP protocol, use the ppp timeout command in the dynamic template configurationmode. To disable this feature, use the no form of this command.
ppp timeout [ absolute absolute_minutes | authentication auth_seconds | retry retry_seconds ]
no ppp timeout
Syntax Description Specifies the absolute timeout for a PPP session.absolute
Specifies the maximum wait time to receive an authentication response.authentication
Specifies the maximum time to wait for a response during PPP negotiation.retry
Specifies the absolute timeout in minutes. This value ranges from0-70000000.
absolute_minutes
Specifies the authentication wait time in seconds. This value ranges from3-30.
auth_seconds
Specifies the retry timeout in seconds. This value ranges from 1-10.retry_seconds
Command Default None
Command Modes Dynamic template configuration
Command History ModificationRelease
This command was introduced.Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate taskIDs. If the user group assignment is preventing you from using a command, contact your AAA administratorfor assistance.
Use the dynamic-template command to enter the dynamic template configuration mode.
Task ID OperationTask ID
read, writeppp
read, writeaaa
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 19
BNG PPP Commandsppp timeout
Examples This is an example of configuring the ppp timeout command in the dynamic template configuration mode:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# dynamic-template type ppp p1RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp timeout absolute 56RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp timeout authentication 4RP/0/RSP0/CPU0:router(config-dynamic-template-type)# ppp timeout retry 5
Related Commands DescriptionCommand
Sets PPP link authentication method.ppp authentication (BNG), on page 2
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
20 OL-28446-03
BNG PPP Commandsppp timeout
show ppp interfaces (BNG)To display PPP state information for an interface, use the show ppp interfaces command in EXEC mode.
show ppp interfaces [brief| detail] {all| type interface-path-id| location node-id}
Syntax Description (Optional) Displays brief output for all interfaces onthe router, for a specific POS interface instance, orfor all interfaces on a specific node.
brief
(Optional) Displays detailed output for all interfaceson the router, for a specific interface instance, or forall interfaces on a specific node.
detail
Interface type. For more information, use the questionmark (?) online help function.
type
Physical interface or virtual interface.
Use the show interfaces command to see alist of all interfaces currently configured onthe router.
Note
For more information about the syntax for the router,use the question mark (?) online help function.
interface-path-id
(Optional) Displays detailed PPP information for allnodes.
all
(Optional) Displays detailed PPP information for thedesignated node. The node-id argument is entered inthe rack/slot/module notation.
location node-id
Command Default No default behavior or values
Command Modes EXEC mode
Command History ModificationRelease
This command was introduced.Release 3.9.0
This command was supported in the dynamic template configurationmode for BNG.
Release 4.2.0
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 21
BNG PPP Commandsshow ppp interfaces (BNG)
Usage Guidelines There are seven possible PPP states applicable for either the Link Control Protocol (LCP) or the NetworkControl Protocol (NCP).
The command output displays a summary of the interface as it is in the PPP Interface Descriptor Block (IDB).The output includes the following information (where applicable):
• Interface state
• Line protocol state
• Link Control Protocol (LCP) state
• Network Control Protocol (NCP) state
• Multilink PPP state
• Multilink PPP configuration
• Keepalive configuration
• Authentication configuration
• Negotiated MRUs
• Negotiated IP addresses
This command can display information for a single interface, all interfaces on a specified node, or all interfaceson the router.
Task ID OperationsTask ID
readppp
Examples This example shows how to display PPP state information for a POS interface:
RP/0/RSP0/CPU0:router# show ppp interface POS 0/2/0/3
POS0/2/0/3 is up, line protocol is upLCP: Open
Keepalives enabled (10 sec)Local MRU: 4470 bytesPeer MRU: 4470 bytes
AuthenticationOf Us: CHAP (Completed as 'test-user')Of Peer: PAP (Completed as 'peer-user')
CDPCP: ListenIPCP: Open
Local IPv4 address: 55.0.0.1Peer IPv4 address: 55.0.0.2Peer DNS Primary: 55.0.0.254Peer DNS Secondary: 155.0.0.254
IPV6CP: OpenLocal IPv6 address: fe80::3531:35ff:fe55:5747/128Peer IPv6 address: fe80::3531:35ff:fe55:4213/128
MPLSCP: Stopped
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
22 OL-28446-03
BNG PPP Commandsshow ppp interfaces (BNG)
This example shows how to display PPP state information for a POS interface that is running as a Layer 2attachment circuit:
RP/0/0/CPU0:# show ppp interface POS0/2/0/2
POS0/2/0/2 is up, line protocol is upLCP: Open
Running as L2 ACThis example shows how to display PPP state information for a multilink interface:
RP/0/RSP0/CPU0:router:# show ppp interface Multilink 0/3/0/0/100
Multilink0/3/0/0/100 is up, line protocol is downLCP: Open
SSO-State: Standby-UpKeepalives disabled
IPCP: OpenSSO-State: Standby-UpLocal IPv4 address: 100.0.0.1Peer IPv4 address: 100.0.0.2
IPV6CP: OpenLocal IPv6 address: fe80::3531:35ff:fe55:4600/128Peer IPv6 address: fe80::3531:35ff:fe55:3215/128
MultilinkLocal MRRU: 1500 bytesPeer MRRU: 1500 bytesLocal Endpoint Discriminator: 1234567812345678Peer Endpoint Discriminator: 1111222233334444MCMP classes: Local 4, Remote 2Member links: 2 active, 6 inactive (min-active 2)- Serial0/3/1/3/1 ACTIVE- Serial0/3/1/3/2 ACTIVE- Serial0/3/1/3/3 INACTIVE : LCP not negotiated- Serial0/3/1/3/4 INACTIVE : Mismatching peer endpoint- Serial0/3/1/3/5 INACTIVE : Mismatching peer auth name- Serial0/3/1/3/6 INACTIVE : MRRU option rejected by Peer- Serial0/3/1/3/7 INACTIVE : Mismatching local MCMP classes- Serial0/3/1/3/8 INACTIVE : MCMP option rejected by peer
This example shows how to display PPP state information for a serial interface:
RP/0/RSP0/CPU0:router# show ppp interface Serial 0/3/1/3/1
Serial0/3/1/3/1 is down, line protocol is downLCP: Open
SSO-State: Standby-UpKeepalives enabled (10 sec)Local MRU: 1500 bytesPeer MRU: 1500 bytesLocal Bundle MRRU: 1500 bytesPeer Bundle MRRU: 1500 bytesLocal Endpoint Discriminator: 1234567812345678Peer Endpoint Discriminator: 1111222233334444Local MCMP Classes: Not negotiatedRemote MCMP Classes: Not negotiated
AuthenticationOf Us: CHAP (Completed as 'test-user')Of Peer: PAP (Completed as 'peer-user')
MultilinkMultilink group id: 100Member status: ACTIVE
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 23
BNG PPP Commandsshow ppp interfaces (BNG)
Table 2: show ppp interfaces Field Descriptions
DescriptionField
Configuration acknowledgemt was received; waitingfor peer to send configuration request.
Ack-Rcvd
Configuration acknowledgemt was sent; waiting forpeer to respond to configuration request.
Ack-Sent
Type of user authentication configured on the localequipment and on the peer equipment. Possible PPPauthentication protocols are Challenge HandshakeAuthentication Protocol (CHAP), MS-CHAP, andPassword Authentication Protocol (PAP).
Authentication
Lower layer is up, but this layer is not required.Closed
Shutting down due to local change.Closing
Connection is idle.Initial
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
24 OL-28446-03
BNG PPP Commandsshow ppp interfaces (BNG)
DescriptionField
IP Control Protocol (IPCP) state. The seven possiblestates that may be displayed are as follows:
• Initial—Lower layer is unavailable (Down), andno Open has occurred. The Restart timer is notrunning in the Initial state.
• Starting—An administrative Open has beeninitiated, but the lower layer is still unavailable(Down). The Restart timer is not running in theStarting state. When the lower layer becomesavailable (Up), a Configure-Request is sent.
• Closed— IPCP is not currently trying tonegotiate.
• Stopped—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received.
• Closing—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received. Uponreception of a Terminate-Ack, the Closed stateis entered. Upon the expiration of the Restarttimer, a new Terminate-Request is transmitted,and the Restart timer is restarted. After theRestart timer has expiredMax-Terminate times,the Closed state is entered.
• Stopping—A Terminate-Request has been sentand the Restart timer is running, but a IPCP-Ackhas not yet been received. Req-Sent.
• ACKsent—IPCP has received a request and hasreplied to it.
• ACKrcvd—IPCP has received a reply to arequest it sent.
• Open—IPCP is functioning properly.
IPCP
Keepalive setting and interval in seconds for echorequest packets.
Keepalive
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 25
BNG PPP Commandsshow ppp interfaces (BNG)
DescriptionField
Indicates the current state of LCP. The state of theLCP will report the following states:
• Initial—Lower layer is unavailable (Down), andno Open has occurred. The Restart timer is notrunning in the Initial state.
• Starting—An administrative Open has beeninitiated, but the lower layer is still unavailable(Down). The Restart timer is not running in theStarting state. When the lower layer becomesavailable (Up), a Configure-Request is sent.
• Closed— LCP is not currently trying tonegotiate.
• Stopped—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received.
• Closing—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received. Uponreception of a Terminate-Ack, the Closed stateis entered. Upon the expiration of the Restarttimer, a new Terminate-Request is transmitted,and the Restart timer is restarted. After theRestart timer has expiredMax-Terminate times,the Closed state is entered.
• Stopping—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received.Req-Sent.
• ACKsent—LCP has received a request and hasreplied to it.
• ACKrcvd—LCP has received a reply to arequest it sent.
• Open—LCP is functioning properly
LCP
IPv4 address for the local interface.Local IPv4 address
Maximum receive unit. The maximum size of theinformation transported, in bytes, in the PPP packetreceived by the local equipment.
Local MRU
Connection open.Open
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
26 OL-28446-03
BNG PPP Commandsshow ppp interfaces (BNG)
DescriptionField
Open System Interconnection Control Protocol(OSICP) state. The possible states that may bedisplayed are as follows:
• Initial—Lower layer is unavailable (Down), andno Open has occurred. The Restart timer is notrunning in the Initial state.
• Starting—An administrative Open has beeninitiated, but the lower layer is still unavailable(Down). The Restart timer is not running in theStarting state. When the lower layer becomesavailable (Up), a Configure-Request is sent.
• Closed— OSICP is not currently trying tonegotiate.
• Stopped—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received.
• Closing—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received. Uponreception of a Terminate-Ack, the Closed stateis entered. Upon the expiration of the Restarttimer, a new Terminate-Request is transmitted,and the Restart timer is restarted. After theRestart timer has expiredMax-Terminate times,the Closed state is entered.
• Stopping—A Terminate-Request has been sentand the Restart timer is running, but aTerminate-Ack has not yet been received.Req-Sent.
• ACKsent—OSICP has received a request andhas replied to it.
• ACKrcvd—OSICP has received a reply to arequest it sent.
• Open—OSICP is functioning properly.
OSICP
IPv4 address for the peer equipment.Peer IPv4 address
Maximum receive unit. The maximum size of theinformation transported, in bytes, in the PPP packetreceived by the peer equipment.
Peer MRU
Configuration request was sent; waiting for peer torespond.
Req-Sent
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 27
BNG PPP Commandsshow ppp interfaces (BNG)
DescriptionField
This layer is required, but lower layer is down.Starting
Listening for a configuration request.Stopped
Shutting down as a result of interactions with peer.Stopping
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
28 OL-28446-03
BNG PPP Commandsshow ppp interfaces (BNG)
show ppp statisticsTo display the statistics information for PPP interfaces, use the show ppp statistics command in EXECmode.
show ppp statistics{extended| {location| location}| interface| {interface-type| interface-path-id}| summary|{location| location}}
Syntax Description Displays the extended PPP statistics across allinterfaces.
extended
Displays the PPP statistics for a single interface.interface
Displays aggregated PPP statistics across allinterfaces.
summary
Displays the PPP statistics for interfaces at a location.location
Specifies the location details.location
Interface type. For more information, use the questionmark (?) online help function.
type
Physical interface or virtual interface.
Use the show interfaces command to see alist of all interfaces currently configured onthe router.
Note
For more information about the syntax for the router,use the question mark (?) online help function.
interface-path-id
Command Default None
Command Modes EXEC mode
Command History ModificationRelease
This command was introduced.Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper taskIDs. If you suspect user group assignment is preventing you from using a command, contact your AAAadministrator for assistance.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 29
BNG PPP Commandsshow ppp statistics
Task ID OperationTask ID
readppp
Examples This example shows the output of the show ppp statistics command:
RP/0/RSP0/CPU0:router# show ppp statistics summary location 0/RSP0/CPU0
Thu Sep 6 06:38:17.668 DSTLCPPackets Sent ReceivedConf-Req 0 0Conf-Ack 0 0Conf-Nak 0 0Conf-Rej 0 0Term-Req 0 0Term-Ack 0 0Code-Rej 0 0Proto-Rej 0 0Echo-Req 0 0Echo-Rep 0 0Disc-Req 0 0Line state brought up: 0Keepalive Link Failures: 0AuthenticationPackets Sent ReceivedPAPRequest 0 0Ack 0 0Nak 0 0(MS-)CHAPChallenge 0 0Response 0 0Rep Success 0 0Rep Fail 0 0AAA authentication timeouts: 0CDPCPPackets Sent ReceivedConf-Req 0 0Conf-Ack 0 0Conf-Nak 0 0Conf-Rej 0 0Term-Req 0 0Term-Ack 0 0Proto-Rej 0 0IPCPPackets Sent ReceivedConf-Req 0 0Conf-Ack 0 0Conf-Nak 0 0Conf-Rej 0 0Term-Req 0 0Term-Ack 0 0Proto-Rej 0 0IPCPIWPackets Sent ReceivedConf-Req 0 0Conf-Ack 0 0Conf-Nak 0 0Conf-Rej 0 0Term-Req 0 0Term-Ack 0 0Proto-Rej 0 0IPv6CP
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
30 OL-28446-03
BNG PPP Commandsshow ppp statistics
Packets Sent ReceivedConf-Req 0 0Conf-Ack 0 0Conf-Nak 0 0Conf-Rej 0 0Term-Req 0 0Term-Ack 0 0Proto-Rej 0 0MPLSCPPackets Sent ReceivedConf-Req 0 0Conf-Ack 0 0Conf-Nak 0 0Conf-Rej 0 0Term-Req 0 0Term-Ack 0 0Proto-Rej 0 0OSICPPackets Sent ReceivedConf-Req 0 0Conf-Ack 0 0Conf-Nak 0 0Conf-Rej 0 0Term-Req 0 0Term-Ack 0 0Proto-Rej 0 0
Related Commands DescriptionCommand
Displays the PPP interfaces.show ppp interfaces (BNG), on page 21
Displays the PPP summary.show ppp summary, on page 32
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 31
BNG PPP Commandsshow ppp statistics
show ppp summaryTo display the summary information for the PPP interfaces, use the show ppp summary command in EXECmode.
show ppp summary location location
Syntax Description Displays the PPP summary for interfaces at a location.location
Specifies the location details.location
Command Default None
Command Modes EXEC mode
Command History ModificationRelease
This command was introduced.Release 4.2.0
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper taskIDs. If you suspect user group assignment is preventing you from using a command, contact your AAAadministrator for assistance.
Task ID OperationTask ID
readppp
Examples This example shows the output of the show ppp summary command for interfaces running PPP:
RP/0/RSP0/CPU0:router# show ppp summary location 0/5/CPU0
====================================Interfaces running PPP====================================POS 0Serial 200PPPoE 10000Multilink Bundles 100----------------------------Total 10300
====================================
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference,Release 4.3.x
32 OL-28446-03
BNG PPP Commandsshow ppp summary
CP FSM States====================================
ACK ACK REQ Stop- Clos- Stop- Clos- Start-Name Total Open sent rcvd sent ping ing ped ed ing Initial------ ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- -----LCP 10300 10300 0 0 0 0 0 0 0 0 0CDPCP 100 0 0 0 100 0 0 0 0 0 0IPCP 10000 10000 0 0 0 0 0 0 0 0 0IPv6CP 0 0 0 0 0 0 0 0 0 0 0MPLSCP 0 0 0 0 0 0 0 0 0 0 0OSICP 0 0 0 0 0 0 0 0 0 0 0
====================================LCP/Authentication Phases====================================LCP Not Negotiated 100Authenticating 0Line held down 0Line Up (Local Termination) 10200Line Up (L2 Forwarded) 0Line UP (VPDN Tunneled) 100
Related Commands DescriptionCommand
Displays the PPP statistics.show ppp statistics, on page 29
Displays the PPP interfaces.show ppp interfaces (BNG), on page 21
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release4.3.x
OL-28446-03 33
BNG PPP Commandsshow ppp summary