aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKrysiak Adam <adam.krysiak@nokia.com>2019-05-28 15:35:09 +0200
committerKrysiak Adam <adam.krysiak@nokia.com>2019-05-29 15:06:34 +0200
commitd3a57d9d71f9a24876153ac4448ae00712f3eb66 (patch)
tree3f7d0bba75534d9123af4804c1d3c0b90f487aa5
parentb5908d85cf0d851f5f9cd637b2252ea1494c9169 (diff)
updating documentation
Issue-ID: CLAMP-394 Change-Id: Idf4afe6c4a580e73923ea5c396c0b00a33e7c160 Signed-off-by: Krysiak Adam <adam.krysiak@nokia.com>
-rw-r--r--docs/images/user-guide/blueprint_node_type.pngbin0 -> 65898 bytes
-rw-r--r--docs/images/user-guide/config-policy-tca1.pngbin215133 -> 109172 bytes
-rw-r--r--docs/images/user-guide/config-policy-tca2.pngbin0 -> 74271 bytes
-rw-r--r--docs/images/user-guide/deploy-params.pngbin222209 -> 97245 bytes
-rw-r--r--docs/images/user-guide/deploy.pngbin126562 -> 12329 bytes
-rw-r--r--docs/images/user-guide/distributed.pngbin141030 -> 89578 bytes
-rw-r--r--docs/images/user-guide/op-policy-box-policy1.pngbin186694 -> 173503 bytes
-rw-r--r--docs/images/user-guide/op-policy-box.pngbin138868 -> 0 bytes
-rw-r--r--docs/images/user-guide/open-box.pngbin135943 -> 40699 bytes
-rw-r--r--docs/images/user-guide/open-menu-prop.pngbin260489 -> 46358 bytes
-rw-r--r--docs/images/user-guide/open-menu.pngbin102693 -> 35423 bytes
-rw-r--r--docs/images/user-guide/opened-closed-loop.pngbin168886 -> 48148 bytes
-rw-r--r--docs/images/user-guide/prop-box.pngbin114725 -> 91272 bytes
-rw-r--r--docs/images/user-guide/submit-menu.pngbin149394 -> 14076 bytes
-rw-r--r--docs/user-guide.rst91
15 files changed, 69 insertions, 22 deletions
diff --git a/docs/images/user-guide/blueprint_node_type.png b/docs/images/user-guide/blueprint_node_type.png
new file mode 100644
index 00000000..1e5ef6a4
--- /dev/null
+++ b/docs/images/user-guide/blueprint_node_type.png
Binary files differ
diff --git a/docs/images/user-guide/config-policy-tca1.png b/docs/images/user-guide/config-policy-tca1.png
index 032bc9a2..47c096d2 100644
--- a/docs/images/user-guide/config-policy-tca1.png
+++ b/docs/images/user-guide/config-policy-tca1.png
Binary files differ
diff --git a/docs/images/user-guide/config-policy-tca2.png b/docs/images/user-guide/config-policy-tca2.png
new file mode 100644
index 00000000..cf1157be
--- /dev/null
+++ b/docs/images/user-guide/config-policy-tca2.png
Binary files differ
diff --git a/docs/images/user-guide/deploy-params.png b/docs/images/user-guide/deploy-params.png
index d51a41ac..aeafb8e3 100644
--- a/docs/images/user-guide/deploy-params.png
+++ b/docs/images/user-guide/deploy-params.png
Binary files differ
diff --git a/docs/images/user-guide/deploy.png b/docs/images/user-guide/deploy.png
index 8f12aa1b..2ec86cc8 100644
--- a/docs/images/user-guide/deploy.png
+++ b/docs/images/user-guide/deploy.png
Binary files differ
diff --git a/docs/images/user-guide/distributed.png b/docs/images/user-guide/distributed.png
index 4a765a99..540168a5 100644
--- a/docs/images/user-guide/distributed.png
+++ b/docs/images/user-guide/distributed.png
Binary files differ
diff --git a/docs/images/user-guide/op-policy-box-policy1.png b/docs/images/user-guide/op-policy-box-policy1.png
index ffd9733b..1143fa21 100644
--- a/docs/images/user-guide/op-policy-box-policy1.png
+++ b/docs/images/user-guide/op-policy-box-policy1.png
Binary files differ
diff --git a/docs/images/user-guide/op-policy-box.png b/docs/images/user-guide/op-policy-box.png
deleted file mode 100644
index 107d2670..00000000
--- a/docs/images/user-guide/op-policy-box.png
+++ /dev/null
Binary files differ
diff --git a/docs/images/user-guide/open-box.png b/docs/images/user-guide/open-box.png
index d38cdb4c..9d7c6ff0 100644
--- a/docs/images/user-guide/open-box.png
+++ b/docs/images/user-guide/open-box.png
Binary files differ
diff --git a/docs/images/user-guide/open-menu-prop.png b/docs/images/user-guide/open-menu-prop.png
index f8d6438b..57c0f2d0 100644
--- a/docs/images/user-guide/open-menu-prop.png
+++ b/docs/images/user-guide/open-menu-prop.png
Binary files differ
diff --git a/docs/images/user-guide/open-menu.png b/docs/images/user-guide/open-menu.png
index 8ca5e86f..2ea4f5ee 100644
--- a/docs/images/user-guide/open-menu.png
+++ b/docs/images/user-guide/open-menu.png
Binary files differ
diff --git a/docs/images/user-guide/opened-closed-loop.png b/docs/images/user-guide/opened-closed-loop.png
index ea854c42..01a3f4e0 100644
--- a/docs/images/user-guide/opened-closed-loop.png
+++ b/docs/images/user-guide/opened-closed-loop.png
Binary files differ
diff --git a/docs/images/user-guide/prop-box.png b/docs/images/user-guide/prop-box.png
index 54027b4f..52879f99 100644
--- a/docs/images/user-guide/prop-box.png
+++ b/docs/images/user-guide/prop-box.png
Binary files differ
diff --git a/docs/images/user-guide/submit-menu.png b/docs/images/user-guide/submit-menu.png
index 641055e2..9d07f4e8 100644
--- a/docs/images/user-guide/submit-menu.png
+++ b/docs/images/user-guide/submit-menu.png
Binary files differ
diff --git a/docs/user-guide.rst b/docs/user-guide.rst
index dca5bb80..cc86c48b 100644
--- a/docs/user-guide.rst
+++ b/docs/user-guide.rst
@@ -2,12 +2,13 @@
.. http://creativecommons.org/licenses/by/4.0
.. Copyright (c) 2017-2018 AT&T Intellectual Property. All rights reserved.
-Open Closed loop in CLAMP
+Closed loop in CLAMP
-------------------------
There is 2 closed loop levels in CLAMP:
+
- Closed loop template: This is created from the DCAE blueprint (designed in the DCAE designer), and distributed by SDC to CLAMP.
- Closed loop instance: Based on the template, it represents a physical closed loop in the platform related to a service and a VNF.
- This is created in CLAMP when receiving the SDC notification, as this one is related to a specific service/vnf.
+ This is created in CLAMP when receiving the SDC notification, as this one is related to a specific service/vnf.
There is no way to design a closed loop from scratch in CLAMP, you can only configure it and manage its life-cycle.
For more info on how to design the service in SDC, check this: https://wiki.onap.org/display/DW/CLAMP+videos#CLAMPvideos-DesignpartinSDC
@@ -22,56 +23,102 @@ Once you click on "Open CL", this dialog box is shown
|clamp-open-box|
-Once the distributed closed loop has been chosen, the closed loop is shown to the user
+Once the distributed closed loop has been chosen, the closed loop is shown to the user.
+From this view user can start configure empty closed loop using **Closed loop modeller**.
|clamp-opened-closed-loop|
+Closed loop modeler has 3 main parts:
+
+#. Loop configuration view
+ Visualizes event flow in Control Loop. This view is auto-generated by Clamp. To generate it Clamp parses DCAE_INVENTORY_BLUEPRINT from CSAR distributed by SDC.
+ It Always consists of **VES -> <nodes from blueprint> -> OperationalPolicy**. Not all nodes are visualized. Only those with type **dcae.nodes.\***
+ |blueprint-node|
+
+#. Loop status
+ Visualizes status of opened loop.
+#. Loop logs
+ Table with log data of opened loop
+
Closed Loop properties
----------------------
-You can check to which service/vnf the closed loop has been associated in SDC.
+In Dublin release this view shows what are deployment parameters or Closed Loop.
+To open it from *Closed Loop* menu select *Properties CL*
|clamp-menu-prop|
-This opens a box that gives the properties set during the SDC notification deployment in CLAMP.
-Do not change those settings
+This opens a box with JSON object. It contains deployment parameters extracted from DCAE_INVENTORY_BLUEPRINT.
+It's not recommended to edit this JSON. Each of this parameters should be available in view shown to deploy analytic application.
+
|clamp-prop-box|
-Operational policy properties
+Operational and Guard policy properties
-----------------------------
-The box "policy" is clickable, so the operational policies can be defined.
-By clicking on the button "New Policy", it's possible to add new operational policies that can chosen in the configuration policy.
+Operational policy is a parametrized drools (in Dublin) rule with logic performing action on resource.
+User can't chose his own rule. Clamp always tries to create operational policy that bases on rule bind with **ClosedLoopControlName** attribute available in Policy dictionary.
+
+There is only one operational policy per closed loop. More about operational policies can be found here `Control Loop Operational Policy <https://wiki.onap.org/display/DW/Control+Loop+Operational+Policy>`_.
+
+Guard policy is policy securing operational policy calls. It defines a set of constraints that have to be matched before running operational policy.
+More about guard policies can be found here `Creating and Using Guard Policies <https://docs.onap.org/en/dublin/submodules/policy/engine.git/docs/platform/guardpolicy.html>`_.
-|clamp-op-policy-box|
+To configure operational and guard policy user has to click *OperationalPolicy* box.
-Once clicked, it's possible to configure each operational policy that can also contain multiple "sub policies", one per Recipe
+Once clicked, it's possible to configure operational policy. Policy can have child policies, one per Recipe.
|clamp-op-policy-box-policy1|
-Configuration policy properties
+1. Parent policy name
+2. Global time limit for this operational policies
+3. Specifies whether policy is abated
+4. Unique id for Control Loop.
+5. Button for creating child/parent policies
+6. Unique id of Policy. (Clamp internal)
+7. Recipe/Operation triggered on controller/orchestrator
+8. Maximum count of retries
+9. Timeout for this operational policy
+10. Actor used to perform action. (Orchestrator/Controller)
+11. Payload required by actor to perform an action
+12. Set of fields with policies called under certain conditions. E.g. when health-check receives timeout failure restart could be called.
+13. Set of fields specifying resource. On this resource Operational Policy should perform an action
+14. Checkbox enabling/disabling guard policy for this operational policy
+15. Guard Policy type (frequency limited or min max)
+16. Set of guard policy specific fields. Please check `Creating and Using Guard Policies <https://docs.onap.org/en/dublin/submodules/policy/engine.git/docs/platform/guardpolicy.html>`_.
+
+
+Micro-service policy properties
-------------------------------
-The box "tca" is clickable, so the TCA configuration policy can be defined.
-In that popup dialog, multiple Thresholds can be defined, the operational policies defined previously can be chosen and set in the "Policy" field.
-
+Boxes between `VES` and `OperationalPolicy` are generated from blueprint. They can be one of ONAP predefined analytic microservices or custom analytics.
+Each of the boxes is clickable. Microservice configuration view is generated using Policy Type assigned to selected microservice.
+Clamp by default assumes that microservices have policy type **onap.policies.monitoring.cdap.tca.hi.lo.app**.
+
+After clicking microservice box Clamp opens popup dialog. Example popup dialog for microservice with default type looks like:
+
|clamp-config-policy-tca1|
+|clamp-config-policy-tca2|
+
+
Saving Closed loop
------------------
-Once all properties have been defined for all policies, the closed loop must be saved.
+Policies are saved localy in Clamp after each configuration change
-|clamp-save-cl|
Submitting the Closed loop to policy
------------------------------------
In the "Manage Menu", the submit action can be used to send the configuration to policy engine.
-The "Validation test" can be used to check the data configured in the closed loop without sending anything to policy engine.
+
|clamp-submit-cl|
-If everything is successful, this changes the status to "Distributed"
+If everything is successful, this changes the status to "Submitted". Clamp should also show proper logs in logs view.
|clamp-distributed|
+After Policies are submitted they should be visible in Policy PAP component.
+Please check `Policy GUI <https://docs.onap.org/en/dublin/submodules/policy/engine.git/docs/platform/policygui.html>`_
+
Deploy/undeploy the Closed loop to DCAE
---------------------------------------
Once sent to policy engine, Clamp can ask to DCAE to deploy the micro service
@@ -92,12 +139,12 @@ Once deployed on DCAE the status Closed loop status goes to ACTIVE, it can then
.. |clamp-opened-closed-loop| image:: images/user-guide/opened-closed-loop.png
.. |clamp-menu-prop| image:: images/user-guide/open-menu-prop.png
.. |clamp-prop-box| image:: images/user-guide/prop-box.png
-.. |clamp-op-policy-box| image:: images/user-guide/op-policy-box.png
.. |clamp-op-policy-box-policy1| image:: images/user-guide/op-policy-box-policy1.png
.. |clamp-config-policy-tca1| image:: images/user-guide/config-policy-tca1.png
-.. |clamp-save-cl| image:: images/user-guide/save-cl.png
+.. |clamp-config-policy-tca2| image:: images/user-guide/config-policy-tca2.png
.. |clamp-submit-cl| image:: images/user-guide/submit-menu.png
.. |clamp-distributed| image:: images/user-guide/distributed.png
.. |clamp-deploy| image:: images/user-guide/deploy.png
.. |clamp-deploy-params| image:: images/user-guide/deploy-params.png
-.. |clamp-undeploy| image:: images/user-guide/undeploy.png \ No newline at end of file
+.. |clamp-undeploy| image:: images/user-guide/undeploy.png
+.. |blueprint-node| image:: images/user-guide/blueprint_node_type.png \ No newline at end of file