From 9198d86003bafe94870ded9b1c376a6164c43e00 Mon Sep 17 00:00:00 2001 From: ramagp Date: Wed, 9 Dec 2020 17:05:15 +0000 Subject: Instructions for control loop design Change-Id: I49d4409c0939fbfd63a5e30dec518642e1de4005 Issue-ID: DOC-681 Signed-off-by: ramagp --- .../cl_design_instructions.rst | 76 +++++++++++++++++++++ .../control-loop-design-steps/media/image1.png | Bin 0 -> 49333 bytes .../control-loop-design-steps/media/image2.png | Bin 0 -> 55564 bytes .../control-loop-design-steps/media/image3.png | Bin 0 -> 53983 bytes .../control-loop-design-steps/media/image4.png | Bin 0 -> 63038 bytes .../control-loop-design-steps/media/image5.png | Bin 0 -> 58872 bytes .../control-loop-design-steps/media/image6.png | Bin 0 -> 55416 bytes .../control-loop-design-steps/media/image7.png | Bin 0 -> 52627 bytes .../control-loop-design-steps/media/image8.png | Bin 0 -> 87387 bytes .../control-loop-design-steps/media/image9.png | Bin 0 -> 66399 bytes docs/guides/onap-user/design/index.rst | 1 + 11 files changed, 77 insertions(+) create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/cl_design_instructions.rst create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image1.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image2.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image3.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image4.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image5.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image6.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image7.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image8.png create mode 100644 docs/guides/onap-user/design/control-loop-design-steps/media/image9.png (limited to 'docs/guides') diff --git a/docs/guides/onap-user/design/control-loop-design-steps/cl_design_instructions.rst b/docs/guides/onap-user/design/control-loop-design-steps/cl_design_instructions.rst new file mode 100644 index 000000000..a0bbbe5c0 --- /dev/null +++ b/docs/guides/onap-user/design/control-loop-design-steps/cl_design_instructions.rst @@ -0,0 +1,76 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 +.. International License. http://creativecommons.org/licenses/by/4.0 +.. Copyright © 2017-2020 Aarna Networks, Inc. + +Instructions for Designing a Control Loop +========================================= + +This document provides step by step instructions on how to design a Control Loop starting from service creation, adding the required DCAE artifacts, policy and VF in the composition phase of SDC and finally distributing it to the CLAMP for further process. + +In order to distribute the DCAE microservice blueprints we need to create a dummy service. The DCAE blueprint will be added as an artifact to the VF inside the service during service composition time. + +Here we are using TCA (Threshold Checking Application) DCAE microservice as an example application to upload for designing the control loop. + +Follow the below steps for creating and distributing the service + +1. Login as DESIGNER (cs0008) and create the service + +.. note:: + The service name should not contain any spaces. The DCAE policy fails to fetch the service from PDP if the name has a space. For example ‘dcae1’ will work and ‘dcae 1’ will not. + +|image1| + +2. Add any VNF (ex: vfw_pg) that was already created during the SDC design phase. + +In the composition canvas drag and drop a resource of type VF from the abstract section in the Elements section (left hand side panel) + +|image2| + +3. Download the required DCAE MS blueprint to be attached to the service + +Use the sample TCA blueprint located here: +https://git.onap.org/dcaegen2/platform/blueprints/tree/blueprints/k8s-tcagen2-clampnode.yaml + +.. note:: + - Check if the version of the plugin used in the blueprint is different from existing, then update the blueprint import to match. + - To check the version run this: `cfy plugins list | grep k8splugin` + +4. Now upload the Control Loop Artifact. The procedure to upload the artifact is + + - Click on the VF, as in the picture below the ‘vsp_pg 0’ is selected. + - Click on ‘DEPLOYMENT ARTIFACTS’ and then click on “Add Artifact”. + |image3| + + - Fill the details and in the type select DCAE_INVENTORY_BLUEPRINT, then click on Done as in the picture shown below. + |image4| + +5. After uploading the DCAE artifact to the SDC Service, attach the policy model to the Service. From the left drop down, select TCA policy under Policies, and click on the Add policy. + +|image5| + +6. Click on Checkin on top right corner then click OK + +|image6| + +7. Search and select the same service from CATALOG and click on Certify on top right corner + +|image7| + +8. Click Distribute to distribute the service, then click on Distribution in the left hand side panel and monitor until the distribution is complete. We should see artifacts deployed in CLAMP and Policy engine, as can be seen in the picture below + +|image8| + +9. At this point we can open the CLAMP GUI and verify that the DCAE microservice design template is in place as shown below. + +|image9| + + +.. |image1| image:: media/image1.png +.. |image2| image:: media/image2.png +.. |image3| image:: media/image3.png +.. |image4| image:: media/image4.png +.. |image5| image:: media/image5.png +.. |image6| image:: media/image6.png +.. |image7| image:: media/image7.png +.. |image8| image:: media/image8.png +.. |image9| image:: media/image9.png diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image1.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image1.png new file mode 100644 index 000000000..e2c0595d9 Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image1.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image2.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image2.png new file mode 100644 index 000000000..58827b12c Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image2.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image3.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image3.png new file mode 100644 index 000000000..76d3147a8 Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image3.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image4.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image4.png new file mode 100644 index 000000000..797b961e0 Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image4.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image5.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image5.png new file mode 100644 index 000000000..c0b5dc668 Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image5.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image6.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image6.png new file mode 100644 index 000000000..9cc9373d2 Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image6.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image7.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image7.png new file mode 100644 index 000000000..5f974d776 Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image7.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image8.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image8.png new file mode 100644 index 000000000..bb314752b Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image8.png differ diff --git a/docs/guides/onap-user/design/control-loop-design-steps/media/image9.png b/docs/guides/onap-user/design/control-loop-design-steps/media/image9.png new file mode 100644 index 000000000..59125ec08 Binary files /dev/null and b/docs/guides/onap-user/design/control-loop-design-steps/media/image9.png differ diff --git a/docs/guides/onap-user/design/index.rst b/docs/guides/onap-user/design/index.rst index 2a629999e..186777b0d 100644 --- a/docs/guides/onap-user/design/index.rst +++ b/docs/guides/onap-user/design/index.rst @@ -104,6 +104,7 @@ The following sections focus on the different Design steps: Service Distribution <./service-distribution/index.rst> VNF parameter resolution Design <./parameter_resolution/index.rst> Control Loop Design <./control-loop/index.rst> + Instructions for control loop design <./control-loop-design-steps/cl_design_instructions.rst> The following section provide links to the projects: -- cgit 1.2.3-korg