PCEP Configuration Command Reference

Command Hierarchies

PCEP Commands

config
— router
[no] pcep
pcc
dead-timer seconds
— no dead-timer
keepalive seconds
— no keepalive
local-address ip-address
[no] peer ip-address
[no] shutdown
pce
dead-timer seconds
— no dead-timer
keepalive seconds
— no keepalive
local-address ip-address
[no] shutdown

Command Descriptions

PCEP Commands

pcep

Syntax 
[no] pcep
Context 
config>router
Description 

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

The no form of the command disables PCEP.

pcc

Syntax 
pcc
Context 
config>router>pcep
Description 

This command enables the context to configure PCC parameters.

pce

Syntax 
pce
Context 
config>router>pcep
Description 

This command enables the context to configure PCE parameters.

dead-timer

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

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

The keep-alive 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.

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

keepalive

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

This command configures the PCEP session keep-alive value. A PCEP speaker (PCC or PCE) must send a keep-alive 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 keep-alive message is sent.

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

The no form of the command returns the keep-alive timer to the default value.

Parameters 
seconds—
the keep-alive value, in seconds
Values—
1 to 255
Values—
30

local-address

Syntax 
local-address ip-address
no local-address
Context 
config>router>pcep>pcc
config>router>pcep>pce
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. Once the user configures the PCEP local address and the peer address on the PCC, the latter 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 if the remote PCE address is reachable out-of-band via the management port. If not, it 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
config>router>pcep>pce
Description 

This command configures the IP address of a peer PCEP speaker. It 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

report-path-constraints

Syntax 
report-path-constraints
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 which is delegated, but for which there is no prior state in its LSP database, such as if no PCReq message was sent for the same PLSP-ID, the following proprietary behavior is observed:

  1. 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 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 SR OS 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 contained a single set. If the PCRpt 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>pce
Description 

This command administratively disables the PCC or PCE process.

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

  1. local-address
  2. keepalive
  3. dead-timer

The unknown-message-rate PCE parameter can be modified without shutting down the PCEP session.

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 following PCC parameters can be modified without shutting down the PCEP session:

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

shutdown

unknown-message-rate

Syntax 
unknown-message-rate integer
no unknown-message-rate
Context 
config>router>pcep>pcc
config>router>pcep>pce
Description 

This command configures the maximum rate of unknown messages which can be received on 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.

Parameters 
integer—
the rate of unknown messages, in messages per minute
Values—
1 to 255
Values—
10