display pce protocol session

Function

The display pce protocol session command displays PCEP session information.

Format

display pce protocol session [ ip-address | verbose ]

Parameters

Parameter	Description	Value
ip-address	Specifies the IP address of a server that establishes a PCEP session with a local client.	The value is in dotted decimal notation.
verbose	Displays detailed information about a PCEP session.	-

Parameter

Description

Value

ip-address

Specifies the IP address of a server that establishes a PCEP session with a local client.

The value is in dotted decimal notation.

verbose

Displays detailed information about a PCEP session.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
pce	read

Usage Guidelines

Usage Scenario

To view PCEP session information, run the display pce protocol session command. The command output contains the peer IP address, parameters on both ends, the session status, and causes for session errors.

Run the display pce protocol session command to view the PCEP session status. If the State field is IDLE, a PCEP session fails to be established. Perform the following operations for fault diagnosis:

Run the display ip routing-table command to view routes. If no route to the PCEP peer IP address exists, run the display ip routing-table command to obtain the command output for fault diagnosis. If a route to the PCEP peer IP address exists, go to the next step.
Run the ping command to check whether the PCEP peer IP address is reachable. If the IP address is unreachable, obtain the ping command output for fault diagnosis.
If the problem persists, run the display pce protocol session verbose command to view detailed PCEP session information. Use the command output to analyze the cause for the failure to establish the PCEP session.
The Keepalive Timer field indicates the heartbeat timer of a PCEP session on the local end, and the Peer Keepalive Timer field indicates the heartbeat timer of a PCEP session on the peer end. If the two timers are different, a PCEP session fails to be established. Change the heartbeat timer in the PCE-server view so that the two ends use the same timer.
If the problem persists, contact technical support personnel.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about a PCEP session.

<HUAWEI> display pce protocol session verbose
Session IP               : 192.168.1.2
Session ID               : 57
State                    : UP
Keepalive Timer          : 30
Hold Timer               : 120
Peer Keepalive Timer     : 30
Peer Hold Timer          : 120
Session Capability       : Stateful PCE-Init Segment-Routing Segment-Routing-IPv6 Label-Stitch Multipath
Session Preference       : 0(YES)
Session Active Time      : 2020-07-20 03:05:08
Last session down reason : None
Notification Status      : Normal
Maximum Segment Depth    : 10
Stitch Label Base        : 321536
Stitch Label Size        : 10240
Dscp Value               : 6
PCC Multipath Number     : 64
PCE Multipath Number     : 64
Delegate Timer Remain    : 1
State Timer Remain       : -

# Display information about a PCEP session on an SMB.

<HUAWEI> display pce protocol session
Peer IP             State      Session ID
10.2.2.2            UP         100

**Table 1** Description of the **display pce protocol session** command output
Item	Description
Session ID	PCEP session ID.
Session IP	IP address of the PCEP session.
Session Active Time	Date and time when a PCEP session was established.
Session Preference	Default priority of a PCEP session.
Session Capability	PCEP session capability.
State	PCEP session status: IDLE: initial state. TCP-PENDING: A TCP connection is being established. OPEN-WAIT: The controller is waiting for a PCEP Open message. KEEP-WAIT: The component is waiting for a PCEP Keepalive message. UP: A PCEP session is successfully established.
State Timer Remain	Remaining time of the status timeout timer, in seconds.
Keepalive Timer	Value of the local Keepalive timer.
Hold Timer	Value of the local hold timer.
Peer IP	IP address of a server that establishes a PCEP session with a local client.
Peer Keepalive Timer	Value of the peer Keepalive timer.
Peer Hold Timer	Value of the peer Hold timer.
Last session down reason	Reason why the last recorded session went down: Hold Timer Expired. Malformed Message Received. Maximum Unknown Request/Reply Messages Received. Maximum Unknown Messages Received. Reset Session Received From Administrator. Session Source Address Changed. Protocol Error Message Received. Protocol Close Message Received. Socket Close/Error Message Received. Protocol Open Message Received During Session UP. Mandatory Tlv/Object Missing. Multiple Connections Received.
Notification Status	Notification status of a PCEP session.
Maximum Segment Depth	Maximum SID depth (MSD) of SR-MPLS TE.
Stitch Label Base	Start value of a stitching label.
Stitch Label Size	Count of stitching labels.
Dscp Value	DiffServ code point (DSCP).
PCC Multipath Number	Maximum number of paths that can be installed during forwarding by the PCC for each PCEP tunnel.
PCE Multipath Number	Maximum number of paths that can be computed for each PCEP tunnel.
Delegate Timer Remain	Remaining time of the re-delegate timer, in seconds.