docs/release/installation.introduction.rst

   1 .. _opnfv-installation:
   2
   3 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   4 .. SPDX-License-Identifier: CC-BY-4.0
   5 .. (c) Sofia Wallin Ericsson AB and other contributors
   6
   7 ============
   8 Installation
   9 ============
  10
  11 Abstract
  12 ========
  13
  14 This document provides an overview of the installation of the Euphrates release of OPNFV.
  15
  16 The Euphrates release can be installed making use of any of the installer projects in OPNFV:
  17 Apex, Compass4Nfv, Daisy4NFV, Fuel or JOID. Each installer provides the ability to install a common OPNFV
  18 platform as well as integrating additional features delivered through a variety of scenarios by
  19 the OPNFV community.
  20
  21
  22 Introduction
  23 ============
  24
  25 The OPNFV platform is comprised of a variety of upstream components that may be deployed on your
  26 infrastructure. A composition of components, tools and configurations is identified in OPNFV as a
  27 deployment scenario.
  28
  29 The various OPNFV scenarios provide unique features and capabilities that you may want to leverage, and
  30 it is important to understand your required target platform capabilities before installing and
  31 configuring your scenarios.
  32
  33 An OPNFV installation requires either a physical infrastructure environment as defined
  34 in the `Pharos specification <https://wiki.opnfv.org/display/pharos/Pharos+Specification>`_, or a virtual one.
  35 When configuring a physical infrastructure it is strongly advised to follow the Pharos configuration guidelines.
  36
  37
  38 Scenarios
  39 =========
  40
  41 OPNFV scenarios are designed to host virtualised network functions (VNF’s) in a variety of deployment
  42 architectures and locations. Each scenario provides specific capabilities and/or components aimed at
  43 solving specific problems for the deployment of VNF’s.
  44
  45 A scenario may, for instance, include components such as OpenStack, OpenDaylight, OVS, KVM etc.,
  46 where each scenario will include different source components or configurations.
  47
  48 To learn more about the scenarios supported in the Euphrates release refer to the scenario
  49 description documents provided:
  50
  51 - :ref:`os-nosdn-kvm-ha <kvmfornfv-os-nosdn-kvm-ha>`
  52 - :ref:`os-nosdn-kvm_ovs_dpdk-noha <kvmfornfv-os-nosdn-kvm_nfv_ovs_dpdk-noha>`
  53 - :ref:`os-odl-fdio-ha <os-odl-fdio-ha>`
  54 - :ref:`os-odl-fdio-noha <os-odl-fdio-noha>`
  55 - :ref:`os-nosdn-fdio-noha <os-nosdn-fdio-noha>`
  56 - :ref:`os-odl-bgpvpn-noha <sdnvpn-os-odl-bgpvpn-noha>`
  57 - :ref:`os-odl-bgpvpn-ha <sdnvpn-os-odl-bgpvpn-ha>`
  58 - `os-odl_l2-sfc-ha <http://docs.opnfv.org/en/stable-danube/submodules/sfc/docs/release/scenarios/os-odl_l2-sfc-ha/index.html>`_
  59 - `os-odl_l2-sfc-noha <http://docs.opnfv.org/en/stable-danube/submodules/sfc/docs/release/scenarios/os-odl_l2-sfc-noha/index.html>`_
  60 - :ref:`os-nosdn-lxd-ha <os-nosdn-lxd-ha>`
  61 - :ref:`os-nosdn-lxd-noha <os-nosdn-lxd-noha>`
  62 - :ref:`k8-nosdn-nofeature-noha <k8-nosdn-nofeature-noha>`
  63 - :ref:`k8-nosdn-lb-noha <k8-nosdn-lb-noha>`
  64 - `os-nosdn-ovs-ha <http://docs.opnfv.org/en/stable-danube/submodules/ovsnfv/docs/release/scenarios/os-nosdn-ovs-ha/index.html>`_
  65 - :ref:`os-nosdn-ovs-noha <os-nosdn-ovs-noha>`
  66 - :ref:`os-nosdn-calipso-noha <os-nosdn-calipso-noha>`
  67 - :ref:`os-nosdn-ovs_dpdk-ha <os-nosdn-ovs_dpdk-ha>`
  68 - :ref:`os-nosdn-ovs_dpdk-noha <os-nosdn-ovs_dpdk-noha>`
  69 - :ref:`os-odl-ovs_dpdk-ha <os-odl-ovs_dpdk-ha>`
  70 - :ref:`os-odl-ovs_dpdk-noha <os-odl-ovs_dpdk-noha>`
  71 - :ref:`os-odl-fdio-dvr-noha <os-odl-fdio-dvr-noha>`
  72 - :ref:`os-odl-fdio-dvr-ha <os-odl-fdio-dvr-ha>`
  73 - :ref:`os-odl-fdio-ipv6-noha <os-odl-fdio-ipv6-noha>`
  74 - :ref:`os-odl-fdio-ipv6-ha <os-odl-fdio-ipv6-ha>`
  75 - :ref:`os-nosdn-fdio-ha <os-nosdn-fdio-ha>`
  76 - :ref:`os-k8s-fdio <os-k8s-fdio>`
  77 - :ref:`os-odl-k8s_coe-noha <os-odl-k8s_coe-noha>`
  78 - :ref:`os-odl-k8s_coe-ha <os-odl-k8s_coe-ha>`
  79 - :ref:`os-nosdn-kvm_ovs_dpdk-ha <os-nosdn-kvm_ovs_dpdk-ha>`
  80 - :ref:`os-nosdn-bar-ha <os-nosdn-bar-ha>`
  81 - :ref:`os-nosdn-bar-noha <os-nosdn-bar-noha>`
  82 - :ref:`os-odl_l2-moon-ha <os-odl_l2-moon-ha>`
  83 - :ref:`k8-nosdn-lb-noha <k8-nosdn-lb-noha>`
  84 - :ref:`os-odl-sfc-ha <os-odl-sfc-ha>`
  85 - :ref:`os-onos-sfc-ha <os-onos-sfc-ha>`
  86 - :ref:`os-nosdn-ovs_dpdk-ha <os-nosdn-ovs_dpdk-ha>`
  87 - :ref:`os-nosdn-openbaton-ha <os-nosdn-openbaton-ha>`
  88 - :ref:`k8-ovn-lb-noha <k8-ovn-lb-noha>`
  89
  90 Installation Procedure
  91 ======================
  92
  93 Detailed step by step instructions for working with an installation toolchain and installing
  94 the required scenario are provided by the installation projects. The projects providing installation
  95 support for the OPNFV Euphrates release are: Apex, Compass4nfv, Daisy4NFV, Fuel and JOID.
  96
  97 The instructions for each toolchain can be found in these links:
  98
  99 - :ref:`Apex installation instruction <apex-installation>`
 100 - :ref:`Compass4nfv installation instruction <compass4nfv-installation>`
 101 - :ref:`Daisy installation instruction <daisy-installation>`
 102 - :ref:`Fuel installation instruction <fuel-installation>`
 103 - :ref:`JOID installation instruction <joid-installation>`
 104
 105 OPNFV Test Frameworks
 106 =====================
 107
 108 If you have elected to install the OPNFV platform using the deployment toolchain provided by OPNFV
 109 your system will have been validated once the installation is completed.
 110 The basic deployment validation only addresses a small part of capabilities provided in
 111 the platform and you may want to execute more exhaustive tests. Some investigation will be required to
 112 select the right test suites to run on your platform.
 113
 114 Many of the OPNFV test project provide user-guide documentation and installation instructions in :ref:`this document <testing-userguide>`