Example: Configuring an RFC 2544-Based Benchmarking Test for UNI Direction of Ethernet Pseudowires
This example shows how to configure the benchmarking test for the user-to-network interface (UNI) direction of an Ethernet pseudowire service.
Requirements
This example uses the following hardware and software components:
An ACX Series router
Junos OS Release 12.3X53 or later
Overview
Consider a sample topology in which a router, Router A, functions
as a reflector of the test frames for an RFC 2544-based benchmarking
test. The logical customer edge (CE)-facing interface and inet family are configured on Router A. Router A is not part of a pseudowire
and therefore, a Layer 3 family configuration is required on it. Router
A, which is a customer edge device, CE1, is connected to Router B,
which functions as a provider edge device, PE1, over an Ethernet pseudowire
in the UNI direction with EtherType or Layer 2 Ethernet payload. The
logical interface, CCC family, and UNI direction are configured on
Router B. Router B or PE1 is connected over an Ethernet pseudowire
in the NNI direction to a provider edge device at the remote site,
PE2. The link between CE1 and PE1 is an Ethernet Layer 2 network and
it can be configured with any EtherType value. The link between PE1
and PE2 is an Ethernet line (E-LINE) or an Ethernet Private Line (EPL)
that has Layer 2 payload and Layer 3 transport sent over it. Router
B or PE1 functions as an initiator and terminator of the test frames
that are sent to Router A and reflected back from it.
This benchmarking test is used to compute the performance attributes in the user-to-network interface (UNI) direction of an Ethernet pseudowire service between Router A and Router B. Data traffic arriving from a network-to-network interface (NNI) toward the customer edge is ignored while the test is in progress. Packets from the CE are not sent toward the NNI because all packets are assumed to be test probes.
Figure 1 shows the sample topology to perform an RFC 2544 test for the UNI direction of an Ethernet pseudowire service.
Configuration
In this example, you configure the benchmarking test for the UNI direction of an Ethernet pseudowire service that is enabled between two routers to detect and analyze the performance of the interconnecting routers.
- CLI Quick Configuration
- Configuring Benchmarking Test Parameters on Router A
- Configuring Benchmarking Test Parameters on Router B
- Results
CLI Quick Configuration
To quickly configure this example, copy the
following commands, paste them in a text file, remove any line breaks,
change any details necessary to match your network configuration,
and then copy and paste the commands into the CLI at the [edit] hierarchy level:
Configuring Benchmarking Test Parameters on Router A
set interfaces ge-0/0/0 vlan-tagging set interfaces ge-0/0/0 unit 0 vlan-id 101 set interfaces ge-0/0/0 unit 0 family inet address 200.0.0.1/24 set services rpm rfc2544-benchmarking profiles test-profile throughput test-type throughput set services rpm rfc2544-benchmarking profiles test-profile throughput packet-size 64 set services rpm rfc2544-benchmarking profiles test-profile throughput test-duration 20m set services rpm rfc2544-benchmarking profiles test-profile throughput bandwidth-kbps 500 set services rpm rfc2544-benchmarking tests test-name test1 interface ge-0/0/0.1 set services rpm rfc2544-benchmarking tests test-name test1 test-profile throughput set services rpm rfc2544-benchmarking tests test-name test1 mode initiate-and-terminate set services rpm rfc2544-benchmarking tests test-name test1 family inet set services rpm rfc2544-benchmarking tests test-name test1 dest-address 10.200.0.2 set services rpm rfc2544-benchmarking tests test-name test1 udp-port 4001
Configuring Benchmarking Test Parameters on Router B
set interfaces ge-0/0/4 vlan-tagging set interfaces ge-0/0/4 unit 0 encapsulation vlan-ccc set interfaces ge-0/0/4 unit 0 vlan-id 101 set services rpm rfc2544-benchmarking tests test-name test1 interface ge-0/0/4.1 set services rpm rfc2544-benchmarking tests test-name test1 mode reflect set services rpm rfc2544-benchmarking tests test-name test1 mode family ccc set services rpm rfc2544-benchmarking tests test-name test1 direction uni
Configuring Benchmarking Test Parameters on Router A
Step-by-Step Procedure
The following example requires you to navigate various levels in the configuration hierarchy. For information about navigating the CLI, see Using the CLI Editor in Configuration Mode.
To configure the test parameters on Router A:
In configuration mode, go to the
[edit interfaces]hierarchy level:[edit] user@host# edit interfaces
Configure the interface on which the test must be run.
[edit interfaces] user@host# edit ge-0/0/0
Configure VLAN tagging for transmission and reception of 802.1Q VLAN-tagged frames.
[edit interfaces ge-0/0/0] user@host# set vlan-tagging
Configure a logical unit and specify the protocol family as
inet.[edit interfaces ge-0/0/0] user@host# edit unit 0 family inet
Specify the address for the logical interface.
[edit interfaces ge-0/0/0 unit 0 family inet] user@host# set address 10.200.0.1/24
Configure the VLAN ID on the logical interface as 101.
[edit interfaces ge-0/0/0 unit 0] user@host# set vlan-id 101
Go to the top level of the configuration command mode.
[edit interfaces ge-0/0/0 unit 0] user@host# top
In configuration mode, go to the
[edit services]hierarchy level.[edit] user@host# edit services
Configure a real-time performance monitoring service (RPM) instance.
[edit services] user@host# edit rpm
Configure an RFC 2544-based benchmarking test for the RPM instance.
[edit services rpm] user@host# edit rfc2544-benchmarking
Define a name for a test profile—for example, throughput.
[edit services rpm rfc2544-benchmarking] user@host# edit profiles test-profile throughput
Configure the type of test to be performed as throughput.
[edit services rpm rfc2544-benchmarking profiles test-profile throughput] user@host# set test-type throughput
Specify the size of the test packet as 64 bytes.
[edit services rpm rfc2544-benchmarking profiles test-profile throughput] user@host# set test-type packet-size 64
Specify the period for which the test is to be performed in hours, minutes, or seconds by specifying a number followed by the letter h (for hours), m (for minutes), or s (for seconds). In this example, you configure the period as 20 minutes.
[edit services rpm rfc2544-benchmarking profiles test-profile throughput] user@host# set test-type test-duration 20m
Define the theoretical maximum bandwidth for the test in kilobits per second, with a value from 1 Kbps through 1,000,000 Kbps.
[edit services rpm rfc2544-benchmarking profiles test-profile throughput] user@host# set test-type bandwidth-kbps 500
Enter the
upcommand to go the previous level in the configuration hierarchy.[edit services rpm rfc2544-benchmarking profiles test-profile throughput] user@host# up
Enter the
upcommand to go the previous level in the configuration hierarchy.[edit services rpm rfc2544-benchmarking profiles] user@host# up
Define a name for the test—for example, test1. The test name identifier can be up to 32 characters in length.
[edit services rpm rfc2544-benchmarking] user@host# edit tests test-name test1
Specify the name of the test profile—for example, throughput—to be associated with a particular test name.
[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set test-profile throughput
Specify the logical interface, ge-0/0/0.1, on which the RFC 2544-based benchmarking test is run.
[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set test-interface ge-0/0/0.1
Specify the test mode for the packets that are sent during the benchmarking test as initiation and termination.
[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set mode initiate-and-terminate
Configure the address type family,
inet, for the benchmarking test.[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set family inet
Configure the destination IPv4 address for the test packets as 200.0.0.2.
[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set dest-address 200.0.0.2
Specify the UDP port of the destination to be used in the UDP header for the generated frames as 4001.
[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set udp-port 4001
Configuring Benchmarking Test Parameters on Router B
Step-by-Step Procedure
The following example requires you to navigate various levels in the configuration hierarchy. For information about navigating the CLI, see Using the CLI Editor in Configuration Mode.
To configure the test parameters on Router B:
In configuration mode, go to the
[edit interfaces]hierarchy level:[edit] user@host# edit interfaces
Configure the interface on which the test must be run.
[edit interfaces] user@host# edit ge-0/0/4
Configure VLAN tagging for transmission and reception of 802.1Q VLAN-tagged frames.
[edit interfaces ge-0/0/4] user@host# set vlan-tagging
Configure a logical unit for the interface.
[edit interfaces ge-0/0/4] user@host# edit unit 0
Specify the encapsulation for Ethernet VLAN circuits.
[edit interfaces ge-0/0/4 unit 0] user@host# set encapsulation vlan-ccc
Configure the VLAN ID as 101 on the logical interface.
[edit interfaces ge-0/0/4 unit 0] user@host# set vlan-id 101
Go to the top level of the configuration command mode.
[edit interfaces ge-0/0/4 unit 0] user@host# top
In configuration mode, go to the
[edit services]hierarchy level.[edit] user@host# edit services
Configure a real-time performance monitoring service (RPM) instance.
[edit services] user@host# edit rpm
Configure an RFC 2544-based benchmarking test for the RPM instance.
[edit services rpm] user@host# edit rfc2544-benchmarking
Define a name for the test—for example, test1. The test name identifier can be up to 32 characters in length.
[edit services rpm rfc2544-benchmarking] user@host# edit tests test-name test1
Specify the logical interface on which the RFC 2544-based benchmarking test is run.
[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set test-interface ge-0/0/4.1
Specify
reflectas the test mode for the packets that are sent during the benchmarking test.[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set mode reflect
Configure the address type family,
ccc, for the benchmarking test.[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set family ccc
Specify the direction of the interface on which the test must be run, which is UNI in this example.
[edit services rpm rfc2544-benchmarking tests test-name test1] user@host# set direction uni
Results
In configuration mode, confirm your configuration on
Router A and Router B by entering the show command. If
the output does not display the intended configuration, repeat the
configuration instructions in this example to correct it.
Configuring Benchmarking Test Parameters on Router A:
[edit interfaces]
ge-0/0/0 {
vlan-tagging;
unit 0 {
vlan-id 101;
family inet {
address 10.200.0.1/24;
}
}
}
[edit services rpm]
rfc2544-benchmarking {
profiles {
test-profile throughput {
test-type throughput
packet-size 64;
test-duration 20m;
bandwidth-kbps 500;
}
}
tests {
test-name test1 {
interface ge-0/0/0.1;
test-profile throughput;
mode initiate-and-terminate;
family inet;
dest-address 10.200.0.2
udp-port 4001;
}
}
}
Configuring Benchmarking Test Parameters on Router B:
[edit interfaces]
ge-0/0/4 {
vlan-tagging;
unit 0 {
encapsulation vlan-ccc;
vlan-id 101;
}
}
[edit services rpm]
rfc2544-benchmarking {
# Note, When in reflector mode, test profile is not needed
tests {
test-name test1 {
interface ge-0/0/4.1;
mode reflect;
family ccc;
direction uni;
}
}
}
After you have configured the device, enter the commit command in configuration mode.
Verifying the Results of the Benchmarking Test for UNI Direction of an Ethernet Pseudowire Service
Examine the results of the benchmarking test that is performed on the configured service between Router A and Router B.
Verifying the Benchmarking Test Results
Purpose
Verify that the necessary and desired statistical values are displayed for the benchmarking test that is run on the configured service between Router A and Router B.
Action
In operational mode, enter the run show services
rpm rfc2544-benchmarking (aborted-tests | active-tests | completed-tests
| summary) command to display information about the results
of each category or state of the RFC 2544-based benchmarking test,
such as terminated tests, active tests, and completed tests, for each
real-time performance monitoring (RPM) instance.
Meaning
The output displays the details of the benchmarking
test that was performed. For more information about the run show
services rpm rfc2544-benchmarking operational command, see show services rpm rfc2544-benchmarking in the CLI Explorer.