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
|
.. This work is licensed under a Creative Commons Attribution 4.0
.. International License. http://creativecommons.org/licenses/by/4.0
.. Copyright 2019 ONAP Doc Team. All rights reserved.
.. _doc_guide_user_des_vf-cre:
VF Creation and Testing
=======================
**Goal**: Using VSPs, create one or more VFs as the building blocks for a
service. Validate and certify the VFs.
**ONAP Component**: SDC
**SDC user roles**: Designer, Tester
|image1|
Steps
-----
- `Create a VF/PNF by VSP import`_
- `Create a VF/PNF manually`_
- `Update a VF/PNF [optional]`_
- `Submit for testing`_
- `Test a VF/PNF`_
.. _doc_guide_user_des_vf-cre_cre-imp:
Create a VF/PNF by VSP import
-----------------------------
**Prerequisites:** (see :ref:`doc_guide_user_des_res-onb` )
- Create a license for each VF/PNF
- Create a Vendor Software Product.
**Steps**
#. From the SDC HOME page, click the *Import VSP*
|image2|
#. From the *Import VF* box, expand a VSP name and click the *Import VSP* icon.
|image3|
#. In the General section, complete all fields.
.. note:: Use the letters "VF" or "PNF" in the name to indicate that the
component type.
#. Click *Create*.
- A message displays while creation is in progress. (This can take up to
10 minutes.)
- A message displays when creation is complete.
#. Click *Check In* to save changes.
- A box displays for confirming the changes.
#. Enter a comment and click *OK*.
- A message displays when the VF/PNF is checked in.
#. [Optional] At any time before submitting the VF/PNF for testing, click
these options to update VF/PNF information:
.. note:: These tasks can be done only before submitting the VF for testing.
- **Icon** change the icon associated with the VF/PNF (vendor-supplied icons
are preferred)
- **Deployment Artifacts** download, view, modify, or change deployment
artifacts (for example, the contents of the Heat .zip file, which contains
the Heat volume template, the license, etc.)
- **Information Artifacts** view or upload artifacts, such as test scripts, test
results, or the AIC questionnaire
- **TOSCA Artifacts** view or upload the TOSCA model or the TOSCA template
- **Properties** define or update properties
- **Composition** view or edit the graphical representation of the resource-level
TOSCA model (generated from the Heat template)
- **Activity Log** view activity related to assets associated with the VF/PNF
(displays the action, date, user, status, and any comments related to each
action)
- **Deployment** view VF modules defined in the Heat template
- **Inputs** view inputs defined for the resource-level TOSCA model
#. After creating a VF/PNF, submit it for testing (see `Submit for testing`_).
.. _doc_guide_user_des_vf-cre_cre-man:
Create a VF/PNF manually
------------------------
**Steps**
#. From the SDC HOME page, click the *Add VF* or *Add PNF*
|image9|
#. In the General section, complete all fields.
#. Before submitting the VF/PNF for testing, click these
options to update VF/PNF information:
.. note:: These tasks can be done only before submitting the VF/PNF for testing.
- **Icon** change the icon associated with the VF/PNF (vendor-supplied icons are
preferred)
- **Deployment Artifacts** download, view, modify, or change VF/PNF deployment
artifacts (for example, the contents of the Heat .zip file, which contains
the Heat volume template, the VF license, etc.)
- **Information Artifacts** view or upload artifacts, such as test scripts, test
results, or the AIC questionnaire
- **TOSCA Artifacts** view or download the TOSCA model or the TOSCA template
- **Properties** define or update properties
- **Composition** view or edit the graphical representation of the resource-level
TOSCA model (generated from the Heat template)
- **Activity Log** view activity related to assets associated with the VF/PNF
(displays the action, date, user, status, and any comments related to each
action)
- **Deployment** view VF modules defined in the Heat template
- **Inputs** view inputs defined for the resource-level TOSCA model
#. Click *Create*.
- A message displays while creation is in progress. (This can take up to
10 minutes.)
- A message displays when creation is complete.
#. Click *Check In* to save changes.
- A box displays for confirming the changes.
#. Enter a comment and click *OK*.
- A message displays when the is checked in.
#. After creating a VF/PNF, submit it for testing (see `Submit for testing`_).
.. _doc_guide_user_des_vf-cre_vf-upd:
Update a VF/PNF [optional]
--------------------------
- Update the VSP and other artifacts in a VF.
- Upload a new version the VSP to the VF whenever the VSP is updated (see steps
3 to 5). Other reasons for updating a VF include:
- artifact changes at the VF level that need be uploaded, for example,
changes to ENV values (see step 6)
**Prerequisites:**
- `Create a VF/PNF by VSP import`_ or `Create a VF/PNF manually`_
- If the VSP was updated: :ref:`doc_guide_user_des_res-onb_upd-vsp`
**Steps**
#. From the SDC HOME page, click *CATALOG* and search for a VF.
#. In the General section, click *Check Out*.
The Select VSP field is displays.
#. In the Select VSP field, click *Browse*.
The Import VF box displays and shows the VSP that was used to create the VF.
#. Expand the VSP field and click.
|image4|
#. Click |image5|
A progress bar displays. |image6|
#. Click *Deployment Artifact* to edit, upload, or delete associated [Optional]
deployment artifacts.
#. Click *Information Artifact* and edit, upload, or delete associated
[Optional] information artifacts.
#. Click *Check In* to save changes.
#. After updating the VF:
- Submit the VF for testing (see `Submit for testing`_).
- Update the VF version in any service that contains the VF
(see step 4 in Update a service [optional]).
.. _doc_guide_user_des_vf-cre_sub-tst:
Submit for testing
------------------
**Prerequisites:** `Create a VF/PNF by VSP import`_ or
`Create a VF/PNF manually`_
**Steps**
#. When a VF/PNF is ready for testing, click *CATALOG* and service for the
VF/PNF.
#. Click the VF/PNF and click *Submit for Testing*.
|image7|
|image8|
#. Enter a message for the testers asking that they begin service certification
and click *OK*.
The default mail client launches with a draft email containing the message.
#. Add the email addresses of the people on the Certification Group for this
site with the *Tester* role and send the email.
.. _doc_guide_user_des_vf-cre_tst-vf:
Test a VF/PNF
-------------
Test the design and artifacts of a VF/PNF.
**Prerequisites:** `Submit for testing`_
**Steps**
#. Sign in to SDC as a *Tester*.
#. From the HOME page, select *Ready For Testing* under Active Projects.
#. In the right pane, click the VF.
#. Click *Start Testing*.
#. Test the VF.
#. When testing is complete, click *Accept*.
.. |image1| image:: media/design_vf_workflow.png
.. |image2| image:: media/SDC-Import.png
.. |image3| image:: media/image2017-1-27_11-14-3.png
.. |image4| image:: media/image2017-1-27_11-17-18.png
.. |image5| image:: media/sdc_artifact_update.png
.. |image6| image:: media/design_vf_updatevspmessage.png
.. |image7| image:: media/image2017-1-27_11-20-13.png
.. |image8| image:: media/image2017-1-27_11-21-4.png
.. |image9| image:: media/SDC-Add.png
|
