summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorelinuxhenrik <henrik.b.andersson@est.tech>2018-09-20 13:05:18 +0200
committerelinuxhenrik <henrik.b.andersson@est.tech>2018-09-20 16:33:37 +0200
commitb511dbcfa89872fc3b7f5e2c163d5a93af678c56 (patch)
tree322106bb62427cfa7d6edb9140defa02d18a90f4
parent2648c6dbd01ad46d3979828b8c4eaa5909973c83 (diff)
Add documentation for Datafile Collector
Change-Id: I247e1b2583e470e75156fc0449e85c0b86a1c8e8 Issue-ID: DCAEGEN2-642 Signed-off-by: elinuxhenrik <henrik.b.andersson@est.tech>
-rw-r--r--docs/sections/apis/DFC.rst97
-rw-r--r--docs/sections/images/DFC.pngbin0 -> 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
new file mode 100644
index 00000000..216f5947
--- /dev/null
+++ b/docs/sections/images/DFC.png
Binary files differ