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
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
|
.. Modifications Copyright © 2017-2018 AT&T Intellectual Property.
.. Licensed under the Creative Commons License, Attribution 4.0 Intl.
(the "License"); you may not use this documentation except in compliance
with the License. You may obtain a copy of the License at
.. https://creativecommons.org/licenses/by/4.0/
.. Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
VNF On-boarding and package management
--------------------------------------
Design Definition
^^^^^^^^^^^^^^^^^^
The ONAP Design Time Framework provides the ability to design NFV
resources including VNFs, Services, and products. The VNF provider must
provide VNF packages that include a rich set of recipes, management and
functional interfaces, policies, configuration parameters, and
infrastructure requirements that can be utilized by the ONAP Design
module to onboard and catalog these resources. Initially this
information may be provided in documents, but in the near future a
method will be developed to automate as much of the transfer of data as
possible to satisfy its long term requirements.
The current VNF Package Requirement is based on a subset of the
Requirements contained in the ETSI Document: ETSI GS NFV-MAN 001 v1.1.1
and GS NFV IFA011 V0.3.0 (2015-10) - Network Functions Virtualization
(NFV), Management and Orchestration, VNF Packaging Specification.
Resource Description
^^^^^^^^^^^^^^^^^^^^^^
.. req::
:id: R-77707
:target: XNF
:keyword: MUST
The xNF provider **MUST** include a Manifest File that
contains a list of all the components in the xNF package.
.. req::
:id: R-66070
:target: XNF
:keyword: MUST
The xNF Package **MUST** include xNF Identification Data to
uniquely identify the resource for a given xNF provider. The identification
data must include: an identifier for the xNF, the name of the xNF as was
given by the xNF provider, xNF description, xNF provider, and version.
.. req::
:id: R-69565
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing xNF
Management APIs, which must include information and tools for ONAP to
deploy and configure (initially and ongoing) the xNF application(s)
(e.g., NETCONF APIs) which includes a description of configurable
parameters for the xNF and whether the parameters can be configured
after xNF instantiation.
.. req::
:id: R-00156
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing xNF
Management APIs, which must include information and tools for
ONAP to monitor the health of the xNF (conditions that require
healing and/or scaling responses).
.. req::
:id: R-00068
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation which includes
a description of parameters that can be monitored for the xNF
and event records (status, fault, flow, session, call, control
plane, etc.) generated by the xNF after instantiation.
.. req::
:id: R-12678
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation which includes a
description of runtime lifecycle events and related actions (e.g.,
control responses, tests) which can be performed for the xNF.
.. req::
:id: R-84366
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing
xNF Functional APIs that are utilized to build network and
application services. This document describes the externally exposed
functional inputs and outputs for the xNF, including interface
format and protocols supported.
.. req::
:id: R-36280
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide documentation describing
xNF Functional Capabilities that are utilized to operationalize the
xNF and compose complex services.
.. req::
:id: R-98617
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide information regarding any
dependency (e.g., affinity, anti-affinity) with other xNFs and resources.
.. req::
:id: R-22346
:target: VNF PACKAGE
:keyword: MUST
:introduced: casablanca
:validation_mode: static
The VNF package MUST provide `VES Event Registration <https://onap.readthedocs.io/en/latest/submodules/vnfsdk/model.git/docs/files/VESEventRegistration.html>`_ for all VES events provided by that xNF.
Resource Configuration
^^^^^^^^^^^^^^^^^^^^^^^
.. req::
:id: R-89571
:target: XNF
:keyword: MUST
The xNF **MUST** support and provide artifacts for configuration
management using at least one of the following technologies;
a) Netconf/YANG, b) Chef, or c) Ansible.
Note: The requirements for Netconf/YANG, Chef, and Ansible protocols
are provided separately and must be supported only if the corresponding
protocol option is provided by the xNF providor.
Configuration Management via NETCONF/YANG
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. req::
:id: R-30278
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide a Resource/Device YANG model
as a foundation for creating the YANG model for configuration. This will
include xNF attributes/parameters and valid values/attributes configurable
by policy.
Configuration Management via Chef
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. req::
:id: R-13390
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide cookbooks to be loaded
on the appropriate Chef Server.
.. req::
:id: R-18525
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide a JSON file for each
supported action for the xNF. The JSON file must contain key value
pairs with all relevant values populated with sample data that illustrates
its usage. The fields and their description are defined in Tables A1
and A2 in the Appendix.
Note: Chef support in ONAP is not currently available and planned for 4Q 2017.
Configuration Management via Ansible
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. req::
:id: R-75608
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide playbooks to be loaded
on the appropriate Ansible Server.
.. req::
:id: R-16777
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide a JSON file for each
supported action for the xNF. The JSON file must contain key value
pairs with all relevant values populated with sample data that illustrates
its usage. The fields and their description are defined in Table B1
in the Appendix.
.. req::
:id: R-46567
:target: XNF
:keyword: MUST
The xNF Package **MUST** include configuration scripts
for boot sequence and configuration.
.. req::
:id: R-16065
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide configurable parameters
(if unable to conform to YANG model) including xNF attributes/parameters
and valid values, dynamic attributes and cross parameter dependencies
(e.g., customer provisioning data).
Resource Control Loop
^^^^^^^^^^^^^^^^^^^^^^^
.. req::
:id: R-22888
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide documentation for the xNF
Policy Description to manage the xNF runtime lifecycle. The document
must include a description of how the policies (conditions and actions)
are implemented in the xNF.
.. req::
:id: R-01556
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing the
fault, performance, capacity events/alarms and other event records
that are made available by the xNF.
.. req::
:id: R-16875
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation which must include
a unique identification string for the specific xNF, a description of
the problem that caused the error, and steps or procedures to perform
Root Cause Analysis and resolve the issue.
.. req::
:id: R-35960
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation which must include
all events, severity level (e.g., informational, warning, error) and
descriptions including causes/fixes if applicable for the event.
.. req::
:id: R-42018
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation which must include
all events (fault, measurement for xNF Scaling, Syslogs, State Change
and Mobile Flow), that need to be collected at each VM, VNFC (defined in `VNF Guidelines <https://onap.readthedocs.io/en/latest/submodules/vnfrqts/guidelines.git/docs/vnf_guidelines/vnf_guidelines.html>`__ ) and for the overall xNF.
.. req::
:id: R-27711
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide an XML file that contains a
list of xNF error codes, descriptions of the error, and possible
causes/corrective action.
.. req::
:id: R-01478
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing all
parameters that are available to monitor the xNF after instantiation
(includes all counters, OIDs, PM data, KPIs, etc.) that must be
collected for reporting purposes.
.. req::
:id: R-73560
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation about monitoring
parameters/counters exposed for virtual resource management and xNF
application management.
.. req::
:id: R-90632
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation about KPIs and
metrics that need to be collected at each VM for capacity planning
and performance management purposes.
.. req::
:id: R-86235
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation about the monitoring
parameters that must include latencies, success rates, retry rates, load
and quality (e.g., DPM) for the key transactions/functions supported by
the xNF and those that must be exercised by the xNF in order to perform
its function.
.. req::
:id: R-33904
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation for each KPI, provide
lower and upper limits.
.. req::
:id: R-53598
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation to, when relevant,
provide a threshold crossing alert point for each KPI and describe the
significance of the threshold crossing.
.. req::
:id: R-69877
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation for each KPI,
identify the suggested actions that need to be performed when a
threshold crossing alert event is recorded.
.. req::
:id: R-22680
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation that describes
any requirements for the monitoring component of tools for Network
Cloud automation and management to provide these records to components
of the xNF.
.. req::
:id: R-33694
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation to when applicable,
provide calculators needed to convert raw data into appropriate reporting
artifacts.
.. req::
:id: R-56815
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing
supported xNF scaling capabilities and capacity limits (e.g., number
of users, bandwidth, throughput, concurrent calls).
.. req::
:id: R-48596
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing
the characteristics for the xNF reliability and high availability.
.. req::
:id: R-74763
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide an artifact per xNF that contains
all of the xNF Event Records supported. The artifact should include
reference to the specific release of the xNF Event Stream Common Event
Data Model document it is based on. (e.g.,
`VES Event Listener <https://onap.readthedocs.io/en/latest/submodules/vnfsdk/model.git/docs/files/VESEventListener.html>`__)
Compute, Network, and Storage Requirements
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. req::
:id: R-35851
:target: XNF
:keyword: MUST
The xNF Package **MUST** include xNF topology that describes
basic network and application connectivity internal and external to the
xNF including Link type, KPIs, Bandwidth, latency, jitter, QoS (if
applicable) for each interface.
.. req::
:id: R-97102
:target: VNF
:keyword: MUST
The VNF Package **MUST** include VM requirements via a Heat
template that provides the necessary data for VM specifications
for all VNF components - for hypervisor, CPU, memory, storage.
.. req::
:id: R-20204
:target: VNF
:keyword: MUST
The VNF Package **MUST** include VM requirements via a Heat
template that provides the necessary data for network connections,
interface connections, internal and external to VNF.
.. req::
:id: R-44896
:target: VNF
:keyword: MUST
The VNF Package **MUST** include VM requirements via a Heat
template that provides the necessary data for high availability
redundancy model.
.. req::
:id: R-55802
:target: VNF
:keyword: MUST
The VNF Package **MUST** include VM requirements via a Heat
template that provides the necessary data for scaling/growth VM
specifications.
Note: Must comply with the *Heat requirements in 5.b*.
.. req::
:id: R-26881
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide the binaries and images
needed to instantiate the xNF (xNF and VNFC images).
.. req::
:id: R-96634
:target: XNF
:keyword: MUST
The xNF provider **MUST** describe scaling capabilities
to manage scaling characteristics of the xNF.
Testing
^^^^^^^^^^
.. req::
:id: R-43958
:target: XNF
:keyword: MUST
The xNF Package **MUST** include documentation describing
the tests that were conducted by the xNF providor and the test results.
.. req::
:id: R-04298
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide their testing scripts to
support testing.
.. req::
:id: R-58775
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide software components that
can be packaged with/near the xNF, if needed, to simulate any functions
or systems that connect to the xNF system under test. This component is
necessary only if the existing testing environment does not have the
necessary simulators.
Licensing Requirements
^^^^^^^^^^^^^^^^^^^^^^^
.. req::
:id: R-85653
:target: XNF
:keyword: MUST
The xNF **MUST** provide metrics (e.g., number of sessions,
number of subscribers, number of seats, etc.) to ONAP for tracking
every license.
.. req::
:id: R-44125
:target: XNF
:keyword: MUST
The xNF provider **MUST** agree to the process that can
be met by Service Provider reporting infrastructure. The Contract
shall define the reporting process and the available reporting tools.
.. req::
:id: R-40827
:target: XNF
:keyword: MUST
The xNF provider **MUST** enumerate all of the open
source licenses their xNF(s) incorporate.
.. req::
:id: R-97293
:target: XNF
:keyword: MUST NOT
The xNF provider **MUST NOT** require audits
of Service Provider's business.
.. req::
:id: R-44569
:target: XNF
:keyword: MUST NOT
The xNF provider **MUST NOT** require additional
infrastructure such as a xNF provider license server for xNF provider
functions and metrics.
.. req::
:id: R-13613
:target: VNF
:keyword: MUST
The VNF **MUST** provide clear measurements for licensing
purposes to allow automated scale up/down by the management system.
.. req::
:id: R-27511
:target: VNF
:keyword: MUST
The VNF provider **MUST** provide the ability to scale
up a VNF provider supplied product during growth and scale down a
VNF provider supplied product during decline without "real-time"
restrictions based upon VNF provider permissions.
.. req::
:id: R-85991
:target: XNF
:keyword: MUST
The xNF provider **MUST** provide a universal license key
per xNF to be used as needed by services (i.e., not tied to a VM
instance) as the recommended solution. The xNF provider may provide
pools of Unique xNF License Keys, where there is a unique key for
each xNF instance as an alternate solution. Licensing issues should
be resolved without interrupting in-service xNFs.
.. req::
:id: R-47849
:target: XNF
:keyword: MUST
The xNF provider **MUST** support the metadata about
licenses (and their applicable entitlements) as defined in this
document for xNF software, and any license keys required to authorize
use of the xNF software. This metadata will be used to facilitate
onboarding the xNF into the ONAP environment and automating processes
for putting the licenses into use and managing the full lifecycle of
the licenses. The details of this license model are described in
Tables C1 to C8 in the Appendix.
Note: License metadata support in ONAP is not currently available
and planned for 1Q 2018.
|