Skip to content

Local-as refactoring and extension #1508

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rszarecki wants to merge 5 commits into
base: master
Choose a base branch
from
Open

Local-as refactoring and extension #1508

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
3501335
Deprecation of ../config/local-as leaf and replacement with
rszarecki Jun 16, 2026
4437a93
Update release/models/bgp/openconfig-bgp-common.yang
rszarecki Jun 16, 2026
8cc5282
Update release/models/bgp/openconfig-bgp-neighbor.yang
rszarecki Jun 16, 2026
ead8f31
Update release/models/bgp/openconfig-bgp-peer-group.yang
rszarecki Jun 16, 2026
ee7d45e
Fix typos in bgp-local-as-group-config descriptions
rszarecki Jun 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion release/models/bgp/openconfig-bgp-common-multiprotocol.yang
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,15 @@ submodule openconfig-bgp-common-multiprotocol {
for multiple protocols in BGP. The groupings are common across
multiple contexts.";

oc-ext:openconfig-version "9.9.1";
oc-ext:openconfig-version "9.10.0";

revision "2026-06-16" {
description
"Deprecation of ../config/local-as leaf and replacement with
local-as-options container. Extending with RFC7705 no-prepend
and replace-as explicit flags and dual-as option.";
reference "9.10.0";
}

revision "2025-04-18" {
description
Expand Down
10 changes: 9 additions & 1 deletion release/models/bgp/openconfig-bgp-common-structure.yang
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,15 @@ submodule openconfig-bgp-common-structure {
"This sub-module contains groupings that are common across multiple BGP
contexts and provide structure around other primitive groupings.";

oc-ext:openconfig-version "9.9.1";
oc-ext:openconfig-version "9.10.0";

revision "2026-06-16" {
description
"Deprecation of ../config/local-as leaf and replacement with
local-as-options container. Extending with RFC7705 no-prepend
and replace-as explicit flags and dual-as option.";
reference "9.10.0";
}

revision "2025-04-18" {
description
Expand Down
62 changes: 60 additions & 2 deletions release/models/bgp/openconfig-bgp-common.yang
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,21 @@ submodule openconfig-bgp-common {
may be application to a subset of global, peer-group or neighbor
contexts.";

oc-ext:openconfig-version "9.9.1";
oc-ext:openconfig-version "9.10.0";

revision "2026-06-16" {
description
"Deprecation of ../config/local-as leaf and replacement with
local-as-options container. Extending with RFC7705 no-prepend
and replace-as explicit flags and dual-as option.";
reference "9.10.0";
}

revision "2025-04-18" {
description
"Clarification to usage of link-bandwidth-ext-community
container under BGP use-multiple-paths`.";
reference "9.9.1";
reference "9.9.1";
}

revision "2025-03-30" {
Expand Down Expand Up @@ -279,6 +287,55 @@ submodule openconfig-bgp-common {
}
}

grouping bgp-local-as-group-config {
description
"Local-AS configuration items.
Local-AS is a migration tool described in RFC7705";

leaf local-as {
type oc-inet:as-number;
description
"The local autonomous system number that is to be used
when establishing sessions with the remote peer or peer
group, if this differs from the global BGP router
autonomous system number. Value is set in My Autonomous
System of the OPEN message sent to establish session.";
reference
"RFC7705: Autonomous System Migration Mechanisms
and Their Effects on the BGP AS_PATH Attribute.
Section 3.1 - Modify Inbound BGP AS_PATH Attribute";
}
Comment thread
rszarecki marked this conversation as resolved.

leaf no-prepend {
type boolean;
description
"When set to TRUE, the value configured as local-as is
not prepended to AS-PATH on received routes.";
reference
"RFC7705: Autonomous System Migration Mechanisms
and Their Effects on the BGP AS_PATH Attribute.
Section 3.1 - Modify Inbound BGP AS_PATH Attribute";
}
Comment thread
rszarecki marked this conversation as resolved.

leaf replace-as {
type boolean;
description
"When set to TRUE, the global AS is not added to AS-PATH
when route is advertised to peer. Only local-as is prepended.";
reference
"RFC7705: Autonomous System Migration Mechanisms
and Their Effects on the BGP AS_PATH Attribute.
Section 3.2 - Modify Outbound BGP AS_PATH Attribute";
}

leaf dual-as {
type boolean;
description
"When set to TRUE, the speaker alternates between local-ASN

@earies earies Jun 19, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TMK - the speaker does not alternate but rather this should allow for accepting OPEN messages from peers presenting either the local or global ASN

@earies earies Jun 19, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Correction: https://datatracker.ietf.org/doc/html/rfc7705#section-4.2

the speaker SHOULD send BGP OPEN using the globally configured ASN
first, and only send a BGP OPEN using the locally configured ASN as a
fallback if the remote neighbor responds with the BGP error "Bad Peer
AS".

and global ASN in every other OPEN messages.";
}
Comment thread
rszarecki marked this conversation as resolved.
}

grouping bgp-common-neighbor-group-config {
description
"Neighbor level configuration items.";
Expand All @@ -291,6 +348,7 @@ submodule openconfig-bgp-common {

leaf local-as {
type oc-inet:as-number;
status deprecated;
description
"The local autonomous system number that is to be used
when establishing sessions with the remote peer or peer
Expand Down
10 changes: 9 additions & 1 deletion release/models/bgp/openconfig-bgp-global.yang
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,15 @@ submodule openconfig-bgp-global {
"This sub-module contains groupings that are specific to the
global context of the OpenConfig BGP module";

oc-ext:openconfig-version "9.9.1";
oc-ext:openconfig-version "9.10.0";

revision "2026-06-16" {
description
"Deprecation of ../config/local-as leaf and replacement with
local-as-options container. Extending with RFC7705 no-prepend
and replace-as explicit flags and dual-as option.";
reference "9.10.0";
}

revision "2025-04-18" {
description
Expand Down
31 changes: 30 additions & 1 deletion release/models/bgp/openconfig-bgp-neighbor.yang
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,15 @@ submodule openconfig-bgp-neighbor {
"This sub-module contains groupings that are specific to the
neighbor context of the OpenConfig BGP module.";

oc-ext:openconfig-version "9.9.1";
oc-ext:openconfig-version "9.10.0";

revision "2026-06-16" {
description
"Deprecation of ../config/local-as leaf and replacement with
local-as-options container. Extending with RFC7705 no-prepend
and replace-as explicit flags and dual-as option.";
reference "9.10.0";
}

revision "2025-04-18" {
description
Expand Down Expand Up @@ -877,6 +885,27 @@ submodule openconfig-bgp-neighbor {
the neighbor";
uses bgp-neighbor-afi-safi-list;
}

container local-as-options {
description
"Local-AS options.
Local-AS is a migration tool described in RFC7705.";

container config {
description
"Local-AS options configuration.
Local-AS is a migration tool described in RFC7705.";
uses bgp-local-as-group-config;
}

container state {
config false;
description
"Local-AS options state.
Local-AS is a migration tool described in RFC7705.";
uses bgp-local-as-group-config;
}
}
Comment thread
rszarecki marked this conversation as resolved.
}

grouping bgp-neighbor-list {
Expand Down
31 changes: 30 additions & 1 deletion release/models/bgp/openconfig-bgp-peer-group.yang
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,15 @@ submodule openconfig-bgp-peer-group {
"This sub-module contains groupings that are specific to the
peer-group context of the OpenConfig BGP module.";

oc-ext:openconfig-version "9.9.1";
oc-ext:openconfig-version "9.10.0";

revision "2026-06-16" {
description
"Deprecation of ../config/local-as leaf and replacement with
local-as-options container. Extending with RFC7705 no-prepend
and replace-as explicit flags and dual-as option.";
reference "9.10.0";
}

revision "2025-04-18" {
description
Expand Down Expand Up @@ -385,6 +393,27 @@ submodule openconfig-bgp-peer-group {
thegroup";
uses bgp-peer-group-afi-safi-list;
}

container local-as-options {
description
"Local-AS options.
Local-AS is a migration tool described in RFC7705.";

container config {
description
"Local-AS options configuration.
Local-AS is a migration tool described in RFC7705.";
uses bgp-local-as-group-config;
}

container state {
config false;
description
"Local-AS options state.
Local-AS is a migration tool described in RFC7705.";
uses bgp-local-as-group-config;
}
}
Comment thread
rszarecki marked this conversation as resolved.
}

grouping bgp-peer-group-list {
Expand Down
10 changes: 9 additions & 1 deletion release/models/bgp/openconfig-bgp.yang
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,15 @@ module openconfig-bgp {
whereas leaf not present inherits its value from the leaf present
at the next higher level in the hierarchy.";

oc-ext:openconfig-version "9.9.1";
oc-ext:openconfig-version "9.10.0";

revision "2026-06-16" {
description
"Deprecation of ../config/local-as leaf and replacement with
local-as-options container. Extending with RFC7705 no-prepend
and replace-as explicit flags and dual-as option.";
reference "9.10.0";
}

revision "2025-04-18" {
description
Expand Down
Loading