VLL SDP Commands

Note:

VLL SDP commands are supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode. Any exceptions are noted explicitly.

spoke-sdp

Syntax

spoke-sdp sdp-id[:vc-id] [no-endpoint] [create]

spoke-sdp sdp-id[:vc-id] endpoint endpoint-name

no spoke-sdp sdp-id[:vc-id]

Context

config>service>epipe

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command binds a service to an existing Service Distribution Point (SDP).

The SDP has an operational state that determines the operational state of the SDP within the service. For example, if the SDP is administratively or operationally down, the SDP for the service is down.

The SDP must already exist in the config>service>sdp context to associate an SDP with an Epipe or VPL service. If the sdp-id is not already configured, an error message is generated. If the sdp-id does exist, a binding between the specific sdp-id and the service is created.

SDPs must be explicitly associated and bound to a service to allow far-end 7210 SAS devices to participate in the service.

The no form of this command removes the SDP binding from the service; the SDP configuration is not affected. When the binding is removed, no packets are forwarded to the far-end router.

Default

no sdp-id is bound to a service

Special Cases

Epipe

At most, only one sdp-id can be bound to an Epipe service. Since an Epipe is a point-to-point service, it can have, at most, two end points. The two end points can be one SAP and one SDP or two SAPs. VC-switching VLLs are an exception. If the VLL is a ‟vc-switching” VLL, the two endpoints must both be SDPs.

Parameters

sdp-id

Specifies the SDP identifier.

Values

1 to 17407

vc-id

Specifies the virtual circuit identifier.

Values

1 to 4294967295

no-endpoint

Keyword to remove the association of a spoke-SDP with an explicit endpoint name.

endpoint-name

Specifies the name of the service endpoint.

create

Keyword to create spoke-SDP.

control-word

Syntax

[no] control-word

Context

config>service>epipe>spoke-sdp

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command provides the option to add a control word as part of the packet encapsulation for pseudowire types for which the control word is optional. These are Ethernet pseudowires (Epipe).

The configuration for the two directions of the pseudowire must match because the control word negotiation procedures described in Section 6.2 of RFC 4447 are not supported. The C-bit in the pseudowire FEC sent in the label mapping message is set to 1 when the control word is enabled. Otherwise, it is set to 0.

The service only comes up if the same C-bit value is signaled in both directions. If a spoke-SDP is configured to use the control word but the node receives a label mapping message with a C-bit clear, the node releases the label with the an ‟Illegal C-bit” status code as per Section 6.1 of RFC 4447. As soon as the user also enabled the control the remote peer, the remote peer withdraws its original label and sends a label mapping with the C-bit set to 1 and the VLL service is up in both nodes.

control-channel-status

Syntax

[no] control-channel-status

Context

config>service>epipe>spoke-sdp

Platforms

7210 SAS-T

Description

This command enables the configuration of static pseudowire status signaling on a spoke-SDP for which signaling for its SDP is set to OFF.

A control-channel-status no shutdown is allowed only if all of the following is true:

  • The system is using network chassis mode D

  • SDP signaling is off

  • The control-word is enabled (control-word by default is disabled)

  • The service type is epipe, apipe, vpls, or IES/VPRN

  • Mate SDP signaling is off (in vc-switched services)

  • pw-path-id is configured for this spoke

The no form of this command removes control channel status signaling form a spoke-SDP. It can only be removed if control channel status is shutdown.

Default

no control-channel-status

acknowledgment

Syntax

[no] acknowledgment

Context

config>service>epipe>spoke-sdp>control-channel-status

Platforms

7210 SAS-T

Description

This command enables the acknowledgment of control channel status messages. By default, no acknowledgment packets are sent.

refresh-timer

Syntax

refresh-timer value

no refresh-timer

Context

config>service>epipe>spoke-sdp>control-channel-status

Platforms

7210 SAS-T

Description

This command configures the refresh timer for control channel status signaling packets. By default, no refresh packets are sent.

Default

no refresh-timer

Parameters

value

Specifies the refresh timer value.

Values

10 to 65535 seconds

Default

0 (off)

request-timer

Syntax

request-timer request-timer request-timer-secs retry-timer retry-timer-secs timeout-multiplier multiplier

Context

config>service>epipe>spoke-sdp>control-channel-status

Platforms

7210 SAS-T

Description

This command configures the control channel status request mechanism. When it is configured, control channel status request procedures are used. These augment the procedures for control channel status messaging from RFC 6478. This command is mutually exclusive with a non-zero refresh-timer value.

Parameters

request-timer

Specifies the interval at which pseudowire status messages, including a reliable delivery TLV, with the ‟request” bit set, are sent.

Values

10 to 65535 seconds

retry-timer

Specifies the timeout interval if no response to a pseudowire status request is received. This parameter must be configured. A value of zero (0) disables retries.

Values

0, 3 to 60 seconds

timeout-multiplier

Specifies the optional timeout multiplier for the retry timer. If a requesting node does not receive a valid response to a pseudowire status request within this multiplier value times the retry timer value, it assumes the pseudowire is down.

Values

3 to 20 seconds

precedence

Syntax

precedence [precedence-value | primary]

no precedence

Context

config>service>epipe>spoke-sdp

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command specifies the precedence of the SDP binding when there are multiple SDP bindings attached to one service endpoint. The value of zero can only be assigned to one SDP bind making it the primary SDP bind. When an SDP binding goes down, the next highest precedence SDP binding begins to forward traffic.

The no form of this command returns the precedence value to the default.

Default

4

Parameters

precedence-value

Specifies the spoke-SDP precedence.

Values

1 to 4

primary

Specifies to make this the primary spoke-SDP.

pw-path-id

Syntax

[no] pw-path-id

Context

config>service>epipe>spoke-sdp

Platforms

7210 SAS-T

Description

This command configures an MPLS-TP Pseudowire Path Identifier for a spoke-SDP. All elements of the PW path ID must be configured to enable a spoke-SDP with a PW path ID.

For an IES or VPRN spoke-SDP, the pw-path-id is only valid for Ethernet spoke-SDPs.

The pw-path-id is only configurable if all of the following is true:

  • The system is using network chassis mode D

  • SDP signaling is off

  • Control-word is enabled (control-word is disabled by default)

  • The service type is epipe, vpls, or IES/VPRN interface

  • Mate SDP signaling is off for vc-switched services

The no form of this command deletes the PW path ID.

Default

no pw-path-id

agi

Syntax

agi agi

no agi

Context

config>service>epipe>spoke-sdp>pw-path-id

Platforms

7210 SAS-T

Description

This command configures the attachment group identifier for an MPLS-TP PW.

Parameters

agi

Specifies the attachment group identifier.

Values

0 to 4294967295

saii-type2

Syntax

saii-type2 global-id:node-id:ac-id

no saii-type2

Context

config>service>epipe>spoke-sdp>pw-path-id

Platforms

7210 SAS-T

Description

This command configures the source individual attachment identifier (SAII) for an MPLS-TP spoke-SDP. If this is configured on a spoke-SDP for which vc-switching is also configured, that is, if it is at an S-PE, the values must match those of the taii-type2 of the mate spoke-SDP.

Parameters

global-id

Specifies the global ID at the source PE or T-PE for the MPLS-TP PW for a spoke-SDP.

Values

0 to 4294967295

node-id

Specifies the node ID at the source PE or T-PE for the MPLS-TP PW for a spoke-SDP.

Values

a.b.c.d or 0 to 4294967295

ac-id

Specifies the attachment circuit ID at the source PE or T-PE for the MPLS-TP PW for a spoke-SDP. If this node is the source of the PW, the AC ID must be set to a locally unique value.

Values

1 to 4294967295

taii-type2

Syntax

taii-type2 global-id:node-id:ac-id

no taii-type2

Context

config>service>epipe>spoke-sdp>pw-path-id

Platforms

7210 SAS-T

Description

This command configures the source individual attachment identifier (SAII) for an MPLS-TP spoke-SDP. If this is configured on a spoke-SDP for which vc-switching is also configured (it is at an S-PE), the values must match those of the taii-type2 of the mate spoke-SDP.

Parameters

global-id

Specifies the global ID at the target PE or T-PE for the MPLS-TP PW for a spoke-SDP.

Values

0 to 4294967295

node-id

Specifies the node ID at the target PE or T-PE for the MPLS-TP PW for a spoke-SDP.

Values

a.b.c.d or 0 to 4294967295

ac-id

Specifies the attachment circuit ID at the target PE or T-PE for the MPLS-TP PW for a spoke-SDP. If this node is the source of the PW, the AC ID must be set to a locally unique value.

Values

1 to 4294967295

pw-status-signaling

Syntax

[no] pw-status-signaling

Context

config>service>epipe>spoke-sdp

Platforms

7210 SAS-T

Description

This command enables pseudowire status signaling for this spoke-SDP binding.

The no form of this command disables the status signaling.

Default

pw-status-signaling

vc-label

Syntax

[no] vc-label vc-label

Context

config>service>epipe>spoke-sdp>egress

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command configures the egress VC label.

Parameters

vc-label

A VC egress value that indicates a specific connection.

Values

16 to 1048575

vc-label

Syntax

[no] vc-label vc-label

Context

config>service>epipe>spoke-sdp>ingress

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command configures the ingress VC label.

Parameters

vc-label

Specifies a VC ingress label value for a connection.

Values

2048 to 18431

vlan-vc-tag

Syntax

vlan-vc-tag 0..4094

no vlan-vc-tag [0..4094]

Context

config>service>epipe>spoke-sdp

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command specifies an explicit dot1q value used when encapsulating to the SDP far end. When signaling is enabled between the near and far end, the configured dot1q tag can be overridden by a received TLV specifying the dot1q value expected by the far end. This signaled value must be stored as the remote signaled dot1q value for the binding. The provisioned local dot1q tag must be stored as the administrative dot1q value for the binding.

When the dot1q tag is not defined, the default value of zero is stored as the administrative dot1q value. Setting the value to zero is equivalent to not specifying the value.

The no form of this command disables the command.

Default

no vlan-vc-tag

Parameters

0..4094

Specifies a valid VLAN identifier to bind an 802.1Q VLAN tag ID.

spoke-sdp-fec

Syntax

spoke-sdp-fec

spoke-sdp-fec spoke-sdp-fec-id [fec fec-type] [aii-type aii-type] [create]

spoke-sdp-fec spoke-sdp-fec-id no-endpoint

spoke-sdp-fec spoke-sdp-fec-id [fec fec-type] [aii-type aii-type] [create] endpoint name [icb]

Context

config>service>epipe

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command binds a service to an existing SDP, using a dynamic MS-PW.

A spoke-SDP is treated like the equivalent of a traditional bridge ‟port” where flooded traffic received on the spoke-SDP is replicated on all other ‟ports” (other spoke and mesh SDPs or SAPs) and not transmitted on the port it was received.

The SDP has an operational state which determines the operational state of the SDP within the service. For example, if the SDP is administratively or operationally down, the SDP for the service is down.

When using dynamic MS-PWs, the particular SDP to bind to is automatically selected based on the Target Attachment Individual Identifier (TAII) and the path to use, specified under spoke-SDP FEC. The selected SDP terminates on the first hop S-PE of the MS-PW. Therefore, an SDP must already be defined in the config>service>sdp context that reaches the first hop 7210 of the MS-PW. The 7210 associates an SDP with a service. If an SDP is not already configured, an error message is generated. If the sdp-id does exists, a binding between that sdp-id and the service is created.

It differs from the spoke-sdp command in that the spoke-sdp command creates a spoke-SDP binding that uses a PW with the PW ID FEC. However, the spoke-sdp-fec command enables PWs with other FEC types to be used. In Release 9.0, only the Generalized ID FEC (FEC129) may be specified using this command.

The no form of this command removes the SDP binding from the service. The SDP configuration is not affected; only the binding of the SDP to a service. When removed, no packets are forwarded to the far-end router.

Parameters

spoke-sdp-fec-id

Specifies an unsigned integer value of the spoke-SDP.

Values

1 to4294967295

fec fec-type

Specifies an unsigned integer value for the type of the FEC used by the MS-PW.

Values

129 to 130

aii-type aii-type

Specifies an unsigned integer value for the Attachment Individual Identifier (AII) type used to identify the MS-PW endpoints.

Values

1 to 2

endpoint endpoint-name

Specifies the name of the service endpoint.

no endpoint

Adds or removes a spoke-SDP association.

icb

Configures the spoke-SDP as an inter-chassis backup SDP binding.

auto-config

Syntax

[no] auto-config

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command enables single-sided automatic endpoint configuration of the spoke-SDP. The 7210 SAS acts as the passive T-PE for signaling this MS-PW.

Automatic Endpoint Configuration allows the configuration of a spoke-SDP endpoint without specifying the TAII associated with that spoke-SDP. It allows a single-sided provisioning model where an incoming label mapping message with a TAII that matches the SAII of that spoke-SDP to be automatically bound to that endpoint. In this mode, the far end T-PE actively initiates MS-PW signaling and sends the initial label mapping message using T-LDP, while the 7210 T-PE for which auto-config is specified, acts as the passive T-PE.

The auto-config command is blocked in CLI if signaling active has been enabled for this spoke-SDP. It it is only applicable to spoke-SDPs configured under the Epipe, IES and VPRN interface context.

The no form of this command means that the 7210 T-PE either acts as the active T-PE (if signaling active is configured) or automatically determines which 7210 initiates MS-PW signaling based on the prefix values configured in the SAII and TAII of the spoke-SDP. If the SAII has the greater prefix value, the 7210 initiates MS-PW signaling without waiting for a label mapping message from the far end. However, if the TAII has the greater value prefix, then the 7210 assumes that the far end T-PE initiates MS-PW signaling and waits for that label mapping message before responding with a T-LDP label mapping message for the MS-PW in the reverse direction.

Default

no auto-config

path

Syntax

path name

no path

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command specifies the explicit path, containing a list of S-PE hops, that should be used for this spoke-SDP. The path-name should correspond to the name of an explicit path configured in the config>service>pw-routing context.

If no path is configured, each next-hop of the MS-PW used by the spoke-SDP is chosen locally at each T-PE and S-PE.

Default

no path

Parameters

path-name

The name of the explicit path to be used, as configured under config>service>pw-routing.

precedence

Syntax

precedence precedence-value

precedence primary

no precedence

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command specifies the precedence of the SDP binding when there are multiple SDP bindings attached to one service endpoint. The value of zero can only be assigned to one SDP bind making it the primary SDP bind. When an SDP binding goes down, the next highest precedence SDP binding begins to forward traffic.

The no form of this command returns the precedence value to the default.

Default

42

Parameters

precedence-value

Specifies the spoke-SDP precedence.

Values

1 to 4

primary

Specifies to make this the primary spoke-SDP.

pw-template-bind

Syntax

pw-template-bind policy-id

no pw-template-bind

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command binds the parameters included in a specific PW Template to a spoke-SDP.

The no form of this command removes the values from the configuration.

Parameters

policy-id

Specifies the existing policy ID.

Values

1 to 2147483647

retry-count

Syntax

retry-count retry-count

no retry-count

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This optional command specifies the number of attempts software should make to reestablish the spoke-SDP after it has failed. After each successful attempt, the counter is reset to zero.

When the specified number is reached, no more attempts are made and the spoke-SDP is put into the shutdown state.

Use the no shutdown command to bring up the path after the retry limit is exceeded.

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

Default

30

Parameters

retry-count

Specifies the maximum number of retries before putting the spoke-SDP into the shutdown state.

Values

10 to 10000

retry-timer

Syntax

retry-timer retry-timer

no retry-timer

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command specifies a retry-timer for the spoke-SDP. This is a configurable exponential back-off timer that determines the interval between retries to reestablish a spoke-SDP if it fails and a label withdraw message is received with the status code ‟AII unreachable”.

The no form of this command reverts the timer to its default value.

Default

30

Parameters

retry-timer

Specifies the initial retry-timer value in seconds.

Values

10 to 480

saii-type2

Syntax

saii-type2 global-id:prefix:ac-id

no saii-type2

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command configures the source attachment individual identifier for the spoke-SDP. This is only applicable to FEC129 AII type 2.

Parameters

global-id

Specifies the global ID of this 7210 T-PE. This value must correspond to one of the global_id values configured for a local-prefix under config>service>pw-routing>local-prefix context.

Values

1 to 4294967295

prefix

Specifies the prefix on this 7210 T-PE that the spoke-SDP SDP is associated with. This value must correspond to one of the prefixes configured under config>service>pw-routing>local-prefix context.

Values

an IPv4-formatted address a.b.c.d or 1 to 4294967295

ac-id

Specifies an unsigned integer representing a locally unique identifier for the spoke-SDP.

Values

1 to 4294967295

taii-type2

Syntax

taii-type2 global-id:prefix:ac-id

no taii-type2

Context

config>service>epipe>spoke-sdp-fec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.

Description

This command configures the target attachment individual identifier for the spoke-SDP. This is only applicable to FEC129 AII type 2.

This command is blocked in CLI if this end of the spoke-SDP is configured for single-sided auto configuration (using the auto-config command).

Parameters

global-id

Specifies the Global ID of this 7210 T-PE. This value must correspond to one of the global_id values configured for a local-prefix under config>service>pw-routing>local-prefix context.

Values

1 to 4294967295

prefix

Specifies the prefix on this 7210 T-PE that the spoke-SDP is associated with. This value must correspond to one of the prefixes configured under config>service>pw-routing>local-prefix context.

Values

an IPv4-formatted address a.b.c.d or 1 to 4294967295

ac-id

Specifies an unsigned integer representing a locally unique identifier for the spoke-SDP.

Values

1 to 4294967295