aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/clamp/acm/api-protocol/system-level-dialogues.rst167
-rw-r--r--docs/clamp/acm/clamp-gui/images/01-gui.pngbin0 -> 5199 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/02-gui.pngbin0 -> 25399 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/03-gui.pngbin0 -> 22009 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/04-gui.pngbin0 -> 3070 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/05-gui.pngbin0 -> 10977 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/06-gui.pngbin0 -> 13765 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/07-gui.pngbin0 -> 13484 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/08-gui.pngbin0 -> 21202 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/09-gui.pngbin0 -> 10824 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/10-gui.pngbin0 -> 8164 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/11-gui.pngbin0 -> 43677 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/12-gui.pngbin0 -> 10778 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/13-gui.pngbin0 -> 42355 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/14-gui.pngbin0 -> 51361 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/15-gui.pngbin0 -> 25049 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/16-gui.pngbin0 -> 10737 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/17-gui.pngbin0 -> 17073 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/18-gui.pngbin0 -> 52727 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/19-gui.pngbin0 -> 54033 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/20-gui.pngbin0 -> 22866 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/21-gui.pngbin0 -> 8935 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/22-gui.pngbin0 -> 7317 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/images/23-gui.pngbin0 -> 13755 bytes
-rw-r--r--docs/clamp/acm/clamp-gui/policy-gui.rst317
-rw-r--r--docs/clamp/acm/images/system-dialogues/change-acm-instance-state-participants.pngbin0 -> 80842 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/change-cl-instance-state-participants.pngbin72443 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/comissioning-clamp-gui.pngbin16095 -> 17615 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/comissioning-sdc.pngbin23311 -> 25247 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/common-properties-type-definition.pngbin48841 -> 51269 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/create-acm-instance.pngbin0 -> 47398 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/create-cl-instance.pngbin43697 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/decommission-acm-type-definition.pngbin0 -> 35440 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/decommission-cl-type-definition.pngbin31967 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/deinstantiate-acm-from-participants.pngbin0 -> 77462 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/deinstantiate-cl-from-participants.pngbin69110 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/delete-acm-instance.pngbin0 -> 32400 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/delete-cl-instance.pngbin28593 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/depriming-acm-type-definition.pngbin0 -> 92859 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/depriming-cl-type-definition.pngbin83153 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/monitoring-by-participants.pngbin28740 -> 31321 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/priming-acm-type-definition.pngbin0 -> 96635 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/priming-cl-type-definition.pngbin87367 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/read-acm-instance.pngbin0 -> 17443 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/read-cl-instance.pngbin15711 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/read-commision-acm-type-definition.pngbin0 -> 17430 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/read-commision-cl-type-definition.pngbin16090 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/statistics-housekeeping.pngbin31967 -> 34005 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/supervise-acms.pngbin0 -> 141054 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/supervise-controlloops.pngbin117067 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/supervise-participants.pngbin32786 -> 33221 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/update-acm-instance-config-participants.pngbin0 -> 91337 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/update-cl-instance-config-participants.pngbin83866 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/update-instance-params-acm.pngbin0 -> 47168 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/update-instance-params-cl.pngbin43525 -> 0 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/view-monitoring-info.pngbin66306 -> 73142 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/view-statistics.pngbin71209 -> 80360 bytes
-rw-r--r--docs/clamp/clamp.rst3
58 files changed, 404 insertions, 83 deletions
diff --git a/docs/clamp/acm/api-protocol/system-level-dialogues.rst b/docs/clamp/acm/api-protocol/system-level-dialogues.rst
index 676ffc9b..6d3f82d6 100644
--- a/docs/clamp/acm/api-protocol/system-level-dialogues.rst
+++ b/docs/clamp/acm/api-protocol/system-level-dialogues.rst
@@ -10,37 +10,37 @@ System Level Dialogues
:depth: 4
-The CLAMP Control Loop Runtime Lifecycle Management uses the following system level dialogues.
-These dialogues enable the CLAMP runtime capabilities described in :ref:`Section 2 of
-TOSCA Defined Control Loops: Architecture and Design <controlloop-capabilities>`.
+The CLAMP Automation Composition Runtime Lifecycle Management uses the following system level
+dialogues. These dialogues enable the CLAMP runtime capabilities described in
+:ref:`Section 2 of TOSCA Defined Automation Compositions: Architecture and Design <acm-capabilities>`.
Design Time dialogues will be described in future releases of the system.
1 Commissioning Dialogues
=========================
-Commissioning dialogues are used to commission and decommission Control Loop Type definitions
-and to set the values of Common Parameters.
+Commissioning dialogues are used to commission and decommission Automation Composition Type
+definitions and to set the values of Common Parameters.
-Commissioning a Control Loop Type is a three-step process:
+Commissioning an Automation Composition Type is a three-step process:
-#. The Control Loop Type must be created, that is the Control Loop Type definition must be
- loaded and stored in the database. This step may be carried out over the REST interface or
- using SDC distribution.
+#. The Automation Composition Type must be created, that is the Automation Composition Type
+ definition must be loaded and stored in the database. This step may be carried out over the
+ REST interface or using SDC distribution.
-#. The Common Properties of the Control Loop type must be assigned values and those values
- must be stored in the database. This step is optional only if all mandatory common properties
- have default values. The Common Property values may be set and amended over and over again
- in multiple sessions until the Control Loop Type is primed.
+#. The Common Properties of the Automation Composition type must be assigned values and those
+ values must be stored in the database. This step is optional only if all mandatory common
+ properties have default values. The Common Property values may be set and amended over and
+ over again in multiple sessions until the Automation Composition Type is primed.
-#. The Control Loop Type Definition and the Common Property values must be primed, that is
- sent to the concerned participants. Once a Control Loop Type is primed, its Common Property
- values can no longer be changed. To change Common Properties on a primed Control Loop Type,
- all instances of the Control Loop Type must be removed and the Control Loop Type must be
- de-primed.
+#. The Automation Composition Type Definition and the Common Property values must be primed,
+ which is sent to the concerned participants. Once an Automation Composition Type is primed,
+ its Common Property values can no longer be changed. To change Common Properties on a primed
+ Automation Composition Type, all instances of the Automation Composition Type must be removed
+ and the Automation Composition Type must be de-primed.
-1.1 Commissioning a Control Loop Type Definition using the CLAMP GUI
---------------------------------------------------------------------
+1.1 Commissioning an Automation Composition Type Definition using the CLAMP GUI
+-------------------------------------------------------------------------------
This dialogue corresponds to a "File → Import" menu on the CLAMP GUI. The documentation of
future releases of the system will describe how the Design Time functionality interacts
@@ -48,116 +48,118 @@ with the Runtime commissioning API.
.. image:: ../images/system-dialogues/comissioning-clamp-gui.png
-1.2 Commissioning a Control Loop Type Definition using SDC
-----------------------------------------------------------
+1.2 Commissioning an Automation Composition Type Definition using SDC
+---------------------------------------------------------------------
.. image:: ../images/system-dialogues/comissioning-sdc.png
-1.3 Setting Common Properties for a Control Loop Type Definition
-----------------------------------------------------------------
+1.3 Setting Common Properties for an Automation Composition Type Definition
+---------------------------------------------------------------------------
This dialogue sets the values of common properties. The values of the common properties
may be set, updated, or deleted at will, as this dialogue saves the properties to the
database but does not send the definitions or properties to the participants. However,
-once a Control Loop Type Definition and its properties are primed
-(See :ref:`Section 1.4 <priming-cl-label>`), the properties cannot be changed until the control loop type
-definition is de-primed (See :ref:`Section 1.5 <depriming-cl-label>`).
+once an Automation Composition Type Definition and its properties are primed
+(See :ref:`Section 1.4 <priming-acm-label>`), the properties cannot be changed until the
+Automation Composition type definition is de-primed (See
+:ref:`Section 1.5 <depriming-acm-label>`).
.. image:: ../images/system-dialogues/common-properties-type-definition.png
-.. _priming-cl-label:
+.. _priming-acm-label:
-1.4 Priming a Control Loop Type Definition on Participants
-----------------------------------------------------------
-The Priming operation sends Control Loop Type definitions and common property values
-to participants. Once a Control Loop Type definition is primed, its property values
+1.4 Priming an Automation Composition Type Definition on Participants
+---------------------------------------------------------------------
+The Priming operation sends Automation Composition Type definitions and common property values
+to participants. Once an Automation Composition Type definition is primed, its property values
can on longer be changed until it is de-primed.
-.. image:: ../images/system-dialogues/priming-cl-type-definition.png
+.. image:: ../images/system-dialogues/priming-acm-type-definition.png
-.. _depriming-cl-label:
+.. _depriming-acm-label:
-1.5 De-Prime a Control Loop Type Definition on Participants
------------------------------------------------------------
+1.5 De-Prime an Automation Composition Type Definition on Participants
+----------------------------------------------------------------------
-This dialogue allows a Control Loop Type Definition to be de-primed so that it can be
+This dialogue allows an Automation Composition Type Definition to be de-primed so that it can be
deleted or its common parameter values can be altered.
-.. image:: ../images/system-dialogues/depriming-cl-type-definition.png
+.. image:: ../images/system-dialogues/depriming-acm-type-definition.png
-1.6 Decommissioning a Control Loop Type Definition in CLAMP
------------------------------------------------------------
+1.6 Decommissioning an Automation Composition Type Definition in CLAMP
+----------------------------------------------------------------------
-.. image:: ../images/system-dialogues/decommission-cl-type-definition.png
+.. image:: ../images/system-dialogues/decommission-acm-type-definition.png
-1.7 Reading Commissioned Control Loop Type Definitions
-------------------------------------------------------
+1.7 Reading Commissioned Automation Composition Type Definitions
+----------------------------------------------------------------
-.. image:: ../images/system-dialogues/read-commision-cl-type-definition.png
+.. image:: ../images/system-dialogues/read-commision-acm-type-definition.png
2. Instantiation Dialogues
==========================
Instantiation dialogues are used to create, set parameters on, instantiate, update,
-and remove Control Loop instances.
+and remove Automation Composition instances.
-Assume a suitable Control Loop Definition exists in the Commissioned Control Loop Inventory.
-To get a Control Loop instance running one would, for example, execute dialogues
-:ref:`2.1 <creating-cl-instance>`, :ref:`2.3 <updating-cl-instance-config>`, and
-:ref:`2.4 <changing-cl-instance-state>`.
+Assume a suitable Automation Composition Definition exists in the Commissioned Automation
+Composition Inventory.
+To get an Automation Composition instance running one would, for example, execute dialogues
+:ref:`2.1 <creating-acm-instance>`, :ref:`2.3 <updating-acm-instance-config>`, and
+:ref:`2.4 <changing-acm-instance-state>`.
-.. _creating-cl-instance:
+.. _creating-acm-instance:
-2.1 Creating a Control Loop Instance
-------------------------------------
+2.1 Creating an Automation Composition Instance
+-----------------------------------------------
-.. image:: ../images/system-dialogues/create-cl-instance.png
+.. image:: ../images/system-dialogues/create-acm-instance.png
.. note::
- This dialogue creates the Control Loop Instance in the Instantiated Control Loop Inventory.
- The instance is sent to the participants using the process described in the dialogue in
- :ref:`Section 2.3 <updating-cl-instance-config>`.
+ This dialogue creates the Automation Composition Instance in the Instantiated Automation
+ Composition Inventory. The instance is sent to the participants using the process described
+ in the dialogue in :ref:`Section 2.3 <updating-acm-instance-config>`.
-2.2 Updating Instance Specific Parameters on a Control Loop Instance
---------------------------------------------------------------------
+2.2 Updating Instance Specific Parameters on an Automation Composition Instance
+-------------------------------------------------------------------------------
-.. image:: ../images/system-dialogues/update-instance-params-cl.png
+.. image:: ../images/system-dialogues/update-instance-params-acm.png
-.. _updating-cl-instance-config:
+.. _updating-acm-instance-config:
-2.3 Updating a Control Loop Instance with a Configuration on Participants
--------------------------------------------------------------------------
+2.3 Updating an Automation Composition Instance with a Configuration on Participants
+------------------------------------------------------------------------------------
-.. image:: ../images/system-dialogues/update-cl-instance-config-participants.png
+.. image:: ../images/system-dialogues/update-acm-instance-config-participants.png
-.. _changing-cl-instance-state:
+.. _changing-acm-instance-state:
-2.4 Changing the state of a Control Loop Instance on Participants
------------------------------------------------------------------
+2.4 Changing the state of an Automation Composition Instance on Participants
+----------------------------------------------------------------------------
-.. image:: ../images/system-dialogues/change-cl-instance-state-participants.png
+.. image:: ../images/system-dialogues/change-acm-instance-state-participants.png
-2.5 De-instantiating a Control Loop Instance from Participants
---------------------------------------------------------------
+2.5 De-instantiating an Automation Composition Instance from Participants
+-------------------------------------------------------------------------
-.. image:: ../images/system-dialogues/deinstantiate-cl-from-participants.png
+.. image:: ../images/system-dialogues/deinstantiate-acm-from-participants.png
-2.6 Deleting a Control Loop Instance
-------------------------------------
+2.6 Deleting an Automation Composition Instance
+-----------------------------------------------
-.. image:: ../images/system-dialogues/delete-cl-instance.png
+.. image:: ../images/system-dialogues/delete-acm-instance.png
-2.7 Reading Control Loop Instances
-----------------------------------
+2.7 Reading Automation Composition Instances
+--------------------------------------------
-.. image:: ../images/system-dialogues/read-cl-instance.png
+.. image:: ../images/system-dialogues/read-acm-instance.png
-1. Monitoring Dialogues
+3. Monitoring Dialogues
=======================
-Monitoring dialogues are used to monitor and to read statistics on Control Loop Instances.
+Monitoring dialogues are used to monitor and to read statistics on Automation Composition Instances.
3.1 Reporting of Monitoring Information and Statistics by Participants
----------------------------------------------------------------------
@@ -183,16 +185,17 @@ Monitoring dialogues are used to monitor and to read statistics on Control Loop
4. Supervision Dialogues
========================
-Supervision dialogues are used to check the state of Control Loop Instances and Participants.
+Supervision dialogues are used to check the state of Automation Composition Instances and
+Participants.
4.1 Supervise Participants
--------------------------
.. image:: ../images/system-dialogues/supervise-participants.png
-4.2 Supervise Control Loops
----------------------------
+4.2 Supervise Automation Compositions
+-------------------------------------
-.. image:: ../images/system-dialogues/supervise-controlloops.png
+.. image:: ../images/system-dialogues/supervise-acms.png
End of Document
diff --git a/docs/clamp/acm/clamp-gui/images/01-gui.png b/docs/clamp/acm/clamp-gui/images/01-gui.png
new file mode 100644
index 00000000..74b13310
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/01-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/02-gui.png b/docs/clamp/acm/clamp-gui/images/02-gui.png
new file mode 100644
index 00000000..ba18a13a
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/02-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/03-gui.png b/docs/clamp/acm/clamp-gui/images/03-gui.png
new file mode 100644
index 00000000..c3716599
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/03-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/04-gui.png b/docs/clamp/acm/clamp-gui/images/04-gui.png
new file mode 100644
index 00000000..744d6e16
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/04-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/05-gui.png b/docs/clamp/acm/clamp-gui/images/05-gui.png
new file mode 100644
index 00000000..2eb1536d
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/05-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/06-gui.png b/docs/clamp/acm/clamp-gui/images/06-gui.png
new file mode 100644
index 00000000..d22b1a7e
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/06-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/07-gui.png b/docs/clamp/acm/clamp-gui/images/07-gui.png
new file mode 100644
index 00000000..df28fd5d
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/07-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/08-gui.png b/docs/clamp/acm/clamp-gui/images/08-gui.png
new file mode 100644
index 00000000..5be657b5
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/08-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/09-gui.png b/docs/clamp/acm/clamp-gui/images/09-gui.png
new file mode 100644
index 00000000..156e0f76
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/09-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/10-gui.png b/docs/clamp/acm/clamp-gui/images/10-gui.png
new file mode 100644
index 00000000..9cbcb96e
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/10-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/11-gui.png b/docs/clamp/acm/clamp-gui/images/11-gui.png
new file mode 100644
index 00000000..dc68ea52
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/11-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/12-gui.png b/docs/clamp/acm/clamp-gui/images/12-gui.png
new file mode 100644
index 00000000..548c6ba1
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/12-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/13-gui.png b/docs/clamp/acm/clamp-gui/images/13-gui.png
new file mode 100644
index 00000000..09b2dc07
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/13-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/14-gui.png b/docs/clamp/acm/clamp-gui/images/14-gui.png
new file mode 100644
index 00000000..28680efc
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/14-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/15-gui.png b/docs/clamp/acm/clamp-gui/images/15-gui.png
new file mode 100644
index 00000000..0d1c949b
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/15-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/16-gui.png b/docs/clamp/acm/clamp-gui/images/16-gui.png
new file mode 100644
index 00000000..829d790d
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/16-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/17-gui.png b/docs/clamp/acm/clamp-gui/images/17-gui.png
new file mode 100644
index 00000000..03d318d2
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/17-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/18-gui.png b/docs/clamp/acm/clamp-gui/images/18-gui.png
new file mode 100644
index 00000000..8e08ad68
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/18-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/19-gui.png b/docs/clamp/acm/clamp-gui/images/19-gui.png
new file mode 100644
index 00000000..494d37ce
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/19-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/20-gui.png b/docs/clamp/acm/clamp-gui/images/20-gui.png
new file mode 100644
index 00000000..4be441ed
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/20-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/21-gui.png b/docs/clamp/acm/clamp-gui/images/21-gui.png
new file mode 100644
index 00000000..2f49598e
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/21-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/22-gui.png b/docs/clamp/acm/clamp-gui/images/22-gui.png
new file mode 100644
index 00000000..9efe51a0
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/22-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/images/23-gui.png b/docs/clamp/acm/clamp-gui/images/23-gui.png
new file mode 100644
index 00000000..f258454a
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/images/23-gui.png
Binary files differ
diff --git a/docs/clamp/acm/clamp-gui/policy-gui.rst b/docs/clamp/acm/clamp-gui/policy-gui.rst
new file mode 100644
index 00000000..bba52784
--- /dev/null
+++ b/docs/clamp/acm/clamp-gui/policy-gui.rst
@@ -0,0 +1,317 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+
+.. _clamp-policy-gui-label:
+
+TOSCA Policy GUI
+################
+
+.. contents::
+ :depth: 4
+
+1 - How to run the Front-End Gui
+================================
+This section describes how to run the front end on your local machine.
+
+**Prerequisite:**
+
+**Building and running CLAMP**
+
+see `Clamp ACM Smoke Tests <https://docs.onap.org/projects/onap-policy-parent/en/latest/development/devtools/clamp-smoke.html>`__
+
+**Step 1:** Go to the clamp directory
+
+.. code-block:: bash
+
+ cd /clamp/extra/bin-for-dev
+
+**Step 2:** Inside the clamp directory run
+
+.. code-block:: bash
+
+ ./start-db.sh test
+
+**Step 3:** Check docker container id
+
+.. code-block:: bash
+
+ docker ps
+
+**Step 4:** Log into docker container
+
+.. code-block:: bash
+
+ docker exec -it 'container_id' bash
+
+**Step 5:** Go into mariadb shell
+
+.. code-block:: bash
+
+ mysql -u root -p
+
+**Step 6:** Enter password
+
+ strong_pitchou
+
+.. image:: images/01-gui.png
+
+**Step 7:** Go into cldsdb4 database
+
+.. code-block:: bash
+
+ use cldsdb4;
+
+**Step 8:** Verify if there is data in the following table 'loop_templates'
+
+.. code-block:: bash
+
+ select * from loop_templates;
+
+** If for some reason the database is empty do the go to the '/docker-entrypoint-initdb.d/dump' directory
+
+.. code-block:: bash
+
+ ./load-fake-data.sh
+
+**Step 9:** Once the database is up and running need to start the clamp emulator, by running the following command inside the /clamp/extra/bin-for-dev
+
+.. code-block:: bash
+
+ ./start-emulator.sh
+
+**Step 10:** Verify if mariadb and the emulator is running
+
+.. code-block:: bash
+
+ docker ps
+
+.. image:: images/02-gui.png
+
+**Step 11:** Start the backend service by running the command inside the /clamp/extra/bin-for-dev
+
+.. code-block:: bash
+
+ ./start-backend.sh
+
+
+.. _building-ui-label:
+
+2 - Checking out and building the UI
+====================================
+
+.. _Building UI
+
+**Step 1:** Checkout the UI from the repo
+
+.. code-block:: bash
+
+ git clone "https://gerrit.nordix.org/onap/policy/gui"
+
+**Step 2:** Change into the "gui" directory and run the following
+
+.. code-block:: bash
+
+ mvn clean install
+
+**Step 3:** Go into the gui-clamp/ui-react directory and run the following
+
+.. code-block:: bash
+
+ npm install
+
+**Step 4:** Start the front end UI
+
+.. code-block:: bash
+
+ npm start --scripts-prepend-node-path
+
+** If you get the following error
+
+.. image:: images/03-gui.png
+
+ gedit package.json
+
+.. code-block:: bash
+
+ change the following
+ "version": "${project.version}",
+
+ to
+
+ "version": "2.1.1",
+
+ save and close
+
+ then delete the node_modules directory
+
+ rm -rf node_modules/
+
+ then run again
+
+ npm install
+
+.. code-block:: bash
+
+ npm start --scripts-prepend-node-path
+
+**Step 5:** Once the UI starts at localhost:3000 it will ask for credentials:
+
+ Login: admin
+ Password: password
+
+3 - How to Commission/Decommission the TOSCA Service Template
+=============================================================
+
+This section describes how to commission and decommission the Tosca Service Template
+
+** Prerequisite:
+
+see clamp-policy-gui-label_
+
+**Step 1:** From the Main Menu Click on TOSCA Automation Composition Dropdown
+
+.. image:: images/04-gui.png
+
+**Step 2:** From the Dropdown Menu Select Upload Automation Composition To Commissioning
+
+.. image:: images/05-gui.png
+
+**Step 3:** On the window Upload Tosca to Commissioning API Click on the input box that says 'Please Select a file'
+
+.. image:: images/06-gui.png
+
+**Step 4:** Once the yaml file is selected click on Upload Tosca Service Template
+
+.. image:: images/07-gui.png
+
+**Step 5:** After the upload there should have a message "Upload Success" in green
+
+.. image:: images/08-gui.png
+
+**Step 6:** To validate that the TOSCA Service Template has been commissioned click on Manage Commissioned Automation Composition Template
+
+.. image:: images/09-gui.png
+
+**Step 7:** In the View Tosca Template Window click on Pull Tosca Service Template
+
+.. image:: images/10-gui.png
+
+**Step 8:** Once the Tosca Service Template has been pulled there should be a json object rendered in the window
+
+.. image:: images/11-gui.png
+
+**Step 9:** Click on Close close the window
+
+**Step 10:** Click on Edit Automation Composition Properties
+
+.. image:: images/12-gui.png
+
+**Step 11:** In the Change ACM Common Properties change the appropriate properties and click on save and there should have a popup saying 'Changes Saved. Commission When Ready...'
+
+.. image:: images/13-gui.png
+
+**Step 12:** After saving the changes click on Commission and should have a Green message saying 'Commissioning Success'
+
+.. image:: images/14-gui.png
+
+**Step 13:** To Decommission the Tosca Service Follow Step 6 and 8
+
+**Step 14:** Once the json objected is rendered in the window click on delete
+
+.. image:: images/11-gui.png
+
+**Step 14:** Once the json objected is rendered in the window click on delete
+
+.. image:: images/11-gui.png
+
+**Step 15:** If the delete is successful it should show a message "Delete Successful"
+
+.. image:: images/15-gui.png
+
+4 - How to Save Instance Properties and Change The Order State
+==============================================================
+
+This section describes how to save the instance properties and change it's order state
+
+** Prerequisite:
+
+see building-ui-label_
+
+**Step 1:** Go to the participant http directory
+
+.. code-block:: bash
+
+ cd /clamp/participant/participant-impl/participant-impl-http
+
+**Step 2:** Run he following command
+
+.. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=--server.port=8080
+
+**Step 3:** Go to the participant kubernetes directory
+
+.. code-block:: bash
+
+ cd /clamp/participant/participant-impl/participant-impl-kubernetes
+
+**Step 4:** Run he following command
+
+.. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=--server.port=8081
+
+**Step 5:** Go to the participant policy directory
+
+.. code-block:: bash
+
+ cd /clamp/participant/participant-impl/participant-impl-policy
+
+**Step 6:** Run he following command
+
+.. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=--server.port=8082
+
+**Step 7:** From the Main Menu Click on Instantiation Management
+
+.. image:: images/16-gui.png
+
+**Step 8:** Once the window for Manage Instance is open click on Create Instance
+
+.. image:: images/17-gui.png
+
+**Step 9:** With the Window Create Instance Properties Insert a Name and change the appropriate properties and click save
+
+.. image:: images/18-gui.png
+
+**Step 10:** After clicking save it should come with a green message saying "Instantiation Properties Success"
+
+.. image:: images/19-gui.png
+
+**Step 11:** To delete an instance repeat Step 7
+
+.. image:: images/16-gui.png
+
+**Step 12:** Once the window for Manage Instance is open click on Delete
+
+.. image:: images/20-gui.png
+
+* NOTE: The only way to delete the instance properties if the order state has to be UNINITIALISED
+
+**Step 13:** To change the state click on Change in Manage Instances Window
+
+.. image:: images/20-gui.png
+
+**Step 14:** After clicking Change there should have a drop down with specific different ordered states
+
+.. image:: images/21-gui.png
+
+**Step 15:** From UNINITIALISED the user can only select Passive Ordered State
+
+.. image:: images/22-gui.png
+
+**Step 16:** Click on Save and a Message in Green "Ordered State Change Success"
+
+.. image:: images/23-gui.png
+
+* NOTE: Can't change from Passive to Running in a local developer machine, can only change in the production environment \ No newline at end of file
diff --git a/docs/clamp/acm/images/system-dialogues/change-acm-instance-state-participants.png b/docs/clamp/acm/images/system-dialogues/change-acm-instance-state-participants.png
new file mode 100644
index 00000000..8c009dd4
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/change-acm-instance-state-participants.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/change-cl-instance-state-participants.png b/docs/clamp/acm/images/system-dialogues/change-cl-instance-state-participants.png
deleted file mode 100644
index 8892f07d..00000000
--- a/docs/clamp/acm/images/system-dialogues/change-cl-instance-state-participants.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/comissioning-clamp-gui.png b/docs/clamp/acm/images/system-dialogues/comissioning-clamp-gui.png
index 473cf05b..5237a7f6 100644
--- a/docs/clamp/acm/images/system-dialogues/comissioning-clamp-gui.png
+++ b/docs/clamp/acm/images/system-dialogues/comissioning-clamp-gui.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/comissioning-sdc.png b/docs/clamp/acm/images/system-dialogues/comissioning-sdc.png
index 19f3f84d..b28e4762 100644
--- a/docs/clamp/acm/images/system-dialogues/comissioning-sdc.png
+++ b/docs/clamp/acm/images/system-dialogues/comissioning-sdc.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/common-properties-type-definition.png b/docs/clamp/acm/images/system-dialogues/common-properties-type-definition.png
index 06fa8967..9fac8555 100644
--- a/docs/clamp/acm/images/system-dialogues/common-properties-type-definition.png
+++ b/docs/clamp/acm/images/system-dialogues/common-properties-type-definition.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/create-acm-instance.png b/docs/clamp/acm/images/system-dialogues/create-acm-instance.png
new file mode 100644
index 00000000..4d732e8e
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/create-acm-instance.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/create-cl-instance.png b/docs/clamp/acm/images/system-dialogues/create-cl-instance.png
deleted file mode 100644
index 88a67648..00000000
--- a/docs/clamp/acm/images/system-dialogues/create-cl-instance.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/decommission-acm-type-definition.png b/docs/clamp/acm/images/system-dialogues/decommission-acm-type-definition.png
new file mode 100644
index 00000000..12c9d3a0
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/decommission-acm-type-definition.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/decommission-cl-type-definition.png b/docs/clamp/acm/images/system-dialogues/decommission-cl-type-definition.png
deleted file mode 100644
index c4051eee..00000000
--- a/docs/clamp/acm/images/system-dialogues/decommission-cl-type-definition.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/deinstantiate-acm-from-participants.png b/docs/clamp/acm/images/system-dialogues/deinstantiate-acm-from-participants.png
new file mode 100644
index 00000000..11b77994
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/deinstantiate-acm-from-participants.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/deinstantiate-cl-from-participants.png b/docs/clamp/acm/images/system-dialogues/deinstantiate-cl-from-participants.png
deleted file mode 100644
index 174250c0..00000000
--- a/docs/clamp/acm/images/system-dialogues/deinstantiate-cl-from-participants.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/delete-acm-instance.png b/docs/clamp/acm/images/system-dialogues/delete-acm-instance.png
new file mode 100644
index 00000000..5043989d
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/delete-acm-instance.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/delete-cl-instance.png b/docs/clamp/acm/images/system-dialogues/delete-cl-instance.png
deleted file mode 100644
index 8417017f..00000000
--- a/docs/clamp/acm/images/system-dialogues/delete-cl-instance.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/depriming-acm-type-definition.png b/docs/clamp/acm/images/system-dialogues/depriming-acm-type-definition.png
new file mode 100644
index 00000000..b8b26f54
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/depriming-acm-type-definition.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/depriming-cl-type-definition.png b/docs/clamp/acm/images/system-dialogues/depriming-cl-type-definition.png
deleted file mode 100644
index 60d97805..00000000
--- a/docs/clamp/acm/images/system-dialogues/depriming-cl-type-definition.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/monitoring-by-participants.png b/docs/clamp/acm/images/system-dialogues/monitoring-by-participants.png
index 69ceabf8..19723b30 100644
--- a/docs/clamp/acm/images/system-dialogues/monitoring-by-participants.png
+++ b/docs/clamp/acm/images/system-dialogues/monitoring-by-participants.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/priming-acm-type-definition.png b/docs/clamp/acm/images/system-dialogues/priming-acm-type-definition.png
new file mode 100644
index 00000000..c5926f39
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/priming-acm-type-definition.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/priming-cl-type-definition.png b/docs/clamp/acm/images/system-dialogues/priming-cl-type-definition.png
deleted file mode 100644
index 46f93480..00000000
--- a/docs/clamp/acm/images/system-dialogues/priming-cl-type-definition.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/read-acm-instance.png b/docs/clamp/acm/images/system-dialogues/read-acm-instance.png
new file mode 100644
index 00000000..a2910c1f
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/read-acm-instance.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/read-cl-instance.png b/docs/clamp/acm/images/system-dialogues/read-cl-instance.png
deleted file mode 100644
index 611039b9..00000000
--- a/docs/clamp/acm/images/system-dialogues/read-cl-instance.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/read-commision-acm-type-definition.png b/docs/clamp/acm/images/system-dialogues/read-commision-acm-type-definition.png
new file mode 100644
index 00000000..411d8288
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/read-commision-acm-type-definition.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/read-commision-cl-type-definition.png b/docs/clamp/acm/images/system-dialogues/read-commision-cl-type-definition.png
deleted file mode 100644
index 3a308787..00000000
--- a/docs/clamp/acm/images/system-dialogues/read-commision-cl-type-definition.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/statistics-housekeeping.png b/docs/clamp/acm/images/system-dialogues/statistics-housekeeping.png
index 6cbfda52..0d3d169f 100644
--- a/docs/clamp/acm/images/system-dialogues/statistics-housekeeping.png
+++ b/docs/clamp/acm/images/system-dialogues/statistics-housekeeping.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/supervise-acms.png b/docs/clamp/acm/images/system-dialogues/supervise-acms.png
new file mode 100644
index 00000000..2634fa6a
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/supervise-acms.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/supervise-controlloops.png b/docs/clamp/acm/images/system-dialogues/supervise-controlloops.png
deleted file mode 100644
index c24d3a09..00000000
--- a/docs/clamp/acm/images/system-dialogues/supervise-controlloops.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/supervise-participants.png b/docs/clamp/acm/images/system-dialogues/supervise-participants.png
index 2439d926..0a26180e 100644
--- a/docs/clamp/acm/images/system-dialogues/supervise-participants.png
+++ b/docs/clamp/acm/images/system-dialogues/supervise-participants.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/update-acm-instance-config-participants.png b/docs/clamp/acm/images/system-dialogues/update-acm-instance-config-participants.png
new file mode 100644
index 00000000..7979cd80
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/update-acm-instance-config-participants.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/update-cl-instance-config-participants.png b/docs/clamp/acm/images/system-dialogues/update-cl-instance-config-participants.png
deleted file mode 100644
index f16ebc2b..00000000
--- a/docs/clamp/acm/images/system-dialogues/update-cl-instance-config-participants.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/update-instance-params-acm.png b/docs/clamp/acm/images/system-dialogues/update-instance-params-acm.png
new file mode 100644
index 00000000..e9217365
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/update-instance-params-acm.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/update-instance-params-cl.png b/docs/clamp/acm/images/system-dialogues/update-instance-params-cl.png
deleted file mode 100644
index ec84ed35..00000000
--- a/docs/clamp/acm/images/system-dialogues/update-instance-params-cl.png
+++ /dev/null
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/view-monitoring-info.png b/docs/clamp/acm/images/system-dialogues/view-monitoring-info.png
index 5937d2f1..e63d60bc 100644
--- a/docs/clamp/acm/images/system-dialogues/view-monitoring-info.png
+++ b/docs/clamp/acm/images/system-dialogues/view-monitoring-info.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/view-statistics.png b/docs/clamp/acm/images/system-dialogues/view-statistics.png
index 451a5d92..099c5cd9 100644
--- a/docs/clamp/acm/images/system-dialogues/view-statistics.png
+++ b/docs/clamp/acm/images/system-dialogues/view-statistics.png
Binary files differ
diff --git a/docs/clamp/clamp.rst b/docs/clamp/clamp.rst
index dad86451..82bf1ebf 100644
--- a/docs/clamp/clamp.rst
+++ b/docs/clamp/clamp.rst
@@ -5,7 +5,7 @@
CLAMP Metadata Automation Composition Management using TOSCA
#############################################################
-CLAMP supports the definition, deployment, and life cycle management of automation compostion elements using Metadata
+CLAMP supports the definition, deployment, and life cycle management of automation composition elements using Metadata
described in TOSCA.
.. toctree::
@@ -14,6 +14,7 @@ described in TOSCA.
acm/acm-architecture
acm/defining-acms
acm/api-protocol/api-protocol-tree
+ acm/clamp-gui/policy-gui
acm/design-impl/design-impl
.. note::