sap sap-id [create] [no-endpoint]
sap sap-id [create] endpoint endpoint-name
no sap sap-id
config>service>epipe
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command creates a SAP within a service. A SAP is a combination of port and encapsulation parameters which identifies the service access point on the interface and within the 7210 device. Each SAP must be unique.
All SAPs must be explicitly created. If no SAPs are created within a service or on an IP interface, a SAP does not exist on that object.
Enter an existing SAP without the create keyword to edit SAP parameters. The SAP is owned by the service in which it was created.
In a single physical port only one SAP can belong to one service. Multiple SAPs can be defined over a physical port but each of these SAPs should belong to different service. This is true only for access-uplink mode. That is, for network mode, multiple SAPs on the same port can belong to the same service.
A SAP can only be associated with a single service. A SAP can only be defined on a port that has been configured as an access port. Additionally, in access-uplink mode, SAPs can be defined also on access-uplink port. Access-uplink SAPs are network facing SAPs representing Dot1q or QinQ tunnels used to transport traffic toward the service nodes.
If a port is shut down, all SAPs on that port become operationally down. When a service is shut down, SAPs for the service are not displayed as operationally down although all traffic traversing the service is discarded.
The operational state of a SAP is relative to the operational state f the port on which theo SAP is defined.
The following encapsulations are supported:
Ethernet access SAPs support null, dot1q
Ethernet access-uplink SAPs support only QinQ encapsulation.
The no form of this command deletes the SAP with the specified port. When a SAP is deleted, all configuration parameters for the SAP is also deleted.
No SAPs are defined.
A default SAP has the following format: port-id:*. This type of SAP is supported only on Ethernet MDAs and its creation is allowed only in the scope of Layer 2 services (Epipe and VPLS).
Specifies the physical port identifier portion of the SAP. See Common CLI command descriptions for command syntax.
Keyword used to create a SAP instance. The create keyword requirement can be enabled/disabled in the environment>create context.
Keyword used to remove the association of a SAP or a spoke-SDP with an explicit endpoint name. This keyword is not supported on platforms operating in the access-uplink operating mode.
Specifies to add a SAP endpoint association, up to 32 characters. This parameter is not supported on platforms configured in the access-uplink operating mode.
accounting-policy acct-policy-id
no accounting-policy
config>service>epipe>sap
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command creates the accounting policy context that can be applied to a SAP.
An accounting policy must be defined before it can be associated with a SAP. If the policy-id does not exist, an error message is generated.
A maximum of one accounting policy can be associated with a SAP at one time. Accounting policies are configured in the config>log context.
The no form of this command removes the accounting policy association from the SAP, and the accounting policy reverts to the default.
Default accounting policy.
Enter the accounting policy-id as configured in the config>log>accounting-policy context.
[no] collect-stats
config>service>epipe>sap
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command enables accounting and statistical data collection for either the SAP, network port, or IP interface. When applying accounting policies the data, by default, is collected in the appropriate records and written to the designated billing file.
When the no collect-stats command is issued, the statistics are still accumulated by the cards. However, the CPU does not obtain the results and write them to the billing file. If a subsequent collect-stats command is issued, the counters written to the billing file include all the traffic while the no collect-stats command was in effect.
no collect-stats
description description-string
no description
config>service>epipe>sap
config>service>epipe>spoke-sdp (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command defines an ASCII string associated with egress-multicast-group-name.
The no form of this command removes an existing description string from egress-multicast-group.
Specifies the description as an ASCII string of up to 80 characters. Only printable 127 bit ASCII characters are allowed. If the string contains spaces, the string must be specified with beginning and ending quotes.
eth-cfm
config>service>epipe>sap
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
Commands in this context configure ETH-CFM parameters.
mep mep-id domain md-index association ma-index [direction {up | down}] primary-vlan-enable
no mep mep-id domain md-index association ma-index
config>service>epipe>sap>eth-cfm
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command provisions the maintenance endpoint (MEP).
For more information about ETH-CFM support, refer to the 7210 SAS-Mxp, R6, R12, S, Sx, T OAM and Diagnostics Guide.
The no form of this command reverts to the default values.
Specifies the maintenance association end point identifier.
Specifies the maintenance domain (MD) index value.
Specifies the MA index value.
Indicates the direction in which the maintenance association (MEP) faces on the bridge port. Direction is not supported when a MEP is created directly under the vpls>eth-cfm construct (vMEP).
down — Sends ETH-CFM messages away from the MAC relay entity.
up — Sends ETH-CFM messages toward the MAC relay entity.
Provides a method for linking the with the primary VLAN configured under the bridge-identifier for the MA. This is only allowed if the mhf-creation method is static. MIPs can not be changed from or to primary VLAN functions without first being deleted. This must be configured as part of the creation step and can only be changed by deleting the MEP and recreating it. Primary VLANs are only supported under Ethernet SAPs.
This parameter is only supported on 7210 SAS-T (network operating mode), 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), and 7210 SAS-Mxp (network operating mode).
[no] ais-enable
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command enables the generation and the reception of AIS messages.
client-meg-level [[level [level ...]]
no client-meg-level
config>service>epipe>sap>eth-cfm>mep>ais-enable
config>service>epipe>spoke-sdp>eth-cfm>mep>ais-enable (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command configures the client maintenance entity group (MEG) levels to use for AIS message generation. Up to 7 levels can be provisioned with the restriction that the client MEG level must be higher than the local MEG level.
Specifies the client MEG level.
interval {1 | 60}
no interval
config>service>vpls>epipe>eth-cfm>mep>ais-enable
config>service>epipe>spoke-sdp>eth-cfm>mep>ais-enable (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command specifies the transmission interval of AIS messages in seconds.
Specifies the transmission interval of AIS messages in seconds.
priority priority-value
no priority
config>service>vpls>epipe>eth-cfm>mep>ais-enable
config>service>epipe>spoke-sdp>eth-cfm>mep>ais-enable (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command specifies the priority of AIS messages originated by the node.
Specifies the priority value of the AIS messages originated by the node.
[no] ccm-enable
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command enables the generation of CCM messages.
The no form of this command disables the generation of CCM messages.
ccm-ltm-priority priority
no ccm-ltm-priority
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command specifies the priority value for CCMs and LTMs transmitted by the MEP.
The no form of this command removes the priority value from the configuration.
The highest priority on the bridge-port.
Specifies the priority of CCM and LTM messages.
[no] eth-test-enable
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
For ETH-test to work, operators need to configure ETH-test parameters on both sender and receiver nodes. The ETH-test then can be done using the following OAM commands:
oam eth-cfm eth-test mac-address mep mep-id domain md-index association ma-index [priority priority] [data-length data-length]
A check is done for both the provisioning and test to ensure that the MEP is an Y.1731 MEP (MEP provisioned with domain format none, association format icc-based). If not, the operation fails. An error message in the CLI and SNMP indicates the problem.
bit-error-threshold errors
no bit-error-threshold
config>service>epipe>sap>eth-cfm>mep>eth-test-enable
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command specifies the threshold value of bit errors.
test-pattern {all-zeros | all-ones} [crc-enable]
no test-pattern
config>service>epipe>sap>eth-cfm>mep>eth-test-enable
config>service>epipe>spoke-sdp>eth-cfm>mep>eth-test-enable (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command configures the test pattern for eth-test frames.
The no form of this command removes the values from the configuration.
Specifies to use all zeros in the test pattern.
Specifies to use all ones in the test pattern.
Generates a CRC checksum.
fault-propagation-enable {use-if-tlv | suspend-ccm}
no fault-propagation-enable
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command configures the fault propagation for the MEP.
Specifies to use the interface TLV.
Specifies to suspend the continuity check messages.
low-priority-defect {allDef | macRemErrXcon | remErrXcon | errXcon | xcon | noXcon}
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command specifies the lowest priority defect that is allowed to generate a fault alarm.
macRemErrXcon
Values |
allDef |
DefRDICCM, DefMACstatus, DefRemoteCCM, DefErrorCCM, and DefXconCCM |
macRemErrXcon |
Only DefMACstatus, DefRemoteCCM, DefErrorCCM, and DefXconCCM |
|
remErrXcon |
Only DefRemoteCCM, DefErrorCCM, and DefXconCCM |
|
errXcon |
Only DefErrorCCM and DefXconCCM |
|
xcon |
Only DefXconCCM; or |
|
noXcon |
No defects DefXcon or lower are to be reported |
mac-address mac-address
no mac-address
config>service>epipe>spoke-sdp>eth-cfm>mep (not supported in access-uplink operating mode)
config>service>epipe>sap>eth-cfm>mep
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode
This command specifies the MAC address of the MEP.
The no form of this command reverts the MAC address of the MEP back to that of the port (if the MEP is on a SAP) or the bridge (if the MEP is on a spoke).
Specifies the MAC address of the MEP.
agg-rate-limit agg-rate
no agg-rate-limit
config>service>epipe>sap>egress
config>service>vpls>sap>egress
config>service>ies>sap>egress
config>service>vprn>sap>egress (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command defines a maximum total rate for all egress queues on a service SAP.
The SAP aggregate rate can be used only if SAP based scheduling mode is configured at the port level. It is not supported in FC-based scheduling mode.
When configured in SAP-based scheduling mode, the egress port scheduler distributes the available bandwidth to all the SAPs configured on the port, up to the configured aggregate rate for the SAP.
The no form of this command removes the aggregate rate limit from the SAP.
Defines the rate, in kilobits-per-second, that the maximum aggregate rate the queues on the SAP or MSS can operate.
tod-suite tod-suite-name
no tod-suite
config>service>epipe>sap
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command applies a time-based policy (filter or QoS policy) to the service SAP. The suite name must already exist in the config>cron context.
no tod-suite
Specifies collection of policies (ACLs, QoS) including time-ranges that define the full or partial behavior of a SAP. The suite can be applied to more than one SAP.
one-way-delay-threshold seconds
config>service>vpls>sap>eth-cfm>mep
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command enables/disables eth-test functionality on MEP.
Specifies the one way delay threshold in seconds.
mip [mac mac-address]
mip default-mac
no mip
config>service>epipe>sap>eth-cfm
config>service>epipe>spoke-sdp>eth-cfm (not supported in access-uplink operating mode)
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command allows Maintenance Intermediate Points (MIPs) to be created if mhf-creation for the MA is configured using the default option.
Specifies the MAC address of the MIP.
Using the no command deletes the MIP. If the operator needs to change the mac back to the default mac without having to delete the MIP and reconfiguring this command is useful.
ethernet
config>service>epipe>sap
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command configures Ethernet properties in this SAP.
[no] llf
config>service>epipe>sap>ethernet
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command enables Link Loss Forwarding (LLF) on an Ethernet port. It provides an end-to-end OAM fault notification for Ethernet VLL service.LLF on an Ethernet port brings down the port when there is a local fault on the pseudowire or service, or a remote fault on the SAP or pseudowire, signaled with label withdrawal or TLDP status bits. It ceases when the fault disappears.
The Ethernet port must be configured for null encapsulation.
The no form of this command disables LLF.
[no] ignore-oper-down
config>service>epipe>sap
Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.
This command enables the user to configure the optional command for a specific SAP to ignore the transition of the operational state to down when a SAP fails. Only a single SAP in an Epipe may use this option.
no ignore-oper-down