- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-DetNetOAM commands | 88.11 KB |
DetNetOAM commands
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.
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
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 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 : --
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 : --
Path ID : 2
Period : 10 sec
Delay measurement : Disabled
Data size : 128
Flow information: --
Table 1 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 group ID |
This field is not supported in the current software version. ID of the path group. |
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 2 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. |
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] detnet-oam enable
[Sysname-detnetoam] instance abc
[Sysname-detnetoam-instance-abc] period 10