From 5dea22255fc131d5c2b0348986bfc75c56d17097 Mon Sep 17 00:00:00 2001 From: sebdet Date: Fri, 11 Jan 2019 13:11:03 +0100 Subject: Add user guide Add user guide to the ReadTheDoc pages, this is still a draft Issue-ID: CLAMP-257 Change-Id: I9b1feb9af3749b262ad42518110280b21df7e610 Signed-off-by: sebdet --- docs/architecture.rst | 6 +- docs/images/ONAP-closedloop.png | Bin 220944 -> 0 bytes docs/images/architecture/ONAP-closedloop.png | Bin 0 -> 220944 bytes docs/images/architecture/distdepl.png | Bin 0 -> 38514 bytes docs/images/architecture/monitoring.png | Bin 0 -> 60890 bytes docs/images/distdepl.png | Bin 38514 -> 0 bytes docs/images/monitoring.png | Bin 60890 -> 0 bytes docs/images/user-guide/config-policy-tca1.png | Bin 0 -> 215133 bytes docs/images/user-guide/deploy-params.png | Bin 0 -> 222209 bytes docs/images/user-guide/deploy.png | Bin 0 -> 126562 bytes docs/images/user-guide/distributed.png | Bin 0 -> 141030 bytes docs/images/user-guide/op-policy-box-policy1.png | Bin 0 -> 186694 bytes docs/images/user-guide/op-policy-box.png | Bin 0 -> 138868 bytes docs/images/user-guide/open-box.png | Bin 0 -> 135943 bytes docs/images/user-guide/open-menu-prop.png | Bin 0 -> 260489 bytes docs/images/user-guide/open-menu.png | Bin 0 -> 102693 bytes docs/images/user-guide/opened-closed-loop.png | Bin 0 -> 168886 bytes docs/images/user-guide/prop-box.png | Bin 0 -> 114725 bytes docs/images/user-guide/save-cl.png | Bin 0 -> 139066 bytes docs/images/user-guide/submit-menu.png | Bin 0 -> 149394 bytes docs/images/user-guide/undeploy.png | Bin 0 -> 117598 bytes docs/index.rst | 13 ++- docs/user-guide.rst | 103 +++++++++++++++++++++++ 23 files changed, 117 insertions(+), 5 deletions(-) delete mode 100644 docs/images/ONAP-closedloop.png create mode 100644 docs/images/architecture/ONAP-closedloop.png create mode 100644 docs/images/architecture/distdepl.png create mode 100644 docs/images/architecture/monitoring.png delete mode 100755 docs/images/distdepl.png delete mode 100755 docs/images/monitoring.png create mode 100644 docs/images/user-guide/config-policy-tca1.png create mode 100644 docs/images/user-guide/deploy-params.png create mode 100644 docs/images/user-guide/deploy.png create mode 100644 docs/images/user-guide/distributed.png create mode 100644 docs/images/user-guide/op-policy-box-policy1.png create mode 100644 docs/images/user-guide/op-policy-box.png create mode 100644 docs/images/user-guide/open-box.png create mode 100644 docs/images/user-guide/open-menu-prop.png create mode 100644 docs/images/user-guide/open-menu.png create mode 100644 docs/images/user-guide/opened-closed-loop.png create mode 100644 docs/images/user-guide/prop-box.png create mode 100644 docs/images/user-guide/save-cl.png create mode 100644 docs/images/user-guide/submit-menu.png create mode 100644 docs/images/user-guide/undeploy.png create mode 100644 docs/user-guide.rst diff --git a/docs/architecture.rst b/docs/architecture.rst index e526fb064..fc9e6c322 100644 --- a/docs/architecture.rst +++ b/docs/architecture.rst @@ -39,6 +39,6 @@ operational costs compared to traditional methods. |closed-loop| -.. |clamp-flow| image:: images/distdepl.png -.. |dashboard-flow| image:: images/monitoring.png -.. |closed-loop| image:: images/ONAP-closedloop.png \ No newline at end of file +.. |clamp-flow| image:: images/architecture/distdepl.png +.. |dashboard-flow| image:: images/architecture/monitoring.png +.. |closed-loop| image:: images/architecture/ONAP-closedloop.png \ No newline at end of file diff --git a/docs/images/ONAP-closedloop.png b/docs/images/ONAP-closedloop.png deleted file mode 100644 index 7d3a2cac8..000000000 Binary files a/docs/images/ONAP-closedloop.png and /dev/null differ diff --git a/docs/images/architecture/ONAP-closedloop.png b/docs/images/architecture/ONAP-closedloop.png new file mode 100644 index 000000000..7d3a2cac8 Binary files /dev/null and b/docs/images/architecture/ONAP-closedloop.png differ diff --git a/docs/images/architecture/distdepl.png b/docs/images/architecture/distdepl.png new file mode 100644 index 000000000..5593f4986 Binary files /dev/null and b/docs/images/architecture/distdepl.png differ diff --git a/docs/images/architecture/monitoring.png b/docs/images/architecture/monitoring.png new file mode 100644 index 000000000..6dbf75e45 Binary files /dev/null and b/docs/images/architecture/monitoring.png differ diff --git a/docs/images/distdepl.png b/docs/images/distdepl.png deleted file mode 100755 index 5593f4986..000000000 Binary files a/docs/images/distdepl.png and /dev/null differ diff --git a/docs/images/monitoring.png b/docs/images/monitoring.png deleted file mode 100755 index 6dbf75e45..000000000 Binary files a/docs/images/monitoring.png and /dev/null differ diff --git a/docs/images/user-guide/config-policy-tca1.png b/docs/images/user-guide/config-policy-tca1.png new file mode 100644 index 000000000..032bc9a2e Binary files /dev/null and b/docs/images/user-guide/config-policy-tca1.png differ diff --git a/docs/images/user-guide/deploy-params.png b/docs/images/user-guide/deploy-params.png new file mode 100644 index 000000000..d51a41ac8 Binary files /dev/null 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 new file mode 100644 index 000000000..8f12aa1b6 Binary files /dev/null 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 new file mode 100644 index 000000000..4a765a994 Binary files /dev/null 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 new file mode 100644 index 000000000..ffd9733bd Binary files /dev/null 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 new file mode 100644 index 000000000..107d2670d Binary files /dev/null and b/docs/images/user-guide/op-policy-box.png differ diff --git a/docs/images/user-guide/open-box.png b/docs/images/user-guide/open-box.png new file mode 100644 index 000000000..d38cdb4cf Binary files /dev/null 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 new file mode 100644 index 000000000..f8d6438b9 Binary files /dev/null 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 new file mode 100644 index 000000000..8ca5e86f1 Binary files /dev/null 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 new file mode 100644 index 000000000..ea854c427 Binary files /dev/null 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 new file mode 100644 index 000000000..54027b4fa Binary files /dev/null and b/docs/images/user-guide/prop-box.png differ diff --git a/docs/images/user-guide/save-cl.png b/docs/images/user-guide/save-cl.png new file mode 100644 index 000000000..7e0439d1c Binary files /dev/null and b/docs/images/user-guide/save-cl.png differ diff --git a/docs/images/user-guide/submit-menu.png b/docs/images/user-guide/submit-menu.png new file mode 100644 index 000000000..641055e2f Binary files /dev/null and b/docs/images/user-guide/submit-menu.png differ diff --git a/docs/images/user-guide/undeploy.png b/docs/images/user-guide/undeploy.png new file mode 100644 index 000000000..c17fa89ee Binary files /dev/null and b/docs/images/user-guide/undeploy.png differ diff --git a/docs/index.rst b/docs/index.rst index 43fb315f6..677c32b12 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -190,12 +190,15 @@ For OOM, the URL is https://:30258/designer/index.html - With AAF enabled, the certificate p12 must be added to the browser ca path: src/main/resources/clds/aaf/org.onap.clamp.p12, password "China in the Spring" + Or get it from this page : https://wiki.onap.org/display/DW/Control+Loop+Flows+and+Models+for+Casablanca Human Interfaces ---------------- .. Basic info on the interface type, ports/protocols provided over, etc. User Interface (CLAMP Designer) - serve to configure control loop +CLAMP UI is used to configure the Control Loop designed and distributed by SDC. From that UI it's possible to distribute the configuration policies and control the life-cycle of the DCAE Micro Services. + The following actions are done using the UI: * Design a control loop flow by selecting a predefined template from a list @@ -219,8 +222,14 @@ The following actions are done using the UI: * Control (start/stop) the operation of the control loop in DCAE - - HealthCheck API - serve to verify CLAMP status (see offered API's section) * https://:8443/restservices/clds/v1/healthcheck This one does not require the certificate + +Walk-through can be found here: https://wiki.onap.org/display/DW/CLAMP+videos + +.. toctree:: + :maxdepth: 1 + :titlesonly: + + CLAMP User Guide \ No newline at end of file diff --git a/docs/user-guide.rst b/docs/user-guide.rst new file mode 100644 index 000000000..dca5bb80f --- /dev/null +++ b/docs/user-guide.rst @@ -0,0 +1,103 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. Copyright (c) 2017-2018 AT&T Intellectual Property. All rights reserved. + +Open 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. + +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 + +There is a specific menu to open distributed closed 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 + +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 + +|clamp-opened-closed-loop| + +Closed Loop properties +---------------------- +You can check to which service/vnf the closed loop has been associated in SDC. + +|clamp-menu-prop| + +This opens a box that gives the properties set during the SDC notification deployment in CLAMP. +Do not change those settings + +|clamp-prop-box| + +Operational 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. + +|clamp-op-policy-box| + +Once clicked, it's possible to configure each operational policy that can also contain multiple "sub policies", one per Recipe + +|clamp-op-policy-box-policy1| + +Configuration 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. + +|clamp-config-policy-tca1| + +Saving Closed loop +------------------ +Once all properties have been defined for all policies, the closed loop must be saved. + +|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" + +|clamp-distributed| + +Deploy/undeploy the Closed loop to DCAE +--------------------------------------- +Once sent to policy engine, Clamp can ask to DCAE to deploy the micro service + +|clamp-deploy| + +This opens a window where the parameters of the DCAE micro service can be configured/tuned. +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) + +|clamp-undeploy| + +.. |clamp-open-menu| image:: images/user-guide/open-menu.png +.. |clamp-open-box| image:: images/user-guide/open-box.png +.. |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-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 -- cgit 1.2.3-korg