17-Deterministic Network Technologies Command Reference

HomeSupportRoutersCR16000-M SeriesReference GuidesCommand ReferencesH3C CR16000-M Router Command Reference-R8630Pxx-6W10017-Deterministic Network Technologies Command Reference
02-DetNetOAM commands
Title Size Download
02-DetNetOAM commands 121.40 KB

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

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Intelligent Storage
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
  • Technical Blogs
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网