-
Interface and Hardware Component Command Reference for the Cisco NCS 6000 Series Routers
-
Preface
-
Ethernet Interface Commands \n\t
-
Ethernet OAM Commands
-
Global Interface Commands
-
Link Bundling Commands
-
Management Ethernet Interface Commands
-
Null Interface Commands
-
Packet-over-SONET Interface Commands
-
PPP Commands
-
VLAN Subinterface Commands
-
10-Gigabit Ethernet\n\t WAN PHY Controller Commands
-
Index
-
Feedback
Contents
PPP Commands
This module provides command line interface (CLI) commands for configuring Point-to-Point Protocol (PPP) on the Cisco NCS 6000 Series Router.
PPP is a standard protocol used to send data over synchronous serial links. PPP also provides a Link Control Protocol (LCP) for negotiating properties of the link. LCP uses echo requests and responses to monitor the continuing availability of the link.
PPP provides the following Network Control Protocols (NCPs) for negotiating properties of data protocols that will run on the link:
- Cisco Discovery Protocol Control Protocol (CDPCP) to negotiate CDP properties
- IP Control Protocol (IPCP) to negotiate IP properties
- IP Version 6 Control Protocol (IPv6CP) to negotiate IPv6 properties
- Multiprotocol Label Switching Control Protocol (MPLSCP) to negotiate MPLS properties
- Open System Interconnection Control Protocol (OSICP) to negotiate OSI properties
- clear ppp sso state
- clear ppp statistics
- encapsulation ppp
- group
- peer ipv4 address
- ppp authentication (BNG)
- ppp chap password
- ppp chap refuse
- ppp ipcp dns
- ppp ipcp neighbor-route disable
- ppp ipcp peer-address default
- ppp max-bad-auth (BNG)
- ppp max-configure (BNG)
- ppp max-failure (BNG)
- ppp max-terminate
- ppp ms-chap hostname
- ppp ms-chap password
- ppp ms-chap refuse
- ppp multilink multiclass
- ppp multilink multiclass local
- ppp multilink multiclass remote apply
- ppp pap refuse
- ppp pap sent-username password
- ppp timeout authentication
- ppp timeout retry
- security ttl
- show ppp interfaces (BNG)
- show ppp sso alerts
- show ppp sso state
- show ppp sso summary
- ssrp group
- ssrp location
- ssrp profile
clear ppp sso state
To clear the replicated Inter-Chassis Stateful Switchover (ICSSO) states for the specified standby interface or for all interfaces on the specified node, use the clear ppp sso state command in EXEC mode.
Syntax Description
interface interface-path-id
Physical interface or virtual interface.
Note Use the show interfaces command to see a list of all interfaces currently configured on the router.
For more information about the syntax for the router, use the question mark (?) online help function.
all location node-id
Specifies the full qualified path of a specific node in the format rack/slot/module.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command sets the PPP sessions in the Standby-Up state to the Standby-Down state. All replicated data received from the peer is purged, and SSRP Request messages are re-sent to the peer.
Task ID
Examples
The following example shows how to clear the replicated ICSSO states for the specified standby interface:
RP/0/RP0/CPU0:router# clear ppp sso state interface 0/1/0/1The following example shows how to clear the replicated Inter-Chassis Stateful Switchover (ICSSO) states for all interfaces on the specified node:
RP/0/RP0/CPU0:router# clear ppp sso state all location 1/0/1clear ppp statistics
To clear all Point-to-Point Protocol (PPP) statistics for a PPP interface, use the clear ppp statistics command in EXEC mode.
Syntax Description
interface interface-path-id
Physical interface or virtual interface.
Note Use the show interfaces command to see a list of all interfaces currently configured on the router.
For more information about the syntax for the router, use the question mark (?) online help function.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
encapsulation ppp
To enable encapsulation for communication with routers or bridges using the Point-to-Point Protocol (PPP), use the encapsulation ppp command in interface configuration mode. To disable PPP encapsulation, use the no form of this command.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the encapsulation ppp command to enable PPP encapsulation on an interface.
Task ID
Examples
The following example shows how to set up PPP encapsulation on interface POS 0/1/0/1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation pppRP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router# interface serial 0/0/1/2/4:3 RP/0/RP0/CPU0:router# encapsulation pppgroup
To create a Session State Redundancy Protocol (SSRP) group and associate it with a profile, use the group command in XR config mode. To remove this group, use the no form of this command.
Syntax Description
group-id
SSRP group identifier. The range is 1 to 65535.
profile profile_name
Profile to associate with this group.
default
Associates the group to the default profile.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Any interfaces on this card can be configured to use this group. The group number must be unique across the router.
Task ID
Examples
The following example shows how to create an SSRP group:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# ssrp location 0/1/cpu0 RP/0/RP0/CPU0:router(config-ssrp-node)# group 1 profile defaultpeer ipv4 address
To configure the IPv4 address for a Session State Redundancy Protocol (SSRP) peer, use the peer ipv4 address command in SSRP configuration mode. To remove the address, use the no form of this command.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
The following example shows how to configure the IPv4 address for a Session State Redundancy Protocol (SSRP) peer:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# ssrp profile Profile_1 RP/0/RP0/CPU0:router(config-ssrp)# peer ipv4 address 10.10.10.10ppp authentication (BNG)
To enable Challenge Handshake Authentication Protocol (CHAP), MS-CHAP, or Password Authentication Protocol (PAP), and to specify the order in which CHAP, MS-CHAP, and PAP authentication is selected on the interface, use the ppp authentication command an appropriate configuration mode. To disable PPP authentication, use the no form of this command.
Syntax Description
protocol
Name of the authentication protocol used for PPP authentication. See Table 1 for the appropriate keyword. You may select one, two, or all three protocols, in any order.
list-name
(Optional) Used with authentication, authorization, and accounting (AAA). Name of a list of methods of authentication to use. If no list name is specified, the system uses the default. The list is created with the aaa authentication ppp command.
default
(Optional) Specifies the name of the list of methods created with the aaa authentication ppp command.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When you enable CHAP or PAP authentication (or both), the local router requires the remote device to prove its identity before allowing data traffic to flow. PAP authentication requires the remote device to send a name and a password, which is checked against a matching entry in the local username database or in the remote security server database. CHAP authentication sends a challenge message to the remote device. The remote device encrypts the challenge value with a shared secret and returns the encrypted value and its name to the local router in a response message. The local router attempts to match the remote device’s name with an associated secret stored in the local username or remote security server database; it uses the stored secret to encrypt 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 method specified is requested during link negotiation. If the peer suggests using the second method, or refuses the first method, the second method is tried. Some remote devices support only one method. Base the order in which you specify methods on the remote device’s ability to correctly negotiate the appropriate method, and on the level of data line security you require. PAP usernames and passwords are sent as clear text strings, which can be intercepted and reused.
Note
If you use a list-name value that was not configured with the aaa authentication ppp command, then authentication does not complete successfully and the line does not come up.
Table 1 lists the protocols used to negotiate PPP authentication.
Table 1 PPP Authentication Protocols for Negotiation Protocol
Description
chap
Enables CHAP on an interface.
ms-chap
Enables Microsoft’s version of CHAP (MS-CHAP) on an interface.
pap
Enables PAP on an interface.
Enabling or disabling PPP authentication does not affect the ability of the local router to authenticate itself to the remote device.
MS-CHAP is the Microsoft version of CHAP. Like the standard version of CHAP, MS-CHAP is used for PPP authentication. In this case, authentication occurs between a personal computer using Microsoft Windows NT 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 remote device.
Task ID
Examples
In this example, CHAP is enabled on POS 0/4/0/1 and uses the authentication list MIS-access:RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/4/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp authentication chap MIS-accessRelated Commands
Command
Description
aaa authentication ppp
Specifies one or more AAA authentication methods for use on serial interfaces running PPP.
encapsulation
Sets the encapsulation method used by the interface.
username
Configures a new user with a username, establishes a password, and grants permissions for the user.
ppp chap password
To enable a router calling a collection of routers to configure a common Challenge Handshake Authentication Protocol (CHAP) secret password, use the ppp chap password command in interface configuration mode. To disable the password, use the no form of this command.
Syntax Description
clear
(Optional) Specifies the cleartext encryption parameter for the password.
encrypted
(Optional) Indicates that the password is already encrypted.
password
Cleartext or already-encrypted password.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The ppp chap password command is sent in CHAP responses and is used by the peer to authenticate the local router. This does not affect local authentication of the peer. This command is useful for routers that do not support this command (such as routers running older Cisco IOS XR images).
The CHAP secret password is used by the routers in response to challenges from an unknown peer.
Task ID
Examples
In this example, a password (xxxx) is entered as a cleartext password:
RP/0/RP0/CPU0:router(config-if)# ppp chap password xxxxWhen the password is displayed (as shown in the following example, using the show running-config command), the password xxxx appears as 030752180500:
RP/0/RP0/CPU0:router(config)# show running-config interface POS 1/0/1/0 interface POS0/1/4/2 description Connected to P1 POS 0/1/4/3 ipv4 address 10.12.32.2 255.255.255.0 encapsulation ppp ppp authentication chap pap ppp chap password encrypted 030752180500On subsequent logins, entering any of the three following commands would have the same effect of making xxxx the password for remote CHAP authentication:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 1/0/1/0 RP/0/RP0/CPU0:router(config-if)# ppp chap password xxxx RP/0/RP0/CPU0:router(config-if)# ppp chap password clear xxxx RP/0/RP0/CPU0:router(config-if)# ppp chap password encrypted 1514190900Related Commands
Command
Description
aaa authentication ppp
Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP.
Enables CHAP, MS-CHAP, or PAP, and specifies the order in which CHAP, MS-CHAP, and PAP authentication is selected on the interface.
Refuses CHAP authentication from peers requesting it.
Configures a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries.
show running-config
Displays the contents of the currently running configuration file or the configuration for a specific interface, or map class information.
ppp chap refuse
To refuse Challenge Handshake Authentication Protocol (CHAP) authentication from peers requesting it, use the ppp chap refuse command in interface configuration mode. To allow CHAP authentication, use the no form of this command.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The ppp chap refuse command specifies that CHAP authentication is disabled for all calls, meaning that all attempts by the peer to force the user to authenticate using CHAP are refused.
If outbound Password Authentication Protocol (PAP) has been configured (using the ppp authentication command), PAP is suggested as the authentication method in the refusal packet.
Task ID
Examples
The following example shows how to specify POS interface 0/3/0/1 and disable CHAP authentication from occurring if a peer calls in requesting CHAP authentication. The method of encapsulation on the interface is PPP.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp chap refuseRelated Commands
Command
Description
aaa authentication ppp
Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP.
Enables CHAP, MS-CHAP, or PAP, and specifies the order in which CHAP, MS-CHAP, and PAP authentication is selected on the interface.
Configures a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries.
Enables remote PAP support for an interface, and includes the sent-username and password commands in the PAP authentication request packet to the peer.
ppp ipcp dns
To configure the primary and secondary Domain Name System (DNS) IP addresses for the Internet Protocol Control Protocol (IPCP), use the ppp ipcp dns command in interface configuration mode. To remove the addresses, use the no form of this command.
ppp ipcp dns primary-ip-address [sec-ip-address]
no ppp ipcp dns primary-ip-address [sec-ip-address]
Syntax Description
primary-ip-address
Primary DNS IP address, in the format A.B.C.D.
sec-ip-address
Secondary DNS IP address, in the format W.X.Y.Z.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
ppp ipcp neighbor-route disable
To disable installation of a route to the peer address negotiated by Internet Protocol Control Protocol (IPCP), use the ppp ipcp neighbor-route disable command in interface configuration mode. To re-enable installation of a route to the peer address negotiated by IPCP, use the no form of this command.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
ppp ipcp peer-address default
To specify the default IPv4 address that is assigned to the peer by the Internet Protocol Control Protocol (IPCP), use the ppp ipcp peer-address default command in interface configuration mode. To remove the address, use the no form of this command.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
ppp max-bad-auth (BNG)
To configure a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries, use the ppp max-bad-auth command in the appropriate configuration mode. To reset to the default of immediate reset, use the no form of this command.
Syntax Description
retries
Number of retries after which the interface is to reset itself. Range is from 0 to 10. Default is 0 retries.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The ppp max-bad-auth command applies to any interface on which PPP encapsulation is enabled.
Task ID
Examples
In this example, POS interface 0/3/0/1 is set to allow two additional retries after an initial authentication failure (for a total of three failed authentication attempts):RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp authentication chap RP/0/RP0/CPU0:router(config-if)# ppp max-bad-auth 3ppp max-configure (BNG)
To specify the maximum number of configure requests to attempt (without response) before stopping the requests, use the ppp max-configure command in an appropriate configuration mode. To disable the maximum number of configure requests and return to the default, use the no form of this command.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the ppp max-configure command to specify how many times an attempt is made to establish a Link Control Protocol (LCP) session between two peers for a particular interface. If a configure request message receives a reply before the maximum number of configure requests are sent, further configure requests are abandoned.
Task ID
Examples
This example shows a limit of four configure requests:RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp max-configure 4ppp max-failure (BNG)
To configure the maximum number of consecutive Configure Negative Acknowledgments (CONFNAKs) to permit before terminating a negotiation, use the ppp max-failure command in an appropriate configuration mode. To disable the maximum number of CONFNAKs and return to the default, use the no form of this command.
Syntax Description
retries
Maximum number of CONFNAKs to permit before terminating a negotiation. Range is from 2 to 10. Default is 5.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
The ppp max-failure command specifies that no more than three CONFNAKs are permitted before terminating the negotiation:RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp max-failure 3ppp max-terminate
To configure the maximum number of terminate requests (TermReqs) to send without reply before closing down the Link Control Protocol (LCP) or Network Control Protocol (NCP), use the ppp max-terminate command in interface configuration mode. To disable the maximum number of TermReqs and return to the default, use the no form of this command.
Syntax Description
number
Maximum number of TermReqs to send without reply before closing down the LCP or NCP. Range is from 2 to 10. Default is 2.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
In the following example, a maximum of five TermReqs are specified to be sent before terminating and closing LCP or NCP:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp max-terminate 5ppp ms-chap hostname
To configure the hostname for MS-CHAP authentication on an interface, use the ppp ms-chap hostname command in interface configuration mode. To remove the hostname, use the no form of this command.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
ppp ms-chap password
To configure a common Microsoft Challenge Handshake Authentication (MS-CHAP) secret password, use the ppp ms-chap password command in interface configuration mode. To disable the password, use the no form of this command.
ppp ms-chap password [ clear | encrypted ] password
no ppp ms-chap password [ clear | encrypted ] password
Syntax Description
clear
(Optional) Specifies the cleartext encryption parameter for the password.
encrypted
(Optional) Indicates that the password is already encrypted.
password
Cleartext or already-encrypted password.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The ppp ms-chap password command is sent in CHAP responses and is used by the peer to authenticate the local router. This does not affect local authentication of the peer. The ppp ms-chap password command is useful for routers that do not support this command (such as routers running older software images).
The MS-CHAP secret password is used by the routers in response to challenges from an unknown peer.
Task ID
ppp ms-chap refuse
To refuse Microsoft Challenge Handshake Authentication Protocol (MS-CHAP) authentication from peers requesting it, use the ppp ms-chap refuse command in interface configuration mode. To allow MS-CHAP authentication, use the no form of this command.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The ppp ms-chap refuse command specifies that MS-CHAP authentication is disabled for all calls, meaning that all attempts by the peer to force the user to authenticate using MS-CHAP are refused.
If outbound Password Authentication Protocol (PAP) has been configured (using the ppp authentication command), PAP is suggested as the authentication method in the refusal packet.
Task ID
Examples
This example shows how to specify POS interface 0/3/0/1 and disable MS-CHAP authentication from occurring if a peer calls in requesting MS-CHAP authentication. The method of encapsulation on the interface is PPP.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp ms-chap refuseppp multilink multiclass
To enable multiclass multilink PPP, use the ppp multilink multiclass command in interface configuration mode. To disable multiclass multilink PPP, use the no form of this command.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
ppp multilink multiclass local
To configure the initial number and maximum number of Multiclass Multilink PPP (MCMP) receive classes in a Conf-Request sent from a local host to its peer, use the ppp multilink multiclass local command in interface configuration mode. To remove these settings, use the no form of this command.
ppp multilink multiclass local initial init-number maximum max-number
no ppp multilink multiclass local initial init-number maximum max-number
Syntax Description
initial init-number
Specifies the initial number of receive classes in the Conf-Request. The range is 1 to 16.
maximum max-number
Specifies the maximum number of receive classes in the Conf-Request. The range is 1 to 16.
Command Default
When MCMP is enabled, the default initial value is 2 and the default maximum value is 4.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The maximum number of receive classes configures the number of transmission classes on the local host.
Task ID
Examples
The following example shows how to configure the initial number and maximum number of Multiclass Multilink PPP (MCMP) receive classes in a Conf-Request sent from a local host to its peer:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# interface Multilink 0/1/0/0/1 RP/0/RP0/CPU0:router(config-if)# ppp multilink multiclass local initial 1 maximum 16ppp multilink multiclass remote apply
To configure the minimum number of Multiclass Multilink PPP (MCMP) receive classes that a local host will accept from its peer in a Conf-Request, use the ppp multilink multiclass command in interface configuration mode. To remove this setting, use the no form of this command.
Syntax Description
min-number
Specifies the minimum number of receive classes in the Conf-Request. The range is 1 to 16.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command is used to coerce the peer to accept a minimum number of MCMP classes. If the peer does not accept the minimum number of MCMP classes specified by this command, the local router will not bring up the PPP link.
Task ID
Examples
The following example shows how to use the ppp multilink multicast remove apply command.
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# interface Multilink 0/1/0/0/1 RP/0/RP0/CPU0:router(config-if)# ppp multilink multiclass remote apply 16Related Commands
Command
Description
Configures the primary and secondary DNS IP addresses for the IPCP.
Disables installation of a route to the peer address negotiated by IPCP.
Specifies the default IPv4 address that is assigned to the peer by the IPCP.
Configures the hostname for MS-CHAP authentication on an interface.
ppp pap refuse
To refuse Password Authentication Protocol (PAP) authentication from peers requesting it, use the ppp pap refuse command in interface configuration mode. To allow PAP authentication, use the no form of this command.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The ppp pap refuse command specifies that PAP authentication is disabled for all calls, meaning that all attempts by the peer to force the user to authenticate using PAP are refused.
If outbound Challenge Handshake Authentication Protocol (CHAP) has been configured (using the ppp authentication command), CHAP is suggested as the authentication method in the refusal packet.
Task ID
Examples
The following example shows how to specify POS 0/3/0/1 using PPP encapsulation on the interface. This example shows PAP authentication being specified as disabled if a peer calls in requesting PAP authentication.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp pap refuseRelated Commands
Command
Description
aaa authentication ppp
Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP.
Enables CHAP, MS-CHAP, or PAP, and specifies the order in which CHAP, MS-CHAP, and PAP authentication is selected on the interface.
Configures a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries.
Enables remote PAP support for an interface, and includes the sent-username and password commands in the PAP authentication request packet to the peer.
ppp pap sent-username password
To enable remote Password Authentication Protocol (PAP) support for an interface, and to use the values specified for username and password in the PAP authentication request, use the ppp pap sent-username password command in interface configuration mode. To disable remote PAP support, use the no form of this command.
ppp pap sent-username username password [ clear | encrypted ] password
no ppp pap sent-username username password [ clear | encrypted ] password
Syntax Description
username
Username sent in the PAP authentication request.
clear
(Optional) Specifies the cleartext encryption parameter for the password.
encrypted
(Optional) Indicates that the password is already encrypted.
password
Cleartext or already-encrypted password.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the ppp pap sent-username password command to enable remote PAP support (for example, to respond to the peer’s request to authenticate with PAP) and to specify the parameters to be used when sending the PAP authentication request.
You must configure the ppp pap sent-username password command for each interface.
Task ID
Examples
In the following example, a password is entered as a cleartext password, xxxx:
RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx password notifiedWhen the password is displayed (as shown in the following example, using the show running-config command), the password notified appears as 05080F1C2243:
RP/0/RP0/CPU0:router(config-if)# show running-config interface POS0/1/0/0 description Connected to P1 POS 0/1/4/2 ipv4 address 10.12.32.2 255.255.255.0 encapsulation ppp ppp pap sent-username P2 password encrypted 05080F1C2243On subsequent logins, entering any of the three following commands would have the same effect of making xxxx the password for remote PAP authentication:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/0 RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx password notified RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx password clear notified RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx encrypted 1514190900Related Commands
Command
Description
aaa authentication ppp
Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP.
Enables CHAP, MS-CHAP, or PAP, and specifies the order in which CHAP, MS-CHAP, and PAP authentication is selected on the interface.
Refuses PAP authentication from peers requesting it
Sets PPP authentication timeout parameters.
show running-config
Displays the contents of the currently running configuration file or the configuration for a specific interface, or map class information.
ppp timeout authentication
To set PPP authentication timeout parameters, use the ppp timeout authentication command in interface configuration mode. To reset the default value, use the no form of this command.
Syntax Description
seconds
Maximum time, in seconds, to wait for a response to an authentication packet. Range is from 3 to 30 seconds. Default is 10 seconds.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The default authentication time is 10 seconds, which should allow time for a remote router to authenticate and authorize the connection and provide a response. However, it is also possible that it will take much less time than 10 seconds. In such cases, use the ppp timeout authentication command to lower the timeout period to improve connection times in the event that an authentication response is lost.
Note
The timeout affects connection times only if packets are lost.
Note
Although lowering the authentication timeout is beneficial if packets are lost, sending authentication requests faster than the peer can handle them results in churn and a slower connection time.
Task ID
Examples
In the following example, PPP timeout authentication is set to 20 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp timeout authentication 20Related Commands
ppp timeout retry
To set PPP timeout retry parameters, use the ppp timeout retry command in interface configuration mode. To reset the time value, use the no form of this command.
Syntax Description
seconds
Maximum time, in seconds, to wait for a response during PPP negotiation. Range is from 1 to 10 seconds. Default is 3 seconds.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The ppp timeout retry command is useful for setting a maximum amount of time PPP should wait for a response to any control packet it sends.
Task ID
security ttl
To specify that the time-to-live (TTL) value in the IP header of the packet is used to validate that a packet is from the expected source, use the security ttl command in SSRP configuration mode. To remove the TTL requirement, use the no form of this command.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If max-hops is not specified, the TTL value must be 255 for a packet to be accepted.
Task ID
Examples
The following example shows how to specify that the time-to-live (TTL) value in the IP header of a packet is used to validate that the packet is from the expected source:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# ssrp profile Profile_1 RP/0/RP0/CPU0:router(config-ssrp)# peer ipv4 address 10.10.10.10 RP/0/RP0/CPU0:router(config-ssrp)# security ttl max-hops number 50show ppp interfaces (BNG)
To display PPP state information for an interface, use the show ppp interfaces command in EXEC mode.
Syntax Description
brief
(Optional) Displays brief output for all interfaces on the router, for a specific POS interface instance, or for all interfaces on a specific node.
detail
(Optional) Displays detailed output for all interfaces on the router, for a specific interface instance, or for all interfaces on a specific node.
type
Interface type. For more information, use the question mark (?) online help function.
interface-path-id
Physical interface or virtual interface.
Note Use the show interfaces command to see a list of all interfaces currently configured on the router.
For more information about the syntax for the router, use the question mark (?) online help function.
all
(Optional) Displays detailed PPP information for all nodes.
location node-id
(Optional) Displays detailed PPP information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
There are seven possible PPP states applicable for either the Link Control Protocol (LCP) or the Network Control 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 interfaces on the router.
Task ID
Examples
This example shows how to display PPP state information for a POS interface:
RP/0/RP0/CPU0:router# show ppp interface POS 0/2/0/3 POS0/2/0/3 is up, line protocol is up LCP: Open Keepalives enabled (10 sec) Local MRU: 4470 bytes Peer MRU: 4470 bytes Authentication Of Us: CHAP (Completed as 'test-user') Of Peer: PAP (Completed as 'peer-user') CDPCP: Listen IPCP: Open Local IPv4 address: 55.0.0.1 Peer IPv4 address: 55.0.0.2 Peer DNS Primary: 55.0.0.254 Peer DNS Secondary: 155.0.0.254 IPV6CP: Open Local IPv6 address: fe80::3531:35ff:fe55:5747/128 Peer IPv6 address: fe80::3531:35ff:fe55:4213/128 MPLSCP: StoppedThis example shows how to display PPP state information for a POS interface that is running as a Layer 2 attachment circuit:
RP/0/0/CPU0:# show ppp interface POS0/2/0/2 POS0/2/0/2 is up, line protocol is up LCP: Open Running as L2 ACThis example shows how to display PPP state information for a multilink interface:
RP/0/RP0/CPU0:router:# show ppp interface Multilink 0/3/0/0/100 Multilink0/3/0/0/100 is up, line protocol is down LCP: Open SSO-State: Standby-Up Keepalives disabled IPCP: Open SSO-State: Standby-Up Local IPv4 address: 100.0.0.1 Peer IPv4 address: 100.0.0.2 IPV6CP: Open Local IPv6 address: fe80::3531:35ff:fe55:4600/128 Peer IPv6 address: fe80::3531:35ff:fe55:3215/128 Multilink Local MRRU: 1500 bytes Peer MRRU: 1500 bytes Local Endpoint Discriminator: 1234567812345678 Peer Endpoint Discriminator: 1111222233334444 MCMP classes: Local 4, Remote 2 Member 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 peerThis example shows how to display PPP state information for a serial interface:
RP/0/RP0/CPU0:router# show ppp interface Serial 0/3/1/3/1 Serial0/3/1/3/1 is down, line protocol is down LCP: Open SSO-State: Standby-Up Keepalives enabled (10 sec) Local MRU: 1500 bytes Peer MRU: 1500 bytes Local Bundle MRRU: 1500 bytes Peer Bundle MRRU: 1500 bytes Local Endpoint Discriminator: 1234567812345678 Peer Endpoint Discriminator: 1111222233334444 Local MCMP Classes: Not negotiated Remote MCMP Classes: Not negotiated Authentication Of Us: CHAP (Completed as 'test-user') Of Peer: PAP (Completed as 'peer-user') Multilink Multilink group id: 100 Member status: ACTIVEshow ppp sso alerts
To display all Inter-Chassis Stateful Switchover (ICSSO) alerts that have occurred, use the show ppp sso alerts command in EXEC mode.
Syntax Description
location node-id
Specifies the full qualified path of a specific node in the format rack/slot/module.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command displays the following information for alerts that have prevented a standby session from being brought to the Standby-Up state using replicated data.
- The interfaces on which the alerts have occurred
- The layer in which the error has occurred
- A short description of the error
Note
Only one error is reported for each layer for each interface. The error displayed is the most recent error that has occurred.
Task ID
Examples
The following example shows how to display all ICSSO alerts that have occurred:
RP/0/RP0/CPU0:router# show ppp sso errors location 0/3/cpu0 Intf Layer SSO Name with error Error ---------------------------------------------------------------------------- Mu0/3/0/0/100 IPCP Unsupported IPCP option 0x07 Se0/3/1/3/1:0 LCP Unacceptable value for LCP MRU option Se0/3/1/3/2:0 of-us-auth Incorrect Authentication protocol, CHAP Se0/3/1/3/3:0 of-peer-auth Invalid CHAP Authentication options Se0/3/1/3/4:0 LCP Inconsistent LCP MRRU optionsshow ppp sso state
To display the Inter-Chassis Stateful Switchover (ICSSO) states of a Point-to-Point Protocol (PPP) session running under a particular Multi-Router Automatic Protection Switching (MR-APS) group, use the show ppp sso state command in EXEC mode.
Syntax Description
group group-id
Specifies the redundancy group number. The range is 1 to 32.
location node-id
Specifies the full qualified path of a specific node in the format rack/slot/module.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command shows the states of these session layers:
Note
When an interface is in Standby mode, it is ready to forward traffic immediately after a switchover, if all the session layers, including IPCP, are in the S-Negd state.
Task ID
Examples
The following example shows how to display the ICSSO states for PPP running under a redundancy group:
RP/0/RP0/CPU0:router# show ppp sso state location 0/3/cpu0 Not-Ready : The session is not yet ready to run as Active or Standby S-UnNegd : In Standby mode, no replication state received yet A-Down : In Active mode, lower layer not yet up Deact'ing : Session was Active, now going Standby A-UnNegd : In Active mode, not fully negotiated yet S-Negd : In Standby mode, replication state received and pre-programmed Act'ing : Session was Standby and pre-programmed, now going Active A-Negd : In Active mode, fully negotiated and up - : This layer not running SSO-Group 1 | of-us of-peer Sess-ID Ifname | LCP auth auth IPCP --------------------------------+------------------------------------------- 1 Multilink0/3/0/0/100 : S-Negd S-Negd S-Negd S-Negd 2 Multilink0/3/0/0/101 : S-UnNegd S-UnNegd S-UnNegd Not-Ready 3 Serial0/3/1/3/1 : S-Negd S-Negd S-Negd - 4 Serial0/3/1/3/2 : A-Negd A-Negd A-Negd A-UnNegd 5 Serial0/3/1/3/3 : A-Down Not-Ready Not-Ready - 6 Serial0/3/1/3/4 : A-Up A-Up A-Up A-Up SSO-Group 1 | of-us of-peer Sess-ID Ifname | LCP auth auth IPCP --------------------------------+------------------------------------------- 1 Multilink0/3/0/0/102 : S-Negd S-Negd S-Negd S-Negd 2 Serial0/3/1/3/5 : S-Negd S-Negd S-Negd - 3 Serial0/3/1/3/6 : A-Negd A-Negd A-Negd A-UnNegdshow ppp sso summary
To display the number of sessions in each Inter-Chassis Stateful Switchover (ICSSO) state for each session layer, use the show ppp sso summary command in XR EXEC mode.
Syntax Description
location node-id
Specifies the full qualified path of a specific node in the format rack/slot/module.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command displays information for these session layers:
Note
Only sessions with Session State Redundancy Protocol (SSRP) configured are displayed.
Task ID
Examples
This example shows how to display the number of sessions in each ICSSO state for each session layer.
RP/0/RP0/CPU0:router# show ppp sso summary location 0/3/cpu0 Not-Ready : The session is not yet ready to run as Active or Standby Stby-UnNegd : In Standby mode, no replication state received yet Act-Down : In Active mode, lower layer not yet up Deactivating : Session was Active, now going Standby Act-UnNegd : In Active mode, not fully negotiated yet Stby-Negd : In Standby mode, replication state received and pre-programmed Activating : Session was Standby and pre-programmed, now going Active Act-Negd : In Active mode, fully negotiated and up - : This layer not running Not- Stby- Act- Deactiv- Act- Stby- Activ- Act Layer | Total Ready UnNegd Down ating UnNegd Negd ating Negd -------------+------- ------ ------ ------ ------ ------ ------ ------ ----- LCP | 20 2 5 0 0 3 6 0 4 of-us-auth | 20 10 2 0 0 1 4 0 3 of-peer-auth | 20 10 3 0 0 2 3 0 2 IPCP | 10 1 2 1 0 3 2 0 1ssrp group
To attach an Session State Redundancy Protocol (SSRP) group on an interface, use the ssrp group command in interface configuration mode. To remove the SSRP group from the interface, use the no form of this command.
Syntax Description
group-number
SSRP group number. The range is 1 to 65535.
id id-number
SSRP identifier number. The range is 1 to 4294967295.
ppp
Specifies point-to-point protocol.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The group must be configured first on a specific location (linecard) and then assigned to the interface. The redundancy ID must be unique within the group. This command specifies a list the protocols that the group can replicate. Currently only PPP is supported.
Task ID
ssrp location
To specify the node on which to create a Session State Redundancy Protocol (SSRP) group and enter the SSRP node configuration mode, use the ssrp location command in XR config mode.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The location specifies the card on which an SSRP group is created.
Task ID
ssrp profile
To configure a Session State Redundancy Protocol (SSRP) profile and enter the SSRP configuration mode, use the ssrp profile command in XR config mode. To remove the profile, use the no form of this command.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
A Session State Redundancy Protocol (SSRP) profile allows the same SSRP configuration to be shared across multiple groups. The same profile can be attached to multiple groups across the router. The group must be configured before the interface that uses the group can be configured. The group number is used in the TCP port number so, the group number must be unique across the router.
Task ID
