Updated Jakarta release notes for E2E Network Slicing use case
[integration.git] / docs / docs_E2E_network_slicing.rst
1 .. This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE
2 .. Full license text at https://creativecommons.org/licenses/by/4.0/legalcode
3
4 .. contents::
5    :depth: 3
6 ..
7 .. _docs_E2E_network_slicing:
8
9
10 E2E Network Slicing Use Case
11 ============================
12
13 Overall Blueprint
14 -----------------
15 The objective of this use case is to realize **End-to-End 5G Network
16 Slicing** using ONAP. An End-to-End Network Slice consists of RAN (Radio
17 Access Network), Transport Network (TN) and Core Network (CN) slice
18 sub-nets. This use case intends to demonstrate the modeling,
19 orchestration (life cycle and resources) and assurance of a network
20 slice which are implemented in alignment with relevant standards. The
21 key highlights of this use case include:
22
23 -  Modular architecture providing building blocks and flexibility under
24    various deployment scenarios
25
26 -  Functionality aligned with 3GPP and other relevant standards such as
27    ETSI and IETF
28
29 -  Interfaces and APIs aligned with relevant standards (3GPP, IETF,
30    ETSI, TM Forum, etc.) while enabling easy customization through use
31    of appropriate plug-ins. This would enable easier interoperability of
32    slice management functions realized within ONAP with 3\ :sup:`rd`
33    party slice management functions, as well as northbound and
34    southbound systems.
35
36 -  Taking a step-by-step approach to realizing different architectural
37    options in an extendable manner.
38
39 -  Providing flexibility in network slice selection by providing an
40    option of manual intervention, as well as abstracting the network
41    internals as needed.
42
43 -  The use case implementation team is composed of service providers,
44    software and hardware vendors, solution providers and system
45    integrators thereby taking into consideration different perspectives
46    and requirements.
47
48 This use case is a multi-release effort in ONAP with the first steps
49 taken in Frankfurt release. It will continue to expand in scope both in
50 breadth and depth, and along the journey it shall also align with
51 updates to the relevant standards which are also currently evolving.
52 This use case shall also collaborate with SDOs such as
53 O-RAN and ETSI to enable wider adoption and use.
54
55 Architecture Choice
56 -------------------
57 3GPP(TS 28.801) defines three layer slice management functions which include:
58
59 CSMF(Communication Service Management Function):
60
61 • Responsible for translating the communication service related requirement to network slice related requirements.
62
63 • Communicate with Network Slice Management Function (NSMF).
64
65 NSMF(Network Slice Management Function):
66
67 • Responsible for management and orchestration of NSI.
68 • Derive network slice subnet related requirements from network slice related requirements.
69 • Communicate with the Network Slice Subnet Management Function (NSSMF) and Communication Service Management Function.
70
71 NSSMF(Network Slice Subnet Management Function):
72
73 • Responsible for management and orchestration of NSSI.
74 • Communicate with the NSMF.
75
76 To realize the three layers of the slice management function, we need to decide whether to implement CSMF, NSMF or NSMF within ONAP, or use the external CSMF, NSMF or NSSMF. This implies that for ONAP-based network slice management, we have different choices from an architectural perspective:
77
78 1) Implement CSMF, NSMF, NSSMF all within ONAP;
79
80 2) Connect an external CSMF from the Northbound, Implement NSMF and NSSMF within ONAP;
81
82 3) Connect an external CSMF from the Northbound, Implement NSMF within ONAP, Connect a 3rd party NSSMF from the Southbound;
83
84 4) Implement CSMF, NSMF within ONAP, Connect a 3rd party NSSMF from then Southbound.
85
86 5) Use external CSMF and NSMF, only implement NSSMF within ONAP.
87
88 External Interfaces
89 -------------------
90 The guiding principle is when a Slice Management function is outside ONAP, standard interfaces/APIs (3GPP, IETF, ETSI, TM Forum, etc.) can be supported by default, while any customization of such interfaces shall also be supported by ONAP using suitable plug-ins/adaptors. This would enable easier interoperability of slice management functions realized within ONAP with 3rd party slice management functions, as well as northbound and southbound systems.
91
92 Another key point would be that both internal and external interface mechanisms should be supported by the corresponding ONAP modules. To be more specific, communication between Slice Management Functions within ONAP (e.g., CSMF and NSMF) shall use ONAP internal mechanisms such as workflow calls, DMaaPmessages, etc. or standard APIs as appropriate. For example, SO acting as NSMF should support API call directly from CSMF in ONAP, as well as API trigger from an external CSMF via EXT-API.
93
94 Network Slice Instance (NSI) Life Cycle View
95 --------------------------------------------
96 3GPP Specification (3GPP TS 28.530) describes management aspects of a Network Slice Instance, which can be described by the four phases:
97
98 - Preparation: The preparation phase includes network slice design, network slice capacity planning, on-boarding and evaluation of the network functions, preparing the network environment and other necessary preparations required to be done before the creation of an NSI.
99 - Commissioning: NSI provisioning in the commissioning phase includes creation of the NSI. During NSI creation all needed resources are allocated and configured to satisfy the network slice requirements. The creation of an NSI can include creation and/or modification of the NSI constituents.
100 - Operation: The Operation phase includes the activation, supervision, performance reporting (e.g. for KPI monitoring), resource capacity planning, modification and de-activation of an NSI.
101 - Decommissioning: Network slice instance provisioning in the decommissioning phase includes decommissioning of non-shared constituents if required and removing the NSI specific configuration from the shared constituents. After the decommissioning phase, the NSI is terminated and does not exist anymore.
102
103 The ONAP-based NSI lifecycle management will finally provide the demonstration of all these phases.
104
105 Abbreviations
106 -------------
107
108 +---------------+--------------------------------------------+
109 |  Abbreviation |                   Meaning                  |
110 +===============+============================================+
111 | CSMF          | Communication Service Management Function  |
112 +---------------+--------------------------------------------+
113 | CSI           | Communication Service Instance             |
114 +---------------+--------------------------------------------+
115 | CST           | Communication Service Template             |
116 +---------------+--------------------------------------------+
117 | NSI           | Network Slice Instance                     |
118 +---------------+--------------------------------------------+
119 | NSMF          | Network Slice Management Function          |
120 +---------------+--------------------------------------------+
121 | NSSI          | Network Slice Sub-net Instance             |
122 +---------------+--------------------------------------------+
123 | NSSMF         | Network Slice Sub-net Management Function  |
124 +---------------+--------------------------------------------+
125 | NST           | Network Slice Template                     |
126 +---------------+--------------------------------------------+
127 | NSST          | Network Slice Sub-net Template             |
128 +---------------+--------------------------------------------+
129
130
131 Recap of Frankfurt functionality
132 --------------------------------
133 In Frankfurt release, CSMF and NSMF within ONAP was implemented, while connecting to an external Core NSSMF.
134 From the NSI Life Cycle perspective, the scope for Frankfurt included NSI design and pre-provision, NSI instantiation
135 and configuration, and NSI activation and deactivation. In particular:
136
137 - CSMF: Functions of slice service creation, slice service activation and deactivation were implemented.
138
139 - NSMF: Functions of NSI instantiation, NSI activation and deactivation were implemented. In addition, manual
140   intervention is also provided in NSMF slice task management portal to ensure the selected NSI/NSSI as well as
141   Service Profile and Slice Profile are OK or need adjustment.
142
143 - Design of CST, NST and onboarding NSST that are required to support the run-time orchestration functions
144
145 - To connect to the external (core) NSSMF, an adaptor was implemented to provide interface between ONAP and 3rd party
146   core NSSMF.
147
148 To support the above functions, code impacts in U-UI, SO, OOF and ExtAPI components, and schema change in A&AI
149 were implemented. See the `Proposed Functions for R6 and Impacted Modules wiki page <https://wiki.onap.org/display/DW/Proposed+Functions+for+R6+and+Impacted+Modules>`_ for details.
150
151 As part of Frankfurt release work, we supported the minimum-scope installation of ONAP to reduce the resource requirements.
152 From the module perspective, 5G E2E Slicing use case involves SDC, SO, A&AI, UUI, EXT-API, OOF and Policy modules of ONAP.
153 So we will configure these required modules along with the mandatory common modules such as DMaaP. Further, for each module,
154 the use case also does not use all of the charts,so we removed the not needed Charts under those modules to optimize the
155 resources required for setting up the use case. This approach will help to install a minimum-scope version ONAP for the
156 E2E Slicing use case.
157
158 Further details of the installation steps are available at: `Install Minimum Scope ONAP for 5G Network Slicing wiki page
159 <https://wiki.onap.org/display/DW/Install+Minimum+Scope+ONAP+for+5G+Network+Slicing>`_
160
161 Recap of Guilin functionality
162 -----------------------------
163 From the architecture point of view, in Guilin release, besides the continuation of NSMF which was implemented in
164 Frankfurt release, the RAN NSSMF, TN NSSMF, CORE NSSMF have been implemented within ONAP, apart from interacting with
165 external RAN NSSMF and external CORE NSSMF.
166
167 The following provides an overview of the enhancements done in Guilin release:
168
169 - **Enhancements in NSMF**: Service Profile decomposition into Slice Profiles for 3 domains, NSI selection enhancement,
170   E2E slice instance creation including RAN, TN and CN slice sub-net instance creation/reuse, activation/deactivation
171   of E2E slice, and deciding whether to terminate E2E slice or not.
172
173 - **RAN NSSMF, TN NSSMF, CN NSSMF within ONAP**: Basic logic for all 3 NSSMFs to support NSSI allocation, activation,
174   deactivation, deletion and modification (in case of reuse of NSSI).
175
176 - **Enable NSMF interaction with RAN NSSMF, TN NSSMF, CN NSSMF**: Implement generic NSSMF adaptor for three domain NSSMFs,
177   alignment with standard interfaces (3GPP, IETF), enable the connection to external RAN NSSMF.
178
179 - **Design of RAN NSST, TN NSST, CN NSST and Slice Profiles, TN information models**: Basic E2E Slicing model was provided
180   all the related templates designed from SDC, TN related information models.
181
182 - **TMF 641 support**: Extension of the TMF 641 based interface from NB of ExtAPI to support service activation,
183   deactivation and termination.
184
185 - **RAN and CN NFs set up and initial configurations**: CN NF simulators was developed: AMF, SMF, UPF and configure the
186   S-NSSAI on CN NFs; RAN NF Simulator was enhanced for PM data reporting, CU and Near-RT RIC configuration.
187
188 - **KPI monitoring**: Implementation to request details of a KPI via UUI to ONAP DCAE. Providing the requested data to UUI
189   by DCAE using a new microservice (Data Exposure Service - DES). Enhancements in PM-Mapper to do KPI computation is
190   in progress, and will be completed in Honolulu release.
191
192 - **Closed Loop**: First steps to realizing a simple Closed Loop in the RAN using PM data collected from the RAN was
193   implemented - update the allowed throughput for a S-NSSAI per Near-RT RIC coverage area based on DL/UL PRB for data
194   traffic that was reported from the RAN. The analysis of the PM data was done using a new Slice Analysis MS in DCAE,
195   and the Policy-based Control Loop framework was applied to trigger the updates in the RAN.
196
197 - **Intelligent Slicing**: First steps to realizing a simple ML-based Closed Loop action in the RAN using PM data collected
198   from the RAN was implemented - update the maxNumberofConns for a S-NSSAI in each cell based on PDU session related
199   PM data that was reported from the RAN (PDU sessions requested, successfully setup and failed to be set up). The
200   training was done offline, and the ML model is onboarded as a micro-service to ONAP for demo purpose alone (it is
201   not part of ONAP code/repos). The ML model provides updates to the Slice Analysis MS, which then uses the
202   Policy-based Control Loop framework to trigger the updates in the RAN.
203
204 - **Modeling enhancements**: Necessary modeling enhancements to support all the above functionalities.
205
206 The base use case page for Guilin release is `E2E Network Slicing Use Case in R7 Guilin <https://wiki.onap.org/display/DW/E2E+Network+Slicing+Use+Case+in+R7+Guilin>`_.
207
208 The child wiki pages of the above page contains details of the assumptions, flows and other relevant details.
209
210 Honolulu release updates
211 ------------------------
212 In Honolulu release, the following aspects were realized:
213
214 - **Modeling Enhancements** were made, details can be found at:
215   `Modeling enhancements in Honolulu <https://wiki.onap.org/display/DW/Modeling+enhancements+in+Honolulu>`_.
216
217 - **Functional Enhancements**
218
219   (a) Minor enhancements in NSMF and NSSMFs including NST Selection, Shared slices, coverageArea to
220       coverageAreaTAList mapping, etc.
221   (b) Enhancements related to endpoints for stitching together an end-to-end network slice
222   (c) Use of CPS (instead of Config DB) to determine the list of Tracking Areas corresponding to a given
223       Coverage Area (input by user). For the remaining RAN configuration data, we continue to use Config DB.
224   (d) RRM Policy update by SDN-R to RAN NFs during RAN NSSI creation/reuse
225
226 - **Integration Testing**
227   Continuing with integration tests deferred in Guilin release, and associated bug-fixing
228
229 Important Remarks
230 ~~~~~~~~~~~~~~~~~~~
231 (a) 2 deployment scenarios for RAN NSSI are supported. In the first scenario, the RAN NSSI comprises also of
232     TN Fronthaul (FH) and TN Midhaul (FH) NSSIs, and RAN NSSMF shall trigger TN NSSMF for TN FH and MH NSSI
233     related actions. In the second scenario, the RAN NSSI comprises only of RAN NFs. TN NSSMF shall be triggered by
234     NSMF for TN FH and MH NSSI related actions. This part is not yet implemented in NSMF within ONAP.
235
236 (b) Details of the modeling aspects, flows and other relevant info about the use case are available in:
237     `R8 E2E Network Slicing Use Case <https://wiki.onap.org/display/DW/R8+E2E+Network+Slicing+use+case>`_ and its child wiki pages.
238
239
240 Impacted Modules for Honolulu
241 -----------------------------
242 The code-impacted modules of E2E Network Slicing in Honolulu release are:
243
244 - **UUI**: The enhancements done include:
245
246   (a) The coverageArea The coverageArea number param is added in CSMF creation UI. Users could input
247       the grid numbers to specify the area where they want the slicing service to cover.
248   (b) The relation link image of AN/TN/CN has been added. Users can see the links and related params
249       of the three domains.
250   (c) The TN’s connection link with AN/CN has been added in NS Task management GUI.
251
252 - **AAI**: Schema changes were introduced. We added some new parameters in 2 nodes:
253
254   (a) ‘Connectivity’ is used to store IETF/ACTN ETH service parameters. New attributes added in order
255       to support the CCVPN network configuration operations on multi-domain (2+) interconnections.
256   (b) ‘Vpn-binding’is used to store ACTN OTN Tunnel model’s parameters.
257
258 - **OOF**: Updates include:
259  
260   (a) NST selection is enhanced by fetching the templates from SDC directly.
261   (b) coverageArea to coverageAreaTAList mapping is done by OOF (as part of Slice Profile generation)
262       by accessing CPS.
263   (c) Bug-fixes
264
265 - **SO**: Main updates include support of NSI shared scenarios by enhancing the interaction with OOF, AAI and
266   UUI. Apart from this some updates/fixes have been made in NSMF, RAN/Core/TN NSSMF functionality in SO, for
267   example:
268
269   (a) *NSMF*: Update NSI selection process support shared NSI and add sst parameter
270   (b) *AN NSSMF*: Activation flow for SDN-R interactions, allocate flow & added timeDelay in QueryJobStatus,
271       support of Option 1 for topmost RAN NSSI
272   (c) *CN NSSMF*: Non-shared allocate flow
273   (d) *TN NSSMF*: Modify TN NSSI operation
274
275 - **CPS**: 2 APIs required for the use case are supported. The remaining yang models are also onboarded,
276   however, the API work as well as further enhancements to CPS Core, NF Proxy and Template-Based Data
277   Model Transformer Service shall continue beyond Honolulu.
278
279 - **SDN-R**: RRMP Policy updates, enhancements for updating the RAN configuration during slice reuse,
280   closed loop and intelligent slicing.
281
282 - **DCAE**:
283
284   (a) *KPI Computation MS*: This MS was introduced newly for computation of slice related KPIs. In this release,
285       it supports basic KPI computation based on formula specified via Policy. Further details about this MS is
286       available at `KPI Computation MS <https://wiki.onap.org/display/DW/DCAE+R8+KPI-Computation+ms>`_
287   (b) *Slice Analysis MS*: Minor updates were done.
288
289 Apart from the above, Policy and SDC had test-only impact for this use case.
290
291 In addition:
292
293 - **Config DB** was updated to handle bugs and gaps found during testing. This is not an official ONAP component, and
294   its functionality is expected to be performed fully by the Configuration Persistence Service (CPS) in future ONAP
295   release (beyond Honolulu).
296
297 - **Core NF simulator** and *ACTN simulator* were also updated and checked into ONAP simulator repo.
298
299 - **RAN-Sim** has been updated to fix bugs found during testing, and also checked into ONAP simulator repo.
300
301
302 Functional Test Cases
303 ---------------------
304 The functional testing of this use case shall cover CSMF/NSMF, the 3 NSSMFs and Closed Loop functionality. We classify the
305 test cases into 5 tracks: CSMF/NSMF, RAN NSSMF, Core NSSMF, TN NSSMF and Closed Loop.
306 Details of the test cases can be found at:
307 `Integration Test details for Honolulu <https://wiki.onap.org/display/DW/Integration+Test+details+for+Honolulu>`_ and its child wiki pages.
308
309
310 Operation Guidance
311 ------------------
312 The Honolulu release setup details for the E2E Network Slicing use case will be available at the following page and its
313 sub-pages:
314 `User Operation Guide for Honolulu release <https://wiki.onap.org/display/DW/User+Operation+Guide+for+Honolulu+release>`_
315
316
317 Known Issues and Resolutions
318 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
319 Details of manual configurations, work-arounds and known issues will be documented in the child wiki pages of:
320 `User Operation Guide for Honolulu release <https://wiki.onap.org/display/DW/User+Operation+Guide+for+Honolulu+release>`_
321
322 The foll. integration tests are carried over to Istanbul release: see `REQ-721 <https://jira.onap.org/browse/REQ-721>`_
323 - NSMF: Option 2 testing, remaining regression testing and service termination testing for NSMF
324 - RAN NSSMF: RAN NSSI termination, interactions with TN NSSMF for FH/BH NSSI reuse and some minor aspects related to SDN-R <-> RAN interaction
325 - TN NSSMF: Checking some minor aspects in SO for modifying TN NSSI.
326 - Core NSSMF: Modifying and deallocating a Core NSSI, reusing an existing Core NSSI
327 - KPI Computation, Closed Loop & Intelligent Slicing: Some minor aspects on SDN-R <-> RAN-Sim interface needs to be addressed.
328
329 Further details of these test cases can be found in REQ jiras for integration testing for Honolulu, and in the
330 use case wiki. This means that the functionality associated with these test cases may require updated versions
331 of the relevant components - the User Operation Guide will also be updated with details of any bug fixes
332 beyond Honolulu as the testing is anyhow continuing as part of Istanbul release.
333
334 Istanbul release updates
335 ------------------------
336 Below aspects are covered in Istanbul release:
337
338 1. **CPS-TBDMT Enhancements** - This service shall be used to map the erstwhile Config-DB-like REST APIs to appropriate CPS API calls. The purpose of this service is to abstract the details of (possibly multiple, and complex) XPath queries from the users of CPS. It enables CPS-users to continue using simple REST API calls that are intuitive and easy-to-understand and implement. The mapping to appropriate queries to CPS (including mapping of one API call to many Xpath queries) shall be done in a generic way by the CPS-TBDMT service. In Istanbul release, following are the main enhancements done:
339
340     - Support edit query ie. post, put and patch requests to CPS
341
342     - Support Output Transformation
343
344       (a) Extract desired output from the data returned from CPS.
345       (b) If 'transformParam' is not defined in the template no transformation takes place.
346     - Support Multiple query
347
348       (a) Make multiple queries to CPS in single request.
349       (b) If 'multipleQueryTemplateId' is mentioned in the template, it will execute this template first  and insert the result to the current template to make multiple queries to CPS.
350     - Support Delete data requests to CPS
351
352       (a) Process delete request type.
353     - Support for dynamic anchor - Accept anchors at run time and execute query
354
355 2. **CPS Integration**
356
357     - Config DB is replaced with the CPS component to read, write, update and delete the RAN Slice details. CPS APIs are accessed via CPS-TBDMT component. CPS integration with DCAE - Slice Analysis MS and OOF are completed. SDN-R integration with CPS is completed for the shared RAN Slice flow, activateRANslice and terminateRANSlice implementations are in progress.
358     - A new SDN-C karaf feature is introduced to register the cm-handle (anchor) with CPS. The integration with CPS-DMI plugin will be done in Jakarta release.
359
360 3. **NSMF based TN Slices** - Support for interacting with TN NSSMF directly from NSMF for front haul and mid haul slice subnets. There will be separate SDC template for this scenario. NST will have 5 NSSTs - CN NSST, AN NSST, TN FH NSST, TN MH NSST, TN BH NSST.
361
362 4. **KPI Monitoring** - Implementation is done in KPI Computation MS to configure the required KPIs and the KPI computation formula based on policies.
363
364 5. **Closed Loop** - Closed Loop updates are sent over A1 interface to Near-RT RIC. This is done at the POC level. This will be further enhanced in Jakarta release to make use of the A1-Policy Management Service in CCSDK.
365
366 6. **Intelligent Slicing** - End to end intelligent slicing - closed loop flow is tested with the initial version of Machine Learning MS.
367
368 7. **Carry-over Testing from Honolulu Release**
369
370     - RAN NSSMF Testing
371
372       (a) Testing completed for the allocation, modification, activation and deactivation of the RAN slice to support option1
373       (b) Integration Testing of AN NSSMF with SDNR interactions for allocate and modify flow is completed
374     - E2E Testing
375
376       (a) Service instantiation for non-shared and shared scenario and fixes to support option 1 are done
377       (b) NSI selection process support for shared NSI is tested
378  
379 Impacted Modules for Istanbul Release
380 -------------------------------------
381 - **SO**
382     (a) Support of NSI termination by enhancing the interaction with OOF, AAI and UUI
383     (b) RAN NSSI Termination support with OOF & SDN-R interactions
384     (c) Bug fixes in Option 1 (CSMF, NSMF and NSSMFs are within ONAP & TN-FH, TN-MH are created by RAN NSSMF)
385         - **CSMF**: Fixed sNSSAI format and updated authentication for NSMF invocation
386         - **NSMF**: Fixes in NSI termination issues to support OOF interaction for NSI termination query and added subnet Type support for respective TN Domain
387         - **AN NSSMF**: Fixes for different termination scenarios in Option 1
388         - **CN NSSMF**: Bug fixes in shared allocate flow, modify flow and terminate flow
389         - Slice Profile alignment with NSSMF
390     (d) NSMF based TN Slices (TN-FH, TN-MH are created by NSMF) - Work flow changes to support this approach
391   
392 - **OOF**
393     (a) Integration with CPS for coverage area to coverage area TA list
394     (b) Bug fixes in NxI termination
395
396 - **DCAE**
397     (a) Minor changes in Slice Analysis MS to support CPS integration
398     (b) KPI Computation MS in enhanced to support policy based KPIs and formula
399
400 - **SDN-R**
401     (a) Bug fixes in instantiateRANSliceAllocate, instantiateRANSliceAllocateModify, activateRANSlice, terminateRANSlice Directed Graphs
402     (b) CPS integration for the instantiateRANSliceAllocateModify, activateRANSlice, terminateRANSlice Directed Graphs
403     (c) A new karaf feature is introduced to register the cm-handle with CPS
404
405 - **CPS-TBDMT**
406     (a) This component is enhanced to support different type of queries based on templates
407     
408 - **CPS**
409     (a) Bug fixes and support for GET, POST, PATCH and DELETE type of queries. 
410
411 Istanbul Release - Functional Test cases
412 ----------------------------------------
413 **Honolulu release carry-over test cases**
414     (a) Different possible scenarios of E2E Slice (eMBB) creation are tested in I-release
415     (b) RAN slice Termination testing completed
416     (c) Test cases to validate slice reuse and terminate using Option 2 (Core NSSMF and RAN NSSMF external) are completed
417
418 **R9 Integration Testing**
419     (a) RAN NSSMF integration with CPS is covered for RANSlice modification, activation, deactivation and termination
420     (b) NSMF driven TN-FH and TN-MH slices creation is tested
421     (c) CPS impacts in closed loop scenario is validated and few test cases are deferred to Jakarta release
422
423     Integration test plan is available at `Integration Testing in Istanbul Release <https://wiki.onap.org/display/DW/R9+Integration+Test+for+E2E+Network+Slicing>`_
424
425 Istanbul Release - Operation Guidance
426 -------------------------------------
427 The steps for E2E network slicing use case will be available at `User Operation Guidance - Istanbul Release <https://wiki.onap.org/pages/viewpage.action?pageId=111118867>`_. It is an update to the user manual created in Honolulu release.
428
429 Istanbul Release - Known issues and Solutions
430 ---------------------------------------------
431
432 **REGISTER 3RD PARTY CONTROLLERS**
433
434 The ONAP TSC approved on July 9th, 2020 to change the status of ESR GUI Module
435 to an 'unmaintained' project. Further information about 'Unmaintained Projects'
436 can be found in the `ONAP Developer Wiki. <https://wiki.onap.org/x/Pw_LBQ>`__
437
438 But excluding the ESR GUI module from ONAP does not mean that the "external
439 system registration" mechanism is excluded; i.e. only the GUI is not available
440 anymore.
441
442 Nevertheless, in order to register the 3rd party controllers (like it is done
443 in E2E network slicing use case and recently in Cloud Leased Line "CLL" use
444 case as part of Intent-Based Networking), AAI's API are invoked manually.
445
446 To do so, please send the following CURL command (PUT) to your AAI, with the
447 attached xml payload. In the payload, please adjust the controller name (in
448 this case sdnc1) and the controller ip address accordingly based on your
449 environment:
450
451 CURL COMMAND:
452
453 .. code-block:: bash
454
455    curl -k -X PUT https://{{your-onap-ip-address}}:30233/aai/v16/external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/sdnc1 -u "AAI:AAI" -H "X-FromAppId:postman" -H "Content-Type:application/xml" -H "Accept: application/xml" -H "X-TransactionId:9999" -d @/home/onap/esr-registration-controller-1.xml
456
457
458 PAYLOAD (esr-registration-controller-1.xml):
459
460 .. code-block:: xml
461
462   <?xml version="1.0" encoding="UTF-8"?>
463   <esr-thirdparty-sdnc xmlns="http://org.onap.aai.inventory/v16">
464       <thirdparty-sdnc-id>sdnc1</thirdparty-sdnc-id>
465       <location>Core</location>
466       <product-name>TSDN</product-name>
467       <esr-system-info-list>
468           <esr-system-info>
469               <esr-system-info-id>sdnc1</esr-system-info-id>
470               <system-name>sdnc1</system-name>
471               <type>WAN</type>
472               <vendor>Huawei</vendor>
473               <version>V3R1</version>
474               <service-url>http://192.168.198.10:18181</service-url>
475               <user-name>onos</user-name>
476               <password>rocks</password>
477               <system-type>nce-t-controller</system-type>
478               <protocol>RESTCONF</protocol>
479               <ssl-cacert>example-ssl-cacert-val-20589</ssl-cacert>
480               <ssl-insecure>true</ssl-insecure>
481               <ip-address>192.168.198.10</ip-address>
482               <port>26335</port>
483               <cloud-domain>example-cloud-domain-val-76077</cloud-domain>
484               <default-tenant>example-default-tenant-val-71148</default-tenant>
485               <passive>true</passive>
486               <remote-path>example-remotepath-val-5833</remote-path>
487               <system-status>example-system-status-val-23435</system-status>
488           </esr-system-info>
489       </esr-system-info-list>
490   </esr-thirdparty-sdnc>
491
492
493 Additional issues occurred during the deployment and integration testing will be
494 listed in the ONAP Developer Wiki at `Network Slicing - Issues and Solutions <https://wiki.onap.org/display/DW/Network+Slicing+-+Issues+and+Solutions>`_
495
496 Jakarta Release Updates
497 -----------------------
498 In Jakarta release, the following aspects are covered:
499
500 1. **E2E Network Slicing Solution**
501     - Slice selection based on resource occupancy level. With this enhancement, NSMF/NSSMF is able to monitor and update resource levels at NSI/NSSI level. OOF returns the solution for NSI/NSSI selection based on the criteria. In case of shared scenario, NSI/NSSI can be shareable only if sufficient resources are available in the network. RAN NSSMF’s resource occupancy is considered for this release. Resource occupancy of Core and TN NSSMFs will be considered in future releases.
502     - Activate, Deactivate scenarios support in external RAN NSSMF - Option2. Note that instantiation and termination are supported in Istanbul release.
503
504 2. **RAN Slicing**
505     - Optimization of cm-handle registration with CPS-DMI Plugin for RAN NF instances to upload yang model.
506     - CPS integration with SDN-R for RAN slice allocation and reconfiguration scenarios
507     - CPS integration stabilization for RAN slice activate/deactivate and terminate scenarios. Validation and bug fix for CPS integration of RAN slice lifecycle.
508     - CSIT for RAN slicing
509 3. **Transport Slicing**
510     - OOF involvement in TN slice reuse and terminate scenarios
511        - Implementation of the call to OOF for allocateNSSI to enable TN NSSI reuse in TN NSSMF
512        - Implementation of the call to OOF for terminateNxi API to deallocate TN NSSI (which may not be terminated even when NSI is terminated) in TN NSSMF
513     - Closed-loop enhancement in CCVPN to support Transport Slicing’s closed-loop (Covered in CCVPN use case).
514 4. **Closed Loop**
515     - IBN based Closed loop for Network Slicing. This enhancement makes use of intents and Machine Learning models for closed loop. ML prediction microservice enhancement is done as a POC work in Jakarta release.
516     - CPS integration stabilization, which validates and enhances CPS integration for closed loop.
517 5. **Carryover tests from Istanbul release**
518     - Option-1 (internal NSMF, NSMF and NSSMF)
519        - E2E testing for activate/deactivate scenario
520        - Pending test cases for E2E Slice termination
521     - NSMF driven TN slicing
522        - Pending testing for activate/deactivate and terminate scenarios
523     - Bug fixes and testing for Core slicing
524        - NF instantiation issue with same NSST
525        - Multiple non-share Core slice creation issue
526
527 Impacted Modules for Jakarta Release
528 ------------------------------------
529 - **SO**: Requirements below are identified for Jakarta release and have impacts in SO component:
530      (1) Use of Optimization solution (OOF) in allocateNSSI, deallocateNSSI in TN NSSMF
531      (2) Activate, Deactivate flows support in external RAN NSSMF for option 2
532      (3) Bug fixes/enhancements of carryover test cases from Istanbul release
533
534 - **OOF**: OOF component has an impact for the requirement below:
535      (1) NSI/NSSI Selection enhancements based on resource occupancy levels
536
537 - **DCAE**: The requirements below are identified for Jakarta release and have impacts in DCAE component:
538      (1) Slice selection taking into consideration of resource occupancy levels
539      (2) CPS integration in closed loop – This was done in I-release. Expecting minor enhancements in Slice Analysis MS once after the other components impacts w.r.t CPS integration and E2E testing are completed.
540      (3) IBN based Closed loop for Network Slicing - This will have impact in E2E Slicing closed loop and TN Slicing closed loop.
541
542 - **CCSDK**: The requirements below are identified for network slicing use case in Jakarta release and have impacts in CCSDK component. Most of these requirements fall under the category of CPS integration.
543       (1) Optimizing cm-handle registration with CPS-DMI Plugin to upload yang model
544       (2) CPS Integration with SDN-R for RAN Slice allocate and reconfigure scenarios
545       (3) CPS Integration Stabilization - RAN Slice activate/deactivate and terminate scenarios
546       (4) CSIT for RAN slicing
547
548 Jakarta Release - Functional Test cases
549 ---------------------------------------
550 The functional testing of this use case covers CSMF/NSMF, RAN/CN/TN NSSMFs and Closed Loop functionality. Test cases are classified into 5 tracks: E2E network slicing, RAN NSSMF, TN NSSMF, Closed Loop and carryover testing. Details of the test cases can be found at: `E2E Network Slicing Tests for Jakarta Release <https://wiki.onap.org/display/DW/E2E+Network+Slicing+Integration+Tests+for+Jakarta+Release>`_ and its child wiki pages.
551
552 Jakarta Release - Operation Guidance
553 ------------------------------------
554 The setup and operation details for E2E network slicing use case are available at `User Operation Guidance - Jakarta Release <https://wiki.onap.org/display/DW/User+Operation+Guidance+-+Jakarta+Release>`_.
555
556 Jakarta Release - Known issues and Solutions
557 --------------------------------------------
558 Details of up to date manual configurations, known issues, solutions and work-arounds can be found in the following wiki page: `Jakarta Release - Issues and Solutions <https://wiki.onap.org/display/DW/Jakarta+Release+-+Issues+and+Solutions>`_.