From 8dde0cc7824e32f1a829b1528fa0e61a5707098f Mon Sep 17 00:00:00 2001
From: Emmett Cox <emmett.cox@ericsson.com>
Date: Mon, 17 Sep 2018 10:25:09 +0100
Subject: [PATCH] User guide documentation for data router

Change-Id: If28014e4f937c9036e22f2db7599fd8568f0c13f
Signed-off-by: Emmett Cox <emmett.cox@ericsson.com>
Issue-ID: DMAAP-552
---
 docs/data-router/DataRouterUserGuide.rst |  25 ++++++++++++++++++++++++
 docs/data-router/administration.rst      |  14 ++++++++++++++
 docs/data-router/architecture.rst        |  25 ++++++++++++++++++++++++
 docs/data-router/configuration.rst       |   7 +++++++
 docs/data-router/consumedapis.rst        |   7 +++++++
 docs/data-router/data-router.rst         |   7 ++++++-
 docs/data-router/delivery.rst            |  32 +++++++++++++++++++++++++++++++
 docs/data-router/dr_arch.png             | Bin 0 -> 28300 bytes
 docs/data-router/humaninterfaces.rst     |  10 ++++++++++
 docs/data-router/logging.rst             |  25 ++++++++++++++++++++++++
 docs/data-router/release-notes.rst       |  29 ++++++++++++++++++++++++++++
 docs/index.rst                           |  19 +++++++++++++-----
 12 files changed, 194 insertions(+), 6 deletions(-)
 create mode 100644 docs/data-router/DataRouterUserGuide.rst
 create mode 100644 docs/data-router/administration.rst
 create mode 100644 docs/data-router/architecture.rst
 create mode 100644 docs/data-router/configuration.rst
 create mode 100644 docs/data-router/consumedapis.rst
 create mode 100644 docs/data-router/delivery.rst
 create mode 100644 docs/data-router/dr_arch.png
 create mode 100644 docs/data-router/humaninterfaces.rst
 create mode 100644 docs/data-router/logging.rst
 create mode 100644 docs/data-router/release-notes.rst

diff --git a/docs/data-router/DataRouterUserGuide.rst b/docs/data-router/DataRouterUserGuide.rst
new file mode 100644
index 00000000..8f7b9ef1
--- /dev/null
+++ b/docs/data-router/DataRouterUserGuide.rst
@@ -0,0 +1,25 @@
+===========================
+Data Router (DR) User Guide
+===========================
+
+Standalone Mode
+---------------
+
+Installation
+============
+
+1. Find the datarouter project on the gerrit website: https://gerrit.onap.org/r/#/admin/projects/dmaap/datarouter
+
+2. Clone the repo onto your server using the clone command found on the datarouter page on gerrit.
+
+3. cd into the docker-compose directory and run docker-compose up.
+
+Configurations
+==============
+
+Using the Data Router
+---------------------
+
+For information on how to use the Data Router refer to the Data Router API guide at:
+
+    :ref:`data_router_api_guide`
\ No newline at end of file
diff --git a/docs/data-router/administration.rst b/docs/data-router/administration.rst
new file mode 100644
index 00000000..b050a1fe
--- /dev/null
+++ b/docs/data-router/administration.rst
@@ -0,0 +1,14 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Administration
+==============
+
+
+Processes
+---------
+NA
+
+Actions
+-------
+NA
diff --git a/docs/data-router/architecture.rst b/docs/data-router/architecture.rst
new file mode 100644
index 00000000..b18f7bb3
--- /dev/null
+++ b/docs/data-router/architecture.rst
@@ -0,0 +1,25 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Architecture
+============
+
+
+Capabilities
+------------
+Data Router is a RESTful web service used for the transfer of data across networks any larger than a Message Router message (> 1Mb).
+
+Usage Scenarios
+---------------
+    Data Router endpoints are used to create/view/delete Feeds, Subscribers and Published files. Clients can use the Data Router endpoints
+    to publish a file to a feed and subscribe to this feed to receive the file.
+
+Interactions
+------------
+Data Router REST service uses the Data Router API to allow users to publish to and subscribe to a feed, in order to send and receive files.
+
+
+
+   |image0|
+
+   .. |image0| image:: dr_arch.png
diff --git a/docs/data-router/configuration.rst b/docs/data-router/configuration.rst
new file mode 100644
index 00000000..2a7096a1
--- /dev/null
+++ b/docs/data-router/configuration.rst
@@ -0,0 +1,7 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Configuration
+=============
+
+NA
\ No newline at end of file
diff --git a/docs/data-router/consumedapis.rst b/docs/data-router/consumedapis.rst
new file mode 100644
index 00000000..aa1a8bd1
--- /dev/null
+++ b/docs/data-router/consumedapis.rst
@@ -0,0 +1,7 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Consumed APIs
+=============
+
+Data Router does not consume any API
diff --git a/docs/data-router/data-router.rst b/docs/data-router/data-router.rst
index ecce2096..aaee3851 100755
--- a/docs/data-router/data-router.rst
+++ b/docs/data-router/data-router.rst
@@ -1,10 +1,15 @@
+.. _data_router_api_guide:
+
 ==========================
 Data Router (DR) API Guide
 ==========================
 Introduction
 ------------
 
-The DataRouter(DR) provisioning API is an HTTPS-based, REST-like API for creating and managing DR feeds and subscriptions. The Data Routing System project is intended to provide a common framework by which data producers can make data available to data consumers and a way for potential consumers to find feeds with the data they require.
+The DataRouter(DR) provisioning API is an HTTPS-based, REST-like API for creating and managing DR feeds
+and subscriptions. The Data Routing System project is intended to provide a common framework by which
+data producers can make data available to data consumers and a way for potential consumers to find feeds
+with the data they require.
 
 
 HTTP Service APIs
diff --git a/docs/data-router/delivery.rst b/docs/data-router/delivery.rst
new file mode 100644
index 00000000..775841a4
--- /dev/null
+++ b/docs/data-router/delivery.rst
@@ -0,0 +1,32 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Delivery
+==============
+
+Data Router is comprised of a datarouter-provisioning container, a datarouter-node container and a mariadb container.
+
+.. blockdiag::
+
+
+   blockdiag layers {
+   orientation = portrait
+   MARIADB -> DR-PROV;
+   DR-PROV -> DR-NODE;
+   group l1 {
+	color = blue;
+	label = "dr-prov Container";
+	DR-PROV;
+	}
+   group l2 {
+	color = yellow;
+	label = "dr-node Container";
+	DR-NODE;
+	}
+   group l3 {
+	color = orange;
+	label = "MariaDb Container";
+	MARIADB;
+	}
+
+   }
diff --git a/docs/data-router/dr_arch.png b/docs/data-router/dr_arch.png
new file mode 100644
index 0000000000000000000000000000000000000000..1655edad3da7ff1b41392cf835c64585dc829191
GIT binary patch
literal 28300
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
Hh4uXpOg&+r

literal 0
HcmV?d00001

diff --git a/docs/data-router/humaninterfaces.rst b/docs/data-router/humaninterfaces.rst
new file mode 100644
index 00000000..71a2b730
--- /dev/null
+++ b/docs/data-router/humaninterfaces.rst
@@ -0,0 +1,10 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Human Interfaces
+================
+
+Data Router does not have human interfaces
+
+
+
diff --git a/docs/data-router/logging.rst b/docs/data-router/logging.rst
new file mode 100644
index 00000000..ac6aa95c
--- /dev/null
+++ b/docs/data-router/logging.rst
@@ -0,0 +1,25 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Logging
+=======
+
+
+Where to Access Information
+---------------------------
+Data Router uses logback framework to generate logs.
+
+Error / Warning Messages
+------------------------
+Currently Data Router does not have any unique error codes. However the following are the common HTTP error codes that
+could possibly occur in Data Router:
+
+    OK = 200 : The normal response from a successful update or get of a feed or subscription
+    CREATED = 201 : the normal response from successfully creating or subscribing to a feed.
+    NO_CONTENT = 204 : the normal response from a successful publish attempt and on successfully deleting a feed or subscription
+    MOVED_PERMANENTLY = 301 :the normal redirect response from prov to a publisher
+    BAD_REQUEST = 400: Usually indicates that either Json object in request body is incorrect in some way, or an Invalid parameter value was included in query string.
+    UNAUTHORIZED = 401 : Usually indicated either request was missing Authorization header, or indicates incorrect Username/password credentials
+    FORBIDDEN = 403 : Usually indicates the request originated from an unauthorized IP address, or that a client certificate was not a part of authorized list.
+    NOT_FOUND = 404 : Usually indicates an incorrect URI
+    METHOD_NOT_ALLOWED = 405 : Indicates an HTTP method is not accepted for given URI
\ No newline at end of file
diff --git a/docs/data-router/release-notes.rst b/docs/data-router/release-notes.rst
new file mode 100644
index 00000000..f69ea2c8
--- /dev/null
+++ b/docs/data-router/release-notes.rst
@@ -0,0 +1,29 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Release-notes
+==============
+
+Version: 1.0.1
+--------------
+
+:Release Date: 2018-09-20
+
+
+New Features:
+
+ - Implements a RESTful HTTPS API for creating feeds to publish files to and subscribe to,
+   as well as perform CRUD operations on these feeds.
+ - Implements a RESTful HTTPS API for subscribing to feeds and perform CRUD operations on these subscriptions.
+ - Implements a RESTful HTTPS API for publishing to feeds and perform CRUD operations on these published files.
+
+
+
+Bug Fixes
+NA
+
+Known Issues
+NA
+
+Other
+NA
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index f7dae490..99f0f281 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -14,15 +14,24 @@ The DataRouter(DR)provisioning API is an HTTPS-based,REST-like API for creating
 HTTP Service APIs
 ------------------
 
-DMaaP Message Router utilizes an HTTP REST API to service all transactions. HTTP and REST standards are followed so
-clients as varied as CURL, Java applications and even Web Browsers will
-work to interact with the Data Router.
+DMaaP Data Router utilizes an HTTPS REST API to service all transactions. HTTPS and REST standards are followed so
+clients as varied as CURL, Java applications and even Web Browsers will work to interact with the Data Router.
 
 
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 1
    
-   data-router/data-router
+   data-router/data-router.rst
+   data-router/administration.rst
+   data-router/architecture.rst
+   data-router/configuration.rst
+   data-router/consumedapis.rst
+   data-router/DataRouterUserGuide.rst
+   data-router/delivery.rst
+   data-router/humaninterfaces.rst
+   data-router/logging.rst
+   data-router/release-notes.rst
+
 
 
-- 
2.16.6