PCEP Commands
This chapter describes the commands for Path Computation Element Protocol (PCEP).
capability
Use this command to enter PCEP capability mode.
Command Syntax
capability
Parameters
None
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 1
(config-pcep)#capability
(config-pcep-cap)#
clear pcep peer
Use this command to reset the PCEP session.
Command Syntax
clear pcep peer (A.B.C.D | X:X::X:X |*)
Parameters
A.B.C.D
PCEP IPv4 peer address
X:X::X:X
PCEP IPv6 peer address
*
All PCEP peers
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#clear pcep peer
clear pcep request
Use this command to re-trigger a PCEP request. If this command is ignored if an existing PCE request is in progress.
Command Syntax
clear pcep request (<5001-65535>|all)
Parameters
<5001-65535>
Tunnel-id
all
All tunnel interfaces
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#clear pcep request all
#show pcep request
===========================================
Path Computation Client Request Details:
===========================================
Tunnel-id : 1
Request-id : 1
Ingress : 1.1.1.1
Egress : 3.3.3.3
Bandwidth : 40m
Time due : 0 secs
State : Init
clear pcep statistics
Use this command to reset all PCEP statistics to zero.
Syntax
clear pcep statistics
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#clear pcep statistics
#show pcep statictics
===========================================
Path Computation Client Statistics Details:
===========================================
Entity Index : 1
PCE Server IP : 50.50.50.1
Open sent : 0
Open recv : 0
Path request sent : 0
Path response recv : 0
Error Sent : 0
Error received : 0
Notification Sent : 0
Notification received : 0
Keepalive Sent : 0
Keepalive received : 0
Unknown recv : 0
Corrupt recv : 0
Request cancelled : 0
Request rejected : 0
Request Timed out : 0
Request comp failed : 0
Request with reply : 0
cool-off-timeout
Use this command to set the flap dampening interval.
Use the no form of this command to set the flap dampening interval to its default value (300 seconds).
Syntax
cool-off-timeout <1-300>
Parameters
<1-300>
Flap dampening interval in seconds. The default value is 300 seconds.
Default
300 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 1
(config-pcep)#cool-off-timeout 150
deadtimer
Use this command to set the dead timer.
Use the no form of this command to set the dead timer to its default (120 seconds).
Command Syntax
deadtimer <1-255>
no deadtimer
Parameters
<1-255>
The keepalive dead interval in seconds. The default value is 120 seconds (4 times the
keepalive default value).
Default
120 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#deadtimer 98
debug pcep
Use this command to debug PCEP.
Use the no form of this command to disable debugging.
Command Syntax
debug pcep (events|error|packet|timer|update|report|request|instantiation|delegation|all)
no debug pcep (events|error|packet|timer|update|report|request|instantiation|delegation|all)
Parameters
events
Path computation client FSM events
error
Path computation client errors
packet
Path computation client packets
timer
Path computation client timers
update
Path computation update
report
Path computation report
request
Path computation request
instantiation
Path computation instantiation
delegation
Path computation delegation
all
Enable all debugging
Command Mode
Exec and Config mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#debug pcep packet
#no debug packet
exit-capability
Use this command to exit PCEP capability mode.
Command Syntax
exit-capability
Parameters
None
Command Mode
PCEP capability mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 1
(config-pcep)#capability
(config-pcep-cap)#exit-capability
(config-pcep)#
flap-limit
Use this command to set the number of flaps within the given time unit allowed by a PCE.
Use the no form of this command to set the number of flaps and time unit to their default value (0 flaps and 0 seconds).
Command Syntax
flap-limit <10-1000> <10-36000>
no flap-limit
Parameters
<10-1000>
Number of flaps allowed by PCE
<10-36000>
Time unit for flap dampening in seconds
Default
Number of flaps: 0
Time unit for flap dampening: 0 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#flap-limit 3 50
keepalive
Use this command to set the local keepalive interval.
Use the no form of this command to set the keepalive interval to its default (30 seconds).
Command Syntax
keepalive <0-255>
no keepalive
Parameters
<0-255>
Keepalive interval in seconds. The default value is 30 seconds.
Default
30 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#keepalive 200
lsp-state-timeout
Use this command to set the interval in seconds that a Path Computation Client (PCC) waits when a PCEP session is terminated before flushing the LSP state associated with that PCEP session.
Use the no form of this command set the interval to is default value (60 seconds).
Command Syntax
lsp-state-timeout (<1-600> | infinity)
no lsp-state-timeout
Parameters
<1-600>
Interval in seconds that a PCC waits when a PCEP session is terminated before flushing the LSP state. The default is 60 seconds.
infinity
Maintain state infinitely.
Default
60 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#lsp-state-timeout 10
pce configuration
Use this command to enter PCEP configuration mode and configure a PCEP client.
Use the no form of the command to remove a PCEP client configuration.
Command Syntax
pce configuration <1-255>
no pce configuration <1-255>
Parameters
<1-255>
Path computation element entity identifier
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 10
(config-pcep)#
pce init-lsp-limit
Use this command to set the number of PCE initiate messages that a PCC can process.
Use the no form of the command to set the number of PCE initiate messages to its default value (1048575 initiate messages).
Command Syntax
pce init-lsp-limit <1-1048575>
no pce init-lsp-limit
Parameters
<1-1048575>
Number of PCE initiate messages that a PCC can process. The default is 1048575 initiate messages.
Default
1048575 initiate messages
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce init-lsp-limit 7777
pce instantiation
Use this command to enable PCE-initiated LSP instantiation.
Use the no form of this command to disable PCE-initiated LSP instantiation.
Command Syntax
pce instantiation
no pce instantiation
Parameters
None
Default
PCE-initiated LSP instantiation is disabled.
Command Mode
PCEP capability mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 1
(config-pcep)#capability
(config-pcep-cap)#pce instantiation
peer-address
Use this command to configure the MD5 authentication key and delegation priority for the session.
Use the no form of the command to unset MD5 authentication key.
Command Syntax
peer-address ipv4 (A.B.C.D | X:X::X:X)(md5 WORD | delegation-priority <1-65535>|)
no peer-address ipv4 A.B.C.D (md5 | delegation-priority |)
Parameter
A.B.C.D
IPv4 address of the peer
X:X::X:X
IPv6 address of the peer
WORD
The MD5 authentication key
<1-65535>
Delegation priority of the PCEP peer
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#peer-address ipv4 1.1.1.1 md5 ipi-pcep
#configure terminal
(config)#pce configuration 127
(config-pcep)#peer-address ipv4 1.1.1.1 delegation-priority 500
redelegation-timeout
Use this command to set the timeout in seconds for how long a Path Computation Client (PCC) waits before revoking LSP delegation to a PCE and attempting to redelegate LSPs associated with the terminated PCEP session to an alternate PCE.
Use the no form of this command to set the redelegation timeout to its default (30 seconds).
Command Syntax
redelegation-timeout <1-600>
no redelegation-timeout
Parameters
<1-600>
Interval in seconds for how long a PCC waits before revoking LSP delegation to a PCE. The default is 30 seconds.
Default
30 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#redelegation-timeout 100
request-timeout
Use this command to set the amount of time a Path Computation Client (PCC) waits for a reply after sending a path computation request.
Use the no form of this command to the request timeout to its default (10 seconds).
Command Syntax
request-timeout <1-20>
no request-timeout
Parameters
<1-20>
Timeout interval for a pending request. The default value is 10 seconds.
Command Mode
10 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#request-timeout 15
show pcep client
Use this command to display information about the PCEP client.
Command Syntax
show pcep client
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#show pcep client
PCEP Client ID
Socket
Service
String
Message received
connection time
show pcep detail
Use this command to display all of the session parameters.
Command Syntax
show pcep detail
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#show pcep detail
===========================================
Path Computation Client Parameter Details :
===========================================
Open wait Timer value : 60 sec
Keep wait Timer value : 60 sec
Session Connect Timer : 60 sec
Session Connect Retry : 5
Keep alive Timer value : 30 sec
Dead Timer value : 120 sec
Request Time out value : 120 sec
PCE Initiate LSP's Limit : 1048575
show pcep pce-request
Use this command to display the requests in PCEPD module and their status. This command also displays any error messages if the reply received is not correct.
Command Syntax
show pcep pce-request
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#show pcep pce-request
===========================================
Path Computation Client Request Details :
===========================================
Tunnel-id : 1
Request-id : 1
Ingress : 1.1.1.1
Egress : 3.3.3.3
Bandwidth : 40m
Time due : 0 secs
State : In-Progress
show pcep peer
Use this command to display all PCE peers and their current states.
Command Syntax
show pcep peer
Parameters
none
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#show pcep peer
===========================================
Path Computation Client Connection Details :
PCEP entity id : 1
Peer Info
---------------------------------------------
PCE Server IP : 20.0.0.3
PCEP Local session-id : 17
PCEP Remote session-id : 1
Session Connect Retry : 0
Session Connect due in : 57 sec
OpenRetry : 0
Open wait due in : 0 sec
Keep wait due in : 0 sec
Keep alive timer due in : 27 sec
Peer Keep-alive value : 30 sec
Peer Dead timer value : 120 sec
Peer Dead timer due in : 117 sec
Peer Overloaded : No
Peer Overload due in : 0 sec
LocalOK : 1
RemoteOK : 1
Max unknown messages : 0
FSM State : Up
Total FSM State changes : 4
Peer Up time : 00:00:03
Flap Limit Timer value : 300 Sec
Local Capabilities :
Stateful PCE Capability : Yes
LSP Instantiation : Yes
SR PCE Capability : Yes
Remote Capabilities :
Stateful PCE Capability : Yes
LSP Update Capability : Yes
LSP Instantiation : Yes
SR PCE Capability : Yes
#
show pcep segment-routing srv6 path brief
Use this command to show as a list the srv6 paths processed by the Path Computation Client (PCC) with the help of an external Path Computation Element (PCE).
Command Syntax
show pcep segment-routing srv6 path brief
Parameters
None
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 6.0.0.
Example
#sh pcep segment-routing srv6 path brief
PCEP Entity : 1 Database
Policy CP PLSP-ID Oper Admin Report Delegated PCE Local-Policy Redelegation State-timeout
Name ID per lsp Status Status Enabled PCE Initiated Status in secs in secs
===========================================================================================================================
policy1 0 1 UP UP Yes 10.8.8.8 Yes No NA NA
show pcep statistics
Use this command to display the session statistics.
Command Syntax
show pcep statistics
Parameters
none
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#show pcep statictics
===========================================
Path Computation Client Statistics Details:
===========================================
Entity Index : 1
PCE Server IP : 50.50.50.1
Open sent : 2
Open recv : 1
Path request sent : 1
Path response recv : 1
Error Sent : 0
Error received : 0
Notification Sent : 0
Notification received : 0
Keepalive Sent : 33
Keepalive received : 32
Unknown recv : 0
Corrupt recv : 0
Request cancelled : 0
Request rejected : 0
Request Timed out : 0
Request comp failed : 0
Request with reply : 0
show pcep tunnel
Use this command to display information about the PCEP tunnels.
Command Syntax
show pcep tunnel brief
show pcep tunnel all
show pcep tunnel <5001-65535> pce <1-255>
Parameters
brief
Brief information
all
All tunnels
<5001-65535>
Path computation element tunnel identifier
<1-255>
Path computation element entity identifier
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#show pcep tunnel brief
PCEP Entity : 1 Database
Tunnel Tunnel Oper Admin Report Delegated PCE Local-Policy Redelegation State timeout
Name ID LSP-ID Status Status Enabled PCE Initiated Status in secs in secs
===================================================================================================================
t3 5004 2206 UP UP Yes 20.0.0.3 No No NA NA
#
tolerance deadtimer
Use this command to set the tolerance dead-timer.
Use the no form of this command to set the tolerance dead-timer to its default (0 seonds)
Command Syntax
tolerance deadtimer <1-255>
no tolerance deadtimer
Parameters
<1-255>
Tolerance dead-timer interval. The default is 0 seconds.
Default
0 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#tolerance deadtimer 50
tolerance keepalive
Use this command to set the tolerance keepalive interval.
Use the no form of this command to set the tolerance keepalive interval to its default (0 seconds).
command syntax
tolerance keepalive <1-255>
no tolerance keepalive
Parameters
<1-255>
Tolerance keepalive interval. The default is 0 seconds.
Default
0 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 127
(config-pcep)#tolerance keepalive 50
update-limit
Use this command to set the number of updates within the given time unit allowed by a PCE.
Use the no form of this command to set the number of updates and time unit to their default value (0 flaps and 0 seconds).
Command Syntax
update-limit <1-1000> <10-36000>
no update-limit
Parameters
<1-1000>
Number of updates allowed by PCE
<10-36000>
Time unit in seconds for update dampening
Default
Number of updates: 0
Time unit for update dampening: 0 seconds
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 1
(config-pcep)#update-limit 3 50
update-source
Use this command to set the source address for Path Computation Client (PCC) updates.
Use the no form of the command to delete the source address for PCC updates.
Command Syntax
update-source (A.B.C.D | X:X::X:X)
no update-source
Parameters
A.B.C.D
IPv4 source address of the PCC
X:X::X:X
IPv6 source address of the PCC
Default
The source address is null.
Command Mode
PCEP mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#pce configuration 10
(config-pcep)#update-source 20.0.0.1