0aa0023143f9ab4b05946f6b2f6afa2763bacd3b
[doc.git] / docs / guides / onap-user / vfw-design-tutorial / index.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0
2 .. International License. http://creativecommons.org/licenses/by/4.0
3 .. Copyright © 2017-2020 Aarna Networks, Inc.
4
5 vFW Service Design Tutorial
6 ###########################
7
8 Browser settings
9 ================
10
11 This exercise will use the ONAP Portal. To interact properly with Portal services, please make sure to set the
12 following settings in your Firefox browser before starting the Service Design and Deployment.
13
14 Check your Firefox browser setting to make sure that Remote Proxy DNS setting is on
15
16 * Type "about:config" in the address bar
17 * Select "Accept the risk"
18 * In the Search enter Proxy
19 * Enable "network.proxy.socks_remote_dns  = true" (Just double click to change the flag)
20 * Please make sure to undo this change after testing, since this could cause potential security risk!
21
22 Check your Firefox settings to allow mixed contents
23
24 * Type "about:config" in the address bar
25 * In the Search enter Mixed
26 * Click on variable security.mixed_content.block_active_content
27 * Change the value to False (Just double click to change the flag)
28
29 Below are the portal URL & User Login details to connect to the ONAP portal
30
31 https://portal.api.simpledemo.onap.org:30225/ONAPPORTAL/login.htm
32
33 User login credentials and roles
34 ::
35
36   Username=cs0008, password=demo123456!, Role=DESIGNER
37   Username=demo,   password=demo123456!, Role=ADMIN
38
39 .. note::
40   From F release onwards, service design and deployment can be done with cs0008 and demo users
41
42 Ex: To open portal URL from FireFox browser and accept SSL certificate exception after the settings
43
44 |image8|
45
46 Login into the portal as designer (cs0008) and enter password (demo123456!) then click on LOGIN
47
48 |image21|
49
50 Service Design & Distribution using SDC GUI
51 ===========================================
52
53 In this section, you will learn the following through the SDC GUI
54
55 * How to create a Vendor License Model
56 * How to create and onboard Vendor Software Product
57 * How to create a Service
58 * How to distribute a Service
59
60 Let us start by creating the VLM
61
62 1. Create Vendor Licence Model (VLM) in SDC
63
64  A. Login to the ONAP portal as designer cs0008 / demo123456!
65  B. Go to SDC → ONBOARD → WORKSPACE → CREATE NEW VLM (Enter below attributes and Create)
66
67  |image35|
68
69  |image34|
70
71  C. Create New License Key Group
72
73  |image15|
74
75  D. Create Entitlement Pool
76
77  |image38|
78
79  E. Create Feature Group (Assign Entitlement Pool & License Key Group in other 2 tabs)
80
81  |image5|
82
83  |image40|
84
85  |image27|
86
87  F. Create License Agreement (Assign Feature Group under the Feature Group Tab)
88
89  |image32|
90
91  |image9|
92
93  G. Click Submit (Top Right Corner of the page) and fill comment then press Commit & Submit
94
95  |image7|
96
97 2. Create Vendor Software Product (VSP)
98
99 Prerequisite: Download VNF Heat package from gerrit (git clone "https://gerrit.onap.org/r/demo") and copy
100 the required HEAT package & use it while upload the package
101
102  A. Go to SDC Home → ONBOARD → WORKSPACE  → CREATE NEW VSP (complete all the fields, click on Network Package
103  checkbox then click create)
104
105  |image22|
106
107  B. Assign the license Agreement by selecting the Missing icon
108
109  |image20|
110
111  C. Select the Licenses drop down box (populate all three fields)
112
113  |image24|
114
115  D. Go to Overview (Left hand side bar), select Software Product Attachments in the right pane, click Select file
116
117    Import HEAT package (ex: vfw_demo.zip) by clicking Select File Button. This file should be copied to your
118    local workstation where the browser is running.
119
120  |image37|
121
122 It will take you to the setup page
123
124 |image25|
125
126  E. Click on “PROCEED TO VALIDATION” and ignore warnings
127
128  |image17|
129
130  F. Click Submit (right corner), fill the comment then press COMMIT & SUBMIT, you will see submit successful message
131
132  |image3|
133
134 3. Import Vendor Software Product and certify
135
136  A. Go to the SDC Home page click Import VSP button
137
138  |image13|
139
140  B. From the Import VSP box, expand a VSP name and click the Import VSP icon
141
142  |image39|
143
144  C. In the General section, complete all fields then click create (top right corner)
145
146  |image43|
147
148  D. Click Check In to save changes (top right corner), enter a comment and click OK
149
150  |image29|
151
152  E.  click CATALOG and search for the checked-in VF, you will see your VF In Design Check In state
153
154  |image10|
155
156  F. Click the VF and click certify (top right corner), enter a comment then click OK
157
158  |image11|
159
160  |image31|
161
162 4. Create a Service and certify
163
164  A. Go to SDC UI → Home Page and Select the Add Service Button
165
166  |image44|
167
168  B In the General section, complete all fields then click Create
169
170  |image19|
171
172  C. select the “Composition” Menu on the left hand side menu bar
173
174  |image41|
175
176  D. On the Composition Page, Search for the vFW_demo service (look under Application L4+)
177
178  |image14|
179
180  E. On the Composition Page, Search for  Generic NeutronNet (look under Generic/Network Elements)
181
182  |image26|
183
184  F. Drag and drop vFW_demo created earlier during onboarding & the Generic NeutronNet onto the right hand side palette
185
186  |image1|
187
188  G. Connect the elements by connecting + signs and Select appropriate options for
189  Requirements and Capabilities, click Next then click Finish at the end
190
191  |image33|
192
193  |image2|
194
195  |image23|
196
197  |image36|
198
199  H. Click Check In to save changes, Enter a comment and click OK
200
201  |image6|
202
203  I. click CATALOG and search for the checked-in Service, you will see you service is in
204  Design Checkin state
205
206  |image28|
207
208  J. Click the Service and click Certify, Enter a comment and click OK, you will
209  see certification succeeded message
210
211  |image31|
212
213 5. Distribute the Service
214
215  A. From the SDC HOME page, click CATALOG and search for the service
216  (it will be in Waiting For Distribution state)
217
218  |image18|
219
220  B. Select the service that is Ready for Distribution, click Distribute (top right corner)
221
222  |image30|
223
224  |image12|
225
226  C. To Monitor Distribution, click on Distribution on the left pane
227
228  |image41|
229
230  |image16|
231
232
233 .. |image1| image:: media/image1.png
234 .. |image2| image:: media/image2.png
235 .. |image3| image:: media/image3.png
236 .. |image5| image:: media/image5.png
237 .. |image6| image:: media/image6.png
238 .. |image7| image:: media/image7.png
239 .. |image8| image:: media/image8.png
240 .. |image9| image:: media/image9.png
241 .. |image10| image:: media/image10.png
242 .. |image11| image:: media/image11.png
243 .. |image12| image:: media/image12.png
244 .. |image13| image:: media/image13.png
245 .. |image14| image:: media/image14.png
246 .. |image15| image:: media/image15.png
247 .. |image16| image:: media/image16.png
248 .. |image17| image:: media/image17.png
249 .. |image18| image:: media/image18.png
250 .. |image19| image:: media/image19.png
251 .. |image20| image:: media/image20.png
252 .. |image21| image:: media/image21.png
253 .. |image22| image:: media/image22.png
254 .. |image23| image:: media/image23.png
255 .. |image24| image:: media/image24.png
256 .. |image25| image:: media/image25.png
257 .. |image26| image:: media/image26.png
258 .. |image27| image:: media/image27.png
259 .. |image28| image:: media/image28.png
260 .. |image29| image:: media/image29.png
261 .. |image30| image:: media/image30.png
262 .. |image31| image:: media/image31.png
263 .. |image32| image:: media/image32.png
264 .. |image33| image:: media/image33.png
265 .. |image34| image:: media/image34.png
266 .. |image35| image:: media/image35.png
267 .. |image36| image:: media/image36.png
268 .. |image37| image:: media/image37.png
269 .. |image38| image:: media/image38.png
270 .. |image39| image:: media/image39.png
271 .. |image40| image:: media/image40.png
272 .. |image41| image:: media/image41.png
273 .. |image43| image:: media/image43.png
274 .. |image44| image:: media/image44.png