5.4. PCEP Configuration Command Reference

5.4.1. Command Hierarchies

5.4.1.1. PCEP Commands

config
— router
[no] pcep
pcc
dead-timer seconds
— no dead-timer
keepalive seconds
— no keepalive
local-address ip-address
max-srte-pce-init-lsps max-number
peer ip-address [preference preference]
— no peer ip-address
redelegation-timer seconds
[no] shutdown
state-timer seconds [action action]
— no state-timer
pce
dead-timer seconds
— no dead-timer
keepalive seconds
— no keepalive
local-address ip-address
[no] shutdown

5.4.2. Command Descriptions

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

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.

Default 

dead-timer 120

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

 

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.

Default 

keepalive 30

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

 

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

max-srte-pce-init-lsps

Syntax 
max-srte-pce-init-lsps max-number
no max-srte-pce-init-lsps
Context 
config>router>pcep>pcc
Description 

This command configures the maximum number of PCE-initiated SR-TE LSPs that can be created by the router.

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

Default 

max-srte-pce-init-lsps 8191

Parameters 
max-number—
Specifies the maximum number of SR-TE PCE-initiated LSPs.
Values—
0 to 8191

 

peer

Syntax 
peer ip-address [preference preference]
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 preference parameter allows the PCC to select the preferred PCE when both have their PCEP sessions successfully established. A maximum of two PCEP peers is supported.

The PCE peer that is not in overload is always selected by the PCC as the active PCE. However, if neither of the PCEs are signaling the overload state, the PCE with the higher numerical preference value is selected, and in case of a tie, the PCE with the lower IP address is selected.

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.
preference—
The preference value of the peer.
Values—
0 to 100

 

Default—
1

redelegation-timer

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

This command configures the redelegation timer for PCE-initiated LSPs.

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

Default 

redelegation-timer 90

Parameters 
seconds—
Specifies the number of seconds before the redelegation timer expires.
Values—
1 to 3600

 

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

state-timer

Syntax 
state-timer seconds [action action]
no state-timer
Context 
config>router>pcep>pcc
Description 

This command configures the state timer for PCE-initiated LSPs. The state timer must be set to a value greater than the redelegation timer.

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

Default 

state-timer 180 action remove

Parameters 
seconds—
Specifies the number of seconds before the state timer expires.
Values—
1 to 3600

 

action—
Specifies the actions that are taken on undelegated LSPs upon the state timer expiration.
Values—
remove, none

 

Default—
remove

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.

Default 

unknown-message-rate 10

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

 

pce

Syntax 
pce
Context 
config>router>pcep
Description 

This command enables the context to configure PCE parameters.