Create use case example and structure
Change-Id: Ia4eff37921ee6d38b86fc3c50176757ef9d56ff8
Signed-off-by: Rich Bennett <rb2745@att.com>
Issue-ID: DOC-223
diff --git a/docs/index.rst b/docs/index.rst
index 32d9b93..fbcb897 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -11,6 +11,7 @@
release/index
guides/onap-developer/index
guides/onap-user/index
+ use-cases/index
diff --git a/docs/use-cases/index.rst b/docs/use-cases/index.rst
new file mode 100644
index 0000000..cc076b1
--- /dev/null
+++ b/docs/use-cases/index.rst
@@ -0,0 +1,14 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2017 AT&T Intellectual Property. All rights reserved.
+
+ONAP Use Cases
+==============
+
+Example uses case descriptions and sequence diagrams illustrating
+interactions between platform components.
+
+.. toctree::
+ :maxdepth: 1
+
+ vfw.rst
diff --git a/docs/use-cases/vfw.rst b/docs/use-cases/vfw.rst
new file mode 100644
index 0000000..bc21650
--- /dev/null
+++ b/docs/use-cases/vfw.rst
@@ -0,0 +1,99 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2017 AT&T Intellectual Property. All rights reserved.
+
+vFirewall
+=========
+
+Description
+-----------
+
+Onboarding
+----------
+
+
+.. uml::
+
+ @startuml
+ title vFW and vDNS VNF Onboarding (R1)\nvFW and vDNS use the same flows but they are separate VNFs/Services
+ ONAP_User -> SDC : vFW_vDNS resource onboarding (HEAT)
+ note right : vFW ( vpg, vfw, vsn)\nvDNS (vpg, vlb,vdns) + DNSScaling (vdns)\nCLAMP not shown
+ ONAP_User -> SDC : vFW_vDNS service onboarding
+ ONAP_User -> SDC : vFW_vDNS distribution
+ |||
+ ONAP_User -> SDC : vFW2_vDNS2 resource onboarding (TOSCA)
+ ONAP_User -> SDC : vFW2_vDNS2 service onboarding
+ ONAP_User -> SDC : vFW2_vDNS2 distribution
+ |||
+ SDC -> SO : artifact distribution
+ SDC -> AAI : artifact distribution
+ SDC -> APPC : artifact distribution
+ SDC -> SDNC : VNF preload data (vFW_vDNS and vFW2_vDNS2) ?
+ SDC -> DCAE : Telemetry to Collect and CLAMP triggers
+ SDC -> Policy : Control Loop Policies (see CLAMP flow)
+ note left: policy may cut through to Policy GUI
+ @enduml
+
+Instantiation
+-------------
+
+.. uml::
+
+ @startuml
+ title vFW vDNS Instantiation (R1)\nvFW and vDNS use the same flows but they are separate VNFs/Services
+ participant UseCaseUI
+ participant ONAP_User
+ Participant SDC
+ Participant VID
+ Participant SO
+ UseCaseUI -> AAI : populate cloud inventory
+ ONAP_User -> VID : vFW_vDNS deployment
+ VID -> SDC : Lookup VNF artifacts
+ VID -> AAI : Lookup cloud locations, subscriber
+ VID -> SO : vFW_vDNS instantiation\n(base modules)
+ SO -> AAI : inventory update
+ SO -> SDNC : Generic VNF API\n(reserved)
+ SO -> Multi_VIM : vFW_vDNS Heat template + ENV file
+ Multi_VIM -> CloudAPI : vFW_vDNS Heat template + ENV file or\n ARM Tempalte + Parameters + LinuxExtensionScripts
+ CloudAPI -> Hypervisor : vFW_vDNS Infrastructure instantiation
+ Hypervisor -> vFW_vDNS : Nova/Neutron Instantiation
+ Hypervisor -> CloudAPI : complete
+ CloudAPI -> Multi_VIM : complete
+ Multi_VIM -> SO : complete
+ note right : SO may poll for completion
+ SO -> SDNC: Generic VNF API\n(activated)
+ note right : on failure from Openstack SO issues rollback to SDNC
+ SDNC -> AAI : L3 Network resource update
+ SO -> VID : complete
+ note right : VID will poll for competion
+ SO -> Multi_VIM : Replaces Robot HEATBridge to pull data from cloud
+ Multi_VIM -> CloudAPI : VM data from cloud\n(public cloud will be less than if owner operated)
+ Multi_VIM -> SO : cloud data
+ SO -> AAI : Update with cloud data
+ |||
+ ONAP_User -> VID : vFW2_vDNS2 deployment (TOCA based)
+ VID -> SDC : Lookup VNF artifacts
+ VID -> AAI : Lookup cloud locations, subscriber
+ VID -> SO : vFW2_vDNS2 instantiation\n(base modules)
+ SO -> AAI : inventory update
+ SO -> SDNC : Generic VNF API\n(reserved)
+ SO -> Multi_VIM : vFW2_vDNS2 TOSCA template + ENV file
+ Multi_VIM -> CloudAPI : vFW_vDNS TOSCA template + ENV file or\n ARM Template + Parameters + LinuxExtensionScripts
+ CloudAPI -> Hypervisor : vFW2_vDNS2 Infrastructure instantiation
+ Hypervisor -> vFW2_vDNS2 : Nova/Neutron Instantiation
+ Hypervisor -> CloudAPI : complete
+ CloudAPI -> Multi_VIM : complete
+ Multi_VIM -> SO : complete
+ note right : SO may poll for completion
+ SO -> SDNC: Generic VNF API\n(activated)
+ note right : on failure from Openstack SO issues rollback to SDNC
+ SDNC -> AAI : L3 Network resource update
+ SO -> VID : complete
+ note right : VID will poll for competion
+ SO -> Multi_VIM : Replaces Robot HEATBridge to pull data from cloud
+ Multi_VIM -> CloudAPI : VM data from cloud\n(public cloud will be less than if owner operated)
+ Multi_VIM -> SO : cloud data
+ SO -> AAI : Update with cloud data
+ @enduml
+
+