Arouteserver

------

- Fix: ``--merge-from-custom-file`` overriding configs from ``clients-from-euroix``.

The ``--merge-from-custom-file`` option of the ``clients-from-euroix`` command is supposed to merge the configurations from a local file into the final content that it generates for clients.yml. However, a bug was triggering an undesired behaviour, for which the ``cfg`` settings from the local file were overriding those automatically generated by the command. This was leading to the removal of information such as max-prefix and as-set that were originally populated using the Euro-IX records.

------

- New: add support for `BIRD 2.14 <http://trubka.network.cz/pipermail/bird-users/2023-October/017161.html>`__ and `OpenBGPD 8.3 <https://www.mail-archive.com/techopenbsd.org/msg76545.html>`__, also added to the integration testing suite.

------

- New: add support for `OpenBGPD 8.0 <https://undeadly.org/cgi?action=article;sid=20230505054214>`__, also added to the integration testing suite.

- New: add early support for BIRD v3 (current release `3.0alpha2 <https://bird.network.cz/pipermail/bird-users/2023-May/016913.html>`__), for testing purposes only.

------

This release **breaks backward compatibility** (BIRD configs only): the default target version used to build BIRD configurations (when the ``--target-version`` argument is not given) is now the latest from the version 2 of BIRD (2.13 at the moment); previously it was 1.6.8. Use the ``--target-version 1.6.8`` command line argument to build 1.6 compatible configurations.

Please note: `BIRD 1 will reach end of life at the end of the year 2023 <https://www.mail-archive.com/bird-usersnetwork.cz/msg07316.html>`__.

- New: add support for `BIRD 2.13 <https://www.mail-archive.com/bird-usersnetwork.cz/msg07305.html>`__, also added to the integration testing suite.

- New: support to build configurations for multiple route servers at once.

Providing a list of values in the ``router_id`` setting of the ``general.yml`` file allows ARouteServer to build configurations for multiple route servers during the same execution.

For more details see `Building configurations for multiple route servers <https://arouteserver.readthedocs.io/en/latest/CONFIG.html#building-configurations-for-multiple-route-servers>`__ on the doc web site.

- Fix: ``ixf-member-export`` (to build an Euro-IX JSON export file from clients.yml) now sets the ``routeserver`` flag of members to ``True``.

See also `GitHub issue 120 <https://github.com/pierky/arouteserver/issues/120>`__.

------

- New: add support for `OpenBGPD 7.8 <https://www.mail-archive.com/techopenbsd.org/msg74147.html>`__, also added to the integration testing suite.

------

- Deprecation: support for overly old OpenBGPD versions (< 7.0) is removed.

See `GitHub PR 117 <https://github.com/pierky/arouteserver/pull/117>`__.

- New: add support for `BIRD 2.0.11 <https://bird.network.cz/pipermail/bird-users/2022-December/016431.html>`__, also added to the integration testing suite.

- New: mapping of 32bit ASNs to 16bit private ASNs for announcement control standard BGP communities.

A new feature is added to allow 32bit ASN clients to be mapped to 16bit ASNs in the standard BGP communities used for announcement control. This feature allows clients to use the 16bit mapped ASN as the ``peer_as`` value for standard BGP communities like *do not announce to $PEER*. In those communities, the 32bit ASN will be represented by the 16bit value which is mapped to it.

For details on how to configure this feature, see the documentation, `"BGP Communities" section <https://arouteserver.readthedocs.io/en/latest/CONFIG.html#bgp-communities>`__.

See also `GitHub issue 101 <https://github.com/pierky/arouteserver/issues/101>`__.

- New: add support for `RFC9234 Route Leak Prevention and Detection Using Roles <https://www.rfc-editor.org/rfc/rfc9234>`__.

A new configuration option is available in general.yml to enable RFC9234 roles (supported by BIRD >= 2.0.11 and OpenBGPD >= 7.5, even though `discouraged until 7.8 will be out <https://github.com/openbgpd-portable/openbgpd-portable/issues/51>`__).
When that's set, BGP sessions on the route server are configured to announce the route-server role and routes received from clients and tagged with the OTC (Only To Customer) attribute are dropped.

This option can be enabled in backward compatibility mode in the general.yml file, and can also be tuned on a client-by-client basis via the clients.yml file.

Details can be found in the `documentation page of general.yml <https://arouteserver.readthedocs.io/en/latest/GENERAL.html#rfc9234-roles-roles>`__.

- New: anchors in HTML pages.

The route server policy textual representation HTML files generated via the ``html`` command now have anchors at the various headers and sub-headers, so when referring other parties to the policy they can be pointed directly to the relevant section.

See also `GitHub issue 119 <https://github.com/pierky/arouteserver/issues/119>`__.

- Fix: minor issues with the HTML pages.

Wrong URL in some links and a misleading reference to a wrong mailing list post about private ASNs.

See also `GitHub issue 119 <https://github.com/pierky/arouteserver/issues/119>`__.

Please note: starting with the next release, the default target version used to build BIRD configurations (when the ``--target-version`` argument is not given) will be the latest from the 2.x major version; until now it was 1.6.8. Operators will need to use the ``--target-version 1.6.8`` command line argument to build BIRD 1.x compatible configurations.