From: Gervais-Martial Ngueko Date: Wed, 29 May 2019 13:23:31 +0000 (+0000) Subject: Merge "updating documentation" X-Git-Tag: 4.0.3~4 X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=187aa0e8bfe23a216a5e88ff78349aaecd0d800a;hp=15c9ef0d579285a7caa3a19fc33ba27ed9cfedf4;p=clamp.git Merge "updating documentation" --- 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 Binary files /dev/null and b/docs/images/user-guide/blueprint_node_type.png 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 Binary files a/docs/images/user-guide/config-policy-tca1.png and b/docs/images/user-guide/config-policy-tca1.png 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 Binary files /dev/null and b/docs/images/user-guide/config-policy-tca2.png differ diff --git a/docs/images/user-guide/deploy-params.png b/docs/images/user-guide/deploy-params.png index d51a41ac..aeafb8e3 100644 Binary files a/docs/images/user-guide/deploy-params.png and b/docs/images/user-guide/deploy-params.png differ diff --git a/docs/images/user-guide/deploy.png b/docs/images/user-guide/deploy.png index 8f12aa1b..2ec86cc8 100644 Binary files a/docs/images/user-guide/deploy.png and b/docs/images/user-guide/deploy.png differ diff --git a/docs/images/user-guide/distributed.png b/docs/images/user-guide/distributed.png index 4a765a99..540168a5 100644 Binary files a/docs/images/user-guide/distributed.png and b/docs/images/user-guide/distributed.png 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 Binary files a/docs/images/user-guide/op-policy-box-policy1.png and b/docs/images/user-guide/op-policy-box-policy1.png 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 Binary files a/docs/images/user-guide/op-policy-box.png and /dev/null differ diff --git a/docs/images/user-guide/open-box.png b/docs/images/user-guide/open-box.png index d38cdb4c..9d7c6ff0 100644 Binary files a/docs/images/user-guide/open-box.png and b/docs/images/user-guide/open-box.png 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 Binary files a/docs/images/user-guide/open-menu-prop.png and b/docs/images/user-guide/open-menu-prop.png differ diff --git a/docs/images/user-guide/open-menu.png b/docs/images/user-guide/open-menu.png index 8ca5e86f..2ea4f5ee 100644 Binary files a/docs/images/user-guide/open-menu.png and b/docs/images/user-guide/open-menu.png 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 Binary files a/docs/images/user-guide/opened-closed-loop.png and b/docs/images/user-guide/opened-closed-loop.png differ diff --git a/docs/images/user-guide/prop-box.png b/docs/images/user-guide/prop-box.png index 54027b4f..52879f99 100644 Binary files a/docs/images/user-guide/prop-box.png and b/docs/images/user-guide/prop-box.png differ diff --git a/docs/images/user-guide/submit-menu.png b/docs/images/user-guide/submit-menu.png index 641055e2..9d07f4e8 100644 Binary files a/docs/images/user-guide/submit-menu.png and b/docs/images/user-guide/submit-menu.png 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 -> -> 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 `_. + +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 `_. -|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 `_. + + +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 `_ + 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