4.7. PCEP Configuration Command Reference

Note:

PCEP commands are only supported on the 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12.

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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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, 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 returns the dead timer to the default value.

Default 

dead-timer 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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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 returns the keepalive timer to the default value.

Default 

keepalive 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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

Description 

This command configures the local address of the PCEP speaker.

The PCEP 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 through the management port. If the remote address is not reachable, the PCC checks if the remote PCE address is reachable in-band. If 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 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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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

Special Cases 
PCEP Protocol Handling for 7210 SAS-Mxp—
When the no shutdown command is issued in the configure>router>pcep>pcc context, resources are allocated to enable processing of the protocol by the node. When you issue the configure>router>pcep>pcc>shutdown command, the resources are deallocated.

unknown-message-rate

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

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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 returns the unknown message rate to the default value.

Default 

unknown-message-rate 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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

Description 

This command displays detailed information about PCEP PCC.

Output 

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

Output Example
*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 35:  Output Fields: PCEP PCC 

Label

Description

Admin Status

Displays the administrative status of the PCC

Oper Status

Displays the operational status of the PCC

Unknown Msg Limit

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

Keepalive Interval

Displays the specified keepalive interval for the PCEP session

DeadTimer Interval

Displays the specified dead time interval for the PCEP session

Capabilities List

Displays the capabilities list for the PCEP session

Address

Displays the local IP address of the PCEP speaker

Report Path Constraints

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

Open Wait Timer

Displays the value of the open wait timer for the PCEP session

Keep Wait Timer

Displays the value of the keep wait timer for the PCEP session

Sync Timer

Displays the value of the synchronization timer for the PCEP session

Request Timer

Displays the value of the request timer for the PCEP session

Connection Timer

Displays the value of the keep wait timer for the PCEP session

Allow Negotiations

Displays where negotiations between PCEP PCC and PCE are allowed

Max Sessions

Displays the maximum number of PCEP sessions on the router

Max Unknown Req

Displays 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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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

Output Example
*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: 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: 10.120.210.36
Oper Status         : up                
===============================================================================
*A:ZBG# 
Table 36:  Output Fields: LSP  

Label

Description

PCEP-specific LSP ID

Displays the PCEP-specific LSP identifier

LSP ID

Displays the LSP identifier

Tunnel ID

Displays the tunnel identifier for the LSP

LSP Name

Displays the configured LSP name

Source Address

Displays the source IP address of the LSP

LSP Delegated

Displays the delegation status of the LSP

Oper Status

Displays the operational status of the LSP

LSP Type

Displays the type of the LSP

Extended Tunnel Id

Displays the expanded tunnel identifier for the LSP

Destination Address

Displays the destination IP address of the LSP

Delegate PCE Address

Displays 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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

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—
Keyword to display detailed path request information.
Output 

The following output is an example of PCEP PCC path request information, and Table 37 describes the output fields.

Output Example
*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 37:  Output Fields: Path Request  

Label

Description

Request ID

Displays the PCEP PCC path request identifier

Tunnel ID

Displays the tunnel identifier for the LSP

LSP ID

Displays the LSP identifier

LSP Name

Displays the configured LSP name

Source Address

Displays the source IP address of the LSP

SVEC Id

Displays the synchronization vector identifier

Message State

Displays the current state of the request

Extended Tunnel Id

Displays the expanded tunnel identifier for the LSP

LSP Type

Displays the type of the LSP

Destination Address

Displays the destination IP address of the LSP

LSP Bandwidth

Displays the bandwidth of the LSP

peer

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

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

Description 

This command displays PCEP PCC peer information.

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

 

detail—
Keyword to display detailed peer information.
Output 

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

Output Example
*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 38:  Output Fields: PCC Peer 

Label

Description

IP Address

Displays the IP address of the PCC peer

Admin Status

Displays the administrative status of the PCC peer

Oper Status

Displays the operational status of the PCC peer

Peer Capabilities

Displays the PCEP capabilities of the PCC peer

Speaker ID

Displays the IP address of the PCC peer speaker

Sync State

Displays the synchronization state of the PCC peer speaker

Peer Overloaded

Displays whether the PCC peer is overloaded

Session Establish Time

Displays the length of time since the PCEP session was established

Oper Keepalive

Displays the operational value for the PCC peer keepalive timer

Oper DeadTimer

Displays the operational value for the PCC peer dead timer

Session Setup Count

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

Session Setup Fail Count

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

Statistics Information

PC Request Message

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

PC Reply Message

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

PC Error Message

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

PC Notification Message

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

PC Keepalive Message

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

PC Update Message

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

PC Report Message

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

Path Report

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

Path Request

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

status

Syntax 
status
Context 
show>router>pcep>pcc
Supported Platforms 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

Description 

This command displays PCEP PCC status information.

Output 

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

Output Example
*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 39:  Output Fields: PCC Status 

Label

Description

Admin Status

Displays the administrative status of the PCC

Oper Status

Displays the operational status of the PCC

Unknown Msg Limit

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

Keepalive Interval

Displays the specified keepalive interval for the PCEP session

DeadTimer Interval

Displays the specified dead time interval for the PCEP session

Capabilities List

Displays the capabilities list for the PCEP session

Address

Displays the local IP address of the PCEP speaker

Report Path Constraints

Displays 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

Displays the IP address of the PCC peer

Admin State/Oper State

Displays the administrative and operational states of the PCC peer

Oper Keepalive/Oper DeadTimer

Displays 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 

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12

Description 

This command displays PCEP PCC LSP information.

Parameters 
lsp—
Keyword 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