6.5. Pseudowire Ports Command Reference

This chapter describes the pseudowire ports (PW-ports) command reference.

6.5.1. Command Hierarchies

6.5.1.1. PW-port Configuration Commands

config
pw-port id [create]
— no pw-port
description description-string
dot1q-etype dot1q-etype
encap-type {dot1q | qinq}
— no encap-type
qinq-etype qinq-etype
— no qinq-etype

6.5.1.2. Redundant Interface Commands

config
— service
— sdp sdp-id [gre | mpls]
— no sdp sdp-id
port [port-id | lag-id]
— no port
pw-port pw-port-id [vc-id vc-id] [create]
— no pw-port pw-port-id
description description-string
egress
shaper
int-dest-id int-dest-id
— no int-dest-id int-dest-id
vport vport-name
— no vport vport-name
encap-type {dot1q | qinq}
— no encap-type
[no] shutdown
vc-type {ether | vlan}
— no vc-type
vlan-vc-tag vlan-id

6.5.1.3. Show Commands

show
— pw-port
pw-port [pw-port-id] [detail]
pw-port sdp [sdp-id]
pw-port sdp none

6.5.2. Command Descriptions

6.5.2.1. PW-port Configuration Commands

pw-port

Syntax 
pw-port id [create]
no pw-port
Context 
config
Description 

This command creates a PW-port that can be bound to a physical port or associated with an FPE (anchored PW-port). A PW-port's purpose is to provide, through a PW-SAP, access level (or SAP level) capability to customer traffic that is tunneled to the SR OS node through an IP/MPLS network.

The no form of this command removes the pw-port.

Default 

no pw-port

Parameters 
id—
ID of the PW-port.
Values—
1 to 32767

 

create—
Keyword required to create the configuration context.

description

Syntax 
description description-string
no description
Context 
config>pw-port
Description 

This command adds a text description to the pw-port.

The no form of this command removes the text description.

Parameters 
description-string—
Specifies the description character string of the configuration context.
Values—
Any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

 

dot1q-etype

Syntax 
dot1q-etype dot1q-etype
no dot1q-etype
Context 
config>pw-port
Description 

This command configures the Dot1q Ethertype on the PW-port. The PW-port is used to extract a customer's Ethernet traffic that is transported in a tunnel over an IP/MPLS network. The Dot1q-etype represents the first two bytes (TPID) in the 802.1Q header of a single-tagged Ethernet frame or the inner 802.1Q header of the double-tagged Ethernet frame inside the tunnel.

The no form of this command removes the configuration.

Parameters 
dot1q-etype—
The value for the dot1q-etype field, in hexadecimal format.
Values—
0x0600..0xFFFF

 

Default—
0x8100

encap-type

Syntax 
encap-type {dot1q | qinq}
no encap-type
Context 
config>pw-port
Description 

This command configures the encapsulation type on a PW-port. Customer Ethernet frames can be single-tagged or double-tagged, and this command determines the number of tags that the SR OS will check (and strip) on PW-SAP ingress and insert on PW-SAP egress.

The no form of this command removes the configuration.

Parameters 
dot1q—
Specifies that the encapsulation type is dot1q; used when the customer's Ethernet frame is single-tagged.
qinq—
Specifies that the encapsulation type is qinq; used when the customer's Ethernet frame is double-tagged.
Default—
dot1q

qinq-etype

Syntax 
qinq-etype qinq-etype
no qinq-etype
Context 
config>pw-port
Description 

This command configures the QinQ Ethertype on the PW-port. The PW-port is used to extract a customer's Ethernet traffic that is transported in a tunnel over an IP/MPLS network. The qinq-etype represents the first two bytes (TPID) in the outer 801.1Q header of the double-tagged Ethernet frame inside the tunnel.

The no form of this command removes the configuration.

Parameters 
qinq-etype—
The value for the qinq-etype field, in hexadecimal format.
Values—
0x0600..0xFFFF

 

Default—
0x8100

6.5.2.2. SDP Binding Commands

binding

Syntax 
binding
Context 
config>service>sdp
Description 

The command enters the context to configure SDP bindings.

port

Syntax 
port [port-id | lag-id]
no ort
Context 
config>service>sdp>binding
Description 

This command specifies the port or lag identifier, to which the PW ports associated with the underlying SDP are bound. If the underlying SDP is re-routed to a port or lag other than the specified one, the PW ports on the SDP are operationally brought down.

The no form of the command removes the value from the configuration.

Parameters 
port-id—
Specifies the identifier of the port in the slot/mda/port format.
lag-id—
Specifies the LAG identifier.

pw-port

Syntax 
pw-port pw-port-id [vc-id vc-id] [create]
no pw-port
Context 
config>service>sdp>binding
Description 

This command creates a pseudowire port.

The no form of the command removes the pseudowire port ID from the configuration.

Parameters 
pw-port-id—
Specifies a unique identifier of the pseudowire port.
Values—
1 to 10239

 

vc-id vc-id
Specifies a virtual circuit identifier signaled to the peer.
Values—
1 to 4294967295

 

create—
Keyword required to create the configuration context.

description

Syntax 
description description-string
no description
Context 
config>service>sdp>binding>pw-port
Description 

This command creates a text description stored in the configuration file for a configuration context.

The description command associates a text string with a configuration context to help identify the content in the configuration file.

The no form of the command removes the string from the configuration.

Default 

no description

Parameters 
description-string—
Specifies the description character string of the configuration context.
Values—
Any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

 

egress

Syntax 
egress
Context 
config>service>sdp>binding>pw-port
Description 

This command enters the context to configure PW-port egress side parameters.

encap-type

Syntax 
encap-type {dot1q | qinq}
no encap-type
Context 
config>service>sdp>binding>pw-port
Description 

This command sets the encapsulation type for the PW-port as dot1q or qinq.

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

Default 

dot1q

Parameters 
dot1q—
Specifies dot1q encapsulation type.
qinq—
Specifies qinq encapsulation type.

shutdown

Syntax 
no shutdown
Context 
config>service>sdp>binding>pw-port
Description 

This command changes the administrative status of the PW-port.

Default 

shutdown

shaper

Syntax 
[no] shaper
Context 
config>service>sdp>binding>pw-port>egress
Description 

This command configures an egress shaping option for use by a PW port.

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

Default 

no shaper

int-dest-id

Syntax 
[no] int-dest-id int-dest-id
Context 
config>service>sdp>binding>pw-port>egress>shaper
Description 

This command specifies the intermediate destination string configured for dynamic Vport selection.

This command is only valid for PW ports used for enhanced subscriber management (ESM on PW).

The no form of the command removes the configured intermediate destination string.

Default 

no.int-dest-id

Parameters 
int-dest-id—
Specifies a text string that describes the intermediate destination ID.

vport

Syntax 
vport vport-name
no vport
Context 
config>service>sdp>binding>pw-port>egress>shaper
Description 

This command configures the name of the Vport to be used for the PW port.

This command is valid for PW ports used for enhanced subscriber management (ESM on pseudowire) and pseudowire SAPs on Ethernet ports. It is not valid for pseudowire ports on the HSMDA.

The no form of the command removes the configured Vport name.

Default 

no vport

Parameters 
vport-name—
Specifies a text string up to 32 characters in length representing the name of the Vport.

vc-type

Syntax 
vc-type {ether | vlan}
no vc-type
Context 
config>service>sdp>binding>pw-port
Description 

This command sets the forwarding mode for PW-port. The vc-type is signaled to the peer, and must be configured consistently on both ends of the PW. vc-type VLAN is only configurable with dot1q encapsulation on the PW-port. The tag with vc-type vlan only has significance for transport, and is not used for service delineation or ESM. The top (provider tag) is stripped while forwarding out of the PW, and a configured vlan-tag (for vc-type vlan) is inserted when forwarding into the PW. With vc-type ether, the tags if present (max 2), are transparently preserved when forwarding in our out of the PW.

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

Default 

ether

Parameters 
ether—
Specifies ether as the virtual circuit (VC) associated with the SDP binding.
vlan—
Specifies vlan as the virtual circuit (VC) associated with the SDP binding.

vlan-vc-tag

Syntax 
vlan-vc-tag vlan-id
no vc-type
Context 
config>service>sdp>binding>pw-port
Description 

This command sets tag relevant for vc-type vlan mode. This tag is inserted in traffic forwarded into the PW.

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

Default 

0

Parameters 
vlan-id—
Specifies the VLAN ID value
Values—
0 to 4094

 

6.5.2.3. Show Commands

pw-port

Syntax 
pw-port [pw-port-id] [detail]
pw-port sdp sdp-id
pw-port sdp none
Context 
show>pw-port
Description 

Displays pseudo-wire port information.

If no optional parameters are specified, the command displays a summary of all defined PW ports. The optional parameters restrict output to only ports matching the specified properties.

Parameters 
pw-port-id
Specifies the pseudo-wire port identifier.
Values—
1 to 10239

 

detail—
Displays detailed port information that includes all the pw-port output fields.
sdp-id
The SDP ID for which to display matching PW port information.
Values—
1 to 17407

 

Output 

The following is an example of PW port information.

Sample Output
*A:ALA-48>config>service# show pw-port
============================================================================
PW Port Information
============================================================================
PW Port   Encap          SDP        IfIndex             VC-Id
----------------------------------------------------------------------------
1         dot1q          1          1526726657          1
2         qinq           1          1526726658          2
3         dot1q          1          1526726659          3
4         qinq           1          1526726660          4
============================================================================
 
*A:ALA-48>config>service# show pw-port 3
============================================================================
PW Port Information
============================================================================
PW Port   Encap          SDP        IfIndex             VC-Id
----------------------------------------------------------------------------
3         dot1q          1          1526726659          3
============================================================================
*A:ALA-48>config>service# show pw-port 3 detail
===============================================================================
PW Port Information
===============================================================================
PW Port            : 3
Encap              : dot1q
SDP                : 1
IfIndex            : 1526726659
VC-Id              : 3
Description        : 1-Gig Ethernet dual fiber
===============================================================================
*A:ALA-48>config>pw-port$ show pw-port sdp none
 
============================================================================
PW Port Information
============================================================================
PW Port   Encap          SDP        IfIndex             VC-Id
----------------------------------------------------------------------------
5         dot1q                     1526726661
============================================================================
 
 
*A:ALA-48>config>pw-port$ show pw-port sdp 1
============================================================================
PW Port Information
============================================================================
PW Port   Encap          SDP        IfIndex             VC-Id
----------------------------------------------------------------------------
1         dot1q          1          1526726657          1
2         qinq           1          1526726658          2
3         dot1q          1          1526726659          3
4         qinq           1          1526726660          4
============================================================================
 

The following table describes show pw-port output fields:

Table 85:  Subscriber Show PW-Port Field Descriptions 

Label

Description  

PW Port

The PW port identifier.

Encap

The encapsulation type of the PW port.

SDP

The SDP identifier.

IfIndex

The interface index used for the PW port.

VC-Id

The Virtual Circuit identifier.

Description

The description string for the PW port.