summaryrefslogtreecommitdiffstats
path: root/docs/clamp/acm/api-protocol/system-level-dialogues.rst
blob: 6d3f82d64dda0b352794c8edfe24d36c199ffeaf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
.. This work is licensed under a Creative Commons Attribution 4.0 International License.

.. _system-level-label:

System Level Dialogues
######################


.. contents::
    :depth: 4


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 Automation Composition Type
definitions and to set the values of Common Parameters.

Commissioning an Automation Composition Type is a three-step process:

#. 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 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 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 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
with the Runtime commissioning API.

.. image:: ../images/system-dialogues/comissioning-clamp-gui.png

1.2 Commissioning an Automation Composition Type Definition using SDC
---------------------------------------------------------------------

.. image:: ../images/system-dialogues/comissioning-sdc.png

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 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-acm-label:

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-acm-type-definition.png

.. _depriming-acm-label:

1.5 De-Prime an Automation Composition Type Definition on Participants
----------------------------------------------------------------------

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-acm-type-definition.png

1.6 Decommissioning an Automation Composition Type Definition in CLAMP
----------------------------------------------------------------------

.. image:: ../images/system-dialogues/decommission-acm-type-definition.png

1.7 Reading Commissioned Automation Composition Type Definitions
----------------------------------------------------------------

.. 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 Automation Composition instances.

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-acm-instance:

2.1 Creating an Automation Composition Instance
-----------------------------------------------

.. image:: ../images/system-dialogues/create-acm-instance.png

.. note::
    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 an Automation Composition Instance
-------------------------------------------------------------------------------

.. image:: ../images/system-dialogues/update-instance-params-acm.png

.. _updating-acm-instance-config:

2.3 Updating an Automation Composition Instance with a Configuration on Participants
------------------------------------------------------------------------------------

.. image:: ../images/system-dialogues/update-acm-instance-config-participants.png

.. _changing-acm-instance-state:

2.4 Changing the state of an Automation Composition Instance on Participants
----------------------------------------------------------------------------

.. image:: ../images/system-dialogues/change-acm-instance-state-participants.png

2.5 De-instantiating an Automation Composition Instance from Participants
-------------------------------------------------------------------------

.. image:: ../images/system-dialogues/deinstantiate-acm-from-participants.png

2.6 Deleting an Automation Composition Instance
-----------------------------------------------

.. image:: ../images/system-dialogues/delete-acm-instance.png

2.7 Reading Automation Composition Instances
--------------------------------------------

.. image:: ../images/system-dialogues/read-acm-instance.png


3. Monitoring Dialogues
=======================

Monitoring dialogues are used to monitor and to read statistics on Automation Composition Instances.

3.1 Reporting of Monitoring Information and Statistics by Participants
----------------------------------------------------------------------

.. image:: ../images/system-dialogues/monitoring-by-participants.png

3.2 Viewing of Monitoring Information
-------------------------------------

.. image:: ../images/system-dialogues/view-monitoring-info.png

3.2 Viewing of Statistics
-------------------------

.. image:: ../images/system-dialogues/view-statistics.png

3.3 Statistics Housekeeping
---------------------------

.. image:: ../images/system-dialogues/statistics-housekeeping.png


4. Supervision Dialogues
========================

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 Automation Compositions
-------------------------------------

.. image:: ../images/system-dialogues/supervise-acms.png

End of Document