From a3ed99e617de7918b4a1290a3be681c3d27b41cc Mon Sep 17 00:00:00 2001 From: Harry Huang Date: Fri, 24 Feb 2017 15:07:39 +0800 Subject: Opera Docs version: firt draft Change-Id: Id0ba01cd205229f0a11ce0d9a921f5fce84dd221 Signed-off-by: Harry Huang (cherry picked from commit f8eb16e4a3c38d4899234c95356c88f9c80789da) --- docs/FAQ/index.rst | 10 +++ docs/installationprocedure/index.rst | 13 ++++ .../installation.instruction.rst | 88 ++++++++++++++++++++++ docs/installationprocedure/introduction.rst | 22 ++++++ docs/releasenotes/index.rst | 13 ++++ docs/releasenotes/release-notes.rst | 25 ++++++ 6 files changed, 171 insertions(+) create mode 100644 docs/FAQ/index.rst create mode 100644 docs/installationprocedure/index.rst create mode 100644 docs/installationprocedure/installation.instruction.rst create mode 100644 docs/installationprocedure/introduction.rst create mode 100644 docs/releasenotes/index.rst create mode 100644 docs/releasenotes/release-notes.rst diff --git a/docs/FAQ/index.rst b/docs/FAQ/index.rst new file mode 100644 index 0000000..c1e208f --- /dev/null +++ b/docs/FAQ/index.rst @@ -0,0 +1,10 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License... http://creativecommons.org/licenses/by/4.0 + +************************************* +OPNFV Opera Installation Instructions +************************************* + +.. toctree:: + :numbered: + :maxdepth: + diff --git a/docs/installationprocedure/index.rst b/docs/installationprocedure/index.rst new file mode 100644 index 0000000..bb20e9a --- /dev/null +++ b/docs/installationprocedure/index.rst @@ -0,0 +1,13 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +************************************* +OPNFV Opera Installation Instructions +************************************* + +.. toctree:: + :numbered: + :maxdepth: 4 + + introduction.rst + installation.instruction.rst diff --git a/docs/installationprocedure/installation.instruction.rst b/docs/installationprocedure/installation.instruction.rst new file mode 100644 index 0000000..d87bde7 --- /dev/null +++ b/docs/installationprocedure/installation.instruction.rst @@ -0,0 +1,88 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) by Yingjun Li (HUAWEI) + +Opera Installation Instructions +=============================== + +This document providing guidelines on how to deploy a working Open-O +environment using opera project. + +The audience of this document is assumed to have good knowledge in +OpenStack and Linux. + + +Preconditions +------------- + +There are some preconditions before starting the Opera deployment + + +A functional OpenStack environment +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +OpenStack should be deployed before opera deploy. + +Getting the deployment scripts +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Retrieve the repository of Opera using the following command: + +- git clone https://gerrit.opnfv.org/gerrit/opera + + +Machine requirements +-------------------- + +1. Ubuntu OS (Pre-installed). + +2. Root access. + +3. Minimum 1 NIC (internet access) + +4. CPU cores: 32 + +5. 64 GB free memory + +6. 100G free disk + + +Deploy Instruction +------------------ + +After opera deployment, Open-O dockers will be launched on local +server as orchestrator and juju vm will be launched on OpenStack +as VNFM. + +Add OpenStack Admin Openrc file +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Add the admin openrc file of your local openstack into opera/conf +directory with the name of admin-openrc.sh. + +Config open-o.yml +~~~~~~~~~~~~~~~~~ + +Set openo_version to specify Open-O version. + +Set openo_ip to specify an external ip to access Open-O services. +(leave the value unset will use local server's external ip) + +Set ports in openo_docker_net to specify Open-O's exposed service +ports. + +Set enable_sdno to specify if use Open-O 's sdno services. +(set this value false will not launch Open-O sdno dockers and reduce +deploy duration) + +Set vnf_type to specify the vnf type need to be deployed. +(currently only support clearwater deployment, leave this unset will not +deploy any vnf) + +Run opera_launch.sh +~~~~~~~~~~~~~~~~~~~ + +.. code-block:: bash + + ./opera_launch.sh + diff --git a/docs/installationprocedure/introduction.rst b/docs/installationprocedure/introduction.rst new file mode 100644 index 0000000..ff8f40b --- /dev/null +++ b/docs/installationprocedure/introduction.rst @@ -0,0 +1,22 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International Licence. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) by Yingjun Li (HUAWEI) + +Abstract +======== + +This document describes how to install Open-O in an OpenStack deployed environment +using Opera project. + +Version history +=============== + ++--------------------+--------------------+--------------------+---------------------------+ +| **Date** | **Ver.** | **Author** | **Comment** | +| | | | | ++--------------------+--------------------+--------------------+---------------------------+ +| 2017-02-16 | 0.0.1 | Harry Huang | First draft | +| | | (HUAWEI) | | ++--------------------+--------------------+--------------------+---------------------------+ + + diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst new file mode 100644 index 0000000..65f5ef4 --- /dev/null +++ b/docs/releasenotes/index.rst @@ -0,0 +1,13 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International Licence. +.. http://creativecommons.org/licenses/by/4.0 + +========================================= +OPNFV Danube: Opera Release Notes +========================================= + +.. toctree:: + :numbered: + :maxdepth: 4 + + release-notes.rst + diff --git a/docs/releasenotes/release-notes.rst b/docs/releasenotes/release-notes.rst new file mode 100644 index 0000000..19dab96 --- /dev/null +++ b/docs/releasenotes/release-notes.rst @@ -0,0 +1,25 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Yingjun Li (HUAWEI) + +========================== +OPNFV Opera Release Notes +========================== + +This document describes release notes of OPNFV Danube Release of Opera + +Abstract +======== + +Opera project is aimed to deploy a working Open-O environment. + +Release Data +============ + ++--------------------+--------------------+--------------------+---------------------------+ +| **Date** | **Ver.** | **Author** | **Comment** | +| | | | | ++--------------------+--------------------+--------------------+---------------------------+ +| 2017-02-24 | 0.0.1 | Harry Huang | First draft | +| | | (HUAWEI) | | ++--------------------+--------------------+--------------------+---------------------------+ -- cgit 1.2.3-korg