preference (RIPng view)

Function

The preference command specifies a priority for RIPng routes. Alternatively, you can set a priority for a specific route using a route-policy.

The undo preference command restores the default setting.

By default, the priority of RIPng routes is 100.

Format

preference { { route-policy route-policy-name | route-filter route-filter-name } | value } ^*

undo preference

Parameters

Parameter	Description	Value
route-policy route-policy-name	Specifies the name of a route-policy, using which the priority of the routes meeting matching conditions can be set.	The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
route-filter route-filter-name	Specifies the name of a route-filter, using which the priority of the routes meeting matching conditions can be set.	The value is a string of 1 to 200 case-sensitive characters, spaces not supported. If parameters are included in the referenced route-filter, specify values for them in the format of (var1, var2, ...var8) behind the route-filter name. A maximum of eight parameters can be specified, and each value ranges from 1 to 200 characters.
value	Specifies the priority of RIPng routes.	The value is an integer ranging from 1 to 255.

Parameter

Description

Value

route-policy route-policy-name

Specifies the name of a route-policy, using which the priority of the routes meeting matching conditions can be set.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

route-filter route-filter-name

Specifies the name of a route-filter, using which the priority of the routes meeting matching conditions can be set.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported. If parameters are included in the referenced route-filter, specify values for them in the format of (var1, var2, ...var8) behind the route-filter name. A maximum of eight parameters can be specified, and each value ranges from 1 to 200 characters.

value

Specifies the priority of RIPng routes.

The value is an integer ranging from 1 to 255.

Views

RIPng view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
ripng	write

Usage Guidelines

Usage Scenario

The smaller the priority value, the higher the priority. To enable RIPng routes to have a higher priority than the routes learned from other IGPs, set a smaller priority value for the RIP routes. The priority determines which algorithm is used to calculate the optimal route among the routes in the IP routing table.

Prerequisites

A route-policy has been configured using the route-policy command.

Configuration Impact

If the preference command is run more than once, the latest configuration overrides the previous one.

Example

# Apply route-filter named filter1 and XPL para (10,11,12,13,14,15,16,17) to set the priority of RIPng routes to 60.

<HUAWEI> system-view
[~HUAWEI] xpl route-filter filter1
[~HUAWEI-xpl-filter] end-filter
[*HUAWEI] ripng 100
[*HUAWEI-ripng-100] preference route-filter filter1(10,11,12,13,14,15,16,17) 60

# Restore the default priority of RIPng routes.

<HUAWEI> system-view
[~HUAWEI] ripng 100
[*HUAWEI-ripng-100] undo preference

# Apply route-policy named policy1 to set the priority of RIPng routes to 60.

<HUAWEI> system-view
[~HUAWEI] route-policy policy1 permit node 10
[*HUAWEI-route-policy] quit
[*HUAWEI] ripng 100
[*HUAWEI-ripng-100] preference route-policy policy1 60

# Set the priority of RIPng routes to 120.

<HUAWEI> system-view
[~HUAWEI] ripng 100
[*HUAWEI-ripng-100] preference 120