From 14517e43710791fc360e995035c8dcbd6c488166 Mon Sep 17 00:00:00 2001 From: GuangrongFu Date: Tue, 22 Mar 2022 11:16:15 +0800 Subject: Updated the docs Issue-ID: HOLMES-522 Signed-off-by: GuangrongFu Change-Id: I9e135d206c171fe3d3d91e5f1f1de90959d60c79 --- docs/platform/architecture.rst | 2 +- docs/platform/configuration.rst | 2 +- docs/platform/consumedapis.rst | 2 +- docs/platform/human-interfaces.rst | 2 +- docs/platform/installation.rst | 14 +++++---- docs/platform/log-and-diagnostic-info.rst | 2 +- docs/release-notes.rst | 47 +++++++++++++++++++++++++++++++ 7 files changed, 60 insertions(+), 11 deletions(-) diff --git a/docs/platform/architecture.rst b/docs/platform/architecture.rst index 0a5ed6c..e5d63e4 100644 --- a/docs/platform/architecture.rst +++ b/docs/platform/architecture.rst @@ -5,7 +5,7 @@ Holmes Architecture ------------------- -Basically, Holmes itself is an independent component in ONAP, which means it could be deployed as an ONAP-level component. In the Istanbul 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. +Basically, Holmes itself is an independent component in ONAP, which means it could be deployed as an ONAP-level component. In the Jakarta 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 diff --git a/docs/platform/configuration.rst b/docs/platform/configuration.rst index fd01c02..7bbcf05 100644 --- a/docs/platform/configuration.rst +++ b/docs/platform/configuration.rst @@ -4,5 +4,5 @@ Configuration ------------- -No machanism for customized configurtions is provided in the Istanbul release. Such functionalities will be provided in the future if necessary. +No machanism for customized configurtions is provided in the Jakarta release. Such functionalities will be provided in the future if necessary. diff --git a/docs/platform/consumedapis.rst b/docs/platform/consumedapis.rst index 640deef..338dab0 100644 --- a/docs/platform/consumedapis.rst +++ b/docs/platform/consumedapis.rst @@ -4,7 +4,7 @@ Consumed APIs ------------- -In the Istanbul release, Holmes mainly depends on the APIs provided by DCAE, A&AI, DMaaP and MSB. +In the Jakarta release, Holmes mainly depends on the APIs provided by DCAE, A&AI, DMaaP and MSB. DCAE ^^^^ diff --git a/docs/platform/human-interfaces.rst b/docs/platform/human-interfaces.rst index 8e74506..3111c08 100644 --- a/docs/platform/human-interfaces.rst +++ b/docs/platform/human-interfaces.rst @@ -7,7 +7,7 @@ Human Interfaces Target Users ^^^^^^^^^^^^ -The human interfaces provided in the Istanbul release by Holmes is intended for the developers rather than the end users. +The human interfaces provided in the Jakarta release by Holmes is intended for the developers rather than the end users. Interface Type ^^^^^^^^^^^^^^ diff --git a/docs/platform/installation.rst b/docs/platform/installation.rst index c6550f9..dad9cfd 100644 --- a/docs/platform/installation.rst +++ b/docs/platform/installation.rst @@ -4,9 +4,11 @@ Installation ------------ -In the Istanbul release, Holmes is deployed as an analytic application by the DCAE controller. So the users do not have to install it on their own. +In the Jakarta release, Holmes could either be deployed as an analytics application of DCAE along with the whole ONAP or be deployed in a standalone mode for the sake of saving resources. -In case the users want to deploy Holmes independently, the steps for the installation is as follows. +If a user wants to deploy Holmes using Helm, please refer to the OOM manual for help. + +In case a user want to deploy Holmes independently, the steps for the installation is as follows. Prerequisites ^^^^^^^^^^^^^ @@ -21,14 +23,14 @@ Steps #. Start the rule management module of Holmes using the command below: - ``sudo docker run --name holmes-rule-management -p 9101:9101 -p 9104:9104 -p 9201:9201 -d -e URL_JDBC=$DB_IP -e MSB_IAG_SERVICE_HOST=$MSB_IAG_IP -e MSB_IAG_SERVICE_PORT=$MSB_IAG_PORT -e TESTING=1 -e HOST_IP=$HOST_IP -e ENABLE_ENCRYPT=false nexus3.onap.org:10001/onap/holmes/rule-management:9.0.0`` + ``sudo docker run --name holmes-rule-management -p 9101:9101 -p 9104:9104 -p 9201:9201 -d -e URL_JDBC=$DB_IP -e MSB_IAG_SERVICE_HOST=$MSB_IAG_IP -e MSB_IAG_SERVICE_PORT=$MSB_IAG_PORT -e HOST_IP=$HOST_IP -e ENABLE_ENCRYPT=false -v $LOCAL_PATH_THAT_STORES_THE_CONFIG_FILES:/opt/hrmrules nexus3.onap.org:10001/onap/holmes/rule-management:10.0.2`` #. Start the engine manamgement module of Holmes using the command below: - ``sudo docker run --name holmes-engine-management -p 9102:9102 -d -e URL_JDBC=$DB_IP -e MSB_IAG_SERVICE_HOST=$MSB_IAG_IP -e MSB_IAG_SERVICE_PORT=MSB_IAG_PORT -e TESTING=1 -e HOST_IP=$HOST_IP -e ENABLE_ENCRYPT=false nexus3.onap.org:10001/onap/holmes/engine-management:9.0.0`` + ``sudo docker run --name holmes-engine-management -p 9102:9102 -d -e URL_JDBC=$DB_IP -e MSB_IAG_SERVICE_HOST=$MSB_IAG_IP -e MSB_IAG_SERVICE_PORT=MSB_IAG_PORT -e HOST_IP=$HOST_IP -e ENABLE_ENCRYPT=false -v $LOCAL_PATH_THAT_STORES_THE_CONFIG_FILES:/opt/hemtopics nexus3.onap.org:10001/onap/holmes/engine-management:10.0.2`` -When the environment variable ``TESTING`` is set to ``1``, it means Holmes is running in the standalone mode. All the interactions between Holmes and other ONAP components are routed by MSB. In order to register Holmes itself to MSB, the users have to specify the IP address of the host using the ``HOST_IP`` variable. Please note that the ``HOST_IP`` should be the IP address of the host, rather than the IP address of the containers (of which the IP address is allocated by the docker daemon). -``ENABLE_ENCRYPT`` specifies whether HTTPS is enabled. When it is set to "false", only the HTTP schema is allowed. Otherwise, only HTTPS is allowed. +All the interactions between Holmes and other ONAP components are routed by MSB. In order to register Holmes itself to MSB, the users have to specify the IP address of the host using the ``HOST_IP`` variable. Please note that the ``HOST_IP`` should be the IP address of the host, rather than the IP address of the containers (of which the IP address is allocated by the docker daemon). +``ENABLE_ENCRYPT`` specifies whether HTTPS is enabled. When it is set to "false", only the HTTP schema is allowed. Otherwise, only HTTPS is allowed. ``LOCAL_PATH_THAT_STORES_THE_CONFIG_FILES`` specifies the place where corresponding configuration files are stored. The configuration files should be organized as `files for the rule management module `_ and `files for the engine management module `_ (only *cfy.json* is needed in the standalone mode). Check the Status of Holmes ^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/platform/log-and-diagnostic-info.rst b/docs/platform/log-and-diagnostic-info.rst index 607ecbc..e588e11 100644 --- a/docs/platform/log-and-diagnostic-info.rst +++ b/docs/platform/log-and-diagnostic-info.rst @@ -4,7 +4,7 @@ Logging & Diagnostic Information --------------------------------- -In the Istanbul release, the logs are kept inside the docker containers, which means that you can get the log information only when the docker is still running. +In the Jakarta release, the logs are kept inside the docker containers, which means that you can get the log information only when the docker is still running. Where to Access Information ^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/release-notes.rst b/docs/release-notes.rst index 704ad6d..6e23807 100644 --- a/docs/release-notes.rst +++ b/docs/release-notes.rst @@ -11,6 +11,53 @@ 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. +Version: 10.0.0 +--------------- + +:Release Date: 2022-05-12 + + +**New Features** + +- `Added support to 7.1 VES data-stream in parallel to 5.4. `_ +- `Removed CBS/consul dependency for application config management to finish DEAE tranformation to support Helm. `_ + +**Bug Fixes** + +- `Engine instance recreating ALARM_INFO table on every restart of pod. `_ +- `Make EN lang as default for other than ZH locale in Holmes UI. `_ +- `Date parsing exceptions in logs after rule-management restart. `_ + +**Known Issues** + +- If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module. +- The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future. + +**Security Issues** + +HOLMES code has been formally scanned during build time using NexusCloud and all critical vulnerabilities have been addressed. + +Quick Links: + +- `HOLMES project page `_ +- `Passing Badge information for HOLMES `_ + + +**Upgrade Notes** + +N/A + + +**Deprecation Notes** + +N/A + + +**Other** + +N/A + + Version: 9.0.0 -------------- -- cgit 1.2.3-korg