- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-DetNetOAM commands | 121.40 KB |
display detnetoam delay-statistics
display detnetoam timeslot-statistics
reset detnetoam delay-statistics
reset detnetoam timeslot-statistics
DetNetOAM commands
binding path-group-id
Use binding path-group-id to bind a path group to a DetNetOAM instance.
Use undo binding path-group-id to cancel the path group binding for a DetNetOAM instance.
Syntax
binding path-group-id pathgroupID
undo binding path-group-id
Default
No path group is bound to a DetNetOAM instance.
Views
DetNetOAM instance view
Predefined user roles
network-admin
Parameters
pathgroupID: Specifies a path group by its path group ID. The value range for this argument is 1 to 4000.
Usage guidelines
Application scenarios
A path group is a group of SRv6 ECMP paths. DetNetOAM probe packets are forwarded through SRv6 paths. A path group is uniquely identified by its path group ID. After you bind a path group to a DetNetOAM instance and enable DetNetOAM probing for the instance, DetNetOAM measures the timeslot deviation and latency for each path in the path group with the same probing parameters. This assists the DetNet module in achieving deterministic forwarding of service packets.
Restrictions and guidelines
You can bind only one path group to a DetNetOAM instance, and a group path can be bound to only one DetNetOAM instance.
If DetNetOAM probing is enabled for a DetNetOAM instance, you cannot change the DetNet path bound to the instance. To change the bound path, first use the undo measure enable command to disable DetNetOAM probing for the instance.
Examples
# Bind path group 10 to DetNetOAM instance abc.
<Sysname> system-view
[Sysname] detnetoam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] binding path-group-id 10
Related commands
binding-path-id
measure enable
binding-path-id
Use binding-path-id to bind a DetNet path to a DetNetOAM instance.
Use undo binding-path-id to cancel the path binding for a DetNetOAM instance.
Syntax
binding-path-id pathID
undo binding-path-id
Default
No path is bound to a DetNetOAM instance.
Views
DetNetOAM instance view
Predefined user roles
network-admin
Parameters
path-id: Specifies a DetNet path by its path ID. The value range for this argument is 1 to 4000.
Usage guidelines
A path ID is generated by the DetNet module to uniquely identify a DetNet path. Use this command to bind a DetNet path to a DetNetOAM instance, and DetNetOAM probe packets will be forwarded along the path. You can bind only one DetNet path to a DetNetOAM instance, and a path can be bound to only one DetNetOAM instance. For more information about DetNet paths, see DetNet configuration in Deterministic Network Technologies Configuration Guide.
If DetNetOAM probing is enabled for a DetNetOAM instance, you cannot change the DetNet path bound to the instance. To change the bound path, first use the undo measure enable command to disable DetNetOAM probing for the instance.
Examples
# Bind DetNet path 10 to DetNetOAM instance abc.
<Sysname> system-view
[Sysname] detnetoam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] binding-path-id 10
Related commands
detnetip path (Deterministic Network Technologies Command Reference)
measure enable
data-size
Use data-size to set the payload size for each probe packet.
Use undo data-size to restore the default.
Syntax
Data-size size
undo data-size
Default
The payload size is 128 bytes.
Views
DetNetOAM instance view
Predefined user roles
network-admin
Parameters
size: Specifies the payload size in the range of 84 to 1024 bytes.
Usage guidelines
The sum of the payload size specified by using this command and the IP header length of each probe packet cannot be larger than the MTU size of any interface on the probed link. If the sum exceeds the MTU size of an interface, the probe packet will be fragmented. This command takes effect only for DetNetOAM instances bound to path groups.
Examples
# Set the payload size to 90 bytes for each probe packet.
<Sysname> system-view
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] data-size 90
delay-measure enable
Use delay-measure enable to enable latency measurement for a DetNetOAM instance.
Use undo delay-measure enable to disable latency measurement for a DetNetOAM instance.
Syntax
delay-measure enable
undo delay-measure enable
Default
Latency measurement is disabled for a DetNetOAM instance.
Views
DetNetOAM instance view
Predefined user roles
network-admin
Usage guidelines
Use this command to enable latency measurement for a DetNetOAM instance. Use this command in conjunction with the the measure enable command. You can enable DetNetOAM probing after you create a DetNetOAM instance on the ingress edge node of a DetNet network, configure the probe interval and probe packet parameters, and bind a path group. Latency measurement starts after DetNetOAM probing is enabled by using the measure enable command. The delay-measure enable command does not enable the device to send probe packets. After you execute this command, you can still use other commands to edit the instance settings.
Examples
# Enable latency measurement for DetNetOAM instance abc.
[Sysname] detnetoam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] delay-measure enable
detnetoam enable
Use detnetoam enable to enable DetNetOAM and enter DetNetOAM view. If DetNetOAM has been enabled, this command enters DetNetOAM view.
Use undo detnetoam enable to disable DetNetOAM.
Syntax
detnetoam enable
undo detnetoam enable
Default
DetNetOAM is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
To use the DetNetOAM probing feature, you must perform the following tasks:
· Enable DetNetOAM on the ingress edge node, transit nodes, and egress edge node of a DetNet network.
· Create a DetNetOAM instance on the ingress edge node of the DetNet network, and configure the probe interval, probe packets parameters, and bound DetNet path in the instance.
Examples
# Enable DetNetOAM and enter DetNetOAM view.
<Sysname> system-view
[Sysname] detnetoam enable
[Sysname-detnetoam]
display detnetoam delay-statistics
Use display detnetoam delay-statistics to display latency measurement results for a path group in the most recent five probe intervals.
Syntax
display detnetoam delay-statistics device-id device-id session-id session-id
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
device-id: Specifies an ingress edge node, which constructs the probe packets, by its ID in the range of 1 to 255. A pair of a device ID and a session ID uniquely identifies a probe session.
session-id: Specifies a DetNetOAM probe session by its ID in the range of 1 to 1048575. A pair of a device ID and a session ID uniquely identifies a probe session.
Examples
# Display the latency measurement results for the probe session with device ID 1 and session ID 1 on the ingress edge node.
<Sysname> display detnetoam delay-statistics device-id 1 session-id 1
DeviceID: 1 SessionID: 1
Period ID Sequence ID TTL TimeStamp(sec, nsec) Direction Interfance
28002661 1 255 1680159757, 467595839 Ingress XGE3/0/1
28002661 2 255 1680159757, 467746051 Ingress XGE3/0/1
28002661 3 255 1680159757, 467746094 Ingress XGE3/0/1
28002661 5 255 1680159757, 468046399 Ingress XGE3/0/1
28002661 7 255 1680159757, 468345609 Ingress XGE3/0/1
28002661 8 255 1680159757, 468495804 Ingress XGE3/0/1
28002661 9 255 1680159757, 468495831 Ingress XGE3/0/1
28002662 1 255 1680159817, 466695834 Ingress XGE3/0/1
28002662 2 255 1680159817, 466846064 Ingress XGE3/0/1
28002662 3 255 1680159817, 466996202 Ingress XGE3/0/1
28002662 4 255 1680159817, 467145294 Ingress XGE3/0/1
28002662 5 255 1680159817, 467295454 Ingress XGE3/0/1
28002662 6 255 1680159817, 467295499 Ingress XGE3/0/1
28002662 7 255 1680159817, 467444539 Ingress XGE3/0/1
28002662 8 255 1680159817, 467594689 Ingress XGE3/0/1
28002662 9 255 1680159817, 467744869 Ingress XGE3/0/1
28002662 10 255 1680159817, 467744894 Ingress XGE3/0/1
# Display the latency measurement results for the probe session with device ID 1 and session ID 1 on the egress edge node.
<Sysname> display detnetoam delay-statistics device-id 1 session-id 1
Device ID: 1 Session ID: 1
Period ID Sequence ID TTL TimeStamp(sec, nsec) Direction Interfance
28002661 1 253 1680159757, 467595839 Egress XGE3/0/1
28002661 2 253 1680159757, 467746051 Egress XGE3/0/1
28002661 3 253 1680159757, 467746094 Egress XGE3/0/1
28002661 5 253 1680159757, 468046399 Egress XGE3/0/1
28002661 7 253 1680159757, 468345609 Egress XGE3/0/1
28002661 8 253 1680159757, 468495804 Egress XGE3/0/1
28002661 9 253 1680159757, 468495831 Egress XGE3/0/1
28002662 1 253 1680159817, 466695834 Egress XGE3/0/1
28002662 2 253 1680159817, 466846064 Egress XGE3/0/1
28002662 3 253 1680159817, 466996202 Egress XGE3/0/1
28002662 4 253 1680159817, 467145294 Egress XGE3/0/1
28002662 5 253 1680159817, 467295454 Egress XGE3/0/1
28002662 6 253 1680159817, 467295499 Egress XGE3/0/1
28002662 7 253 1680159817, 467444539 Egress XGE3/0/1
28002662 8 253 1680159817, 467594689 Egress XGE3/0/1
28002662 9 253 1680159817, 467744869 Egress XGE3/0/1
28002662 10 253 1680159817, 467744894 Egress XGE3/0/1
Table 1 Command output
Field |
Description |
Device ID |
ID of the ingress edge node that constructs DetNetOAM probe packets. |
Session ID |
Session ID that distinguishes a probe session from other probe sessions with the same ingress edge node. |
Period ID |
Probe interval ID. |
Sequence ID |
Packet sequence ID. |
TTL |
TTL value of the packet. |
Direction |
Timestamp type: · Ingress—The timestamp indicates the time when the probe packet arrived at the ingress edge node. · Egress—The timestamp indicates the time when the probe packet leaves the egress edge node. |
display detnetoam instance
Use display detnetoam instance to display DetNetOAM instance information.
Syntax
display detnetoam instance [ instance-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
instance-name: Specifies a DetNetOAM instance by its name, a case-sensitive string of 1 to 31 characters.
Examples
# Display information about DetNetOAM instance 1.
<Sysname> display detnetoam instance 1
Instance name : 1
Status : Disabled
Device ID : 2
Session ID : 5
Path group ID : 10
Path ID : 1
Period : 10 sec
Delay measurement : Disabled
Data size : 128
Flow information:
Source IP : 1.1.1.1
Destination IP : 2.2.2.2
Source port : 1000
Destination port : 2000
DSCP : 23
# Display information about DetNetOAM instance 2.
<Sysname> display detnetoam instance 2
Instance name : 2
Status : Disabled
Device ID : 2
Session ID : 6
Path group ID : 20
Path ID : 2
Period : 10 sec
Delay measurement : Disabled
Data size : 128
Flow information: --
Table 2 Command output
Field |
Description |
Instance name |
Name of the DetNetOAM instance. |
Status |
Whether DetNetOAM probing is enabled for the DetNetOAM instance: · Enabled. · Disabled. |
Device ID |
ID of the ingress edge node that constructs the DetNetOAM probe packet. A pair of a device ID and a session ID uniquely identifies a probe session. |
Session ID |
Session ID that distinguishes the probe session from other probe sessions with the same ingress edge node. A pair of a device ID and a session ID uniquely identifies a probe session. |
Path ID |
Path ID of the DetNet path bound to the DetNetOAM instance. If no DetNet path is bound to the instance, this field displays two hyphens (--). |
Period |
Probe interval of the DetNetOAM instance, in seconds. |
Delay measurement |
|
Data size |
|
Flow information |
Parameter settings for DetNetOAM probe packets. If no parameters are configured for DetNetOAM probe packets, this field displays two hyphens (--). |
Source IP |
Source IP address for probe packets. |
Destination IP |
Destination IP address for probe packets. |
Source port |
Source port number for probe packets. |
Destination port |
Destination port number for probe packets. |
DSCP |
DSCP value for probe packets. |
display detnetoam statistics
Use display detnetoam statistic to display DetNetOAM probing results in the most recent five probe intervals.
Syntax
display detnetoam statistic [ path-id path-id path-hop path-hop ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
path-id path-id: Specifies a DetNet path by its path ID. The value range for this argument is 1 to 4000.
path-hop path-hop: Specifies a node by its index in the range of 1 to 256.
Examples
# Display DetNetOAM probing results in the most recent five probe intervals.
<Sysname> display detnetoam statistics
PathID: 1 PathHop: 1
Period ID TimeSlotMax TimeSlotMin TimeSlotAvg
166626252 1 0 0
166626253 0 0 0
166626254 0 0 0
166626255 0 0 0
166626256 0 0 0
Table 3 Command output
Field |
Description |
PathID |
Path ID of a DetNet path. |
PathHop |
Index of a node on the path. |
PeriodID |
ID of the probe interval. |
TimeSlotMax |
Maximum timeslot deviation. |
TimeSlotMin |
Minimum timeslot deviation. |
TimeSlotAvg |
Average timeslot deviation. |
display detnetoam timeslot-statistics
Use display detnetoam timeslot-statistics to display timeslot deviation measurement results for a path group in the most recent five probe intervals.
Syntax
display detnetoam timeslot-statistics device-id device-id session-id session-id [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
device-id: Specifies an ingress edge node, which constructs the probe packets, by its ID in the range of 1 to 255. A pair of a device ID and a session ID uniquely identifies a probe session.
session-id: Specifies a DetNetOAM probe session by its ID in the range of 1 to 1048575. A pair of a device ID and a session ID uniquely identifies a probe session.
verbose: Displays detailed timeslot deviation measurement results for the specified probe session. If you do not specify this keyword, the command displays brief timeslot deviation measurement results.
Examples
# Display brief timeslot deviation measurement results for the probe session with device ID 1 and session ID 1.
<Sysname> display detnetoam timeslot-statistics device-id 1 session-id 1
DeviceID: 1 SessionID: 1
Period ID Sequence ID TTL TimeSlotOffset
28020376 1 255 12
28020376 2 255 12
28020376 3 255 12
28020376 4 255 12
28020376 5 255 12
28020376 6 255 12
28020376 7 255 12
28020376 8 255 12
28020376 9 255 12
28020376 10 255 12
# Display detailed timeslot deviation measurement results for the probe session with device ID 1 and session ID 1.
<Sysname> display detnetoam timeslot-statistics device-id 1 session-id 1 verbose
Device ID : 1
Session ID : 1
PathGroupID : 10
PathID : 1
Period ID : 28020378
Sequence ID : 1
TTL : 255
TimeSlotOffset : 3
Device ID : 1
Session ID : 1
PathGroupID : 10
PathID : 2
Period ID : 28020378
Sequence ID : 2
TTL : 255
TimeSlotOffset : 12
Table 4 Command output
Field |
Description |
Device ID |
ID of the ingress edge node that constructs the DetNetOAM probe packet. |
Session ID |
DetNetOAM probe session ID. |
Period ID |
DetNetOAM probe interval ID. |
Sequence ID |
DetNetOAM probe packet ID. |
TTL |
TTL value of the DetNetOAM probe packet. |
TimeSlotOffset |
Timeslot deviation. |
PathGroupID |
ID of the path group probed by DetNetOAM. |
PathID |
ID of the path through which the probe packet is forwarded. |
Related commands
display detnetoam instance
flow
Use flow to configure parameters for DetNetOAM probe packets.
Use undo flow to delete parameter settings for DetNetOAM probe packets.
Syntax
flow source-ip src-ip-address destination-ip dest-ip-address source-port src-port-number destination-port dest-port-number [ dscp dscp-value ]
flow source-ipv6 src-ipv6-address destination-ipv6 dest-ipv6-address source-port src-port-number destination-port dest-port-number [ dscp dscp-value ]
undo flow
Default
No parameters are configured for DetNetOAM probe packets.
Views
DetNetOAM instance view
Predefined user roles
network-admin
Parameters
source-ip src-ip-address: Specifies a source IPv4 address for DetNetOAM probe packets, in dotted decimal format.
destination-ip dest-ip-address: Specifies a destination IPv4 address for DetNetOAM probe packets, in dotted decimal format.
source-ipv6 src-ipv6-address: Specifies a source IPv6 address for DetNetOAM probe packets.
destination-ipv6 dest-ipv6-address: Specifies a destination IPv6 address for DetNetOAM probe packets.
source-port src-port-number: Specifies a source port number for DetNetOAM probe packets, in the range of 0 to 65535.
destination-port dest-port-number: Specifies a destination port number for DetNetOAM probe packets, in the range of 0 to 65535.
dscp dscp-value: Specifies a DSCP value for DetNetOAM probe packets, in the range of 0 to 63. The default value for this argument is 63.
Usage guidelines
If you execute this command multiple times for a DetNetOAM instance, the most recent configuration takes effect.
If DetNetOAM probing is enabled for a DetNetOAM instance, you cannot use this command to edit parameter settings for probe packets. To edit parameter settings for probe packets, first use the undo measure enable command to disable DetNetOAM probing for the instance.
Examples
# Specify the source IPv4 address as 10.10.10.1, destination IPv4 address as 10.10.10.2, source port number as 234, destination port number as 663, and DSCP value as 23 for probe packets in DetNetOAM instance abc.
<Sysname> system-view
[Sysname] detnetoam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] flow source-ip 10.10.10.1 destination-ip 10.10.10.2 source-port 234 destination-port 663 dscp 23
instance
Use instance to create a DetNetOAM instance and enter its view, or enter the view of an existing DetNetOAM instance.
Use undo instance to delete a DetNetOAM instance.
Syntax
instance instance-name
undo instance instance-name
Default
No DetNetOAM instances exist.
Views
DetNetOAM view
Predefined user roles
network-admin
Parameters
instance-name: Specifies a DetNetOAM instance by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
To perform DetNetOAM probing for a DetNet network, you must create a DetNet instance on its ingress edge node. You can configure the probe interval, probe packets parameters, and bound DetNet path in the instance.
You do not need to create any DetNet instance on the transit nodes and egress edge node of the DetNet network. Enable DetNetOAM on these node and DetNetOAM probing can be performed.
Examples
# Create DetNetOAM instance abc and enter its view.
<Sysname> system-view
[Sysname] detnetoam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-abc]
measure enable
Use measure enable to enable DetNetOAM probing for a DetNetOAM instance.
Use undo measure enable to disable DetNetOAM probing for a DetNetOAM instance.
Syntax
measure enable
undo measure enable
Default
DetNetOAM probing is disabled for a DetNetOAM instance.
Views
DetNetOAM instance view
Predefined user roles
network-admin
Usage guidelines
Use this command to enable DetNetOAM probing for a DetNetOAM instance.
Before executing this command, you must first create a DetNetOAM instance, bind a DetNet path, and configure the probe packet parameters. Without the configuration of these settings, this command does not take effect.
After executing this command for a DetNetOAM instance, you cannot edit the settings of the DetNetOAM instance. To edit its settings, first use the undo measure enable command to disable DetNetOAM probing for the instance.
Examples
# Enable DetNetOAM probing for DetNetOAM instance abc.
<Sysname> system-view
[Sysname] detnetoam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] measure enable
period
Use period to configure the DetNetOAM probe interval for a DetNetOAM instance.
Use undo period to restore the default.
Syntax
period period
undo period
Default
The probe interval for a DetNetOAM instance is 60 seconds.
Views
DetNetOAM instance view
Predefined user roles
network-admin
Parameters
period: Specifies a probe interval for a DetNetOAM instance. The value for this argument takes 10, 60, or 600 seconds.
Usage guidelines
The ingress edge node sends probe packets in the probe interval of the DetNetOAM instance.
If DetNetOAM probing is enabled for a DetNetOAM instance, you cannot edit its probe interval. To edit the probe interval, first use the undo measure enable command to disable DetNetOAM probing for the instance.
Examples
# Configure the probe interval for DetNetOAM instance abc as 10 seconds.
<Sysname> system-view
[Sysname] detnetoam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] period 10
reset detnetoam delay-statistics
Use reset detnetoam delay-statistics to clear latency measurement statistics for the DetNetOAM probe session.
Syntax
reset detnetoam delay-statistics [ device-id device-id session-id session-id ]
Views
Any view
Predefined user roles
network-admin
Parameters
device-id: Specifies an ingress edge node, which constructs the probe packets, by its ID in the range of 1 to 1048575. A pair of a device ID and a session ID uniquely identifies a probe session.
session-id: Specifies a DetNetOAM probe session by its ID in the range of 1 to 4294967295. A pair of a device ID and a session ID uniquely identifies a probe session.
Examples
# Clear latency measurement statistics for the DetNetOAM probe session with Device ID 1 and Session ID 1.
<Sysname> reset detnetoam delay-statistics device-id 1 session-id 1
Related commands
display detnetoam delay-statistics
reset detnetoam timeslot-statistics
Use reset detnetoam timeslot-statistics to clear timeslot deviation measurement statistics for the DetNetOAM probe session.
Syntax
reset detnetoam timeslot-statistics [ device-id device-id session-id session-id ]
Views
Any view
Predefined user roles
network-admin
Parameters
device-id: Specifies an ingress edge node, which constructs the probe packets, by its ID in the range of 1 to 255. A pair of a device ID and a session ID uniquely identifies a probe session.
session-id: Specifies a DetNetOAM probe session by its ID in the range of 1 to 1048575. A pair of a device ID and a session ID uniquely identifies a probe session.
Examples
# Clear timeslot deviation measurement statistics for the DetNetOAM probe session with Device ID 1 and Session ID 1.
<Sysname> reset detnetoam timeslot-statistics device-id 1 session-id 1
Related commands
display detnetoam session-statistics