IPv6 Configuration - Setting Up a Service VM as an IPv6 vRouter
===============================================================
-This section provides instructions to set up a service VM as an IPv6 vRouter using OPNFV Gambia Release
+This section provides instructions to set up a service VM as an IPv6 vRouter using OPNFV Hunter Release
installers. Because Open Daylight no longer supports L2-only option, and there is only limited support of
IPv6 in L3 option of Open Daylight, setup of service VM as an IPv6 vRouter is only available under
pure/native OpenStack environment. The deployment model may be HA or non-HA. The infrastructure may be
******************************************
If you intend to set up a service VM as an IPv6 vRouter in OpenStack-only environment of
-OPNFV Gambia Release, please **NOTE** that:
+OPNFV Hunter Release, please **NOTE** that:
* Because the anti-spoofing rules of Security Group feature in OpenStack prevents
a VM from forwarding packets, we need to disable Security Group feature in the
Install OPNFV and Preparation
-----------------------------
-**OPNFV-NATIVE-INSTALL-1**: To install OpenStack-only environment of OPNFV Gambia Release:
+**OPNFV-NATIVE-INSTALL-1**: To install OpenStack-only environment of OPNFV Hunter Release:
**Apex Installer**:
:Abstract:
This document provides the users with the Configuration Guide to set up a
-service VM as an IPv6 vRouter using OPNFV Gambia Release.
+service VM as an IPv6 vRouter using OPNFV Hunter Release.
.. toctree::
:numbered:
:Abstract:
This document provides the users with the Installation Procedure to install
-OPNFV Gambia Release on IPv6-only Infrastructure.
+OPNFV Hunter Release on IPv6-only Infrastructure.
.. toctree::
:numbered:
OPNFV IPv6 Project Release Notes
================================
-This document provides the release notes for Gambia of IPv6 Project.
+This document provides the release notes for Hunter of IPv6 Project.
.. contents::
:depth: 3
| **Date** | **Version** | **Author** | **Comment** |
| | | | |
+--------------------+--------------------+--------------------+----------------------+
-| 2018-09-06 | 0.1.0 | Bin Hu | Initial draft |
-+--------------------+--------------------+--------------------+----------------------+
-| 2018-10-18 | 1.0.0 | Bin Hu | Release ready |
-+--------------------+--------------------+--------------------+----------------------+
-| 2018-12-12 | 1.1.0 | Bin Hu | SR1 Release ready |
-+--------------------+--------------------+--------------------+----------------------+
-| 2019-01-22 | 1.2.0 | Bin Hu | SR2 Release ready |
+| 2019-03-14 | 0.1.0 | Bin Hu | Initial draft |
+--------------------+--------------------+--------------------+----------------------+
Release Data
+--------------------------------------+--------------------------------------+
| **Project** | IPv6 |
+--------------------------------------+--------------------------------------+
-| **Repo/tag** | opnfv-7.2.0 |
+| **Repo/tag** | opnfv-8.0.0 |
+--------------------------------------+--------------------------------------+
-| **Release designation** | Gambia 7.2 |
+| **Release designation** | Hunter 8.0 |
+--------------------------------------+--------------------------------------+
-| **Release date** | January 25, 2019 |
+| **Release date** | May 10, 2019 |
+--------------------------------------+--------------------------------------+
-| **Purpose of the delivery** | OPNFV Gambia 7.2 Release |
+| **Purpose of the delivery** | OPNFV Hunter 8.0 Release |
+--------------------------------------+--------------------------------------+
Important Notes
Summary
-------
-This is the Gambia release of the IPv6 feature as part of OPNFV, including:
+This is the Hunter release of the IPv6 feature as part of OPNFV, including:
* Installation of OPNFV on IPv6-Only Infrastructure by Apex Installer
* Configuration of setting up a Service VM as an IPv6 vRouter in OpenStack-Only
environment
* User Guide, which includes:
- * gap analysis of IPv6 support in OpenStack Pike and OpenDaylight Nitrogen
+ * gap analysis of IPv6 support in OpenStack Rocky and OpenDaylight Fluorine
* exploration of IPv6 in container networking
Please refer to our:
References
----------
-For more information on the OPNFV Gambia release, please see:
+For more information on the OPNFV Hunter release, please see:
http://www.opnfv.org/software
.. (c) Bin Hu (AT&T) and Sridhar Gaddam (RedHat)
====================================
-Using IPv6 Feature of Gambia Release
+Using IPv6 Feature of Hunter Release
====================================
This section provides the users with gap analysis regarding IPv6 feature requirements with
-OpenStack Queens Official Release and Open Daylight Oxygen Official Release. The gap analysis
+OpenStack Rocky Official Release and Open Daylight Fluorine Official Release. The gap analysis
serves as feature specific user guides and references when as a user you may leverage the
IPv6 feature in the platform and need to perform some IPv6 related operations.
-For more information, please find Neutron's IPv6 document for Queens Release [1]_.
+For more information, please find Neutron's IPv6 document for Rocky Release [1]_.
-***************************************
-IPv6 Gap Analysis with OpenStack Queens
-***************************************
+**************************************
+IPv6 Gap Analysis with OpenStack Rocky
+**************************************
This section provides users with IPv6 gap analysis regarding feature requirement with
-OpenStack Neutron in Queens Official Release. The following table lists the use cases / feature
+OpenStack Neutron in Rocky Official Release. The following table lists the use cases / feature
requirements of VIM-agnostic IPv6 functionality, including infrastructure layer and VNF
-(VM) layer, and its gap analysis with OpenStack Neutron in Queens Official Release.
+(VM) layer, and its gap analysis with OpenStack Neutron in Rocky Official Release.
Please **NOTE** that in terms of IPv6 support in OpenStack Neutron, there is no difference
-between **Queens** release and prior, e.g. **Pike** and **Ocata**, release.
+between **Rocky** release and prior, e.g. **Queens**, **Pike** and **Ocata**, release.
.. table::
:class: longtable
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
- |Use Case / Requirement |Supported in Queens|Notes |
+ |Use Case / Requirement |Supported in Rocky |Notes |
+===========================================================+===================+====================================================================+
|All topologies work in a multi-tenant environment |Yes |The IPv6 design is following the Neutron tenant networks model; |
| | |dnsmasq is being used inside DHCP network namespaces, while radvd |
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
|IPv6 Support in "Allowed Address Pairs" Extension |Yes | |
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
- |Support for IPv6 Prefix Delegation. |Yes |Partial support in Queens |
+ |Support for IPv6 Prefix Delegation. |Yes |Partial support in Rocky |
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
- |Distributed Virtual Routing (DVR) support for IPv6 |**No** |In Queens DVR implementation, IPv6 works. But all the IPv6 ingress/ |
+ |Distributed Virtual Routing (DVR) support for IPv6 |**No** |In Rocky DVR implementation, IPv6 works. But all the IPv6 ingress/ |
| | |egress traffic is routed via the centralized controller node, i.e. |
| | |similar to SNAT traffic. |
| | |A fully distributed IPv6 router is not yet supported in Neutron. |
|(keepalived+VRRP). | | |
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
-*******************************************
-IPv6 Gap Analysis with Open Daylight Oxygen
-*******************************************
+*********************************************
+IPv6 Gap Analysis with Open Daylight Fluorine
+*********************************************
This section provides users with IPv6 gap analysis regarding feature requirement with
-Open Daylight Oxygen Official Release. The following table lists the use cases / feature
+Open Daylight Fluorine Official Release. The following table lists the use cases / feature
requirements of VIM-agnostic IPv6 functionality, including infrastructure layer and VNF
-(VM) layer, and its gap analysis with Open Daylight Oxygen Official Release.
+(VM) layer, and its gap analysis with Open Daylight Fluorine Official Release.
-**Open Daylight Oxygen Status**
+**Open Daylight Fluorine Status**
-In Open Daylight Oxygen official release, the legacy ``Old Netvirt`` identified by feature
+In Open Daylight Fluorine official release, the legacy ``Old Netvirt`` identified by feature
``odl-ovsdb-openstack`` is deprecated and no longer supported. The ``New Netvirt``
identified by feature ``odl-netvirt-openstack`` is used.
-Two new features are supported in Open Daylight Oxygen official release:
+Two new features are supported in Open Daylight Fluorine official release:
-* "IPv6 L3VPN Dual Stack with Single router" [5]_
-* "IPv6 Inter Data Center using L3VPNs" [6]_
+* Support for advertising MTU info in IPv6 RAs
+* IPv6 external connectivity for FLAT/VLAN based provider networks
.. table::
:class: longtable
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
- |Use Case / Requirement |Supported in ODL Oxygen |Notes |
+ |Use Case / Requirement |Supported in ODL Fluorine|Notes |
+==================================================+=========================+==============================================================+
|REST API support for IPv6 subnet creation in ODL |Yes |Yes, it is possible to create IPv6 subnets in ODL using |
| | |Neutron REST API. |
| (east-west) | | |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
|IPv6 Router support in ODL: |**NO** |This feature is targeted for Flourine Release. |
- | | |In ODL Oxygen Release, RFE "IPv6 Inter-DC L3 North-South |
+ | | |In ODL Fluorine Release, RFE "IPv6 Inter-DC L3 North-South |
|3. External routing (north-south) | |Connectivity Using L3VPN Provider Network Types" Spec [3]_ is |
| | |merged. But the code patch has not been merged yet. |
| | |On the other hand, "IPv6 Cluster Support" is available in |
- | | |Oxygen Release [4]_. Basically, existing IPv6 features were |
+ | | |Fluorine Release [4]_. Basically, existing IPv6 features were |
| | |enhanced to work in a three node ODL Clustered Setup. |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
|IPAM: Support for IPv6 Address assignment modes. |Yes |ODL IPv6 Router supports all the IPv6 Address assignment |
|IPv6 L3VPN Dual Stack with Single router |Yes |Refer to "Dual Stack VM support in OpenDaylight" Spec [5]_. |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
|IPv6 Inter Data Center using L3VPNs |Yes |Refer to "IPv6 Inter-DC L3 North-South connectivity using |
- | | |L3VPN provider network types" Spec [6]_. |
+ | | |L3VPN provider network types" Spec [3]_. |
+ +--------------------------------------------------+-------------------------+--------------------------------------------------------------+
+ |Support for advertising MTU info in IPv6 RAs |Yes | |
+ +--------------------------------------------------+-------------------------+--------------------------------------------------------------+
+ |IPv6 external connectivity for FLAT/VLAN based |Yes | |
+ |provider networks | | |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
References
-.. [1] Neutron IPv6 Documentation for Queens Release: http://docs.openstack.org/neutron/queens/admin/config-ipv6.html
+.. [1] Neutron IPv6 Documentation for Rocky Release: http://docs.openstack.org/neutron/rocky/admin/config-ipv6.html
.. [2] How to Use Config-Drive for Metadata with IPv6 Network: http://superuser.openstack.org/articles/deploying-ipv6-only-tenants-with-openstack/
.. [3] https://docs.opendaylight.org/projects/netvirt/en/stable-fluorine/specs/oxygen/ipv6-interdc-l3vpn.html
.. [4] http://git.opendaylight.org/gerrit/#/c/66707/
-.. [5] https://docs.opendaylight.org/projects/netvirt/en/stable-oxygen/specs/l3vpn-dual-stack-vms.html
-.. [6] https://docs.opendaylight.org/projects/netvirt/en/stable-oxygen/specs/ipv6-interdc-l3vpn.html
+.. [5] https://docs.opendaylight.org/projects/netvirt/en/stable-fluorine/specs/oxygen/l3vpn-dual-stack-vms.html
.. http://creativecommons.org/licenses/by/4.0
.. (c) Bin Hu (AT&T) and Sridhar Gaddam (RedHat)
-===========================================
-IPv6 Gap Analysis with Open Daylight Oxygen
-===========================================
+=============================================
+IPv6 Gap Analysis with Open Daylight Fluorine
+=============================================
This section provides users with IPv6 gap analysis regarding feature requirement with
-Open Daylight Oxygen Official Release. The following table lists the use cases / feature
+Open Daylight Fluorine Official Release. The following table lists the use cases / feature
requirements of VIM-agnostic IPv6 functionality, including infrastructure layer and VNF
-(VM) layer, and its gap analysis with Open Daylight Oxygen Official Release.
+(VM) layer, and its gap analysis with Open Daylight Fluorine Official Release.
-**Open Daylight Oxygen Status**
+**Open Daylight Fluorine Status**
-In Open Daylight Oxygen official release, the legacy ``Old Netvirt`` identified by feature
+In Open Daylight Fluorine official release, the legacy ``Old Netvirt`` identified by feature
``odl-ovsdb-openstack`` is deprecated and no longer supported. The ``New Netvirt``
identified by feature ``odl-netvirt-openstack`` is used.
-Two new features are supported in Open Daylight Oxygen official release:
+Two new features are supported in Open Daylight Fluorine official release:
-* "IPv6 L3VPN Dual Stack with Single router" [3]_
-* "IPv6 Inter Data Center using L3VPNs" [4]_
+* Support for advertising MTU info in IPv6 RAs
+* IPv6 external connectivity for FLAT/VLAN based provider networks
.. table::
:class: longtable
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
- |Use Case / Requirement |Supported in ODL Oxygen |Notes |
+ |Use Case / Requirement |Supported in ODL Fluorine|Notes |
+==================================================+=========================+==============================================================+
|REST API support for IPv6 subnet creation in ODL |Yes |Yes, it is possible to create IPv6 subnets in ODL using |
| | |Neutron REST API. |
| (east-west) | | |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
|IPv6 Router support in ODL: |**NO** |This feature is targeted for Flourine Release. |
- | | |In ODL Oxygen Release, RFE "IPv6 Inter-DC L3 North-South |
+ | | |In ODL Fluorine Release, RFE "IPv6 Inter-DC L3 North-South |
|3. External routing (north-south) | |Connectivity Using L3VPN Provider Network Types" Spec [1]_ is |
| | |merged. But the code patch has not been merged yet. |
| | |On the other hand, "IPv6 Cluster Support" is available in |
- | | |Oxygen Release [2]_. Basically, existing IPv6 features were |
+ | | |Fluorine Release [2]_. Basically, existing IPv6 features were |
| | |enhanced to work in a three node ODL Clustered Setup. |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
|IPAM: Support for IPv6 Address assignment modes. |Yes |ODL IPv6 Router supports all the IPv6 Address assignment |
|IPv6 L3VPN Dual Stack with Single router |Yes |Refer to "Dual Stack VM support in OpenDaylight" Spec [3]_. |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
|IPv6 Inter Data Center using L3VPNs |Yes |Refer to "IPv6 Inter-DC L3 North-South connectivity using |
- | | |L3VPN provider network types" Spec [4]_. |
+ | | |L3VPN provider network types" Spec [1]_. |
+ +--------------------------------------------------+-------------------------+--------------------------------------------------------------+
+ |Support for advertising MTU info in IPv6 RAs |Yes | |
+ +--------------------------------------------------+-------------------------+--------------------------------------------------------------+
+ |IPv6 external connectivity for FLAT/VLAN based |Yes | |
+ |provider networks | | |
+--------------------------------------------------+-------------------------+--------------------------------------------------------------+
.. [1] https://docs.opendaylight.org/projects/netvirt/en/stable-fluorine/specs/oxygen/ipv6-interdc-l3vpn.html
.. [2] http://git.opendaylight.org/gerrit/#/c/66707/
-.. [3] https://docs.opendaylight.org/projects/netvirt/en/stable-oxygen/specs/l3vpn-dual-stack-vms.html
-.. [4] https://docs.opendaylight.org/projects/netvirt/en/stable-oxygen/specs/ipv6-interdc-l3vpn.html
+.. [3] https://docs.opendaylight.org/projects/netvirt/en/stable-fluorine/specs/oxygen/l3vpn-dual-stack-vms.html
.. http://creativecommons.org/licenses/by/4.0
.. (c) Bin Hu (AT&T) and Sridhar Gaddam (RedHat)
-=======================================
-IPv6 Gap Analysis with OpenStack Queens
-=======================================
+======================================
+IPv6 Gap Analysis with OpenStack Rocky
+======================================
This section provides users with IPv6 gap analysis regarding feature requirement with
-OpenStack Neutron in Queens Official Release. The following table lists the use cases / feature
+OpenStack Neutron in Rocky Official Release. The following table lists the use cases / feature
requirements of VIM-agnostic IPv6 functionality, including infrastructure layer and VNF
-(VM) layer, and its gap analysis with OpenStack Neutron in Queens Official Release.
+(VM) layer, and its gap analysis with OpenStack Neutron in Rocky Official Release.
Please **NOTE** that in terms of IPv6 support in OpenStack Neutron, there is no difference
-between **Queens** release and prior, e.g. **Pike** and **Ocata**, releases.
+between **Rocky** release and prior, e.g. **Queens**, **Pike** and **Ocata**, releases.
.. table::
:class: longtable
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
- |Use Case / Requirement |Supported in Queens|Notes |
+ |Use Case / Requirement |Supported in Rocky |Notes |
+===========================================================+===================+====================================================================+
|All topologies work in a multi-tenant environment |Yes |The IPv6 design is following the Neutron tenant networks model; |
| | |dnsmasq is being used inside DHCP network namespaces, while radvd |
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
|IPv6 Support in "Allowed Address Pairs" Extension |Yes | |
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
- |Support for IPv6 Prefix Delegation. |Yes |Partial support in Queens |
+ |Support for IPv6 Prefix Delegation. |Yes |Partial support in Rocky |
+-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+
- |Distributed Virtual Routing (DVR) support for IPv6 |**No** |In Queens DVR implementation, IPv6 works. But all the IPv6 ingress/ |
+ |Distributed Virtual Routing (DVR) support for IPv6 |**No** |In Rocky DVR implementation, IPv6 works. But all the IPv6 ingress/ |
| | |egress traffic is routed via the centralized controller node, i.e. |
| | |similar to SNAT traffic. |
| | |A fully distributed IPv6 router is not yet supported in Neutron. |
.. (c) Bin Hu (AT&T) and Sridhar Gaddam (RedHat)
====================================
-Using IPv6 Feature of Gambia Release
+Using IPv6 Feature of Hunter Release
====================================
:Abstract:
This section provides the users with:
-* Gap Analysis regarding IPv6 feature requirements with OpenStack Queens
+* Gap Analysis regarding IPv6 feature requirements with OpenStack Rocky
Official Release
-* Gap Analysis regarding IPv6 feature requirements with Open Daylight Oxygen
+* Gap Analysis regarding IPv6 feature requirements with Open Daylight Fluorine
Official Release
* IPv6 Setup in Container Networking
* Use of Neighbor Discovery (ND) Proxy to connect IPv6-only container to
studied with two Hosts, each with 2 Docker containers. Docker IPv6 NAT topic
is also explored.
-For more information, please find `Neutron's IPv6 document for Queens Release
-<http://docs.openstack.org/neutron/queens/admin/config-ipv6.html>`_.
+For more information, please find `Neutron's IPv6 document for Rocky Release
+<http://docs.openstack.org/neutron/rocky/admin/config-ipv6.html>`_.
.. toctree::
:numbered:
:maxdepth: 4
- ./gap-os-queens.rst
- ./gap-odl-oxygen.rst
+ ./gap-os-rocky.rst
+ ./gap-odl-fluorine.rst
./ipv6-in-container-networking.rst
./icmpv6-and-ndp-proxying-for-docker-containers.rst
./docker-ipv6-simple-cluster-topology.rst
Code Review / ipv6.git / commitdiff