Contents

1 Adaptive routing commands· 1-1

1.1.1 adaptive-routing enable· 1-1

1.1.2 adaptive-routing detect 1-1

1.1.3 adaptive-routing interval 1-2

1.1.4 adaptive-routing udp-port 1-3

1.1.5 adaptive-routing udp-source-ip· 1-3

1.1.6 display adaptive-routing device status· 1-4

1.1.7 extcommunity-type device-id· 1-4

1.1.8 peer advertise device-id· 1-5

 

1 Adaptive routing commands

1.1.1  adaptive-routing enable

Use adaptive-routing enable to enable adaptive routing globally and enter adaptive routing view.

Use undo adaptive-routing enable to disable adaptive routing.

Syntax

adaptive-routing enable

undo adaptive-routing enable

Default

Adaptive routing is disabled globally.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Application scenarios

As a network routing technology, adaptive routing enables routers to detect network-wide topology changes, and dynamically perform path selection based on the changes. This can optimize network performance, ensure packet forwarding efficiency, reduce latency, avoid congestion, and enhance the overall reliability and efficiency of the network.

Restrictions and guidelines

Use this command to enable or disable adaptive routing globally for a device. If adaptive routing is disabled globally, all adaptive routing settings cannot take effect on the device. Disabling adaptive routing globally will remove adaptive routing settings from the interfaces on the device.

Examples

# Enable adaptive routing globally and enter adaptive routing view.

<Sysname> system-view

[Sysname] adaptive-routing enable

[Sysname-adaptive-routing]

1.1.2  adaptive-routing detect

Use adaptive-routing detect to enable adaptive routing for an interface and advertise the local device ID to the peer device.

Use undo adaptive-routing detect to restore the default.

Syntax

adaptive-routing detect

undo adaptive-routing detect

Default

Adaptive routing is disabled for an interface.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Application scenarios

Use this command to control ARN packet advertisement. An interface can send ARN packets only after you configure this command for it.

Restrictions and guidelines

This command can take effect only after you enable adaptive routing globally.

Examples

# Enable adaptive routing for interface GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] adaptive-routing detect

1.1.3  adaptive-routing interval

Use adaptive-routing interval to configure the ARN packet sending interval.

Use undo adaptive-routing interval to restore the default.

Syntax

adaptive-routing interval interval-value

undo adaptive-routing interval

Default

The ARN packet sending interval is 500 milliseconds.

Views

Adaptive routing view

Predefined user roles

network-admin

mdc-admin

Parameters

interval-value: Specifies an ARN packet sending interval in milliseconds, an integer in the range of 100 to 10000 and in steps of 100.

Usage guidelines

Adaptive routing requires the peer end to acknowledge the sent ARN packets. If no acknowledgment packets are received, the device will retransmit the ARN packets at the specified intervals.

Examples

# Configure the ARN packet sending interval as 200 milliseconds.

<Sysname> system-view

[Sysname] adaptive-routing enable

[Sysname-adaptive-routing] adaptive-routing interval 200

1.1.4  adaptive-routing udp-port

Use adaptive-routing udp-port to configure the source and destination UDP port numbers for ARN packets.

Use undo adaptive-routing udp-port to restore the default.

Syntax

adaptive-routing udp-port port-number

undo adaptive-routing udp-port

Default

The source and destination UDP port numbers for ARN packets are both 4780.

Views

Adaptive routing view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a port number in the range 1024 to 50000.

Usage guidelines

You must specify the UDP port numbers as the same value for the devices that receive and send ARN packets.

Examples

# Configure the source and destination UDP port numbers for ARN packets as 4955.

<Sysname> system-view

[Sysname] adaptive-routing enable

[Sysname-adaptive-routing] adaptive-routing udp-port 4955

1.1.5  adaptive-routing udp-source-ip

Use adaptive-routing udp-source-ip to configure the source IPv4 address for ARN packets.

Use undo adaptive-routing udp-source-ip to restore the default.

Syntax

adaptive-routing udp-source-ip ipv4-address

undo adaptive-routing udp-source-ip

Default

The source IPv4 address for ARN packets is 1.1.1.1.

Views

Adaptive routing view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv4-address: Specifies the source IPv4 address of ARN packets.

Examples

# Configure the source IPv4 address for ARN packets as 2.2.2.2.

<Sysname> system-view

[Sysname] adaptive-routing enable

[Sysname-adaptive-routing] adaptive-routing udp-source-ip 2.2.2.2

1.1.6  display adaptive-routing device status

Use display adaptive-routing device status to display device ID-to-interface mapping information.

Syntax

display adaptive-routing device status [ device-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

device-id: Specifies a device by its device ID. If you do not specify this argument, the command displays information about all device ID-to-interface mappings.

Examples

# Display device ID-to-interface mapping information.

<Sysname> display adaptive-routing device status

  Local Device Id: 3.3.3.3

 

  Device ID: 1.1.1.1

  Interface                             Status

  GigabitEthernet1/0/1                Up

 

  Device ID: 2.2.2.2

  Interface                             Status

  GigabitEthernet1/0/2                Up

表1-1 Command output

Field	Description
Device ID	Device ID.
Interface	Name of the interface that receives the ARP packets carrying the specified device ID.
Status	Interface state.

 

1.1.7  extcommunity-type device-id

Use extcommunity-type device-id to configure the type value for the device ID extended community attribute.

Use undo extcommunity-type device-id to restore the default.

Syntax

extcommunity-type device-id device-type-value

undo extcommunity-type device-id

Default  

The type value for the device ID extended community attribute is 84ef in hexadecimal format.

Views

BGP instance view

Predefined user roles

network-admin

mdc-admin

Parameters

device-type-value: Specifies the type value for the device ID extended community attribute, a hexadecimal number in the range of 0 to ffff.

Usage guidelines

The device ID extended community attribute is an H3C-proprietary attribute. For interoperability purposes, you can use this command to change the type value for the device ID extended community attribute to a value that can be identified by other vendors.

Examples

# Configure the type value for the device ID extended community attribute as 0x5688.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] extcommunity-type device-id 5688

1.1.8  peer advertise device-id

Use peer advertise device-id to advertise the device ID extended community attribute to a peer or peer group.

Use undo peer advertise device-id to restore the default.

Syntax

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } advertise device-id

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } advertise device-id

Default

BGP does not advertise the device ID extended community attribute to a peer or peer group.

Views

BGP IPv4 unicast address family view

BGP IPv6 unicast address family view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ipv4-address: Specifies a peer by its IPv4 address. The peer must have been created.

mask-length: Specifies a mask length in the range of 0 to 32. You can use the ipv4-address and mask-length arguments together to specify a subnet. If you specify a subnet, this command applies to all dynamic peers in the subnet.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

prefix-length: Specifies a prefix length in the range of 0 to 128. You can use the ipv6-address and prefix-length arguments together to specify a subnet. If you specify a subnet, this command applies to all dynamic peers in the subnet.

Usage guidelines

Application scenarios

Adaptive routing requires advertising the device ID extended community attribute in BGP routes to implement fast path switchover.

Operating mechanism

The device can advertise the device ID extended community attribute in BGP routes only when the peer advertise-ext-community command is configured. The device ID is the global router ID configured for the local device.

Restrictions and guidelines

If a device does not support advertising the device ID extended community attribute, the device cannot process the device ID extended community attribute in received BGP routes. In addition, the device cannot carry the device ID extended community attribute when forwarding the BGP routes.

The device ID extended community attribute is an H3C-proprietary attribute. For interoperability purposes, you can use extcommunity-type device-id command to change the type value for the device ID extended community attribute to a value that can be identified by other vendors.

Examples

# In BGP IPv4 unicast address family view, enable BGP to advertise the device ID extended community attribute to the peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] peer 1.1.1.1 advertise device-id