From 094373650f9c7ed2c4ff599b9fd0351661456bed Mon Sep 17 00:00:00 2001 From: Guangrong Fu Date: Tue, 10 Oct 2017 10:14:05 +0800 Subject: Add New Documents Change-Id: I7f5eb4b89414957cc353da37d1d342ebdfd5d43a Issue-ID: HOLMES-66 Signed-off-by: Guangrong Fu --- docs/index.rst | 12 ++------ docs/offeredapis.rst | 10 ------- docs/platform/administration.rst | 15 ++++++++++ docs/platform/architecture.rst | 32 +++++++++++++++++++++ docs/platform/configuration.rst | 8 ++++++ docs/platform/consumedapis.rst | 7 +++++ docs/platform/delivery.rst | 9 ++++++ docs/platform/human-interfaces.rst | 15 ++++++++++ docs/platform/images/holmes-architecture.png | Bin 0 -> 17965 bytes .../images/overall-architecture-in-onap.png | Bin 0 -> 43459 bytes docs/platform/index.rst | 18 ++++++++++++ docs/platform/installation.rst | 5 ++++ docs/platform/log-and-diagnostic-info.rst | 14 +++++++++ docs/platform/offeredapis.rst | 10 +++++++ docs/release-notes/bug-fixes.rst | 4 +++ docs/release-notes/known-issues.rst | 4 +++ docs/release-notes/new-features.rst | 4 +++ docs/release-notes/security-issues.rst | 4 +++ docs/release-notes/upgrade-notes.rst | 4 +++ 19 files changed, 156 insertions(+), 19 deletions(-) delete mode 100644 docs/offeredapis.rst create mode 100644 docs/platform/administration.rst create mode 100644 docs/platform/architecture.rst create mode 100644 docs/platform/configuration.rst create mode 100644 docs/platform/consumedapis.rst create mode 100644 docs/platform/delivery.rst create mode 100644 docs/platform/human-interfaces.rst create mode 100644 docs/platform/images/holmes-architecture.png create mode 100644 docs/platform/images/overall-architecture-in-onap.png create mode 100644 docs/platform/index.rst create mode 100644 docs/platform/installation.rst create mode 100644 docs/platform/log-and-diagnostic-info.rst create mode 100644 docs/platform/offeredapis.rst create mode 100644 docs/release-notes/bug-fixes.rst create mode 100644 docs/release-notes/known-issues.rst create mode 100644 docs/release-notes/new-features.rst create mode 100644 docs/release-notes/security-issues.rst create mode 100644 docs/release-notes/upgrade-notes.rst diff --git a/docs/index.rst b/docs/index.rst index c7887dd..692003c 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -3,18 +3,12 @@ Holmes ------------------------------------------------ -Holmes provides alarm correlation and analysis for Telecom cloud infrastructure and services, including hosts, vims, VNFs and NSs. Holmes aims to find the root reason which causes the failure or degradation of services by digging into the ocean of events collected from different levels of the Telecom cloud. - -Holmes comprises three modules: the rule management module, the engine management module and the data source adapter. - -- Holmes - - Rule Management Module - - Engine Management Module - - Data Source Adapter +This document is aimed to give the users some brief introductions on Holmes from different aspects. The users could find useful information, e.g. the architecuture, the APIs and the installation steps, etc. as well as the release notes of Holmes in this document. .. toctree:: :maxdepth: 1 - offeredapis.rst + platform/index.rst + release-notes/index.rst diff --git a/docs/offeredapis.rst b/docs/offeredapis.rst deleted file mode 100644 index 41142ed..0000000 --- a/docs/offeredapis.rst +++ /dev/null @@ -1,10 +0,0 @@ -Holmes Rule Management Component Offered APIs -================================== -The rule management module provides the following APIs. - -* Rule Creation -* Rule Update -* Rule Query -* Rule Deletion - -.. swaggerv2doc:: ../rulemgt/src/main/resources/swagger.json diff --git a/docs/platform/administration.rst b/docs/platform/administration.rst new file mode 100644 index 0000000..a32790f --- /dev/null +++ b/docs/platform/administration.rst @@ -0,0 +1,15 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + + +Administration +-------------- + +Processes +^^^^^^^^^ +* Process 1 +* Process 2 + +Actions +^^^^^^^ +* Action X +* Action Y \ No newline at end of file diff --git a/docs/platform/architecture.rst b/docs/platform/architecture.rst new file mode 100644 index 0000000..2fca78b --- /dev/null +++ b/docs/platform/architecture.rst @@ -0,0 +1,32 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + + +Architecture +------------ + +Holmes comprises three modules: the rule management module, the engine management module and the data source adapter. + +- Holmes + - Rule Management Module + - Engine Management Module + - Data Source Adapter + +ONAP-level Architecture +^^^^^^^^^^^^^^^^^^^^^^^ + +Basically, Holmes itself is an independent component in ONAP, which means it could be deployed as an ONAP-level component. In the Amsterdam release, Holmes is more generally a DCAE analytic application. It is deployed by DCAE and run as an analytic application on top of it. Also, it could be considered as a filter of the Policy component because it reduces the number of the input messages of Policy. + +.. image:: images/overall-architecture-in-onap.png + +Holmes Architecture +^^^^^^^^^^^^^^^^^^^ + +Take a deep dive into Holmes, we could see it mainly consists of three modules, which are the rule management module, the engine management module and the data source adapter module respectively. + +The rule management module provides interfaces for the operations (e.g. creating, updating and deleting) on the rules. + +The data source adapter consists of subscribers and publishers, which are used to convert the data format into the one that could be digested by Holmes and vice versa. + +The engine management module is the core of Holmes. All the rules are deployed here. When alarms gets into Holmes, they will be pushed into the Drools engine and analyzed by the enabled rules one after another. When processing the alarms, a couple of attributes, such as the alarm name, the occurrence time of the alarm and so on, are utilized. Also, the topological information from A&AI is used in combination of the alarm attributes. After the root cause is identified, it will be converted into a control loop event and published to a specific DMaaP topic which is subscribed to by the Policy component. + +.. image:: images/holmes-architecture.png diff --git a/docs/platform/configuration.rst b/docs/platform/configuration.rst new file mode 100644 index 0000000..cedb443 --- /dev/null +++ b/docs/platform/configuration.rst @@ -0,0 +1,8 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + + +Configuration +------------- + +No machanism for customized configurtions is provided in the Amsterdam release. Such functionalities will be provided in the future if necessary. + diff --git a/docs/platform/consumedapis.rst b/docs/platform/consumedapis.rst new file mode 100644 index 0000000..f6eebb0 --- /dev/null +++ b/docs/platform/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 +------------- + +References to APIs offered by other components \ No newline at end of file diff --git a/docs/platform/delivery.rst b/docs/platform/delivery.rst new file mode 100644 index 0000000..27b3770 --- /dev/null +++ b/docs/platform/delivery.rst @@ -0,0 +1,9 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + + +Delivery +-------- + +Describe how functions are packaged into run-time components. For some components a block diagram may be useful. + +**TO BE DONE** \ No newline at end of file diff --git a/docs/platform/human-interfaces.rst b/docs/platform/human-interfaces.rst new file mode 100644 index 0000000..e8501d0 --- /dev/null +++ b/docs/platform/human-interfaces.rst @@ -0,0 +1,15 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Human Interfaces +---------------- +Provide info on the targeted user, interface types, ports/protocols to access, etc. + +Target Users +^^^^^^^^^^^^ + +Interface Type +^^^^^^^^^^^^^^ + +Access +^^^^^^ \ No newline at end of file diff --git a/docs/platform/images/holmes-architecture.png b/docs/platform/images/holmes-architecture.png new file mode 100644 index 0000000..b2bd2a9 Binary files /dev/null and b/docs/platform/images/holmes-architecture.png differ diff --git a/docs/platform/images/overall-architecture-in-onap.png b/docs/platform/images/overall-architecture-in-onap.png new file mode 100644 index 0000000..22c8227 Binary files /dev/null and b/docs/platform/images/overall-architecture-in-onap.png differ diff --git a/docs/platform/index.rst b/docs/platform/index.rst new file mode 100644 index 0000000..19742bb --- /dev/null +++ b/docs/platform/index.rst @@ -0,0 +1,18 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Holmes +------------------------------------------------ + +Holmes provides alarm correlation and analysis for Telecom cloud infrastructure and services, including hosts, vims, VNFs and NSs. Holmes aims to find the root reason which causes the failure or degradation of services by digging into the ocean of events collected from different levels of the Telecom cloud. + +.. toctree:: + :maxdepth: 1 + + architecture.rst + offeredapis.rst + delivery.rst + log-and-diagnostic-info.rst + installation.rst + configuration.rst + administration.rst + human-interfaces.rst \ No newline at end of file diff --git a/docs/platform/installation.rst b/docs/platform/installation.rst new file mode 100644 index 0000000..7926680 --- /dev/null +++ b/docs/platform/installation.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + + +Installation +------------ diff --git a/docs/platform/log-and-diagnostic-info.rst b/docs/platform/log-and-diagnostic-info.rst new file mode 100644 index 0000000..4561eab --- /dev/null +++ b/docs/platform/log-and-diagnostic-info.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 + +Logging & Diagnostic Information + + +Description of how to interact with and diagnose problems with the components as delivered. + +Where to Access Information +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +Error / Warning Messages +^^^^^^^^^^^^^^^^^^^^^^^^ \ No newline at end of file diff --git a/docs/platform/offeredapis.rst b/docs/platform/offeredapis.rst new file mode 100644 index 0000000..41142ed --- /dev/null +++ b/docs/platform/offeredapis.rst @@ -0,0 +1,10 @@ +Holmes Rule Management Component Offered APIs +================================== +The rule management module provides the following APIs. + +* Rule Creation +* Rule Update +* Rule Query +* Rule Deletion + +.. swaggerv2doc:: ../rulemgt/src/main/resources/swagger.json diff --git a/docs/release-notes/bug-fixes.rst b/docs/release-notes/bug-fixes.rst new file mode 100644 index 0000000..4dc09fc --- /dev/null +++ b/docs/release-notes/bug-fixes.rst @@ -0,0 +1,4 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Bug Fixes +--------- diff --git a/docs/release-notes/known-issues.rst b/docs/release-notes/known-issues.rst new file mode 100644 index 0000000..f4341d7 --- /dev/null +++ b/docs/release-notes/known-issues.rst @@ -0,0 +1,4 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Known Issues +------------ diff --git a/docs/release-notes/new-features.rst b/docs/release-notes/new-features.rst new file mode 100644 index 0000000..f548910 --- /dev/null +++ b/docs/release-notes/new-features.rst @@ -0,0 +1,4 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +New Features +------------ diff --git a/docs/release-notes/security-issues.rst b/docs/release-notes/security-issues.rst new file mode 100644 index 0000000..3a6cd9e --- /dev/null +++ b/docs/release-notes/security-issues.rst @@ -0,0 +1,4 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Security Issues +--------------- diff --git a/docs/release-notes/upgrade-notes.rst b/docs/release-notes/upgrade-notes.rst new file mode 100644 index 0000000..29e67e5 --- /dev/null +++ b/docs/release-notes/upgrade-notes.rst @@ -0,0 +1,4 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Upgrade Notes +------------- -- cgit 1.2.3-korg