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. (committed goal)
- 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 (stretch goal)
Deployment:
Test environment requirements for above test cases:
- xNF simulator for test cases: ftpes capable server.
- with VES 6.x support for 'fileReady' event.
- 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.
- sample data files for collection. E.g. 3gpp PM files
- DMaaP R3, at minimum need DR running and configured for Bulk PM support
- DCAE R3, MR with support for VES 6.x spec
- DCAE R3, Data File Collector installed and configured
Use Case preconditions:
- xNF instantiated at ONAP, e.g. in A&AI
DCAE Data File Collector Sequence Diagram
DCAE Data File Collector Test cases and Status
| # | Test Case | Status |
|---|---|---|
| 1 | xNF: Ensure fileReady event is received from xNF at DCAE VES collector. Expected outcome: fileReady event received, and meets VES 6.x specification | NOT 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 | NOT 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 | NOT YET TESTED |
4 | 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 6.x specification is logged as invalid event | NOT YET TESTED |
| 5 | 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. | NOT 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. | NOT 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 | NOT 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 | NOT 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. | NOT 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. | NOT YET TESTED |
| 11 | DCAE Data File Collector: Ensure the connection to xNF is closed. Expected outcome: Connection to xNF is closed. | NOT 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 | NOT YET TESTED |
E2E Sequence Diagram
End-to-End feature integration Testcases for:
| # | Test Case | Status |
|---|---|---|
| 1 | Ensure that the 'FileReady' VES event is sent from the simulated xNF via the VES collector and is received by Data File Collector. | NOT YET TESTED |
| 2 | Ensure 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. | NOT YET TESTED |
| 3 | Ensure that the PM xml file(s) are published to the Data Router. | NOT YET TESTED |
| 4 | Ensure that the File Consumer simulator is able to subscribe and consume the PM file(s) from the Data Router. | NOT YET TESTED |