Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


The bulk PM feature consists of two main parts:

  • Event-driven bulk transfer of monitoring data from an xNF to ONAP/DCAE. A micro-service will listen for 'FileReady' VES events sent from an xNF via the VES collector. Once files become available the collector micro-service will fetch them using protocol such as FTPES (committed) or HTTPSSFTP. The collected data files are published internally on a DMaaP Data Router (DR) feed.
  • For 3GPP formatted measurement data and for consumers that prefer such data in VES format, an optional 3GPP PM Mapper micro-service is planned that can extract selected measurements from a 3GPP XML file and publish them as VES events on a DMaaP Message Router topic. The mapper receives the files by subscribing to a Data Router feed.(Strech Goal For Casablanca)

Presentations:

Image RemovedImage Added


Development Status

ProjectPTLJIRADescription
DCAE

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyDCAEGEN2-566

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyDCAEGEN2-567

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyDCAEGEN2-564

  1. Develop new file collector micro-service
  2. Develop new 3GPP PM mapper micro-service (stretch goal)
  3. Upgrade VES collector to support VES version 67.0.1 and new updated notification domain (dependency)
DMaaPRamprasad Koya

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyDMAAP-28

  1. Integrate Data Router service (under investigation, not committed)
VNFRQTS

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyVNFRQTS-263

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyVNFRQTS-264

  1. Add general xNF requirements for bulk file transfer mechanism
  2. Add xNF requirements for transfer of bulk PM data in 3GPP format


Testing

Current Status

  1. Testing Blockers

  2. High visibility bugs
  3. Other issues for testing that should be seen at a summary level
  4. Where possible, always include JIRA links

Test contacts:

    Rajendra Jaiswal rajendra.jaiswal@ericsson.com

     Liam Burke liam.burke@ericsson.com

End to End flow to be Tested:  DCAE Data File Collector

End to End flow to be Tested:  DCAE 3GPP PM Mapper

Gliffy Diagram
size500
nameSummary SeqDia Template
pagePin211
version6
Gliffy Diagram
size500
nameSummary SeqDia Template
pagePin2
8






























Test Cases and Status:  DCAE Data File Collector

#Test CaseStatus
1

xNF:  Ensure fileReady event is received from xNF at DCAE VES collector.

Expected outcome: fileReady event received, and meets VES 7.x specification

Status
titleNot yet tested

2

DCAE VES Collector:  Ensure fileReady event is processed and forwarded to

correct topic on

DCAE Message Router.

Expected outcome: fileReady event on correct MR topic

Status
titleNot yet tested

3
DCAE File

DCAE Data File Collector:  Ensure fileReady event is received from DCAE Message Router.

Expected outcome: fileReady event received by Data File Collector

Status
titleNot yet tested

DCAE Data File Collector:  Ensure event is processed and any invalid file entries (i.e. missing or corrupt data) are logged.

Expected outcome: any fileReady event which does not meet VES 7.x specification is logged as invalid event

Status
titleNot yet tested

DCAE Data File Collector:  After succesful event parsing, confirm secure connection to file location is initiated for file retrieval.

Expected outcome: connection to xNF file location contained in the event.

Status
titleNot yet tested

6

DCAE Data File Collector: Confirm that any unsuccessful connection attempts are logged.

Expected outcome: any errors such as authentication failed, destination unreachable, etc. are logged.

Status
titleNot yet tested

7

DCAE Data File Collector:  Ensure that for each new entry in the fileReady event the file is retrieved.

Expected outcome: every file indicated in the fileReady event is retreived from the xNF

Status
titleNot yet tested

8

DCAE Data File Collector: Ensure any files which are not available are logged.

Expected outcome: any errors such as non-existant file (e.g. file removed before retrieval) are logged

Status
titleNot yet tested

9

DCAE Data File Collector: Confirm that in the event a file fails to transfer successfully, retry is initiated.

Expected outcome: Retry is initiated for unsuccessful transfer.

Status
titleNot yet tested

10

DCAE Data File Collector: Confirm that in the event the maximum number of retries is exceeded, an error is logged.

Expected outcome: Error log indicating that the file was not able to retrieved.

Status
titleNot yet tested

611

DCAE Data File Collector:

 

Ensure the connection to xNF is closed.

Expected outcome: Connection to xNF is closed.

Status
titleNot yet tested

712

DCAE Data File Collector:  Ensure the data file(s) retrieved for that processed fileReady event are published

to

.

Expected outcome: Data retrieved is avaialble on correct feed on DMaaP Data Router

.


Status
titleNot yet tested
 

Q:  Should we need separate test cases for validation and error handling scenario?  Or just include in above as exceptions per test case?

Test Cases and Status:  DCAE 3GPP PM Mapper








Test environment requirements for above test cases:

  • xNF (or emulator) with at least VES 7.0.1 support for 'fileReady' event in notifcation domain.
    • E.g. xNF able to produce data files and send VES fileReady events,
    • E.g. xNF emulator able to produce 'fileReady' notification events including updated events, or a series or predefined VES events at periodic intervals.
  • xNF (or separate) ftpes capable server.
  • sample data files for collection. E.g. 3gpp PM files
  • Test environment reqs:
    • DMaaP R3, at minimum need DR running and configured for Bulk PM support
    • DCAE R3, MR with support for VES 7.x spec
    • DCAE R3, Data File Collector installed and configured
    • xNF instantiated at ONAP, e.g. in A&AI



End-to-End feature integration : To be Tested

Gliffy Diagram
size600
nameBulk PM e2e
pagePin2

End-to-End feature integration: 

Test cases (tbd) to test end-to-end feature interaction for PnP, Bulk PM (File collector + Mapper), closed loop (e.g. TCA triggered on specific PM counter in the bulk data) and action performed.

#Test CaseStatus
1

Ensure that the 'FileReady' VES event is sent from the simulated xNF via the VES collector and is received by Data File Collector.

Status
colourGreen
titleNot yet tested

2

Status
titleNot yet tested

3

Status
titleNot yet tested

DONE

2Ensure that the Data File Collector starts to download the xml PM file(s) from the simulated xNF once it receives the 'FileReady' VES event via the VES collector.

Status
colourGreen
titleDONE

3Ensure that the PM xml file(s) are published to the Data Router.

Status
colourGreen
titleDONE

4Ensure that the File Consumer is able to subscribe and consume the PM file(s) from the Data Router.

Status
colourGreen
titleDONE

5Ensure that a simulated File Consumer is able to subscribe and consume the PM file(s) from the Data Router.

Status
colourGreen
titleDONE

6Verify 3GPP PM Mapper subscribes to feed on the Data Router and maps the PM xml file onto the Message Router as a VES Message(s)

Status
titleSTRETCH GOAL


Test environment requirements for above test cases:

  • sample data file(s) available on simulated xNF.
  • Test environment reqs:
    • DMaaP R3, at minimum need DR running and configured for Bulk PM support
    • Docker images for VES Collector, Message Outer, Data File Collector, Data Router

Status
titleNot yet tested
 

Status
titleNot yet tested
 

6

Status
titleNot yet tested

7
Status
titleNot yet tested