Monitoring PPP Interfaces
Use the following versions of the show ppp interface command to monitor PPP interfaces:
You can set a statistics baseline for PPP interfaces using the baseline ppp commands. Use the optional delta keyword with PPP show commands to show baselined statistics.
You can use the output filtering feature of the show command to include or exclude lines of output based on a text string that you specify. Refer to show Commands in JUNOSe System Basics Configuration Guide, Chapter 2, Command-Line Interface, for details.
baseline ppp interface
- Use to establish a baseline for PPP statistics on an interface.
- The router implements the baseline by reading and storing the statistics at the time the baseline is set, then subtracting this baseline whenever baseline-related statistics are retrieved.
- Use the optional delta keyword with PPP show commands to show baselined statistics.
- Examples
host1#baseline ppp interface atm 3/3.20host1#baseline ppp interface atm 3/0/3.20There is no no version. show ppp interface
- Use to display selective PPP interface information.
- You can filter the command display for characteristics of particular interest, such as interface type, data type, configured protocol, or interface state.
- Field descriptions
- PPP interfaceInterface type, interface specifier, and status (up, down, lowerDown, not present, passive, or tunnel). For more information about specifying the physical interface on which you want to configure PPP, see Interface Types and Specifiers in JUNOSe Command Reference Guide, About This Guide.
- Interface aliasAlias or description of the PPP interface
- Interface administrative statusIndicates whether the interface is administratively enabled (open), meaning that the no ppp shutdown command is operational; or administratively disabled (closed), which means that the ppp shutdown command is operational
- Configured network protocolIndicates the network protocol configured on the interface
- Baseline statusIndicates whether a statistics baseline is set
- Interface statistics
- packetsNumber of packets received (in) or transmitted (out) on the interface
- octetsNumber of octets received (in) or transmitted (out) on the interface
- errorsNumber of errors received (in) or transmitted (out) on the interface
- discardsNumber of packets discarded on receipt (in) or discarded before they were transmitted (out); for more information about the discards counter, see Rate Limiting for PPP Control Packets
- configuredIPCP is configured on this interface (true or false)
- administrative-statusIPCP administrative status (open or closed)
- ip-addressAddress to be used for negotiation of the local IP address option
- dns-precedenceUsed to resolve conflicts during negotiation of DNS addresses; "local" indicates that the local side takes precedence and the no ppp peer dns command is operative; "peer" indicates that the remote side takes precedence and the ppp peer dns command is operative
- wins-precedenceUsed to resolve conflicts during negotiation of WINS addresses; "local" indicates that the local side takes precedence and the no ppp peer wins command is operative; "peer" indicates that the remote side takes precedence and the ppp peer wins command is operative
- ipcp-netmask-optionControls negotiation of the IPCP netmask option; disabled = do not negotiate, enabled = negotiate
- configuredIPv6CP is configured on this interface (true or false)
- administrative-statusIPv6CP administrative status (open or closed)
- ipv6-interfaceIdAddress to be used for negotiation of local IPv6 address option
- operational-statusIPCP operational status (up, down, not present, or not present no resources)
- terminate-reasonReason for termination of IPCP service
- operational-statusIPv6CP operational status (up, down, not present, or not present no resources)
- terminate-reasonReason for termination of IPv6CP service
- IPCP negotiated optionsShows the following negotiated addresses for the local and remote (peer) side of the link
- ip-addressIP address
- ip-address-maskIP address mask
- primary-dns-addressPrimary DNS address
- secondary-dns-addressSecondary DNS address
- primary-wins-addressPrimary WINS address
- secondary-wins-addressSecondary WINS address
NOTE: The command displays a value of "none" for any negotiated option parameters if the option was not negotiated.
- configuredOSINLCP is configured on this interface (true or false)
- administrative-statusOSINLCP administrative status (open or closed)
- operational-statusOSINLCP operational status (up, down, not present, or not present no resources)
- terminate-reasonReason for termination of OSINLCP service
- npdu-alignmentNegotiated NPDU alignment for the local and remote (peer) side of the link
NOTE: The command displays a value of "none" for any negotiated option parameters if the option was not negotiated.
- configuredMPLSNLCP is configured on this interface (true or false)
- administrative-statusMPLSNLCP administrative status (open or closed)
- operational-statusMPLSNLCP operational status (up, down, not present, or not present no resources)
- terminate-reasonReason for termination of MPLSNLCP service
- npdu-alignmentNegotiated NPDU alignment for the local and remote (peer) side of the link
NOTE: The command displays a value of "none" for any negotiated option parameters if the option was not negotiated.
- max-receive-unitControls negotiation of the local MRU option; "use lower layer" indicates that the MRU of the layer below PPP defines the MRU to be negotiated; "disabled" indicates that the MRU option is not to be negotiated. A numeric value indicates the MRU value to be negotiated
- authenticationControls the negotiation of the local authentication option; "none" indicates do not negotiate; "chap" indicates negotiate chap; "pap" indicates negotiate pap; "chap/pap" indicates negotiate chap and, if it is rejected, negotiate pap; "pap/chap" indicates negotiate pap and, if it is rejected, negotiate chap.
- magic-numberControls whether the local magic number is negotiated: enabled (negotiate), or disabled (do not negotiate)
- magic-number-mismatchIndicates whether the router is configured to ignore the LCP peer magic number and retain the PPP connection when the peer has not negotiated an LCP magic number: ignore (ignore the peer magic number mismatch and retain the PPP connection), or reject (router terminates the PPP connection if it detects a peer magic number mismatch)
- keepalive-timerRate of LCP echo requests
- restart-timerRetry frequency during LCP, IPCP, OSINLCP, and MPLS negotiations
- max-terminateMaximum number of terminate requests
- max-configureMaximum number of configure requests
- max-failureMaximum number of configure NAKs
- passive-modeForces a PPP interface into a passive mode before LCP negotiation begins; "disabled" means do not wait for peer; "enabled" means wait for peer to initiate negotiation
- link-statusOverall status of LCP negotiations, including the following states: Initial (idle), Starting (ready to negotiate), Authenticate (authenticating), and Network (LCP is up)
- LCP negotiated optionsShows the following negotiated values for the local and remote (peer) side of the link:
- max-receive unitMaximum receive unit, in octets
- authenticationAuthentication method (none, pap, or chap)
- magic-numberMagic number
- pfcPFC (none or enabled)
- acfcACFC (none or enabled)
NOTE: The command displays a value of "none" for any negotiated option parameters if the option was not negotiated.
- local discriminator classEndpoint discriminator type, format, and address space for the local and remote (peer) router
- local endpoint discriminatorEndpoint discriminator value for the local router within the specified class
- peer discriminator classEndpoint discriminator type, format, and address space for the remote router
- peer endpoint discriminatorEndpoint discriminator value for the remote router within the specified class
- LCP protocol statisticsShows the following statistics for the life of the interface (since system boot or interface creation, whichever is later)
- in-keepalive-requestsNumber of received keepalive requests (LCP Echo Requests)
- out-keepalive-requestsNumber of transmitted keepalive requests
- in-keepalive-repliesNumber of received keepalive replies
- out-keepalive-repliesNumber of transmitted keepalive replies
- keepalive-failuresNumber of keepalive failures reported on the interface
- authenticate-retryMaximum number of authentication retries configured using the ppp max-bad-auth command
- authentication-routerVirtual router for the authentication virtual router context
- grantAuthentication status (true = access granted, false = access not granted)
- session-timeoutSession timeout, in seconds; session is terminated at expiration
- inactivity-timeoutInactivity timeout, in seconds; session is terminated if it is not active for specified timeout
- accounting-timeoutAccounting timeout in seconds; frequency of accounting updates to the authentication server
- peer-ip-addressIP address to be used in negotiation of peer IP address
- peer-ip-address-maskIP address mask to be used in negotiation of the peer IP address mask
- peer-primary-dns-addressIP address to be used in negotiation of the peer primary DNS address
- peer-secondary-dns-addressIP address to be used in negotiation of the peer secondary DNS address
- peer-primary-wins-addressIP address to be used in negotiation of the peer primary WINS address
- peer-secondary-wins-addressIP address to be used in negotiation of the peer secondary WINS address
NOTE: The command displays the authentication status as "none" for any parameters not provided by the authentication server.
- up-timeTime the session has been up, in seconds
- in-octetsNumber of octets received on the interface
- out-octetsNumber of octets transmitted out the interface
- in-packetsNumber of packets received on the interface
- out-packetsNumber of packets transmitted out the interface
- nameName toM be used in challenge packets
- challenge-retryMaximum number of challenge packets to be transmitted
- challenge-timeoutFrequency, in seconds, of challenge packet retransmission
- minimum-challenge-lengthMinimum length of challenge packet
- maximum-challenge-lengthMaximum length of challenge packet; the size of the challenge used for each challenge packet is a random number between minimum-challenge-length and maximum-challenge-length
- minimum-rechallenge-timeoutMinimum time, in seconds, before initiating a rechallenge to peer
- maximum-rechallenge-timeoutMaximum time, in seconds, before initiating a rechallenge to peer; the actual time before a rechallenge is a random number between minimum-rechallenge-timeout and maximum-rechallenge-timeout
- If the operational status is down for a specific interface, one of the following termination reasons might appear in parentheses:
- administrative disableInterface has been administratively disabled, which means that the ppp shutdown command is in effect. This applies to an interface, IPCP, IPv6CP, OSINLCP, and MPLS.
- administrative logoutInterface has been administratively logged out, which means that the logout subscriber command has been issued. This applies to an interface only.
- no upper interfaceNo upper layer is configured. This applies to an interface only.
- authentication failureAuthentication is required and has failed. This applies to an interface only.
- no local xxxlocal option, xxx, is required and could not be negotiated (for example, IP address). This applies to an interface, IPCP, IPv6CP, OSINLCP, and MPLS.
- no peer xxxRemote peer option, xxx, is required and could not be negotiated (for example, authentication). This applies to an interface, IPCP, IPv6CP, OSINLCP, and MPLS.
- keepalive drop count exceededKeepalive drop count has been exceeded. This applies to an interface only.
- session timeoutSession timeout period has expired. This applies to an interface only.
- inactivity timeoutInactivity timeout period has expired. This applies to an interface only.
- address lease expiredAddress lease period has expired. This applies to an interface only.
- not configuredProtocol is not configured on the interface. This applies to IPCP, IPv6CP, OSINLCP, and MPLS.
- link downLink is down and the protocol is not operationally up. This applies to IPCP, IPv6CP, OSINLCP, and MPLS.
- lower layer downLower protocol layer is down. This applies to an interface only.
- max configure exceededMaximum number of configure requests was exceeded while negotiations were in progress. This means that there was no response from the peer, or the peer refused to negotiate. This applies to an interface, IPCP, IPv6CP, OSINLCP, and MPLS.
- peer requested terminationRemote peer requested termination of the connection, which means that a terminate request was received while the session was in an open state. This applies to an interface, IPCP, IPv6CP, OSINLCP, and MPLS.
host1#show ppp interface atm 3/3.20 fullPPP interface ATM 3/3.20 is upInterface alias is 'interface ezu19xuy'Interface administrative status is openConfigured network protocol is IPCPIPCP protocol configurationconfigured trueadministrative-status openip-address 180.1.0.1dns-precedence localwins-precedence localipcp-netmask-option enabledIPCP protocol statusoperational-status upIPCP negotiated options local peerip-address 180.1.0.1 195.0.1.13ip-address-mask none 255.255.255.252primary-dns-address none 192.168.10.10secondary-dns-address none noneprimary-wins-address none 192.168.100.100secondary-wins-address none noneOSINLCP protocol configurationconfigured falseadministrative-status openOSINLCP protocol statusoperational-status not presentterminate-reason not configuredMPLSNLCP protocol configurationconfigured falseadministrative-status openMPLSNLCP protocol statusoperational-status not presentterminate-reason not configuredInterface statistics in outpackets 0 0octets 617 1008errors 0 0discards 384723 0LCP protocol configurationmax-receive-unit use lower layerauthentication chap/papmagic-number enabledmagic-number-mismatch ignorekeepalive-timer 0 secondsrestart-timer 3 secondsmax-terminate 2max-configure 10max-failure 5passive-mode disabledLCP protocol statuslink-status networkLCP negotiated options local peermax-receive-unit 9178 9178authentication chap nonemagic-number 0x667cdfaa 0x27012f05accm none nonepfc none noneacfc none noneLCP protocol statisticsin-keepalive-requests 0out-keepalive-requests 0in-keepalive-replies 0out-keepalive-replies 0keepalive-failures 0Authentication configurationauthenticate-retry 0authentication-router ''Authentication statusgrant truesession-timeout noneinactivity-timeout noneaccounting-timeout nonepeer-ip-address nonepeer-ip-address-mask 255.255.255.252peer-primary-dns-address 192.168.10.10peer-secondary-dns-address nonepeer-primary-wins-address nonepeer-secondary-wins-address noneAuthentication statisticsup-time 53 secondsin-octets 72out-octets 60in-packets 0out-packets 0PAP protocol configurationrequest-timeout 20 secondsCHAP protocol configurationname ''challenge-retry 10challenge-timeout 4 secondsminimum-challenge-length 16maximum-challenge-length 32minimum-rechallenge-timeout 0 secondsmaximum-rechallenge-timeout 0 secondsExample 2Provides detailed output for a particular IPv6 interface host1#show ppp interface fastEthernet 12/0.1.1 fullPPP interface FastEthernet 12/0.1.1 is lowerDownInterface administrative status is openConfigured network protocol is IPV6CPIPCP protocol configurationconfigured falseadministrative-status openip-address 0.0.0.0dns-precedence localwins-precedence localipcp-netmask-option disabledIPCP protocol statusoperational-status not presentIPV6CP protocol configurationconfigured trueadministrative-status openipv6-interfaceId 90:1a00:140:4b39IPV6CP protocol statusoperational-status downterminate-reason link downOSINLCP protocol configurationconfigured falseadministrative-status openOSINLCP protocol statusoperational-status not presentInterface statistics in outpackets 0 0octets 1163 706errors 0 0discards 153482 0LCP protocol configurationmax-receive-unit use lower layerauthentication nonemagic-number enabledmagic-number-mismatch rejectkeepalive-timer 30 secondsrestart-timer 3 secondsmax-terminate 2max-configure 10max-failure 5passive-mode disabledLCP protocol statuslink-status initialLCP protocol statisticsin-keepalive-requests 11out-keepalive-requests 11in-keepalive-replies 11out-keepalive-replies 11keepalive-failures 0Authentication configurationauthenticate-retry 0authentication-router ''aaa-profile ''Authentication statusgrant falseterminate-reason lower layer downPAP protocol configurationrequest-timeout 20 secondsCHAP protocol configurationname ''challenge-retry 10challenge-timeout 4 secondsminimum-challenge-length 16maximum-challenge-length 32minimum-rechallenge-timeout 0 secondsmaximum-rechallenge-timeout 0 secondsExample 3Displays a termination reason (administrative disable) when the operational status of the interface is down host1#show ppp interfacePPP interface pos 0/1:1 is lowerDownPPP interface pos 4/0:1 is lowerDownPPP interface pos 12/1:1 is lowerDown3 ppp interfaces foundPPP interface serial 0/0:1/1 is UpPPP interface serial 0/0:1/2 is Down (administrative disable)show ppp interface summary
- Use to display a summary of all the multilinked and nonmultilinked PPP interfaces configured on the router.
- Field descriptions
- PPP StatusNonmultilinked PPP interfaces
- Configuration statusIndicates the configuration state of the PPP interface, IPCP, IPv6CP, OSINLCP, or MPLS
- configuredInterface or protocol is configured
- notConfiguredInterface or protocol is not configured
- Administrative statusIndicates the administrative state of the PPP interface, IPCP, IPv6CP, OSINLCP, or MPLS
- openInterface or protocol is administratively enabled
- closedInterface or protocol is administratively disabled
- upInterface is operational
- downInterface is not operational because of a problem in the PPP layer
- lowerDownInterface is not operational because a lower layer in the protocol stack is down
- notPresentInterface is not operational because the hardware is unavailable
- passiveInterface is waiting for the peer to send an LCP confReq message
- tunnelInterface is being redirected through a tunnel
- Operational status (Ip, Ipv6, Osi. Mpls)Indicates the operational state of the IPCP, IPv6CP, OSINLCP, or MPLS protocol
- upProtocol is operational
- downProtocol is not operational because of a problem in the PPP layer
- notPresentProtocol is not operational because it does not exist
- noResourcesProtocol is not operational because it does not exist due to a lack of resources
host1#show ppp interface summaryPPP StatusConfiguration status configured notConfiguredInterface 4000 n/aIp 4000 0Ipv6 0 4000Osi 0 4000Mpls 0 4000Administrative status open closedInterface 4000 0Ip 4000 0Ipv6 4000 0Osi 4000 0Mpls 4000 0Operational status up down notPresent noResourcesInterface 4000 0 0 n/aIp 4000 0 0 0Ipv6 0 0 4000 0Osi 0 0 4000 0Mpls 0 0 4000 0Operational status lowerDown passive tunnelInterface 0 0 0PPP Multilink StatusConfiguration status configured notConfiguredLink Interface 8000 n/aNetwork Interface 2000 n/aIp 2000 0Ipv6 0 2000Osi 0 2000Mpls 0 2000Administrative status open closedLink Interface 8000 0Network Interface 2000 0Ip 2000 0Ipv6 2000 0Osi 2000 0Mpls 2000 0Operational status up down notPresent noResourcesLink Interface 8000 0 0 n/aNetwork Interface 2000 0 0 n/aIp 2000 0 0 0Ipv6 0 0 2000 0Osi 0 0 2000 0Mpls 0 0 2000 0Operational status lowerDown passive tunnelLink Interface 0 0 0Network Interface 0 0 0