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 SFTP. 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:


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 7.0.1 and 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

Gliffy Diagram
size500
nameSummary SeqDia Template
pagePin1011
version8

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

Gliffy Diagramsize500nameSummary SeqDia TemplatepagePin10

E2E Sunny Day Scenario Sequence Diagram

Gliffy Diagram
name
size600
5G E2E
pagePin4






























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 DCAE Message Router.

Expected outcome: fileReady event on correct MR topic

Status
titleNot yet tested

3

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

11

DCAE Data File Collector: Ensure the connection to xNF is closed.

Expected outcome: Connection to xNF is closed.

Status
titleNot yet tested

12

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

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

Status
titleNot yet tested








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

Test Cases and Status:  DCAE 3GPP PM Mapper

#Test CaseStatus1

DMaaP DR: Confirm that bulk data is available on expected DR feed.

Expected outcome:

Status
titleNot yet tested

2

DCAE 3GPP PM Mapper: Confirm that DR client (mapper) is able to retrieve data.

Expected outcome:

Status
titleNot yet tested

3

DCAE 3GPP PM Mapper: Confirm that mapper can validate the data using schema (e.g. 3gpp xml format).

Expected outcome:

Status
titleNot yet tested

DCAE 3GPP PM Mapper: Confirm any file validation errors are logged.

Expected outcome: Any data file validation

Status
titleNot yet tested
 

DCAE 3GPP PM Mapper: Confirm that mapper creates expected VES PM events for the mapped data.

Expected outcome: PM events are created per 3GPP PM Mapper configuration from the input data.

Status
titleNot yet tested
 

6

DCAE 3GPP PM Mapper: Confirm that any mapping errors are logged.

Expected outcome: Log entries for any mapping errors.

Status
titleNot yet tested

7

DCAE 3GPP PM Mapper: Confirm that mapped events are forwarded on DCAE Message Router.

Expected outcome: PM events on correct MR topic.

Status
titleNot yet tested
 



End-to-End feature integration : To be Tested

Gliffy Diagram
size600
nameBulk PM e2e
pagePin2

Test environment requirements for above test cases:

  • sample data files available on DmaaP DR
    • e.g. 3GPP PM files used in DCAE Data File Collector testing, or equivalent available in DR
  • Test environment reqs:
    • DMaaP R3, at minimum need DR running and configured for Bulk PM support
    • DCAE 3GPP PM Mapper installed and configured for 3GPP data handling
      • i.e. configured for 3GPP PM parsing and event creation
    • xNF instantiated at ONAP, e.g. in A&AI

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
titleDONE

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
titleNot yet testedSTRETCH 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