summaryrefslogtreecommitdiffstats
path: root/docs/manual_use_case.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/manual_use_case.rst')
-rw-r--r--docs/manual_use_case.rst44
1 files changed, 44 insertions, 0 deletions
diff --git a/docs/manual_use_case.rst b/docs/manual_use_case.rst
new file mode 100644
index 0000000..46e3b12
--- /dev/null
+++ b/docs/manual_use_case.rst
@@ -0,0 +1,44 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2017 ONAP
+
+
+.. contents::
+ :local:
+
+**Manual Scale Out Use Case**
+==================================
+
+(VNF Perspective)
+
+In its Beijing Release, ONAP will support the ability to manually scale out VNF Components. Below is the Sequence Diagram for how Manual Scale Out will work in ONAP.
+
+|image0|
+
+Description of Workflow
+---------------------------------------------
+
+At a high level the way Manual Scale Out will work is:
+ 1. Using VID, the operator will choose to scale out a VNFC by picking a VF_Module to scale and choosing which controller is responsible for that VNF.
+ 2. VID sends the Scale Out Request to SO.
+ 3. When SO receives the Scaling request it will first send a request to the appropriate controller (APPC or SDNC) to execute a Healthcheck on the VNF.
+ 4. Once the Healthcheck has been run, SO executes the Heat Template associated with the VF Module requested by the VID Operator.
+ 5. After the new component(s) have been instantiated SO calls the responsible controller (via DMaaP) to configure the new instances.
+ 6. Finally a Healthcheck is run to ensure that the entire VNF is Operating as it should.
+
+
+VNF Impacts
+------------------------
+
+For VNFs to make use of the Manual Scaling Capabilities of ONAP, they must support the following functionality:
+ 1. VNFs must support a Healthcheck as described in: `The Management Section of the ONAP VNF Guidelines <http://onap.readthedocs.io/en/latest/submodules/vnfrqts/requirements.git/docs/Chapter7.html#vnf-rest-apis>`_.
+ a. R-31809 is the requirement dictating the need for VNF Healthchecks.
+ b. The Ansible Healthcheck Playbook description may be found in `The Ansible Standards and Capabilities Section <http://onap.readthedocs.io/en/latest/submodules/vnfrqts/requirements.git/docs/Chapter7.html#ansible-standards-and-capabilities>`_.
+ 2. VNF Heat Templates must be built according the `VNF Modularity Rules <http://onap.readthedocs.io/en/latest/submodules/vnfrqts/requirements.git/docs/Chapter4.html#d-vnf-modularity>`_.
+ a. The VF_Module to be scaled must be built according the VNF Modularity Rules for Incremental Modules.
+ 3. Configuration of the VNF must be done via NETCONF, Chef, or Ansible as described in `Configuration Management <http://onap.readthedocs.io/en/latest/submodules/vnfrqts/requirements.git/docs/Chapter7.html#c-configuration-management>`_.
+
+
+.. |image0| image:: Scale_Out_Workflow.png
+ :width: 7in
+ :height: 9in