1 files changed, 111 insertions, 0 deletions
diff --git a/docs/instantiatemacro.rst b/docs/instantiatemacro.rst
new file mode 100644
index 000000000..3caeb5b02
--- /dev/null
+++ b/docs/instantiatemacro.rst
@@ -0,0 +1,111 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+   International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. _instantiatemacro:
+
+Instantiate Service, "Macro" mode (PNF example)
+================================================
+
+
+Overview
+--------
+
+Using VID with Macro method means that all the service model resources are deployed in a single SO API call.
+Macro orchestration model can be used to orchestrate service models, which contain PNFs and VNFs.
+
+
+`Pre-requisites`_
+--------------
+
+.. note::
+   To be able to orchestrate services in "Macro" mode, the VID ModernUI needs to be enabled.
+   Review settings in VID container`s /usr/local/tomcat/webapps/vid/WEB-INF/conf/onap.features.properties file.
+   Flags below must be set to "true":
+
+    FLAG_ENABLE_WEBPACK_MODERN_UI = true
+
+    FLAG_EXTENDED_MACRO_PNF_CONFIG = true
+
+.. _Pre-requisites: https://docs.onap.org/projects/onap-vid/en/latest/instantiate.html#pre-requisites
+
+`Access to VID portal`_
+--------------------
+
+.. _Access to VID portal: https://docs.onap.org/projects/onap-vid/en/latest/instantiate.html#access-to-vid-portal
+
+Instantiate Service in "Macro" mode
+-----------------------------------
+
+A Service Model, which contains a PNF resource will be used to demonstrate the "Macro" orchestration mode.
+
+Click "Browse SDC Service Models" and search for the service to instantiate.
+
+The view show only service models in the DISTRIBUTED state.
+
+.. figure:: images/browse-service-models-pnf.png
+   :align: center
+
+Select a service and click Deploy.
+
+Complete the mandatory fields indicated by the red star and click "Set".
+
+.. figure:: images/new-service-instance-popup-pnf.png
+   :align: center
+
+Add a new object to the service instance.
+
+.. note::
+   The blue button for adding objects to the service instance appears when you hover over the object model.
+
+.. figure:: images/service-instance-pnf.png
+   :align: center
+
+Complete the mandatory fields indicated by the red star and click "Set".
+
+.. note::
+   The PNF instance name must be unique
+
+.. figure:: images/new-pnf-instance.png
+   :align: center
+
+To deploy the selected configuration, click "DEPLOY" button in the top right corner.
+
+.. figure:: images/service-instance-pnf-deploy.png
+   :align: center
+
+If the service instance with selected objects is deployed correctly, you will be redirected to the page where you can check the instantiation status.
+
+.. figure:: images/instantiation-status.png
+   :align: center
+
+.. note::
+   In case of Service Models, which contain PNF resources, to complete the deployment of the service instance with PNF object, send a "pnfRegistration" event to VES.
+   No additional actions are needed for VNFs/CNFs.
+
+
+Instantiation Status
+-----------------------------------
+
+The "Instantiation Status" contains information about all deployed service instances.
+
+To check detailed information, click the ellipsis on the right side of the selected service instance.
+
+.. figure:: images/instantiation-status-complete.png
+   :align: center
+
+.. figure:: images/service-information.png
+   :align: center
+
+
+
+Deleting Service Instances previous orchestrated in "macro" model
+-----------------------------------------
+
+To delete a previously created "Macro" instance using VID, the entire service instance must be deleted.
+
+To proceed with a service instance removal, from VID Home screen:
+
+- search for existing service instance
+- edit/view the service instance you want to delete
+- click on red button with white cross
+- confirm deletion of the service instance