4.7. PCEP Configuration Command Reference

4.7.1. Command Hierarchies

  1. PCEP Commands
  2. Show Commands
  3. Tools Commands

4.7.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.7.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.7.1.3. Tools Commands

tools
— dump
— router
— pcep
— pcc lsp [plsp-id plsp-id]
— pcc lsp lsp-type lsp-type [tunnel-id tunnel-id]

4.7.2. Command Descriptions

  1. PCEP Commands
  2. Show Commands
  3. Tools Commands

4.7.2.1. PCEP Commands

pcep

Syntax 
[no] pcep
Context 
config>router
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

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

The no form of this command disables PCEP.

pcc

Syntax 
[no] pcc
Context 
config>router>pcep
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure PCC parameters.

The no form of this command disables PCC.

dead-timer

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

Supported on all 7210 SAS platforms as described in this document

Description 

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

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

The no form of this command reverts to the default value.

Default 

120

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

 

keepalive

Syntax 
keepalive seconds
no keepalive
Context 
config>router>pcep>pcc
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

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, which means that each peer can use a different keepalive timer value at its end.

The no form of this command reverts to the default value.

Default 

30

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

 

local-address

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

Supported on all 7210 SAS platforms as described in this document

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 checks if the remote PCE address is reachable in-band. Out-of-band sessions are not supported.

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

Parameters 
ip-address—
Specifies 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
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

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 this command removes the specified peer PCEP speaker.

Parameters 
ip-address—
Specifies 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
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

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

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 applies:

  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 7210 SAS 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 this command disables the preceding 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
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

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

The no form of this command administratively enables the PCC process.

Default 

shutdown

unknown-message-rate

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

Supported on all 7210 SAS platforms as described in this document

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 this command reverts to the default value.

Default 

10

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

 

4.7.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
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays PCEP PCC detailed information.

Output 

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

Sample Output
*A:ZBG>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:ZBG>show>router>pcep#
Table 31:  Output Fields: PCEP PCC 

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
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

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—
1 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, and Table 32 describes the output fields.

Sample Output
*A:ZBG# 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: 10.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: 10.120.210.36
Oper Status         : up                
===============================================================================
*A:ZBG# 
Table 32:  Output Fields: PCEP PCC LSP  

Label

Description

PCEP-specific LSP ID

The PCEP-specific LSP identifier

LSP ID

The LSP identifier

Tunnel ID

The tunnel identifier for the LSP

LSP Name

The configured LSP name

Source Address

The source IP address of the LSP

LSP Delegated

The delegation status of the LSP

Oper Status

The operational status of the LSP

LSP Type

The type of the LSP

Extended Tunnel Id

The expanded tunnel identifier for the LSP

Destination Address

The destination IP address of the LSP

Delegate PCE Address

The IP address of the delegate PCE router

path-request

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

Supported on all 7210 SAS platforms as described in this document

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, and Table 33 describes the output fields.

Sample Output
*A:ZBG# 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:ZBG# 
Table 33:  Output Fields: PCEP PCC Path Request  

Label

Description

Request ID

The PCEP PCC path request identifier

Tunnel ID

The tunnel identifier for the LSP

LSP ID

The LSP identifier

LSP Name

The configured LSP name

Source Address

The source IP address of the LSP

SVEC Id

The synchronization vector identifier

Message State

The current state of the request

Extended Tunnel Id

The expanded tunnel identifier for the LSP

LSP Type

The type of the LSP

Destination Address

The destination IP address of the LSP

LSP Bandwidth

The bandwidth of the LSP

peer

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

Supported on all 7210 SAS platforms as described in this document

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 34 describes the output fields.

Sample Output
*A:ZBG>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:ZBG>show>router>pcep>pcc#
Table 34:  Output Fields: PCEP PCC Peer 

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
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays PCEP PCC status information.

Output 

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

Sample Output
*A:ZBG>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:ZBG>show>router>pcep>pcc#
Table 35:  Output Fields: PCEP PCC Status  

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

4.7.2.3. Tools Commands

pcc

Syntax 
pcc lsp [plsp-id plsp-id]
pcc lsp lsp-type lsp-type [tunnel-id tunnel-id]
Context 
tools>dump>router>pcep
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays PCEP PCC LSP information.

Parameters 
lsp—
Keyword used to display LSP information.
plsp-id—
Specifies the ID of a PCC LSP. Only information for the PCC LSP with the specified ID is displayed.
Values—
1 to 1048575

 

lsp-type—
Specifies an LSP type. Only information for LSPs matching the specified type is displayed.
Values—
rsvp-p2p

 

tunnel-id—
Specifies a tunnel ID. Only information for the tunnel with the specified ID is displayed.
Values—
1 to 65535