--- /dev/null
+# Copyright (c) 2019 AT&T Intellectual Property.
+# Copyright (c) 2018-2019 Nokia.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Compiled python modules.
+*.pyc
+
+# Setuptools distribution folder.
+/dist/
+
+# Python egg metadata, regenerated from source files by setuptools.
+/*.egg-info
+.tox
+docs/_build
+
--- /dev/null
+---
+version: 2
+
+formats:
+ - htmlzip
+
+build:
+ image: latest
+
+python:
+ version: 3.7
+ install:
+ - requirements: docs/requirements-docs.txt
+
+sphinx:
+ configuration: docs/conf.py
--- /dev/null
+from docs_conf.conf import *
+linkcheck_ignore = [
+ 'http://localhost.*',
+ 'http://127.0.0.1.*',
+ 'https://gerrit.o-ran-sc.org.*'
+]
--- /dev/null
+---
+project_cfg: oran
+project: com-golog
--- /dev/null
+..\r
+.. Copyright (c) 2019 AT&T Intellectual Property.\r
+..\r
+.. Copyright (c) 2019 Nokia.\r
+..\r
+..\r
+.. Licensed under the Creative Commons Attribution 4.0 International\r
+..\r
+.. Public License (the "License"); you may not use this file except\r
+..\r
+.. in compliance with the License. You may obtain a copy of the License at\r
+..\r
+..\r
+.. https://creativecommons.org/licenses/by/4.0/\r
+..\r
+..\r
+.. Unless required by applicable law or agreed to in writing, documentation\r
+..\r
+.. distributed under the License is distributed on an "AS IS" BASIS,\r
+..\r
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+..\r
+.. See the License for the specific language governing permissions and\r
+..\r
+.. limitations under the License.\r
+..\r
+\r
+\r
+Welcome to O-RAN SC vespamgr Documentation\r
+==========================================\r
+\r
+.. toctree::\r
+ :maxdepth: 2\r
+ :caption: Contents:\r
+\r
+ overview.rst\r
+ release-notes.rst\r
+\r
+\r
+\r
+* :ref:`genindex`\r
+* :ref:`modindex`\r
+* :ref:`search`
\ No newline at end of file
--- /dev/null
+..\r
+.. Copyright (c) 2019 AT&T Intellectual Property.\r
+..\r
+.. Copyright (c) 2019 Nokia.\r
+..\r
+..\r
+.. Licensed under the Creative Commons Attribution 4.0 International\r
+..\r
+.. Public License (the "License"); you may not use this file except\r
+..\r
+.. in compliance with the License. You may obtain a copy of the License at\r
+..\r
+..\r
+.. https://creativecommons.org/licenses/by/4.0/\r
+..\r
+..\r
+.. Unless required by applicable law or agreed to in writing, documentation\r
+..\r
+.. distributed under the License is distributed on an "AS IS" BASIS,\r
+..\r
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+..\r
+.. See the License for the specific language governing permissions and\r
+..\r
+.. limitations under the License.\r
+..\r
+\r
+\r
+vespamgr Overview\r
+=================\r
+\r
+The VESPA manager uses the VES Agent (https://github.com/nokia/ONAP-VESPA)\r
+to adapt near-RT RIC internal statistics' collection using Prometheus\r
+(xApps and platform containers) to ONAP's VES (VNF event streaming).\r
+\r
+The vesmgr container runs two processes: the VESPA manager and the VES Agent (i.s. VESPA).\r
+The VESPA manager starts and configures the VES Agent.\r
+The VES Agent is a service acting as a bridge between Prometheus and ONAP's VES Collector.
\ No newline at end of file
--- /dev/null
+..\r
+.. Copyright (c) 2019 AT&T Intellectual Property.\r
+..\r
+.. Copyright (c) 2019 Nokia.\r
+..\r
+..\r
+.. Licensed under the Creative Commons Attribution 4.0 International\r
+..\r
+.. Public License (the "License"); you may not use this file except\r
+..\r
+.. in compliance with the License. You may obtain a copy of the License at\r
+..\r
+..\r
+.. https://creativecommons.org/licenses/by/4.0/\r
+..\r
+..\r
+.. Unless required by applicable law or agreed to in writing, documentation\r
+..\r
+.. distributed under the License is distributed on an "AS IS" BASIS,\r
+..\r
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+..\r
+.. See the License for the specific language governing permissions and\r
+..\r
+.. limitations under the License.\r
+..\r
+\r
+\r
+Release-Notes\r
+=============\r
+\r
+\r
+This document provides the release notes for version 0.0.8 of vespamgr.\r
+\r
+.. contents::\r
+ :depth: 3\r
+ :local:\r
+\r
+\r
+Version history\r
+---------------\r
+\r
++--------------------+--------------------+--------------------+--------------------+\r
+| **Date** | **Ver.** | **Author** | **Comment** |\r
+| | | | |\r
++--------------------+--------------------+--------------------+--------------------+\r
+| 2019-11-13 | 0.0.8 | R Riska | First version |\r
+| | | | |\r
++--------------------+--------------------+--------------------+--------------------+\r
+\r
+\r
+Summary\r
+-------\r
+\r
+This is the first version of this component.\r
+\r
+\r
+\r
+\r
+Release Data\r
+------------\r
+\r
+This is the first version of this component.\r
+\r
+\r
+\r
+\r
+Feature Additions\r
+^^^^^^^^^^^^^^^^^\r
+\r
+Bug Corrections\r
+^^^^^^^^^^^^^^^\r
+\r
+\r
+Deliverables\r
+^^^^^^^^^^^^\r
+\r
+Software Deliverables\r
++++++++++++++++++++++\r
+\r
+The deliverable is a container running two processes:\r
+- VESPA manager\r
+- VES Agent, i.e. VESPA (https://github.com/nokia/ONAP-VESPA)\r
+\r
+\r
+\r
+\r
+Documentation Deliverables\r
+++++++++++++++++++++++++++\r
+\r
+\r
+\r
+\r
+\r
+Known Limitations, Issues and Workarounds\r
+-----------------------------------------\r
+\r
+System Limitations\r
+^^^^^^^^^^^^^^^^^^\r
+\r
+\r
+\r
+Known Issues\r
+^^^^^^^^^^^^\r
+\r
+Workarounds\r
+^^^^^^^^^^^\r
+\r
+\r
+\r
+\r
+\r
+References\r
+----------\r
+\r
+\r
--- /dev/null
+sphinx
+sphinx-rtd-theme
+sphinxcontrib-httpdomain
+recommonmark
+lfdocs-conf
--- /dev/null
+# documentation only
+[tox]
+minversion = 2.0
+envlist =
+ docs,
+ docs-linkcheck,
+skipsdist = true
+
+[testenv:docs]
+passenv =
+ http_proxy
+ https_proxy
+
+basepython = python3
+deps =
+ sphinx
+ sphinx-rtd-theme
+ sphinxcontrib-httpdomain
+ recommonmark
+ lfdocs-conf
+
+commands =
+ sphinx-build -W -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
+ echo "Generated docs available in {toxinidir}/docs/_build/html"
+whitelist_externals = echo
+
+[testenv:docs-linkcheck]
+passenv =
+ http_proxy
+ https_proxy
+
+basepython = python3
+deps = sphinx
+ sphinx-rtd-theme
+ sphinxcontrib-httpdomain
+ recommonmark
+ lfdocs-conf
+commands = sphinx-build -W -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck