summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEkko Chang <ekko.chang@qct.io>2020-03-03 02:20:41 +0000
committerEkko Chang <ekko.chang@qct.io>2020-03-04 09:38:22 +0000
commit97d68942abd217b4f05b38b70df80230ac608873 (patch)
tree4fa31e1638f8b555bfb5aa37ca5632669765e75a
parent729478d078e7570824472d02ff0d4e115cb33144 (diff)
DL-Handler user guid Doc
Issue-ID: DCAEGEN2-2028 Signed-off-by: Ekko Chang <ekko.chang@qct.io> Change-Id: Id3a65a8442497e744040acaf40b241b5672f4c0b
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-dbs-edit.pngbin0 -> 839075 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-dbs.pngbin0 -> 756538 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-design-edit.pngbin0 -> 967020 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-design.pngbin0 -> 722835 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-feeder.pngbin0 -> 694176 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-kafka-edit.pngbin0 -> 862153 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-kafka.pngbin0 -> 705207 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-tools.pngbin0 -> 708093 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-topic-config.pngbin0 -> 865658 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-topic-edit1.pngbin0 -> 922069 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-topic-edit2.pngbin0 -> 783825 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-topic-edit3.pngbin0 -> 860844 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-topic-new.pngbin0 -> 858316 bytes
-rw-r--r--docs/sections/services/datalake-handler/images/adminui-topics.pngbin0 -> 759708 bytes
-rw-r--r--docs/sections/services/datalake-handler/userguide.rst81
15 files changed, 79 insertions, 2 deletions
diff --git a/docs/sections/services/datalake-handler/images/adminui-dbs-edit.png b/docs/sections/services/datalake-handler/images/adminui-dbs-edit.png
new file mode 100644
index 00000000..017aaa7a
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-dbs-edit.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-dbs.png b/docs/sections/services/datalake-handler/images/adminui-dbs.png
new file mode 100644
index 00000000..6c411a8f
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-dbs.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-design-edit.png b/docs/sections/services/datalake-handler/images/adminui-design-edit.png
new file mode 100644
index 00000000..26019845
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-design-edit.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-design.png b/docs/sections/services/datalake-handler/images/adminui-design.png
new file mode 100644
index 00000000..b0904479
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-design.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-feeder.png b/docs/sections/services/datalake-handler/images/adminui-feeder.png
new file mode 100644
index 00000000..26adab2a
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-feeder.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-kafka-edit.png b/docs/sections/services/datalake-handler/images/adminui-kafka-edit.png
new file mode 100644
index 00000000..b48e5128
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-kafka-edit.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-kafka.png b/docs/sections/services/datalake-handler/images/adminui-kafka.png
new file mode 100644
index 00000000..743fb1e6
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-kafka.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-tools.png b/docs/sections/services/datalake-handler/images/adminui-tools.png
new file mode 100644
index 00000000..18a1e18b
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-tools.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-config.png b/docs/sections/services/datalake-handler/images/adminui-topic-config.png
new file mode 100644
index 00000000..d15f075c
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-topic-config.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-edit1.png b/docs/sections/services/datalake-handler/images/adminui-topic-edit1.png
new file mode 100644
index 00000000..81212670
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-topic-edit1.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-edit2.png b/docs/sections/services/datalake-handler/images/adminui-topic-edit2.png
new file mode 100644
index 00000000..145b86d6
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-topic-edit2.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-edit3.png b/docs/sections/services/datalake-handler/images/adminui-topic-edit3.png
new file mode 100644
index 00000000..08cd6be5
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-topic-edit3.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-new.png b/docs/sections/services/datalake-handler/images/adminui-topic-new.png
new file mode 100644
index 00000000..12f8948f
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-topic-new.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/images/adminui-topics.png b/docs/sections/services/datalake-handler/images/adminui-topics.png
new file mode 100644
index 00000000..adb5696c
--- /dev/null
+++ b/docs/sections/services/datalake-handler/images/adminui-topics.png
Binary files differ
diff --git a/docs/sections/services/datalake-handler/userguide.rst b/docs/sections/services/datalake-handler/userguide.rst
index 4a0957f5..b3be9491 100644
--- a/docs/sections/services/datalake-handler/userguide.rst
+++ b/docs/sections/services/datalake-handler/userguide.rst
@@ -1,4 +1,81 @@
Admin UI User Guide
---------------------
-
-To be filled.
+
+Introduction
+~~~~~~~~
+DataLake Admin UI aims to provide a user-friendly dashboard to easily monitor and
+manage DataLake configurations for the involved components, ONAP topics, databases,
+and 3rd-party tools. Please refer to the link to access the Admin UI portal
+via http://datalake-admin-ui:30479
+
+
+DataLake Feeder Management
+******************
+.. image:: ./images/adminui-feeder.png
+Click the "DataLake Feeder" on the menu bar, and the dashboard will show
+the overview DataLake Feeder information, such as the numbers of topics.
+Also, you can enable or disable DataLake Feeder process backend process
+by using the toggle switch.
+
+
+Kafka Management
+******************
+.. image:: ./images/adminui-kafka.png
+Click the "Kafka" on the menu bar, and it provides the kafka resource settings
+including add, modify and delete in the page to fulfill your management demand.
+
+.. image:: ./images/adminui-kafka-edit.png
+You can modify the kafka resource via clicking the card,
+and click the plus button to add a new Kafka resource.
+Then, you will need to fill the required information such as identifying name,
+message router address and zookeeper address, and so on to build it up.
+
+
+Topics Management
+******************
+.. image:: ./images/adminui-topics.png
+.. image:: ./images/adminui-topic-edit1.png
+.. image:: ./images/adminui-topic-edit2.png
+.. image:: ./images/adminui-topic-edit3.png
+The Topic page lists down all the topics which you have been configured
+by topic management. You can edit the topic setting via double click the specific row.
+The setting includes DataLake feeder status - catch the topic or not,
+data format, and the numbers of time to live for the topic.
+And choose one or more Kafka items as topic resource
+and define the databased to store topic info are necessary.
+
+.. image:: ./images/adminui-topic-config.png
+For the default configuration of Topics, you can click the "Default configurations" button
+to do the setting. When you add a new topic, these configurations will be filled into the form automatically.
+
+.. image:: ./images/adminui-topic-new.png
+To add a new topic for the DataLake Feeder, you can click the "plus icon" button
+to catch the data into the 3rd-party database.
+Please be noted that only existing topics in the Kafka can be added.
+
+
+Database Management
+******************
+.. image:: ./images/adminui-dbs.png
+.. image:: ./images/adminui-dbs-edit.png
+In the Database Management page, it allows you to add, modify and delete the database resources
+where the message from topics will be stored.
+DataLake supports a bunch of databases including Couchbase DB, Apache Druid, Elasticsearch, HDFS, and MongoDB.
+
+
+3rd-Party Tools Management
+******************
+.. image:: ./images/adminui-tools.png
+In the Tools page, it allows you to manage the resources of 3rd-party tools for data visualization.
+Currently, DataLake supports two Tools which are Kibana and Apache Superset.
+
+
+3rd-Party Design Tools Management
+******************
+.. image:: ./images/adminui-design.png
+.. image:: ./images/adminui-design-edit.png
+After setting up the 3rd-party tools, you can import the template as the JSON, YAML or other formats
+for data exploration, data visualization and dashboarding. DataLake supports Kibana dashboarding,
+Kibana searching, Kibana visualization, Elasticsearch field mapping template,
+and Apache Druid Kafka indexing service.
+