diff options
| -rw-r--r-- | docs/release/configguide/featureconfig.rst | 6 | ||||
| -rw-r--r-- | docs/release/configguide/index.rst | 2 | ||||
| -rw-r--r-- | docs/release/installation/index.rst | 2 | ||||
| -rw-r--r-- | docs/release/release-notes/release-notes.rst | 24 | ||||
| -rw-r--r-- | docs/release/userguide/feature.usage.rst | 62 | ||||
| -rw-r--r-- | docs/release/userguide/gap-odl-fluorine.rst (renamed from docs/release/userguide/gap-odl-oxygen.rst) | 36 | ||||
| -rw-r--r-- | docs/release/userguide/gap-os-rocky.rst (renamed from docs/release/userguide/gap-os-queens.rst) | 18 | ||||
| -rw-r--r-- | docs/release/userguide/index.rst | 14 |
8 files changed, 83 insertions, 81 deletions
diff --git a/docs/release/configguide/featureconfig.rst b/docs/release/configguide/featureconfig.rst index cb8e035..b05d6b1 100644 --- a/docs/release/configguide/featureconfig.rst +++ b/docs/release/configguide/featureconfig.rst @@ -6,7 +6,7 @@ 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 @@ -28,7 +28,7 @@ Setup Manual in OpenStack-Only Environment ****************************************** 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 @@ -42,7 +42,7 @@ OPNFV Gambia Release, please **NOTE** that: 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**: diff --git a/docs/release/configguide/index.rst b/docs/release/configguide/index.rst index 40a1c1d..5f3c43f 100644 --- a/docs/release/configguide/index.rst +++ b/docs/release/configguide/index.rst @@ -11,7 +11,7 @@ IPv6 Configuration Guide :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: diff --git a/docs/release/installation/index.rst b/docs/release/installation/index.rst index 46ce838..229c7dc 100644 --- a/docs/release/installation/index.rst +++ b/docs/release/installation/index.rst @@ -11,7 +11,7 @@ IPv6 Installation Procedure :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: diff --git a/docs/release/release-notes/release-notes.rst b/docs/release/release-notes/release-notes.rst index eb57366..d71873f 100644 --- a/docs/release/release-notes/release-notes.rst +++ b/docs/release/release-notes/release-notes.rst @@ -6,7 +6,7 @@ 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 @@ -20,13 +20,7 @@ Version History | **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 @@ -35,13 +29,13 @@ 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 @@ -62,14 +56,14 @@ For details, please refer to our `User Guide <../userguide/index.html>`_. 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: @@ -104,7 +98,7 @@ Please refer to `Testing Methodology <../installation/index.html#testing-methodo 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 diff --git a/docs/release/userguide/feature.usage.rst b/docs/release/userguide/feature.usage.rst index 4742051..026ab21 100644 --- a/docs/release/userguide/feature.usage.rst +++ b/docs/release/userguide/feature.usage.rst @@ -3,33 +3,33 @@ .. (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 | @@ -125,9 +125,9 @@ between **Queens** release and prior, e.g. **Pike** and **Ocata**, release. +-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+ |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. | @@ -149,31 +149,31 @@ between **Queens** release and prior, e.g. **Pike** and **Ocata**, release. |(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. | @@ -195,11 +195,11 @@ Two new features are supported in Open Daylight Oxygen official release: | (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 | @@ -229,14 +229,18 @@ Two new features are supported in Open Daylight Oxygen official release: |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 diff --git a/docs/release/userguide/gap-odl-oxygen.rst b/docs/release/userguide/gap-odl-fluorine.rst index b2a076f..7ed4f71 100644 --- a/docs/release/userguide/gap-odl-oxygen.rst +++ b/docs/release/userguide/gap-odl-fluorine.rst @@ -2,31 +2,31 @@ .. 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. | @@ -48,11 +48,11 @@ Two new features are supported in Open Daylight Oxygen official release: | (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 | @@ -82,10 +82,14 @@ Two new features are supported in Open Daylight Oxygen official release: |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 diff --git a/docs/release/userguide/gap-os-queens.rst b/docs/release/userguide/gap-os-rocky.rst index f7451f2..550a918 100644 --- a/docs/release/userguide/gap-os-queens.rst +++ b/docs/release/userguide/gap-os-rocky.rst @@ -2,23 +2,23 @@ .. 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 | @@ -116,9 +116,9 @@ between **Queens** release and prior, e.g. **Pike** and **Ocata**, releases. +-----------------------------------------------------------+-------------------+--------------------------------------------------------------------+ |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. | diff --git a/docs/release/userguide/index.rst b/docs/release/userguide/index.rst index 95d59d4..30869aa 100644 --- a/docs/release/userguide/index.rst +++ b/docs/release/userguide/index.rst @@ -5,16 +5,16 @@ .. (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 @@ -33,15 +33,15 @@ containers to external network. The Docker IPv6 simple cluster topology is 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 |