twamp-light
config>router
config>service>vprn
config>test-oam>twamp
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
Commands in this context configure TWAMP Light functionality.
The config>service>vprn context is supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.
reflector [udp-port udp-port-number] [create]
no reflector
config>router>twamp-light
config>service>vprn>twamp-light
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures TWAMP Light session reflector-specific parameters. To create a reflector, the user must configure the udp-port-number value and include the create keyword.
The no form of this command removes the reflector.
The config>service>vprn>twamp-light context is supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.
Specifies the destination UDP port that the session reflector listens to for TWAMP Light packets. The session controller that is launching the TWAMP Light packets must have the same destination UDP port configured as part of the TWAMP Light test. IES services use the destination UDP port that is configured under the router context. Only one UDP port may be configured per unique context. An error message is generated if the specified UDP port is unavailable.
Creates the reflector.
description description-string
no description
config>router>twamp-light>reflector
config>router>twamp-light>reflector>prefix
config>service>vprn>twamp-light>reflector
config>service>vprn>twamp-light>reflector>prefix
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
The config>service>vprn>twamp-light>reflector and config>service>vprn>twamp-light>reflector>prefix contexts are supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.
This command creates a text description for the current configuration context that is stored in the configuration file. The description command associates a text string with a configuration context to help identify the content in the configuration file.
The no form of this command removes the description.
Specifies the description character string. Allowed values are any character strings up to 80 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed in double quotes.
prefix ip-prefix/prefix-length [create]
no prefix ip-prefix/prefix-length
config>router>twamp-light>reflector
config>service>vprn>twamp-light>reflector
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the IP prefixes that the reflector accepts TWAMP Light packets from and respond to. Each prefix requires its own configuration entry.
The no form of this command removes the specifies prefix.
The config>service>vprn>twamp-light>reflector context is supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.
Specifies the IP address.
Specifies the length of the IP prefix.
Keyword used to create the IP prefix entry.
[no] shutdown
config>router>twamp-light>reflector
config>service>vprn>twamp-light>reflector
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command disables the TWAMP Light reflector functionality within the current context.
The no form of this command enables the TWAMP Light reflector functionality within the current context.
The config>service>vprn>twamp-light>reflector context is supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode.
shutdown
inactivity-timeout seconds
no inactivity-timeout
config>test-oam>twamp>twamp-light
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the length of time to maintain stale states on the session reflector. A stale state occurs when test data information has not been refreshed or updated by newly arriving probes for that specific test in a predetermined amount of time. Any single reflector can maintain an up state for a maximum of 12000 tests. If the maximum value is exceeded, the session reflector does not have memory to allocate to new tests.
The no form of this command disables the inactivity timer.
inactivity-timer 100
Specifies the number of seconds to maintain a stale state.
session session-name [test-family {ethernet | ip} [session-type {proactive | on-demand}] create]
no session session-name
config>oam-pm
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the individual session containers that house the test-specific configuration parameters. Because this session context provides only a container abstract to house the individual test functions, it cannot be shut down. Only individual tests sessions within the container may be shut down. No values, parameters, or configuration within this context may be changed if any individual test is active. Changes may only be made when all tests within the context are shut down, with the exception of the description.
The no form of this command removes the session.
Specifies the name of the session container. 32 characters maximum.
Specifies that the test is based on the Ethernet layer.
Specifies that the test is based on the IP layer.
Specifies that the test is always on, with no stop. Tests are proactive by default.
Specifies that the test runs on demand, with an immediate start and no stop, or a stop based on offset.
Keyword to create the session container.
ip
config>oam-pm>session
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
Commands in this context configure the IP-specific source and destination information, the priority, and the IP test tools on the launch point.
destination ip-address
no destination
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the destination IP address to which the TWAMP Light packets are addressed. The destination address must be included in the prefix list on the session reflector within the context to allow the reflector to process the inbound TWAMP Light packets.
The no form of this command removes the destination parameters.
no destination
Specifies the IP address of the peer to which the packets are directed.
dest-udp-port udp-port-number
no dest-udp-port
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the destination UDP port to which the TWAMP Light packets are sent from the session controller. This value must match the udp-port udp-port number configured on the TWAMP Light reflector that responds to this specific TWAMP Light test.
The no form of this command removes the destination UDP port configuration.
Specifies the destination UDP port.
fc fc-name
no fc
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the forwarding class designation for TWAMP Light packets that are sent through the node and exposed to the various QoS functions on the network element.
The no form of this command restores the default value.
fc be
Specifies the forwarding class.
forwarding bypass-routing
forwarding interface interface-name
forwarding next-hop ip-address
no forwarding
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures influence for the forwarding decision of the TWAMP Light packet. When this command is used, only one of the forwarding options can be enabled at any time.
The no form of this command removes the configured influence and enables the default forwarding logic.
no forwarding
Specifies that packets should be sent to a host on a directly attached network, bypassing the routing table.
Specifies the name of the interface from which the packet is sent. The name must already exist in the config>router>interface context or within the appropriate config>service context. 32 characters maximum.
Specifies the IP address of the next hop.
profile {in | out}
no profile
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures whether TWAMP Light PDUs are treated as in-profile or out-of-profile.
The no form of this command restores the default value. The default has been selected because the forwarding class defaults to best effort.
profile out
Specifies that TWAMP Light PDU packets are treated as in-profile.
Specifies that TWAMP Light PDU packets are treated as out-of-profile.
router router-instance
router service-name service-name
no router
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the source context from which TWAMP Light packets are launched. The routing instance and service name must be a VPRN instance.
VPRN instances may only be specified on 7210 SAS platforms that support VPRN services. See the platform-specific 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide for information about platform support for VPRN services.
The no form of this command restores the default value.
router base
Specifies the routing instance from which the TWAMP Light packets are launched.
Specifies the name of the service from which the TWAMP Light packets are launched. 64 characters maximum.
source ip-address
no source
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the source IP address that the session controller (launch point) uses for the test. The source address must be a local resident IP address in the context; otherwise, the response packets are not processed by the TWAMP Light application. Only source addresses configured as part of TWAMP tests are able to process the reflected TWAMP packets from the session reflector.
The no form of this command removes the source address parameters.
Specifies the source IP address.
source-udp-port udp-port-number
no source-udp-port
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command restricts the source UDP range. When this command is omitted, the source UDP port is dynamically allocated by the system. This command should only be used if a TWAMP Client is used to establish a TCP connection and communicate the test parameters to a TWAMP Server over TWAMP TCP Control, and the test is launched from OAM-PM (Session-Sender). This command should not be used when the reflection point is a TWAMP Light reflector that does not require TCP TWAMP Control.
The no form of this command removes the source UDP port configuration and enables default allocation.
no source-udp-port
Specifies the source UDP port.
ttl time-to-live
no ttl
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the value of the TTL (time to live) field in the IP header.
The no form of this command restores the default value.
ttl 255
Specifies the numerical value to place in the TTL field.
twamp-light [test-id test-id] [create]
no twamp-light
config>oam-pm>session>ip
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command assigns an identifier to the TWAMP Light test and creates the individual test.
The no form of this command removes the TWAMP Light test function from the OAM-PM session.
no twamp-light
Specifies the value of the 4-byte local test identifier that is not sent in TWAMP Light packets.
Creates the test.
interval milliseconds
no interval
config>oam-pm>session>ip>twamp-light
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the message period, or probe spacing, for the transmission of TWAMP Light frames.
The no form of this command restores the default value.
Specifies the number of milliseconds between the transmission of TWAMP Light frames.
loss
config>oam-pm>session>ip>twamp-light
Commands in this context configure loss parameters for the TWAMP-Light test.
pad-size octets
no pad-size
config>oam-pm>session>ip>twamp-light
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the amount by which the TWAMP Light packets are padded. TWAMP session-controller packets are 27 bytes smaller than TWAMP session-reflector packets. If symmetrical packet sizes in the forward and backward direction are required, a minimum padding of 27 bytes must be configured.
The no form of this command removes all padding.
pad-size 0
Specifies the size of the padding, in octets.
record-stats {delay | loss | delay-and-loss}
no record-stats
config>oam-pm>session>ip>twamp-light
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command configures the statistics that are recorded and reported for the TWAMP-Light PDU.
The TWAMP-Light PDU can report on both delay and loss using a single packet. The user can choose which statistics to report. Only delay recording is enabled by default. All other metrics are ignored.
To change the record statistics configuration, the user must shut down the TWAMP-Light session. This is required because base statistics are shared among various datasets as a result of the single packet approach of the TWAMP-Light PDU. Issuing a no shutdown command clears all previous non-volatile memory for the session and allocates new memory blocks.
All command parameters are mutually exclusive.
The no form of this command reverts to the default value.
record-stats delay
Specifies to report on delay using a single packet.
Specifies to report on loss using a single packet.
Specifies to report on both delay and loss using a single packet.
[no] shutdown
config>oam-pm>session>ip>twamp-light
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This command starts or stops the test.
shutdown
test-duration seconds
no test-duration
config>oam-pm>session>ip>twamp-light
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
This optional command configures the length of time that the test runs before stopping automatically. This command is only a valid option when a session-type is configured as on-demand. This command is not an option when the session-type is configured as proactive.
The no form of this command removes a previously configured test-duration value and allows the TWAMP Light test to execute until it is stopped manually.
test-duration 0
Specifies the length of time, in seconds, that the TWAMP light test runs.