4.8. PCEP Configuration Command Reference

4.8.1. Command Hierarchies

  1. PCEP Commands
  2. Show Commands

4.8.1.1. PCEP Commands

config
— router
— [no] pcep
— [no] pcc
— dead-timer seconds
— no dead-timer
— keepalive seconds
— no keepalive
— local-address ip-address
— no local-address
— [no] peer ip-address
— [no] shutdown
— [no] report-path-constraints
— [no] shutdown
— unknown-message-rate msg/min
— no unknown-message-rate

4.8.1.2. Show Commands

show
— router
— pcep
— pcc
— detail
— lsp-db [lsp-type lsp_type] [delegated-pce ip-address]
— lsp-db [lsp-type lsp_type] from ip-address [delegated-pce ip-address]
— lsp-db [lsp-type lsp_type] lsp lsp-name [delegated-pce ip-address]
— lsp-db [lsp-type lsp_type] to ip-address [tunnel-id [tunnel-id]]
— lsp-db [lsp-type lsp_type] tunnel-id [tunnel-id]
— path-request [lsp-type {rsvp-p2p}] [dest ip-address] [detail]
— peer [ip-address] [detail]
— status

4.8.2. Command Descriptions

  1. PCEP Commands
  2. Show Commands

4.8.2.1. PCEP Commands

pcep

Syntax 
[no] pcep
Context 
config>router
Description 

This command enables the Path Computation Element Communication Protocol (PCEP) and enters the context to configure PCEP parameters.

The no form of the command disables PCEP.

pcc

Syntax 
[no] pcc
Context 
config>router>pcep
Description 

This command enables the context to configure PCC parameters.

dead-timer

Syntax 
dead-timer seconds
no dead-timer
Context 
config>router>pcep>pcc
Description 

This command configures the PCEP session dead timer value, which is the amount of time a PCEP speaker will wait after the receipt of the last PCEP message before declaring its peer down.

The dead timer mechanism is asymmetric, meaning that each PCEP speaker can propose a different dead timer value to its peer to use to detect session timeout.

The no form of the command returns the dead timer to the default value.

Default 

120

Parameters 
seconds—
the dead timer value, in seconds
Values—
1 to 255

 

keepalive

Syntax 
keepalive seconds
no keepalive
Context 
config>router>pcep>pcc
Description 

This command configures the PCEP session keepalive value. A PCEP speaker must send a keepalive message if no other PCEP message is sent to the peer at the expiry of this timer. This timer is restarted every time a PCEP message or keepalive message is sent.

The keepalive mechanism is asymmetric, meaning that each peer can use a different keepalive timer value at its end.

The no form of the command returns the keepalive timer to the default value.

Default 

30

Parameters 
seconds—
the keepalive value, in seconds
Values—
1 to 255

 

local-address

Syntax 
local-address ip-address
no local-address
Context 
config>router>pcep>pcc
Description 

This command configures the local address of the PCEP speaker.

The PCEP protocol operates over TCP using destination TCP port 4189. The PCE client (PCC) always initiates the connection. When the user configures the PCEP local address and the peer address on the PCC, the PCC initiates a TCP connection to the PCE. When the connection is established, the PCC and PCE exchange OPEN messages, which initializes the PCEP session and exchanges the session parameters to be negotiated.

The PCC always checks first to determine if the remote PCE address is reachable out-of-band via the management port. If the remote address is not reachable, the PCC will check if the remote PCE address is reachable in-band. When the session comes up out-of-band, the system IP address is always used. The local address configured by the user is only used for in-band sessions and is otherwise ignored.

The no form of the command removes the configured local address of the PCEP speaker.

Parameters 
ip-address—
the IP address of the PCEP speaker to be used for in-band sessions

peer

Syntax 
[no] peer ip-address
Context 
config>router>pcep>pcc
Description 

This command configures the IP address of a peer PCEP speaker. The address is used as the destination address in the PCEP session messages to a PCEP peer.

The no form of the command removes the specified peer PCEP speaker.

Parameters 
ip-address—
the IP address of the PCEP peer to be used as the destination address in the PCEP session
Values—
a.b.c.d

 

report-path-constraints

Syntax 
[no] report-path-constraints
Context 
config>router>pcep>pcc
Description 

This command enables the inclusion of LSP path constraints in the PCE report messages sent from the PCC to a PCE.

In order for the PCE to know about the original constraints for an LSP that is delegated but for which there is no prior state in its LSP database; for example, if no PCReq message was sent for the same PLSP-ID, the following proprietary behavior is observed:

  1. the PCC appends a duplicate of each of the LSPA, metric, and bandwidth objects in the PCRpt message. The only difference between two objects of the same type is that the P-flag is set in the common header of the duplicate object to indicate that it is a mandatory object for processing by the PCE.
  2. the value of the metric or bandwidth in the duplicate object contains the original constraint value, while the first object contains the operational value. This is applicable to hop metrics in the metric and bandwidth objects only. The 7705 SAR PCC does not support configuring a boundary on the path computation IGP or TE metrics.
  3. the path computation on the PCE must use the first set of objects when updating a path if the PCRpt message contained a single set. If the PCRpt message contained a duplicate set, PCE path computation must use the constraints in the duplicate set.

The no form of the command disables the above behavior in case of interoperability issues with third-party PCE implementations.

Default 

report-path-constraints

shutdown

Syntax 
[no] shutdown
Context 
config>router>pcep>pcc
config>router>pcep>pcc>peer
Description 

This command administratively disables the PCC process.

The following PCC parameters can be modified without shutting down the PCEP session:

  1. report-path-constraints
  2. unknown-message-rate

The following PCC parameters can only be modified when the PCEP session is shut down:

  1. local-address
  2. keepalive
  3. dead-timer
  4. peer
Default 

shutdown

unknown-message-rate

Syntax 
unknown-message-rate msg/min
no unknown-message-rate
Context 
config>router>pcep>pcc
Description 

This command configures the maximum rate of unknown messages that can be received during a PCEP session.

When the rate of received unrecognized or unknown messages reaches the configured limit, the PCEP speaker closes the session to the peer.

The no form of the command returns the unknown message rate to the default value.

Default 

10

Parameters 
msg/min—
the rate of unknown messages, in messages per minute
Values—
1 to 255

 

4.8.2.2. Show Commands

Note:

The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration.

detail

Syntax 
detail
Context 
show>router>pcep>pcc
Description 

This command displays PCEP PCC detailed information.

Output 

The following output is an example of PCEP PCC detailed information, and Table 32 describes the fields.

Output Example
*A:Sar18 Dut-B>show>router>pcep# pcc detail
===============================================================================
Path Computation Element Protocol (PCEP) Path Computation Client (PCC) Info
===============================================================================
Admin Status           : Down            Oper Status          : Down
Unknown Msg Limit      : 10 msg/min
Keepalive Interval     : 50 seconds      DeadTimer Interval   : 150 seconds
Capabilities List      : stateful-delegate stateful-pce rsvp-path
Address                : 10.10.10.10
Report Path Constraints: True
Open Wait Timer        : 60 seconds      Keep Wait Timer      : 60 seconds
Sync Timer             : 60 seconds      Request Timer        : 120 seconds
Connection Timer       : 60 seconds      Allow Negotiations   : False
Max Sessions           : 1               Max Unknown Req      : 1000
===============================================================================
*A:Sar18 Dut-B>show>router>pcep#
Table 32:  Show PCEP PCC Output Fields  

Label

Description

Admin Status

The administrative status of the PCC

Oper Status

The operational status of the PCC

Unknown Msg Limit

The maximum rate of unknown messages that can be received on a PCEP session

Keepalive Interval

The specified keepalive interval for the PCEP session

DeadTimer Interval

The specified dead time interval for the PCEP session

Capabilities List

The capabilities list for the PCEP session

Address

The local IP address of the PCEP speaker

Report Path Constraints

Indicates whether to include LSP path constraints in the PCE report messages sent from the PCC to a PCE

Open Wait Timer

The value of the open wait timer for the PCEP session

Keep Wait Timer

The value of the keep wait timer for the PCEP session

Sync Timer

The value of the synchronization timer for the PCEP session

Request Timer

The value of the request timer for the PCEP session

Connection Timer

The value of the keep wait timer for the PCEP session

Allow Negotiations

Indicates where negotiations between PCEP PCC and PCE are allowed

Max Sessions

The maximum number of PCEP sessions on the router

Max Unknown Req

The maximum number of unknown requests for PCEP sessions on the router

lsp-db

Syntax 
lsp-db [lsp-type lsp_type] [delegated-pce ip-address]
lsp-db [lsp-type lsp_type] from ip-address [delegated-pce ip-address]
lsp-db [lsp-type lsp_type] lsp lsp-name [delegated-pce ip-address]
lsp-db [lsp-type lsp_type] to ip-address [tunnel-id [tunnel-id]]
lsp-db [lsp-type lsp_type] tunnel-id [tunnel-id]
Context 
show>router>pcep>pcc
Description 

This command displays PCEP PCC LSP information.

Parameters 
lsp_type—
specifies the type of LSP to display. The only available option is RSVP-TE point-to-point LSPs (rsvp-p2p).
tunnel-id—
specifies a tunnel ID
Values—
0 to 65535

 

ip-address—
specifies an IPv4 address
Values—
a.b.c.d

 

Output 

The following output is an example of PCEP PCC LSP information.

Output Example
*A:7705:Dut-C# show router pcep pcc lsp-db 
===============================================================================
PCEP Path Computation Client (PCC) LSP Update Info
===============================================================================
PCEP-specific LSP ID: 1                 
LSP ID              : 21504             LSP Type            : rsvp-p2p
Tunnel ID           : 1                 Extended Tunnel Id  : 10.20.1.3
LSP Name            : test_lsp::fully_loose
Source Address      : 10.20.1.3         Destination Address : 10.20.1.1
LSP Delegated       : True              Delegate PCE Address: 138.120.210.36
Oper Status         : active            
-------------------------------------------------------------------------------
PCEP-specific LSP ID: 2                 
LSP ID              : 21510             LSP Type            : rsvp-p2p
Tunnel ID           : 1                 Extended Tunnel Id  : 10.20.1.3
LSP Name            : test_lsp::stdby_fully_loose_2
Source Address      : 10.20.1.3         Destination Address : 10.20.1.1
LSP Delegated       : True              Delegate PCE Address: 138.120.210.36
Oper Status         : up                
===============================================================================
*A:7705:Dut-C# 

path-request

Syntax 
path-request [lsp-type {rsvp-p2p}] [dest ip-address] [detail]
Context 
show>router>pcep>pcc
Description 

This command displays PCEP PCC path request information.

Parameters 
lsp-type—
specifies the type of LSP to display. The only available option is RSVP-TE point-to-point LSPs.
ip-address—
specifies the destination IPv4 address to display
Values—
a.b.c.d

 

detail—
displays detailed path request information
Output 

The following output is an example of PCEP PCC path request information.

Output Example
*A:7705:Dut-C# show router pcep pcc path-request 
===============================================================================
PCEP Path Computation Client (PCC) Path Computation Request (PCReq) Info
===============================================================================
Request ID         : 4                  Message State      : sent-for-compute
Tunnel ID          : 2                  Extended Tunnel Id : 10.20.1.3
LSP ID             : 62468              LSP Type           : rsvp-p2p
LSP Name           : test_lsp::fully_loose
Source Address     : 10.20.1.3          Destination Address: 10.20.1.1
SVEC Id            : 4                  LSP Bandwidth      : 0
===============================================================================
*A:7705:Dut-C# 

peer

Syntax 
peer [ip-address] [detail]
Context 
show>router>pcep>pcc
Description 

This command displays PCEP PCC peer information.

Parameters 
ip-address—
specifies a peer IPv4 address to display
Values—
a.b.c.d

 

detail—
displays detailed peer information
Output 

The following output is an example of a PCEP PCC peer information, and Table 33 describes the fields.

Output Example
*A:Sar18 Dut-B>show>router>pcep>pcc# peer detail
===============================================================================
PCEP Path Computation Client (PCC) Peer Info
===============================================================================
IP Address            : 10.10.10.11
Admin Status          : Down            Oper Status             : Down
Peer Capabilities     : (Not Specified)
Speaker ID            : (Undefined)
Sync State            : not-initialized Peer Overloaded         : False
Session Establish Time: 0d 00:00:00
Oper Keepalive        : N/A             Oper DeadTimer          : N/A
Session Setup Count   : 0               Session Setup Fail Count: 0
-------------------------------------------------------------------------------
Statistics Information
-------------------------------------------------------------------------------
                              Sent                     Received
-------------------------------------------------------------------------------
PC Request Message            0                        0
PC Reply Message              0                        0
PC Error Message              0                        0
PC Notification Message       0                        0
PC Keepalive Message          0                        0
PC Update Message             0                        0
PC Report Message             0                        0
Path Report                   0                        0
Path Request                  0                        0
-------------------------------------------------------------------------------
===============================================================================
*A:Sar18 Dut-B>show>router>pcep>pcc#
Table 33:  Show PCEP PCC Peer Output Fields  

Label

Description

IP Address

The IP address of the PCC peer

Admin Status

The administrative status of the PCC peer

Oper Status

The operational status of the PCC peer

Peer Capabilities

The PCEP capabilities of the PCC peer

Speaker ID

The IP address of the PCC peer speaker

Sync State

The synchronization state of the

Peer Overloaded

Indicates whether the PCC peer is overloaded

Session Establish Time

The length of time since the PCEP session was established

Oper Keepalive

The operational value for the PCC peer keepalive timer

Oper DeadTimer

The operational value for the PCC peer dead timer

Session Setup Count

The number of times that the PCEP session has been set up

Session Setup Fail Count

The number of times that the PCEP session failed to be set up

Statistics Information

PC Request Message

The number of path computation (PC) request messages sent the PCC peer and received from the PCC peer

PC Reply Message

The number of PC reply messages sent to the PCC peer and received from the PCC peer

PC Error Message

The number of PC error messages sent to the PCC peer and received from the PCC peer

PC Notification Message

The number of PC notification messages sent to the PCC peer and received from the PCC peer

PC Keepalive Message

The number of PC keepalive messages sent to the PCC peer and received from the PCC peer

PC Update Message

The number of PC update messages sent to the PCC peer and received from the PCC peer

PC Report Message

The number of PC report messages sent to the PCC peer and received from the PCC peer

Path Report

The number of path reports sent to the PCC peer and received from the PCC peer

Path Request

The path requests sent to the PCC peer and received from the PCC peer

status

Syntax 
status
Context 
show>router>pcep>pcc
Description 

This command displays PCEP PCC status information.

Output 

The following output is an example of a PCEP PCC status information, and Table 34 describes the fields.

Output Example
*A:Sar18 Dut-B>show>router>pcep>pcc# status
===============================================================================
Path Computation Element Protocol (PCEP) Path Computation Client (PCC) Info
===============================================================================
Admin Status           : Down            Oper Status          : Down
Unknown Msg Limit      : 10 msg/min
Keepalive Interval     : 50 seconds      DeadTimer Interval   : 150 seconds
Capabilities List      : stateful-delegate stateful-pce rsvp-path
Address                : 10.10.10.10
Report Path Constraints: True
-------------------------------------------------------------------------------
PCEP Path Computation Client (PCC) Peer Info
-------------------------------------------------------------------------------
Peer                       Admin State/Oper State Oper Keepalive/Oper DeadTimer
-------------------------------------------------------------------------------
10.10.10.11                Down/Down              Not-Applicable/Not-Applicable
-------------------------------------------------------------------------------
===============================================================================
*A:Sar18 Dut-B>show>router>pcep>pcc#
Table 34:  Show PCEP PCC Status Output Fields  

Label

Description

Admin Status

The administrative status of the PCC

Oper Status

The operational status of the PCC

Unknown Msg Limit

The maximum rate of unknown messages that can be received on a PCEP session

Keepalive Interval

The specified keepalive interval for the PCEP session

DeadTimer Interval

The specified dead time interval for the PCEP session

Capabilities List

The capabilities list for the PCEP session

Address

The local IP address of the PCEP speaker

Report Path Constraints

Indicates whether to include LSP path constraints in the PCE report messages sent from the PCC to a PCE

PCEP Path Computation Client (PCC) Peer Info

Peer

The IP address of the PCC peer

Admin State/Oper State

The administrative and operational states of the PCC peer

Oper Keepalive/Oper DeadTimer

The operational keepalive and dead timer intervals of the PCC peer