ON THIS PAGE
Example: Configuring Internal Fabric OAM Monitoring
This example shows how to configure the internal fabric Operation, Administration, Maintenance (OAM) monitoring feature on the QFabric system, including the fabric maintenance association (FMA) and flow specifications for unicast Ethernet traffic.
Internal fabric monitoring enables you to validate the flow path of protocol data units (PDUs) across a given VLAN on the QFabric system using the ping operation.
Internal fabric monitoring is useful for fault detection on the QFabric system. For example, if a PDU reaches a destination that is not part of the VLAN configuration, the ping operation displays the exception on the console at runtime.
Requirements
This example uses the following hardware and software components:
One QFabric system with the following components:
A Director group (two Director devices)
Two QFabric system Interconnect devices
Node devices, including:
One Node device (Node-81) configured in a default network Node group (NNW-NG-0)
One Node device (Node-80) in an autogenerated server Node group (SNG-80)
Two Node devices (Node-83 and Node-84) configured in a redundant server Node group (RSNG-8384)
Junos OS Release 12.2 or later
Before you configure the FMA, first configure a VLAN in which the internal fabric OAM monitoring occurs. You can usually configure a VLAN by specifying a VLAN ID or VLAN name. However, in the case of the VLAN used for internal fabric OAM monitoring, you must specify a VLAN name (not a VLAN ID). The FMA configuration requires a VLAN name and not a VLAN ID.
If you have already configured a VLAN ID for the VLAN, you must delete the VLAN ID from the associated interfaces and then add a VLAN name.
Overview
On a QFabric system, enabling internal fabric OAM monitoring requires that you configure an FMA and a flow specification.
The FMA associates a particular VLAN with a set of source and destination interfaces called fabric maintenance endpoints (FMEPs) that are used for tracing the data path between the endpoints. Configuration of the VLAN name is mandatory when you configure an FMA.
A flow specification is used to determine the contents of a packet that is used for a particular operation. For example, an Ethernet type flow specification describes the contents of a pure Layer 2 packet, whereas an Ethernet IPv4 type flow specification describes an Ethernet IPv4 packet.
Topology
This example uses the following topology:

The QFabric system Node devices are connected to the Interconnect devices.
Node device Node-80 is configured in the server Node group SNG-80.
Node devices Node-83 and Node-84 are configured in a redundant server Node group RSNG-8384.
The device with the unicast flow source IP address is connected to Node-80.
The device with the unicast flow destination IP addresses is connected to Node-84.
Table 1 maps the association of the fabric OAM elements configured in this example.
Interface |
FMA |
VLAN Name |
FMEP ID |
Flow Specifications |
---|---|---|---|---|
Node-80:xe-0/0/22 |
fma1 |
v10 |
1 |
|
Node-84:xe-0/0/22 |
fma1 |
v10 |
2 |
|
Configuration
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.
set vlans v10 vlan-id 10 set interfaces Node-80:xe-0/0/22 unit 0 family ethernet-switching vlan members v10 set interfaces Node-84:xe-0/0/22 unit 0 family ethernet-switching vlan members v10 set protocols oam fabric fabric-maintenance-associations fma1 vlan-name v10 set protocols oam fabric fabric-maintenance-associations fma1 fabric-maintenance-end-points 1 fmep-interface Node-80:xe-0/0/22.0 set protocols oam fabric fabric-maintenance-associations fma1 fabric-maintenance-end-points 2 fmep-interface Node-84:xe-0/0/22.0 set protocols oam fabric flow-specs flowspec1 unicast-ethernet-ipv4 source-ip 10.244.10.100 set protocols oam fabric flow-specs flowspec1 unicast-ethernet-ipv4 destination-ip 10.244.10.110 set protocols oam fabric flow-specs flowspec1 unicast-ethernet-ipv4 destination-mac 00:00:80:8d:2d:15 set protocols oam fabric flow-specs flowspec1 unicast-ethernet-ipv4 source-l4-port 60 set protocols oam fabric flow-specs flowspec1 unicast-ethernet-ipv4 destination-l4-port 80 set protocols oam fabric flow-specs flowspec2 unicast-ethernet-ipv4 source-ip 10.244.10.100 set protocols oam fabric flow-specs flowspec2 unicast-ethernet-ipv4 destination-ip 10.244.10.111 set protocols oam fabric flow-specs flowspec2 unicast-ethernet-ipv4 destination-mac 00:00:80:8d:2d:17 set protocols oam fabric flow-specs flowspec2 unicast-ethernet-ipv4 source-l4-port 60 set protocols oam fabric flow-specs flowspec2 unicast-ethernet-ipv4 destination-l4-port 80
Procedure
Step-by-Step Procedure
To configure internal fabric OAM monitoring:
Configure a name and ID for the VLAN.
[edit] set vlans v10 vlan-id 10
Assign a set of interfaces to the VLAN.
[edit] set interfaces Node-80:xe-0/0/22 unit 0 family ethernet-switching vlan members v10 set interfaces Node-84:xe-0/0/22 unit 0 family ethernet-switching vlan members v10
Define the FMA and associate it with a VLAN name.
[edit protocols oam fabric] set fabric-maintenance-associations fma1 vlan-name v10
Configure FMEPs for the FMA.
[edit protocols oam fabric] set fabric-maintenance-associations fma1 fabric-maintenance-end-points 1 fmep-interface Node-80:xe-0/0/22.0 set fabric-maintenance-associations fma1 fabric-maintenance-end-points 2 fmep-interface Node-84:xe-0/0/22.0
Configure two IPv4 flow specifications for unicast traffic from FMEP 1 to FMEP 2.
[edit protocols oam fabric] set flow-specs flowspec1 unicast-ethernet-ipv4 source-ip 10.244.10.100 set flow-specs flowspec1 unicast-ethernet-ipv4 destination-ip 10.244.10.110 set flow-specs flowspec1 unicast-ethernet-ipv4 destination-mac 00:00:80:8d:2d:15 set flow-specs flowspec1 unicast-ethernet-ipv4 source-l4-port 60 set flow-specs flowspec1 unicast-ethernet-ipv4 destination-l4-port 80 set flow-specs flowspec2 unicast-ethernet-ipv4 source-ip 10.244.10.100 set flow-specs flowspec2 unicast-ethernet-ipv4 destination-ip 10.244.10.111 set flow-specs flowspec2 unicast-ethernet-ipv4 destination-mac 00:00:80:8d:2d:17 set flow-specs flowspec2 unicast-ethernet-ipv4 source-l4-port 60 set flow-specs flowspec2 unicast-ethernet-ipv4 destination-l4-port 80
Results
Display the results of the configuration.
root@qfabric> show protocols oam fabric
fabric-maintenance-associations {
fma1 {
vlan-name v10;
fabric-maintenance-end-points {
1 {
fmep-interface Node-80:xe-0/0/22.0;
}
2 {
fmep-interface Node-84:xe-0/0/22.0;
}
}
}
}
flow-specs {
flowspec1 {
unicast-ethernet-ipv4 {
source-ip 10.244.10.100;
destination-ip 10.244.10.110;
destination-mac 0:0:80:8d:2d:15;
source-l4-port 60;
destination-l4-port 80;
}
}
flowspec2 {
unicast-ethernet-ipv4 {
source-ip 10.244.10.100;
destination-ip 10.244.10.111;
destination-mac 0:0:80:8d:2d:17;
source-l4-port 60;
destination-l4-port 80;
}
}
}
Verification
Confirm that the configuration is working properly.
- Verifying Configuration of Fabric OAM Interfaces
- Verifying Configuration of the Fabric OAM Flow Specification
- Verifying Operation of the Unicast ping Command
Verifying Configuration of Fabric OAM Interfaces
Purpose
Verify that the interfaces are associated with the FMA.
Action
Display the fabric OAM interfaces.
root@qfabric> show oam fabric interfaces
Interface-name Fabric-Maintenance VLAN Interface MEP MEP
Association state Identifier Name
NW-NG-0:NULL fma-default * up 32790 fmep-default-BBAK8793
NW-NG-0:NULL fma-default * up 32791 fmep-default-BBAK8798
RSNG-8384:NULL fma-default * up 32794 fmep-default-BBAK8748
RSNG-8384:NULL fma-default * up 32795 fmep-default-BBAK0465
Node-84:xe-0/0/22.0 fma1 V10 up 2
SNG-60:NULL fma-default * up 32793 fmep-default-BBAK9603
SNG-80:NULL fma-default * up 32792 fmep-default-BBAK8728
Node-80:xe-0/0/22.0 fma1 V10 up 1
Meaning
Interfaces Node-84:xe-0/0/22.0 and Node-80:xe-0/0/22.0 are associated with the FMA, FMEP, and VLAN as configured.
Interfaces that are not configured for fabric OAM monitoring (NW-NG-0:NULL, RSNG-8384:NULL, SNG-60:NULL, and SNG-80:NULL) display an asterisk (*) in the VLAN column, and the default FMA and FMEP names in the Fabric-Maintenance Association and MEP Name columns.
Verifying Configuration of the Fabric OAM Flow Specification
Purpose
Verify the configuration of the flow specifications.
Action
Display the fabric OAM flow specification configuration.
root@qfabric> show oam fabric flow-specification
Flow specification name : flowspec1 Type : Ethernet Unicast IPV4
Ethernet frame size : Unspecified
Source-IP : 10.244.10.100
Source-IP Mask : Unspecified
Destination-IP : 10.244.10.110
Destination-IP Mask : Unspecified
Destination-mac : 0:0:80:8d:2d:15
IP-protocol : Unspecified
Source-L4-port : 60
Destination-L4-port : 80
Flow specification name : flowspec2 Type : Ethernet Unicast IPV4
Ethernet frame size : Unspecified
Source-IP : 10.244.10.100
Source-IP Mask : Unspecified
Destination-IP : 10.244.10.111
Destination-IP Mask : Unspecified
Destination-mac : 0:0:80:8d:2d:17
IP-protocol : Unspecified
Source-L4-port : 60
Destination-L4-port : 80
Meaning
The output shows that flow specifications were configured as the user intended.
Verifying Operation of the Unicast ping Command
Purpose
Verify that the fabric OAM unicast ping
command
works.
Action
Issue the ping fabric unicast-flow
command.
root@qfabric> ping fabric unicast-flow source-fmep-id 1 dest-fmep-id 2 flow-spec-name flowspec1 fma-name fma1 count 3
Fabric flow ping between source Node-80 destination Node-84
received response from fmep-id 2...
received response from fmep-id 2...
received response from fmep-id 2...
sent 3 requests, received 3 responses
root@qfabric> ping fabric unicast-flow source-fmep-id 1 dest-fmep-id 2 fma-name fma1 flow-spec-name flowspec2
Fabric flow ping between source Node-80 destination Node-84
received response from fmep-id 2...
sent 1 requests, received 1 responses
Meaning
The fabric OAM unicast ping request from the source Node device (Node-80) to the destination Node device (Node-84) has been successful.