xpl extcommunity-list soo

Function

The xpl extcommunity-list soo command creates a site of origin (SoO) set and displays the SoO set view.

The undo xpl extcommunity-list soo command deletes a specified SoO set.

By default, no SoO sets are configured.

Format

xpl extcommunity-list soo soo-list-name

undo xpl extcommunity-list soo soo-list-name

Parameters

Parameter	Description	Value
soo-list-name	Specifies the name of an SoO set.	The value is a string of 1 to 200 case-sensitive characters, spaces not supported. The string can contain letters, digits, underscores (_), hyphens (-), and dots (.). It must start with a letter or digit.

Parameter

Description

Value

soo-list-name

Specifies the name of an SoO set.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported. The string can contain letters, digits, underscores (_), hyphens (-), and dots (.). It must start with a letter or digit.

Views

System view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
route-base	write

Usage Guidelines

Usage Scenario

An SoO set is a group of data related to the SoO extended community attribute and can be used by route-filters to filter VPN routes. To create an SoO set and enter the SoO set view, run the xpl extcommunity-list soo command.

Follow-up Procedure

Configure elements for the set and separate every two neighboring elements with a comma (,). The elements can be configured in any of the following formats:
- 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295.
- IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IPv4 address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
- Integral 4-byte AS number:2-byte user-defined number, for example, 0:3 or 65537:3. The integral 4-byte AS number ranges from 65536 to 4294967295, and the user-defined number is an integer ranging from 0 to 65535.
- 4-byte AS number in dotted notation (x.y):2-byte user-defined number, for example, 0.0:3 or 0.1:0. The x, y, and user-defined number are integers ranging from 0 to 65535.
- regular regular-expression: matches VPN routes with SoO in the specified regular expression. For detailed description about regular expressions, see Configuration Guide - Basic Configuration.
  In the preceding elements, either value around a colon (:) can be replaced by an asterisk (*) to match any value.
  Regular expression processing is computing-intensive. When a large number of regular expressions are configured in an XPL policy to match a BGP route attribute and the length of the route attribute is long, the processing performance of the XPL policy deteriorates. To improve the processing performance of the routing policy, decrease the number of regular expressions or use a non-regular expression matching command.
  It is recommended that a maximum of 100 regular expressions be configured for each policy.
Run the end-list command in the SoO set view to conclude the configuration of the SoO set.

Precautions

An SoO set is only a group of data used as matching rules and does not have the permit or deny function. Therefore, an SoO set can be used to filter routes only after it is referenced by a route-filter.

To exit from the SoO set view, run the abort command in the SoO set view.

If the SoO attribute is set to be in the format of 4-byte AS number:2-byte user-defined number, the filtering rule that uses the SoO-based regular expression is affected by the as-notation plain command:

If the as-notation plain command is run, route matching can succeed only after the regular expression is set to be in the format of integral 4-byte AS number:2-byte user-defined number.
If the as-notation plain command is not run, route matching can succeed only after the regular expression is set to be in the format of 4-byte AS number in dotted notation:2-byte user-defined number.
Note: If the as-notation plain command is run after the regular expression is configured, you need to reconfigure the RD value using the rdStr parameter; otherwise, route matching may fail against an import or export route-policy, causing a network fault.

Example

# Configure an SoO set named soo1.

<HUAWEI> system-view
[~HUAWEI] xpl extcommunity-list soo soo1
[~HUAWEI-xpl-ext-soo] 2:1,
[~HUAWEI-xpl-ext-soo] 2:12,
[~HUAWEI-xpl-ext-soo] 192.168.122.15:1,
[~HUAWEI-xpl-ext-soo] regular ^10:3
[~HUAWEI-xpl-ext-soo] end-list