X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fuser-guide.rst;h=0d7d4e6192cb625f8bdedac1c254c849c9bb1e26;hb=refs%2Fheads%2Felalto;hp=cc86c48bb8b23e29ec24cca85b94c36fc3be678e;hpb=d3a57d9d71f9a24876153ac4448ae00712f3eb66;p=clamp.git diff --git a/docs/user-guide.rst b/docs/user-guide.rst index cc86c48b..0d7d4e61 100644 --- a/docs/user-guide.rst +++ b/docs/user-guide.rst @@ -2,29 +2,29 @@ .. http://creativecommons.org/licenses/by/4.0 .. Copyright (c) 2017-2018 AT&T Intellectual Property. All rights reserved. -Closed loop in CLAMP -------------------------- -There is 2 closed loop levels in CLAMP: +Control loop in CLAMP +--------------------- +There is 2 control 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. +- Control loop template: This is created from the DCAE blueprint (designed in the DCAE designer), and distributed by SDC to CLAMP. +- Control loop instance: Based on the template, it represents a physical control 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. -There is no way to design a closed loop from scratch in CLAMP, you can only configure it and manage its life-cycle. +There is no way to design a control 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 -There is a specific menu to open distributed closed loops in CLAMP UI. +There is a specific menu to open distributed control loops in CLAMP UI. |clamp-open-menu| -Please note that the option "Create CL" can be used to create a closed loop from the template distributed by SDC, you can therefore instantiate it for another service/vnf +Please note that the option "Create CL" can be used to create a control loop from the template distributed by SDC, you can therefore instantiate it for another service/vnf 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. -From this view user can start configure empty closed loop using **Closed loop modeller**. +Once the distributed control loop has been chosen, the control loop is shown to the user. +From this view user can start configure empty control loop using **Closed loop modeller**. |clamp-opened-closed-loop| @@ -40,9 +40,9 @@ Closed loop modeler has 3 main parts: #. Loop logs Table with log data of opened loop -Closed Loop properties ----------------------- -In Dublin release this view shows what are deployment parameters or Closed Loop. +Control Loop properties +----------------------- +In Dublin release this view shows what are deployment parameters or control Loop. To open it from *Closed Loop* menu select *Properties CL* |clamp-menu-prop| @@ -54,11 +54,11 @@ It's not recommended to edit this JSON. Each of this parameters should be availa |clamp-prop-box| Operational and Guard policy properties ------------------------------ +--------------------------------------- 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 `_. +There is only one operational policy per control 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 `_. @@ -74,13 +74,35 @@ Once clicked, it's possible to configure operational policy. Policy can have chi 3. Specifies whether policy is abated 4. Unique id for Control Loop. 5. Button for creating child/parent policies + Child/parent policies are policies that depend on one another under certain circumstances (check point 12.) 6. Unique id of Policy. (Clamp internal) 7. Recipe/Operation triggered on controller/orchestrator -8. Maximum count of retries + This recipe will be used by policy drools PDP when sending request to controller/orchestrator. + E.g. in case of *Health-Check* is selected here and *APPC* as actor PDP will trigger APPC LCM API triggering health-check operation. + + List of options is predefined in Clamp code and can't be modified. + Possible options: + * Restart + * Rebuild + * Migrate + * Health-Check + * ModifyConfig + * VF Module Create + * VF Module Delete + * Reroute +8. Maximum amount of retries that policy takes when triggering action 9. Timeout for this operational policy 10. Actor used to perform action. (Orchestrator/Controller) + Actor that will be used by drools PDP to perform action. + Possible options: + * APPC + * SO + * VFC + * SDNC + * SDNR 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. +12. Set of fields describing child/parend policies dependency. + 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) @@ -100,13 +122,13 @@ After clicking microservice box Clamp opens popup dialog. Example popup dialog f |clamp-config-policy-tca2| -Saving Closed loop ------------------- +Saving Control loop +------------------- Policies are saved localy in Clamp after each configuration change -Submitting the Closed loop to policy ------------------------------------- +Submitting the Control loop to policy +------------------------------------- In the "Manage Menu", the submit action can be used to send the configuration to policy engine. @@ -119,8 +141,8 @@ If everything is successful, this changes the status to "Submitted". Clamp shoul After Policies are submitted they should be visible in Policy PAP component. Please check `Policy GUI `_ -Deploy/undeploy the Closed loop to DCAE ---------------------------------------- +Deploy/undeploy the Control Loop to DCAE +----------------------------------------- Once sent to policy engine, Clamp can ask to DCAE to deploy the micro service |clamp-deploy| @@ -130,7 +152,7 @@ The policy_id is automatically generated by Clamp in the previous steps. |clamp-deploy-params| -Once deployed on DCAE the status Closed loop status goes to ACTIVE, it can then be Undeployed/Stopped or even Updated (this is to push new policies on policy engine) +Once deployed on DCAE the status Control loop status goes to ACTIVE, it can then be Undeployed/Stopped or even Updated (this is to push new policies on policy engine) |clamp-undeploy|