From 203f4ab5595f9297880196d916a318f1c3df4d11 Mon Sep 17 00:00:00 2001 From: Piotr Marcinkiewicz Date: Fri, 10 Sep 2021 14:20:59 +0200 Subject: Update StndDefined Events Collection page - Cover VES Collector Helm based deployment in documentation Issue-ID: DCAEGEN2-2630 Signed-off-by: Piotr Marcinkiewicz Change-Id: Idd499bf08fe6546a4bac6d209b393633b9b506e2 --- .../services/ves-http/stnd-defined-validation.rst | 84 ++++++++++++++++++---- 1 file changed, 71 insertions(+), 13 deletions(-) diff --git a/docs/sections/services/ves-http/stnd-defined-validation.rst b/docs/sections/services/ves-http/stnd-defined-validation.rst index c9019db8..576b60fc 100644 --- a/docs/sections/services/ves-http/stnd-defined-validation.rst +++ b/docs/sections/services/ves-http/stnd-defined-validation.rst @@ -48,27 +48,27 @@ Format of the schema mapping file is a JSON file with list of mappings, as shown [ { - "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/faultMnS.yaml", - "localURL": "3gpp/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/faultMnS.yaml" + "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/faultMnS.yaml", + "localURL": "3gpp/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/faultMnS.yaml" }, { - "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/heartbeatNtf.yaml", - "localURL": "3gpp/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/heartbeatNtf.yaml" + "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/FileDataReportingMnS.yaml", + "localURL": "3gpp/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/FileDataReportingMnS.yaml" }, { - "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/PerDataFileReportMnS.yaml", - "localURL": "3gpp/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/PerDataFileReportMnS.yaml" + "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/heartbeatNtf.yaml", + "localURL": "3gpp/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/heartbeatNtf.yaml" }, { - "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/provMnS.yaml", - "localURL": "3gpp/rep/sa5/MnS/blob/SA88-Rel16/OpenAPI/provMnS.yaml" + "publicURL": "https://forge.3gpp.org/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/provMnS.yaml", + "localURL": "3gpp/rep/sa5/MnS/blob/Rel-16-SA-91/OpenAPI/provMnS.yaml" } ] -Config maps ------------ +External schema config maps +--------------------------- -The mapping and schemas files content can be changed by editing a proper config map. +The mapping and schema files content can be changed by editing a proper config map. +----------------------------------------------+-----------------------------------------------------------------------------------------------------+ @@ -76,10 +76,11 @@ The mapping and schemas files content can be changed by editing a proper config +==============================================+=====================================================================================================+ | dcae-external-repo-configmap-schema-map | Defines a content of the /opt/app/VESCollector/etc/externalRepo/schema-map.json file. | +----------------------------------------------+-----------------------------------------------------------------------------------------------------+ -| dcae-external-repo-configmap-sa88-rel16 | Defines a content of schemas stored in the /opt/app/VESCollector/etc/externalRepo folder. | +| dcae-external-repo-configmap-sa91-rel16 | Defines a content of schemas stored in the /opt/app/VESCollector/etc/externalRepo folder. | +----------------------------------------------+-----------------------------------------------------------------------------------------------------+ -Config maps are defined in the `OOM `_ repository and installed with dcaegen2 module. +Config maps are defined in the `OOM `_ repository +and are installed with dcaegen2-services module. Properties configuration via Cloudify ------------------------------------- @@ -121,6 +122,63 @@ generate error. | ves_3gpp_performance_assurance_publish_url | Yes | String | http://message-router.onap.svc.cluster.local:3904/events/unauthenticated.SEC_3GPP_PERFORMANCEASSURANCE_OUTPUT | +----------------------------------------------+--------+---------+---------------------------------------------------------------------------------------------------------------+ +Config maps with app properties via Helm +---------------------------------------- + +When deploying VES collector via deacgen2-services Helm chart, application properties can be changed by editing the corresponding config map. + + ++------------------------------------------------------+-----------------------------------------------------------------------------------------------------+ +| Config map name | Description | ++======================================================+=====================================================================================================+ +| dcae-ves-collector-application-config-configmap | Defines a content of the /app-config/application_config.yaml file. | ++------------------------------------------------------+-----------------------------------------------------------------------------------------------------+ +| dcae-ves-collector-filebeat-configmap | Defines a content of the /usr/share/filebeat/filebeat.yml file. | ++------------------------------------------------------+-----------------------------------------------------------------------------------------------------+ + + +Properties configuration via Helm chart overrides +------------------------------------------------- + +Collector.properties content may be overridden when deploying VES Collector via Helm chart. In case of deploying VES using Helm chart, +a config map "dcae-ves-collector-application-config-configmap" with the application_config.yaml file is created. The application_config.yaml +contains properties, that override values from Collector.properties. In order to change any value, it is sufficient to edit the application_config.yaml +in the config map. The VES application frequently reads the configMap content and applies configuration changes. + +The content of "dcae-ves-collector-application-config-configmap" is defined in the values.yaml of the dcae-ves-collector chart +and is installed with dcaegen2-services module. + +The following table shows stndDefined related properties added to VES Collector Helm chart. These properties +represent fields from collector.properties file, but also contain configuration of DMaaP topic URLs used for stndDefined +events routing. + +**NOTE**: Keep in mind that some properties may use relative path. It is relative to default VES Collector context which +is: */opt/app/VESCollector/*. Final path of etc. *collector.externalSchema.schemasLocation* will be: +*/opt/app/VESCollector/etc/externalRepo/*. Setting absolute path to these properties is also acceptable and won't +generate error. + ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| Property name | Type | Default value | ++=============================================================================+=========+===============================================================================================================+ +| collector.externalSchema.checkflag | Integer | 1 | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| collector.externalSchema.mappingFileLocation | String | ./etc/externalRepo/schema-map.json | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| collector.externalSchema.schemasLocation | String | ./etc/externalRepo/ | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| event.externalSchema.schemaRefPath | String | $.event.stndDefinedFields.schemaReference | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| event.externalSchema.stndDefinedDataPath | String | $.event.stndDefinedFields.data | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| streams_publishes.ves-3gpp-fault-supervision.dmaap_info.topic_url | String | http://message-router.onap.svc.cluster.local:3904/events/unauthenticated.SEC_3GPP_FAULTSUPERVISION_OUTPUT | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| streams_publishes.ves-3gpp-provisioning.dmaap_info.topic_url | String | http://message-router.onap.svc.cluster.local:3904/events/unauthenticated.SEC_3GPP_PROVISIONING_OUTPUT | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| streams_publishes.ves-3gpp-heartbeat.dmaap_info.topic_url | String | http://message-router.onap.svc.cluster.local:3904/events/unauthenticated.SEC_3GPP_HEARTBEAT_OUTPUT | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ +| streams_publishes.ves-3gpp-performance-assurance.dmaap_info.topic_url | String | http://message-router.onap.svc.cluster.local:3904/events/unauthenticated.SEC_3GPP_PERFORMANCEASSURANCE_OUTPUT | ++-----------------------------------------------------------------------------+---------+---------------------------------------------------------------------------------------------------------------+ + Validation overview ------------------- -- cgit 1.2.3-korg