Abstract
========
-This document describes how to install the Gambia release of OPNFV when
+This document describes how to install the Hunter release of OPNFV when
using Apex as a deployment tool covering it's limitations, dependencies
and required system resources.
License
=======
-Gambia release of OPNFV when using Apex as a deployment tool Docs
+Hunter release of OPNFV when using Apex as a deployment tool Docs
(c) by Tim Rozet (Red Hat)
-Gambia release of OPNFV when using Apex as a deployment tool Docs
+Hunter release of OPNFV when using Apex as a deployment tool Docs
are licensed under a Creative Commons Attribution 4.0 International License.
You should have received a copy of the license along with this.
If not, see <http://creativecommons.org/licenses/by/4.0/>.
``sudo yum install https://repos.fedorapeople.org/repos/openstack/openstack-queens/rdo-release-queens-1.noarch.rpm``
``sudo yum install epel-release``
- ``sudo curl -o /etc/yum.repos.d/opnfv-apex.repo http://artifacts.opnfv.org/apex/gambia/opnfv-apex.repo``
+ ``sudo curl -o /etc/yum.repos.d/opnfv-apex.repo http://artifacts.opnfv.org/apex/hunter/opnfv-apex.repo``
The RDO Project release repository is needed to install OpenVSwitch, which
is a dependency of opnfv-apex. If you do not have external connectivity to
Introduction
============
-This document describes the steps to install an OPNFV Gambia reference
+This document describes the steps to install an OPNFV Hunter reference
platform using the Apex installer.
The audience is assumed to have a good background in networking
4. minimum 1 networks and maximum 5 networks, multiple NIC and/or VLAN
combinations are supported. This is virtualized for a VM deployment.
-5. The Gambia Apex RPM and its dependencies.
+5. The Hunter Apex RPM and its dependencies.
6. 16 GB of RAM for a bare metal deployment, 64 GB of RAM for a Virtual
Deployment.
Scenarios and Deploy Settings for Upstream Deployments
------------------------------------------------------
-The deploy settings and scenarios included with the Gambia release of Apex will
+The deploy settings and scenarios included with the Hunter release of Apex will
be supported as deemed by the `OPNFV Scenarios in Apex`_ section of this guide.
-Each of these scenarios has been tested by Apex over the Gambia release, and
+Each of these scenarios has been tested by Apex over the Hunter release, and
using those deploy settings will control which upstream artifacts are pulled
at deploy time. By specifying different versions of OpenStack, ODL, or other
components in the deploy settings, different upstream artifacts may be downloaded
========================================================================
-OPNFV Release Notes for the Gambia release of OPNFV Apex deployment tool
+OPNFV Release Notes for the Hunter release of OPNFV Apex deployment tool
========================================================================
Abstract
========
-This document provides the release notes for Gambia release with the Apex
+This document provides the release notes for Hunter release with the Apex
deployment toolchain.
License
Important Notes
===============
-This is the OPNFV Gambia release that implements the deploy stage of the
+This is the OPNFV Hunter release that implements the deploy stage of the
OPNFV CI pipeline via Apex.
Apex is based on RDO's Triple-O installation tool chain.
Summary
=======
-Gambia release with the Apex deployment toolchain will establish an OPNFV
+Hunter release with the Apex deployment toolchain will establish an OPNFV
target system on a Pharos compliant lab infrastructure. The current definition
of an OPNFV target system is OpenStack Pike combined with an SDN
controller, such as OpenDaylight. The system is deployed with OpenStack High
Availability (HA) for most OpenStack services. SDN controllers are deployed
on every controller unless deploying with one the HA FD.IO scenarios. Ceph
storage is used as Cinder backend, and is the only supported storage for
-Gambia. Ceph is setup as 3 OSDs and 3 Monitors, one OSD+Mon per Controller
+Hunter. Ceph is setup as 3 OSDs and 3 Monitors, one OSD+Mon per Controller
node in an HA setup. Apex also supports non-HA deployments, which deploys a
single controller and n number of compute nodes. Furthermore, Apex is
capable of deploying scenarios in a bare metal or virtual fashion. Virtual
- Documentation is built by Jenkins
- .iso image is built by Jenkins
- .rpm packages are built by Jenkins
-- Jenkins deploys a Gambia release with the Apex deployment toolchain
+- Jenkins deploys a Hunter release with the Apex deployment toolchain
bare metal, which includes 3 control+network nodes, and 2 compute nodes.
Release Data
| **Release date** | 2018-12-14 |
| | |
+--------------------------------------+--------------------------------------+
-| **Purpose of the delivery** | OPNFV Gambia release |
+| **Purpose of the delivery** | OPNFV Hunter release |
| | |
+--------------------------------------+--------------------------------------+
Module version changes
~~~~~~~~~~~~~~~~~~~~~~
-This is the first tracked version of the Gambia release with the Apex
+This is the first tracked version of the Hunter release with the Apex
deployment toolchain. It is based on following upstream versions:
- OpenStack (Queens release)
Document Version Changes
~~~~~~~~~~~~~~~~~~~~~~~~
-This is the first tracked version of Gambia release with the Apex
+This is the first tracked version of Hunter release with the Apex
deployment toolchain.
The following documentation is provided with this release:
-- OPNFV Installation instructions for the Gambia release with the Apex
+- OPNFV Installation instructions for the Hunter release with the Apex
deployment toolchain - ver. 1.0.0
-- OPNFV Release Notes for the Gambia release with the Apex deployment
+- OPNFV Release Notes for the Hunter release with the Apex deployment
toolchain - ver. 1.0.0 (this document)
Deliverables
Documentation Deliverables
~~~~~~~~~~~~~~~~~~~~~~~~~~
-- OPNFV Installation instructions for the Gambia release with the Apex
+- OPNFV Installation instructions for the Hunter release with the Apex
deployment toolchain - ver. 7.1
-- OPNFV Release Notes for the Gambia release with the Apex deployment
+- OPNFV Release Notes for the Hunter release with the Apex deployment
toolchain - ver. 7.1 (this document)
Known Limitations, Issues and Workarounds
References
==========
-For more information on the OPNFV Gambia release, please see:
+For more information on the OPNFV Hunter release, please see:
-http://wiki.opnfv.org/releases/Gambia
+http://wiki.opnfv.org/releases/Hunter
:Authors: Tim Rozet (trozet@redhat.com)
:Authors: Dan Radez (dradez@redhat.com)
+++ /dev/null
-.. _k8s-nosdn-nofeature-noha:
-
-.. This work is licensed under a Creative Commons Attribution 4.0 International Licence.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) <optionally add copywriters name>
-
-=================================================
-k8s-nosdn-nofeature-noha overview and description
-=================================================
-
-.. toctree::
- :numbered:
- :maxdepth: 4
-
- k8s-nosdn-nofeature-noha.rst
+++ /dev/null
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) <optionally add copywriters name>
-
-This document provides scenario level details for Gambia 1.1 of
-Kubernetes deployment with no SDN controller, no extra features
-and no High Availability enabled. Note this scenario is *not* supported
-for Gambia initial release and will be supported in a later service release
-of Gambia.
-
-============
-Introduction
-============
-
-This scenario is used primarily to validate and deploy a Kubernetes
-deployment without any NFV features or SDN controller enabled.
-
-Scenario components and composition
-===================================
-
-This scenario deploys a Kubernetes cluster on bare metal or virtual
-environment with a single master node. TripleO is used to bootstrap
-all the nodes and set up basic services like SSH. An undercloud VM
-used similarly to Openstack deployments, however no Openstack services
-(Nova, Neutron, Keystone, etc) will be deployed to the nodes. After
-TripleO successfully executes all the bootstrapping tasks, Kubespray
-is run (using ansible) to deploy Kubernetes cluster on the nodes.
-
-
-Scenario usage overview
-=======================
-
-Simply deploy this scenario by using the k8s-nosdn-nofeature-noha.yaml deploy
-settings file.
-
-Limitations, Issues and Workarounds
-===================================
-
-None
-
-References
-==========
-
-For more information on the OPNFV Gambia release, please visit
-http://www.opnfv.org/gambia
-
.. http://creativecommons.org/licenses/by/4.0
.. (c) <optionally add copywriters name>
-This document provides scenario level details for Gambia 1.1 of
+This document provides scenario level details for Hunter 1.1 of
deployment with no SDN controller and no extra features enabled.
============
References
==========
-For more information on the OPNFV Gambia release, please visit
-http://www.opnfv.org/gambia
+For more information on the OPNFV Hunter release, please visit
+http://www.opnfv.org/Hunter
.. http://creativecommons.org/licenses/by/4.0
.. (c) <optionally add copywriters name>
-This document provides scenario level details for Gambia 1.1 of
+This document provides scenario level details for Hunter 1.1 of
deployment with no SDN controller and no extra features enabled.
============
References
==========
-For more information on the OPNFV Gambia release, please visit
-http://www.opnfv.org/gambia
+For more information on the OPNFV Hunter release, please visit
+http://www.opnfv.org/Hunter
+++ /dev/null
-.. _os-odl-nofeature-ha:
-
-.. This work is licensed under a Creative Commons Attribution 4.0 International Licence.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) <optionally add copywriters name>
-
-============================================
-os-odl-nofeature-ha overview and description
-============================================
-
-.. toctree::
- :numbered:
- :maxdepth: 4
-
- os-odl-nofeature-ha.rst
+++ /dev/null
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) <optionally add copywriters name>
-
-This document provides scenario level details for Gambia 1.1 of
-deployment with the OpenDaylight SDN controller and no extra features enabled.
-
-============
-Introduction
-============
-
-This scenario is used primarily to validate and deploy a Queens OpenStack
-deployment with OpenDaylight, and without any NFV features enabled.
-
-Scenario components and composition
-===================================
-
-This scenario is composed of common OpenStack services enabled by default,
-including Nova, Neutron, Glance, Cinder, Keystone, Horizon. Optionally and
-by default, Tacker and Congress services are also enabled. Ceph is used as
-the backend storage to Cinder on all deployed nodes.
-
-All services are in HA, meaning that there are multiple cloned instances of
-each service, and they are balanced by HA Proxy using a Virtual IP Address
-per service.
-
-OpenDaylight is also enabled in HA, and forms a cluster. Neutron
-communicates with a Virtual IP Address for OpenDaylight which is load
-balanced across the OpenDaylight cluster. Every Open vSwitch node is
-connected to every OpenDaylight for High Availability.
-
-Scenario usage overview
-=======================
-
-Simply deploy this scenario by using the os-odl-nofeature-ha.yaml deploy
-settings file.
-
-Limitations, Issues and Workarounds
-===================================
-
-* `APEX-268 <https://jira.opnfv.org/browse/APEX-268>`_:
- VMs with multiple floating IPs can only access via first NIC
-
-References
-==========
-
-For more information on the OPNFV Gambia release, please visit
-http://www.opnfv.org/gambia
-
+++ /dev/null
-.. _os-odl-nofeature-noha:
-
-.. This work is licensed under a Creative Commons Attribution 4.0 International Licence.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) <optionally add copywriters name>
-
-==============================================
-os-odl-nofeature-noha overview and description
-==============================================
-
-.. toctree::
- :numbered:
- :maxdepth: 4
-
- os-odl-nofeature-noha.rst
+++ /dev/null
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) <optionally add copywriters name>
-
-This document provides scenario level details for Gambia 1.1 of
-deployment with the OpenDaylight SDN controller and no extra features enabled.
-
-============
-Introduction
-============
-
-This scenario is used primarily to validate and deploy a Queens OpenStack
-deployment with OpenDaylight, and without any NFV features enabled.
-
-Scenario components and composition
-===================================
-
-This scenario is composed of common OpenStack services enabled by default,
-including Nova, Neutron, Glance, Cinder, Keystone, Horizon. Optionally and
-by default, Tacker and Congress services are also enabled. Ceph is used as
-the backend storage to Cinder on all deployed nodes.
-
-Only a single controller is deployed in this scenario, which also includes
-the OpenDaylight service on it.
-
-Scenario usage overview
-=======================
-
-Simply deploy this scenario by using the os-odl-nofeature-noha.yaml deploy
-settings file.
-
-Limitations, Issues and Workarounds
-===================================
-
-* `APEX-268 <https://jira.opnfv.org/browse/APEX-268>`_:
- VMs with multiple floating IPs can only access via first NIC
-
-References
-==========
-
-For more information on the OPNFV Gambia release, please visit
-http://www.opnfv.org/gambia
-
.. http://creativecommons.org/licenses/by/4.0
.. (c) <optionally add copywriters name>
-This document provides scenario level details for Gambia 1.1 of
+This document provides scenario level details for Hunter 1.1 of
deployment with the OVN SDN controller and no extra features enabled.
============
References
==========
-For more information on the OPNFV Gambia release, please visit
-http://www.opnfv.org/gambia
+For more information on the OPNFV Hunter release, please visit
+http://www.opnfv.org/Hunter