From dca493fb41c38de1618b64084565d5fc46c9c3cf Mon Sep 17 00:00:00 2001 From: Giuseppe Carella Date: Mon, 2 Oct 2017 16:55:40 +0200 Subject: Extended documentation for Euphrates Inlcuded user guide and configuration guide that can be used to get started immediately with orchestra Change-Id: Idec9cf8462b0497addc8419fb77744a639fd8718 Signed-off-by: Giuseppe Carella Signed-off-by: Michael Pauls --- docs/release/configguide/feature.configuration.rst | 69 +++++++++++++++------- docs/release/configguide/index.rst | 2 +- 2 files changed, 49 insertions(+), 22 deletions(-) (limited to 'docs/release/configguide') diff --git a/docs/release/configguide/feature.configuration.rst b/docs/release/configguide/feature.configuration.rst index 32e20f9..99535f9 100644 --- a/docs/release/configguide/feature.configuration.rst +++ b/docs/release/configguide/feature.configuration.rst @@ -1,34 +1,61 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -======== -Abstract -======== -Add a brief introduction to configure OPNFV with this specific feature including -dependancies on platform components, this description should be at a level that -will apply to any installer providing the pre-requisite components. + +Orchestra Installation +====================== +Orchestra is the OPNFV name given to the Open Baton integration project. This documentation explains how to install it. +Please notice that the JOID installer already integrates Orchestra as a scenario. Please refer to the JOID installer in case +you want to install Orchestra using it. .. contents:: :depth: 3 :local: -Pre-configuration activities -============================ -Describe specific pre-configuration activities. This should include ensuring the -right components are installed by the installation tools as required for your -feature to function. Refer to the previous installer configuration chapters, -installations guide and release notes Hardware configuration -====================== -Describe the hardware configuration needed for this specific feature +---------------------- + +No special hardware is needed in order to execute Orchestra. We assume that you are performing +the installation on top of a clean installation either of Ubuntu 14.04, Ubuntu 16.04 or Debian Jessy. +In other cases we suggest to install the components one by one. +You can checkout the bootstrap repository and see the installation procedures which are executed by the bootstrap script. + +Orchestra can be installed on any kind of environment (physical hosts, virtual machines, containers, etc.). +So, you can decide either to install it on top of virtual machine running on the jump host or somewhere else. +Suggested requirements in terms of CPUs, Memory, and disk space are: + +* minimal: > 2GB of RAM, and > 2CPUs, 10GB of disk space +* suggested: > 8GB of RAM, and > 8CPUs, 10GB of disk space + +In general, you may be able to get a working environment also with less perfomant hardware, especially tuning the JVM startup options (i.e -Xms and -Xmx). + +Orchestra Bootstrap +------------------- +To facilitate the installation procedures we provide a bootstrap script which +will install the desired components and configure them for running a hello world VNF out of the box. +To execute the bootstrap procedure you need to have curl installed (see http://curl.haxx.se/). +This command should work on any Ubuntu system: + +.. code-block:: bash + + apt-get install curl + +We provide a non-interactive installation using a configuration file. +Specifically, you need to have the configuration file locally available and to pass it +to the bootstrap command as a parameter. You can download this example of configuration file, +modify it accordingly and execute the bootstrap typing the following command: + +.. code-block:: bash + + wget http://get.openbaton.org/bootstraps/orchestra/euphrates/bootstrap-config-file # modify any parameters you want + sh <(curl -s http://get.openbaton.org/bootstraps/orchestra/euphrates/bootstrap) release --config-file=/home/ubuntu/bootstrap-config-file + +VERY IMPORTANT NOTE - By default RabbitMQ is installed on the host of the NFVO. +Be aware of the fact that during the installation you will be prompted for entering the RabbitMQ IP and Port. +Please make sure that this IP can be reached by external components (VMs, or host where will run other VNFMs) otherwise you will have runtime issues. +If you are installing Open Baton on a VM running in OpenStack, the best is that you put here the floating IP. -Orchestra configuration -===================== -Describe the procedures to configure your feature on the platform in order -that it is ready to use according to the feature instructions in the platform -user guide. Where applicable you should add content in the postinstall.rst -to validate the feature is configured for use. -(checking components are installed correctly etc...) +At this point the NFVO dashboard should be reachable via the following URL http://your-ip-here:8080 diff --git a/docs/release/configguide/index.rst b/docs/release/configguide/index.rst index 4039341..6b19c9c 100644 --- a/docs/release/configguide/index.rst +++ b/docs/release/configguide/index.rst @@ -6,6 +6,6 @@ Orchestra Configuration Guide ********************************** .. toctree:: - :maxdepth: 1 + :maxdepth: 4 feature.configuration -- cgit 1.2.3-korg