diff options
author | elinuxhenrik <henrik.b.andersson@est.tech> | 2018-09-20 13:05:18 +0200 |
---|---|---|
committer | elinuxhenrik <henrik.b.andersson@est.tech> | 2018-09-20 16:33:37 +0200 |
commit | b511dbcfa89872fc3b7f5e2c163d5a93af678c56 (patch) | |
tree | 322106bb62427cfa7d6edb9140defa02d18a90f4 /docs/sections | |
parent | 2648c6dbd01ad46d3979828b8c4eaa5909973c83 (diff) |
Add documentation for Datafile Collector
Change-Id: I247e1b2583e470e75156fc0449e85c0b86a1c8e8
Issue-ID: DCAEGEN2-642
Signed-off-by: elinuxhenrik <henrik.b.andersson@est.tech>
Diffstat (limited to 'docs/sections')
-rw-r--r-- | docs/sections/apis/DFC.rst | 97 | ||||
-rw-r--r-- | docs/sections/images/DFC.png | bin | 0 -> 43468 bytes |
2 files changed, 97 insertions, 0 deletions
diff --git a/docs/sections/apis/DFC.rst b/docs/sections/apis/DFC.rst new file mode 100644 index 00000000..0605f3fa --- /dev/null +++ b/docs/sections/apis/DFC.rst @@ -0,0 +1,97 @@ +============================== +DFC (DataFile Collector) +============================== + +:Date: 2018-09-21 + +.. contents:: + :depth: 3 +.. + +Overview +======== + +DFC will orchestrate the collection of bulk PM data flow: + 1. Subscribes to fileReady DMaaP topic + 2. Collects the file from the xNF + 3. Sends new event to DataRouter with file. + +Introduction +============ + +DFC is delivered as one **Docker container** which hosts application server and can be started by `docker-compose`. + +Functionality +============= +../images/DFC.png + + +Paths +===== + +GET /events/unauthenticated.VES_NOTIFICATION_OUTPUT +----------------------------------------------- + +Description +~~~~~~~~~~~ + +Reads fileReady events from DMaaP (Data Movement as a Platform) + + +Responses +~~~~~~~~~ + ++-----------+-------------------------------------------+ +| HTTP Code | Description | ++===========+===========================================+ +| **200** | successful response | ++-----------+-------------------------------------------+ + + + +POST /publish +-------------------------------------- + +Description +~~~~~~~~~~~ + +Publish the collected file/s as a stream to DataRouter + - file as stream + - compression + - fileFormatType + - fileFormatVersion + + +Responses +~~~~~~~~~ + ++-----------+-------------------------------------------+ +| HTTP Code | Description | ++===========+===========================================+ +| **200** | successful response | ++-----------+-------------------------------------------+ + +Compiling DFC +============= + +Whole project (top level of DFC directory) and each module (sub module directory) can be compiled using +`mvn clean install` command. + +Maven GroupId: +============== + +org.onap.dcaegen2.collectors + +Maven Parent ArtifactId: +======================== + +dcae-collectors + +Maven Children Artifacts: +========================= + +1. datafile-app-server: DFC server +2. datafile-dmaap-client: Contains implementation of DmaaP client +3. datafile-commons: Common code for whole DFC modules + + diff --git a/docs/sections/images/DFC.png b/docs/sections/images/DFC.png Binary files differnew file mode 100644 index 00000000..216f5947 --- /dev/null +++ b/docs/sections/images/DFC.png |