Docs: Update release notes 09/11409/2
authorJohnKeeney <john.keeney@est.tech>
Fri, 30 Jun 2023 17:08:11 +0000 (18:08 +0100)
committerJohn Keeney <john.keeney@est.tech>
Fri, 30 Jun 2023 18:59:50 +0000 (18:59 +0000)
Issue-ID: NONRTRIC-883
Change-Id: I56903d937913cd4b6d69b7a9d8f8f0daa345dadf
Signed-off-by: JohnKeeney <john.keeney@est.tech>
17 files changed:
datafilecollector/docs/conf.py
datafilecollector/docs/index.rst
datafilecollector/docs/release-notes.rst [new file with mode: 0644]
docs/conf.py
docs/overview.rst
docs/release-notes.rst
influxlogger/docs/conf.py
influxlogger/docs/index.rst
influxlogger/docs/release-notes.rst [new file with mode: 0644]
pm-file-converter/docs/conf.py
pm-file-converter/docs/index.rst
pm-file-converter/docs/overview.rst
pm-file-converter/docs/release-notes.rst [new file with mode: 0644]
pmproducer/docs/conf.py
pmproducer/docs/index.rst
pmproducer/docs/overview.rst
pmproducer/docs/release-notes.rst [new file with mode: 0644]

index bc39c07..57c10f3 100644 (file)
@@ -19,7 +19,7 @@ from docs_conf.conf import *
 
 #branch configuration
 
-branch = 'latest'
+branch = 'h-release'
 
 linkcheck_ignore = [
     'http://localhost.*',
index 4010edb..9acd109 100644 (file)
@@ -12,3 +12,5 @@ Non-RT RIC PM Data File Collector
    ./overview.rst
    ./developer-guide.rst
    ./api-docs.rst
+   ./release-notes.rst
+
diff --git a/datafilecollector/docs/release-notes.rst b/datafilecollector/docs/release-notes.rst
new file mode 100644 (file)
index 0000000..79fbbf3
--- /dev/null
@@ -0,0 +1,46 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2023 Nordix
+
+=============
+Release-Notes
+=============
+
+
+This document provides the release notes for the release of the Non-RT RIC - RAN PM - PM Data File Collector.
+
+Version history Non-RT RIC - RAN PM - PM Data File Collector
+============================================================
+
++------------+----------+------------------+--------------------+
+| **Date**   | **Ver.** | **Author**       | **Comment**        |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+| 2023-06-16 |          | John Keeney      | H Release          |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+
+
+Release Data
+============
+
+H Release
+---------
++-----------------------------+---------------------------------------------------+
+| **Project**                 | Non-RT RIC RAN PM                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Repo/commit-ID**          | nonrtric/plt/ranpm/                               |
+|                             | fbccee5729fb23f3424046c1d122d29f0fec545a          |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release designation**     | H                                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release date**            | 2023-06-16                                        |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Purpose of the delivery** | First release (H) of RAN PM Usecase/Functions     |
+|                             |    nonrtric-plt-ranpm-datafilecollector:1.0.0     |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
index 042ab2b..531d9c2 100644 (file)
@@ -20,7 +20,7 @@
 
 from docs_conf.conf import *
 
-branch = 'latest'
+branch = 'h-release'
 baseurl = 'https://docs.o-ran-sc.org/projects/'
 selfurl = '%s/o-ran-sc-nonrtric-plt-ranpm/en/%s' %(baseurl, branch)
 
index a262bd2..f359337 100644 (file)
@@ -13,7 +13,7 @@ Overview
 ********
 
 The OSC Non-RT RIC provides a high performing, fully scalable end-to-end solution for handling
-PM Mesurements. A PM report (containing aggregated PM measurements over a time interval) is
+PM Measurements. A PM report (containing aggregated PM measurements over a time interval) is
 an XML file. The format is defined by 3GPP (TS 32.432 and 3GPP TS 32.435).
 The files are collected from the RAN and stored. An rApp can subscribe for chosen measurement types from
 measured resources in the network.
@@ -29,14 +29,14 @@ The picture illustrates the components involved.
 * The PM File Converter converts these to a Json format. The structure and the contents
   is the same as the XML format.
 * The PM Producer handles filtering and distribution of PM data to subscribers. These subscribers can be rApps.
-* The Influx Logger stores selected PM mesurements into a time series database.
+* The Influx Logger stores selected PM measurements into a time series database.
 * HTTPS-SERVER is for testing and implements functionality to simulate file transfer from RAN nodes.
 
 The third party products used are:
 
 * Minio object storage, for storing of files.
 * Kafka for transferring of data (not the full PM reports, though)
-* Influx time series database for storing of selected PM mesurements over time.
+* Influx time series database for storing of selected PM measurements over time.
 
 .. image:: ./Components.png
    :width: 500pt
@@ -47,7 +47,7 @@ For more detailed documentation of the components:
 * :doc:`Non-RT RIC - RAN PM - PM File Converter (Documentation site) <pm-file-converter:index>`.
 * :doc:`Non-RT RIC - RAN PM - PM Producer (Documentation site) <pmproducer:index>`.
 * :doc:`Non-RT RIC - RAN PM - Influx Logger (Documentation site) <influxlogger:index>`.
-* `Non-RT RIC - Information Coordinator Service (Documentation site) <https://docs.o-ran-sc.org/projects/o-ran-sc-nonrtric-plt-informationcoordinatorservice/en/latest/>`_.
+* `Non-RT RIC - Information Coordinator Service (Documentation site) <https://docs.o-ran-sc.org/projects/o-ran-sc-nonrtric-plt-informationcoordinatorservice/en/h-release/>`_.
 *  HTTPS-SERVER TBD
 
 *********
@@ -77,7 +77,7 @@ At anytime an rApp can read logged PM data from the Influx database.
 PM Data Subscription
 ********************
 PM measurement data is subscribed by creating an Information Job using the Information Coordination Service (ICS).
-This a subscription broker and is part of what is called Data Managament an Exposure (DME) in O-RAN.
+This a subscription broker and is part of what is called Data Management an Exposure (DME) in O-RAN.
 The ICS makes sure that all data producers gets its data subscriptions (jobs).
 
 In the picture below, an rApp and the Influx Logger are consumers of PM data.
@@ -86,7 +86,7 @@ In the picture below, an rApp and the Influx Logger are consumers of PM data.
    :width: 500pt
 
 The PM Data Influx logger will create a PM data subscription based on a configuration file. An rApp can create
-PM data subscpition. The PM Data producer will deliver received PM measurements according to the subscriptions.
+PM data subscription. The PM Data producer will deliver received PM measurements according to the subscriptions.
 
 The PM Data file collector will fetch all PM measurement files. The PM Data Converted will convert all fetched xml files
 to json. So these does not use any subscriptions.
@@ -96,14 +96,14 @@ PM Subscriber design time dependencies
 **************************************
 
 An rApp uses the ICS API to create and manage the subscription of PM Measurements.
-The API documentation is avaiable in `Non-RT RIC - Information Coordinator Service (Documentation site) <https://docs.o-ran-sc.org/projects/o-ran-sc-nonrtric-plt-informationcoordinatorservice/en/latest/>`_.
+The API documentation is available in `Non-RT RIC - Information Coordinator Service (Doc site) <https://docs.o-ran-sc.org/projects/o-ran-sc-nonrtric-plt-informationcoordinatorservice/en/h-release/>`_.
 
-The schema for the PM Mesaurement information jobs is defined in :doc:`Non-RT RIC - RAN PM - PM Producer (Documentation site) <pmproducer:index>`.
+The schema for the PM Measurement information jobs is defined in :doc:`Non-RT RIC - RAN PM - PM Producer (Documentation <pmproducer:index>`.
 This schema defines parameters used in the subscription (info job) and defines which measurements to subscribe for and on which
 kafka topic the information shall be delivered to.
 
 An application retrieving logged PM data from the Influx database needs to consider how the data is stored (the schema). That is
-defined in :doc:`Non-RT RIC - RAN PM - Influx Logger (Documentation site) <influxlogger:index>`.
+defined in :doc:`Non-RT RIC - RAN PM - Influx Logger (Documentation) <influxlogger:index>`.
 
 .. image:: ./DesignTimeDependencies.png
    :width: 500pt
index cb0c8cd..3f41d62 100644 (file)
@@ -9,6 +9,11 @@ Release-Notes
 
 This document provides the release notes for the release of the Non-RT RIC RAN PM Usecase/Functions.
 
+More detailed Release Notes for individual functions can be found in: 
+* :doc:`Non-RT RIC - RAN PM - PM Data File Collector (Doc site) <datafilecollector:index>`.
+* :doc:`Non-RT RIC - RAN PM - PM File Converter (Doc site) <pm-file-converter:index>`.
+* :doc:`Non-RT RIC - RAN PM - PM Producer (Doc site) <pmproducer:index>`.
+* :doc:`Non-RT RIC - RAN PM - Influx Logger (Doc site) <influxlogger:index>`.
 
 Version history RAN PM Usecase/Functions
 ========================================
@@ -17,29 +22,34 @@ Version history RAN PM Usecase/Functions
 | **Date**   | **Ver.** | **Author**       | **Comment**        |
 |            |          |                  |                    |
 +------------+----------+------------------+--------------------+
-| 2023-04-21 | 0.0.0    | John Keeney      | Started Docs.      |
-|            |          |                  | Remove this row    |
+| 2023-06-16 |          | John Keeney      | H Release          |
+|            |          |                  |                    |
 +------------+----------+------------------+--------------------+
 
 
 Release Data
 ============
 
-H
--
+H Release
+---------
 +-----------------------------+---------------------------------------------------+
 | **Project**                 | Non-RT RIC RAN PM                                 |
 |                             |                                                   |
 +-----------------------------+---------------------------------------------------+
-| **Repo/commit-ID**          |                                                   |
+| **Repo/commit-ID**          | nonrtric/plt/ranpm/                               |
+|                             | fbccee5729fb23f3424046c1d122d29f0fec545a          |
 |                             |                                                   |
 +-----------------------------+---------------------------------------------------+
 | **Release designation**     | H                                                 |
 |                             |                                                   |
 +-----------------------------+---------------------------------------------------+
-| **Release date**            | 2023-06-xx                                        |
+| **Release date**            | 2023-06-16                                        |
 |                             |                                                   |
 +-----------------------------+---------------------------------------------------+
-| **Purpose of the delivery** | First release of RAN PM Usecase/Functions         |
+| **Purpose of the delivery** | First release (H) of RAN PM Usecase/Functions     |
+|                             |    nonrtric-plt-ranpm-datafilecollector:1.0.0     |
+|                             |    nonrtric-plt-pmlog:1.0.0                       |
+|                             |    nonrtric-plt-ranpm-pm-file-converter:1.0.0     |
+|                             |    nonrtric-plt-pmproducer:1.0.0                  |
 |                             |                                                   |
 +-----------------------------+---------------------------------------------------+
index 9729d6f..83ae31b 100644 (file)
@@ -17,7 +17,7 @@
 
 from docs_conf.conf import *
 
-branch = 'latest'
+branch = 'h-release'
 
 linkcheck_ignore = [
     'http://localhost.*',
index a0b0e7d..26da9b6 100644 (file)
@@ -12,3 +12,4 @@ Non-RT RIC Influx Logger
    ./overview.rst
    ./developer-guide.rst
    ./api-docs.rst
+   ./release-notes.rst
diff --git a/influxlogger/docs/release-notes.rst b/influxlogger/docs/release-notes.rst
new file mode 100644 (file)
index 0000000..1d1db2d
--- /dev/null
@@ -0,0 +1,46 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2023 Nordix
+
+=============
+Release-Notes
+=============
+
+
+This document provides the release notes for the release of the Non-RT RIC - RAN PM - Influx Logger (pmlog).
+
+Version history Non-RT RIC - RAN PM - Influx Logger
+===================================================
+
++------------+----------+------------------+--------------------+
+| **Date**   | **Ver.** | **Author**       | **Comment**        |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+| 2023-06-16 |          | John Keeney      | H Release          |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+
+
+Release Data
+============
+
+H Release
+---------
++-----------------------------+---------------------------------------------------+
+| **Project**                 | Non-RT RIC RAN PM                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Repo/commit-ID**          | nonrtric/plt/ranpm/                               |
+|                             | fbccee5729fb23f3424046c1d122d29f0fec545a          |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release designation**     | H                                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release date**            | 2023-06-16                                        |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Purpose of the delivery** | First release (H) of RAN PM Usecase/Functions     |
+|                             |    nonrtric-plt-pmlog:1.0.0                       |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
index bc39c07..57c10f3 100644 (file)
@@ -19,7 +19,7 @@ from docs_conf.conf import *
 
 #branch configuration
 
-branch = 'latest'
+branch = 'h-release'
 
 linkcheck_ignore = [
     'http://localhost.*',
index dde56a8..e719706 100644 (file)
@@ -10,4 +10,5 @@ Non-RT RIC PM File Converter
    :caption: Contents:
 
    ./overview.rst
+   ./release-notes.rst
 
index 438cdf1..17e75f3 100644 (file)
@@ -19,7 +19,7 @@ are collected from the RAN. The event is sent by the Data File Collector.
 
 The XML file is read from the storage, converted to Json, gzipped and stored.
 
-A Json object indicating that a new Json PM Mesurement report is available is sent on
+A Json object indicating that a new Json PM Measurement report is available is sent on
 a Kafka topic to be picked up by other components for further processing,
 
 .. image:: ./Architecture.png
@@ -35,7 +35,7 @@ This product is a part of :doc:`NONRTRIC <nonrtric:index>`.
 Output PM Measurement
 *********************
 
-The Json format of the PM mesaurememt follows the same structure as the input XML format (defined by 3GPP).
+The Json format of the PM measurement follows the same structure as the input XML format (defined by 3GPP).
 
 Here follows an example:
 
@@ -130,7 +130,7 @@ Input File Ready Message
 ************************
 
 Below follows an example of an input File Ready Message. The
-message is sent by the Data File Collector. The only elemts used by this component are sourceName, name and
+message is sent by the Data File Collector. The only elements used by this component are sourceName, name and
 objectStoreBucket.
 
 .. code-block:: javascript
diff --git a/pm-file-converter/docs/release-notes.rst b/pm-file-converter/docs/release-notes.rst
new file mode 100644 (file)
index 0000000..f33902c
--- /dev/null
@@ -0,0 +1,46 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2023 Nordix
+
+=============
+Release-Notes
+=============
+
+
+This document provides the release notes for the release of the Non-RT RIC - RAN PM - PM File Converter.
+
+Version history Non-RT RIC - RAN PM - PM File Converter
+=======================================================
+
++------------+----------+------------------+--------------------+
+| **Date**   | **Ver.** | **Author**       | **Comment**        |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+| 2023-06-16 |          | John Keeney      | H Release          |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+
+
+Release Data
+============
+
+H Release
+---------
++-----------------------------+---------------------------------------------------+
+| **Project**                 | Non-RT RIC RAN PM                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Repo/commit-ID**          | nonrtric/plt/ranpm/                               |
+|                             | fbccee5729fb23f3424046c1d122d29f0fec545a          |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release designation**     | H                                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release date**            | 2023-06-16                                        |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Purpose of the delivery** | First release (H) of RAN PM Usecase/Functions     |
+|                             |    nonrtric-plt-ranpm-pm-file-converter:1.0.0     |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
index a8dac9b..3d31ef8 100644 (file)
@@ -19,7 +19,7 @@ from docs_conf.conf import *
 
 #branch configuration
 
-branch = 'latest'
+branch = 'h-release'
 
 language = 'en'
 
index a0ef6fc..96b5005 100644 (file)
@@ -12,3 +12,4 @@ Non-RT RIC PM Producer
    ./overview.rst
    ./developer-guide.rst
    ./api-docs.rst
+   ./release-notes.rst
index c56af74..7852177 100644 (file)
@@ -129,7 +129,7 @@ For each filtered result sent to a Kafka topic, there will the following propert
 Configuration
 *************
 
-The component is configured by a configuration file and by the normal spring boot configuration file (apoplication.yaml).
+The component is configured by a configuration file and by the normal spring boot configuration file (application.yaml).
 
 ==================
 Configuration file
diff --git a/pmproducer/docs/release-notes.rst b/pmproducer/docs/release-notes.rst
new file mode 100644 (file)
index 0000000..c5b968a
--- /dev/null
@@ -0,0 +1,46 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2023 Nordix
+
+=============
+Release-Notes
+=============
+
+
+This document provides the release notes for the release of the Non-RT RIC - RAN PM - PM Producer.
+
+Version history Non-RT RIC - RAN PM - PM Producer
+=================================================
+
++------------+----------+------------------+--------------------+
+| **Date**   | **Ver.** | **Author**       | **Comment**        |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+| 2023-06-16 |          | John Keeney      | H Release          |
+|            |          |                  |                    |
++------------+----------+------------------+--------------------+
+
+
+Release Data
+============
+
+H Release
+---------
++-----------------------------+---------------------------------------------------+
+| **Project**                 | Non-RT RIC RAN PM                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Repo/commit-ID**          | nonrtric/plt/ranpm/                               |
+|                             | fbccee5729fb23f3424046c1d122d29f0fec545a          |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release designation**     | H                                                 |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Release date**            | 2023-06-16                                        |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+
+| **Purpose of the delivery** | First release (H) of RAN PM Usecase/Functions     |
+|                             |    nonrtric-plt-pmproducer:1.0.0                  |
+|                             |                                                   |
++-----------------------------+---------------------------------------------------+