summaryrefslogtreecommitdiffstats
path: root/docs/sections/platform-doc/dcaedashboard_userguide.rst
blob: 0d7611d96fbe921035bc6238d77cb89787cb499e (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
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
DCAE Dashboard User Guide
=========================


Overview
--------

DCAE Dashboard is a web application that provides a unified interface for DCAE
users and Ops users in ONAP to manage DCAE microservices.


Starting with the Dashboard
---------------------------

Type in the application login URL in a web browser. The Login page
should appear.

|dashboard_1.png|

If you are a first time user, then click on the **Sign up** button. Fill in
the Sign up FORM and submit it to register for an account. Upon a
successful login by providing valid login credentials, the user's
dashboard (Home) screen is displayed. The header navigation bar contains
menu links and a user profile section in the top right corner. The
collapsible left sidebar contains all the application menus; each item
(except "Home") can be expanded into sub-items by clicking on the item. 

User Dashboard contents appear in the panel to the right of the left
navigation menu. By default(initial view), the screen displays tiles
contains the count of blueprints and count of deployments owned by the
signed-in user. The count of plugins uploaded to the Cloudify Orchestrator
is also shown in the Plugins tile.  Each tile is clickable and will
navigate control to the individual screens that display detailed
information about the items. There is a switch at the top to toggle
between user level or user role group access for the dashboard
contents.  By switching access type to **Group**, the aggregate count of
inventory items at the user group (role) level are shown on the dashboard.

|dashboard_2.png|

|dashboard_3.png|

Auto Refresh switch lets user automatically reload the dashboard at
regular intervals.

An autocomplete list of blueprints lets a user find a specific blueprint
and trigger a deployments list query. Upon selecting a blueprint item, a
query is triggered to find associated deployments for the selected
blueprint. Similarly upon selecting a specific deployment entity, any
matching execution workflows are queried and displayed in the executions
data grid. By default the user dashboard shows currently active
executions that are happening in Cloudify. 

|dashboard_4.png|

|dashboard_5.png|

|dashboard_6.png| 

Working with blueprints and deployments
---------------------------------------

Searching/Filtering Blueprints
------------------------------


1. Click on the "Inventory" menu item, which will expand to show
   sub-items. Select the "Blueprints" sub-item.

A "Blueprints" screen appears, which displays the blueprints retrieved from
Inventory. By default, a blueprint owner filter is applied to display
items where the owner is the signed in user. By deselecting the "My
Blueprints" checkbox, all blueprints belonging to the role group will be
displayed.

|dashboard_7.png|

|dashboard_8.png|

2. You can search for blueprints based on their name. Type the name of
the blueprint you wish to work with in the search box at the top right
hand of the screen and press 'enter' or click the magnifying glass icon
to look for it.

|dashboard_9.png|

3. You can use search filters by clicking on the down arrow at the right
end of the search box. Filter by blueprint name and/or owner is available. Once
finished, click the magnifying glass at the bottom of the advanced
filters box or press "enter".

|dashboard_10.png|

|dashboard_11.png|

|dashboard_12.png|

4. Lookup deployments mapped to a blueprint

|dashboard_13.png|

Creating Blueprints
-------------------

1. A user can create a new blueprint either from scratch or by uploading
   an existing file. To do this, select the "Blueprints" sub-menu

Once the existing set of blueprints appear on the screen, click on the
"Upload" Button 

|dashboard_14.png|

2. In the "Upload Blueprint" pop-up, fill out all the fields. Provide
   the name and version number for the blueprint -- hints on nomenclature are
   available by clicking on the input field help icon (question mark
   symbol).  A blueprint file can be either "dragged and dropped" from
   the user's own directory or it can be created from scratch. When
   finished, press "Save". *Note:*\ **Import Data**\ *function is not
   supported and will be removed later.*

|dashboard_15.png|

3. Allow the Blueprints screen to reload and then check that the
   blueprint you created is in the table.


Viewing/Exporting Blueprints
----------------------------

1. Navigate to the Blueprints screen via the sidebar menu On the
   Blueprints screen, click on the Actions button icon (More actions)
   for the blueprint you wish to work with. A number of choices are
   indicated in a pop-up: View, Export, Update, Deploy and Delete.

|dashboard_16.png|

2. Choose "View" to display the contents of the blueprint

|dashboard_17.png|

Deploying Blueprints
--------------------

3. Navigate to the Blueprints screen via the sidebar menu. On the
   Blueprints screen, click on the Actions button icon (More actions)
   for the blueprint you wish to work with and select "Deploy"

|dashboard_18.png|

4. On the "Deploy Blueprint" pop-up, fill in all the fields. There are
   two ways to  supply the input parameters for the blueprint: one is to
   drag and drop a parameters file; the other is to manually fill in the
   name-value pairs. When finished, press the "Deploy" button at the
   bottom.

|dashboard_19.png|

5. Navigate to the Deployments screen via the sidebar menu and check
   that the blueprint deployed is listed on the screen

|dashboard_20.png|

Searching/Filtering Deployments
-------------------------------

1. Navigate to the Deployments screen via the sidebar menu.

2. By default, the deployment owner filter and application cache filters are
   applied to display items where the owner is the signed in user. Data is
   fetched from the application cache store. By deselecting the "My
   Deployments" checkbox, all deployments belonging to the role group
   will be displayed. By deselecting "Cache" checkbox, cache is bypassed
   and data is fetched from Cloudify Maanger.  "Tenant" filter can be
   applied to restrict the query per tenant partition. Upon selecting the
   "Tenant" checkbox, the tenants list dropdown appears.

3. You can search for Deployments by an ID. Enter the ID  and press
   'Enter' or click the magnifying glass icon.

|dashboard_21.png|

4. If you wish to make an advanced search, select the "Tenant" checkbox,
   select a tenant from the tenants list,  click the down arrow at the
   right end of the input field to expand the advanced search filters.
   Here you can filter by deployment IDs,  owners, (installation)
   Status and Helm chart deployment. Once finished, click the magnifying
   glass at the bottom of the advanced filters box. 

|dashboard_22.png|

Viewing Blueprint, Inputs, Executions
-------------------------------------

1. Navigate to the Deployments screen on the left hand menu

On the deployments table screen, click on the "Actions" button icon  for
the deployment you wish to manage.

|dashboard_23.png|

|dashboard_24.png|

|dashboard_25.png|

|dashboard_26.png|

|dashboard_27.png|

Undeploying Deployments
-----------------------

1. Navigate to the Deployments screen on the left hand menu

2. On the deployments table screen, click on the "Actions" button icon 
   for the deployment you wish to uninstall. Click on Undeploy.

|dashboard_28.png|

3. On the confirmation popup, confirm the tenant is correct and select
   "Undeploy" when ready to undeploy

|dashboard_29.png|

Helm Status, Upgrade, Rollback
------------------------------

1. Navigate to the Deployments screen on the left hand menu

2. Ensure that the deployment is a helm deployment

On the deployments table screen, click on the "Actions" button icon  for
the deployment you wish to perform helm operations on.

|dashboard_30.png|

*Helm Status*

|dashboard_31.png|

*Helm Upgrade*

|dashboard_32.png|

*Helm Rollback*

|dashboard_33.png|

Checking system health
----------------------


Viewing Service Health
----------------------

Navigate to the Service Health screen on the sidebar menu

|dashboard_34.png|

Node Health
-----------

Viewing Node Health
-------------------

Navigate to the Node Health screen on the sidebar menu

|dashboard_35.png|

.. |dashboard_1.png| image:: attachments/dashboard_1.png
.. |dashboard_2.png| image:: attachments/dashboard_2.png
.. |dashboard_3.png| image:: attachments/dashboard_3.png
.. |dashboard_4.png| image:: attachments/dashboard_4.png
.. |dashboard_5.png| image:: attachments/dashboard_5.png
.. |dashboard_6.png| image:: attachments/dashboard_6.png
.. |dashboard_7.png| image:: attachments/dashboard_7.png
.. |dashboard_8.png| image:: attachments/dashboard_8.png
.. |dashboard_9.png| image:: attachments/dashboard_9.png
.. |dashboard_10.png| image:: attachments/dashboard_10.png
.. |dashboard_11.png| image:: attachments/dashboard_11.png
.. |dashboard_12.png| image:: attachments/dashboard_12.png
.. |dashboard_13.png| image:: attachments/dashboard_13.png
.. |dashboard_14.png| image:: attachments/dashboard_14.png
.. |dashboard_15.png| image:: attachments/dashboard_15.png
.. |dashboard_16.png| image:: attachments/dashboard_16.png
.. |dashboard_17.png| image:: attachments/dashboard_17.png
.. |dashboard_18.png| image:: attachments/dashboard_18.png
.. |dashboard_19.png| image:: attachments/dashboard_19.png
.. |dashboard_20.png| image:: attachments/dashboard_20.png
.. |dashboard_21.png| image:: attachments/dashboard_21.png
.. |dashboard_22.png| image:: attachments/dashboard_22.png
.. |dashboard_23.png| image:: attachments/dashboard_23.png
.. |dashboard_24.png| image:: attachments/dashboard_24.png
.. |dashboard_25.png| image:: attachments/dashboard_25.png
.. |dashboard_26.png| image:: attachments/dashboard_26.png
.. |dashboard_27.png| image:: attachments/dashboard_27.png
.. |dashboard_28.png| image:: attachments/dashboard_28.png
.. |dashboard_29.png| image:: attachments/dashboard_29.png
.. |dashboard_30.png| image:: attachments/dashboard_30.png
.. |dashboard_31.png| image:: attachments/dashboard_31.png
.. |dashboard_32.png| image:: attachments/dashboard_32.png
.. |dashboard_33.png| image:: attachments/dashboard_33.png
.. |dashboard_34.png| image:: attachments/dashboard_34.png
.. |dashboard_35.png| image:: attachments/dashboard_35.png