X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Findex.rst;h=5513baa888f548cf40eba7cd33bce76791323b55;hb=03a0083c52637cf25f75f41169da9de0f33cb786;hp=26a89e02c71bbdec4bd0f50de1552b80139c423d;hpb=0caac0f8bacd54d8b7ae81eda2e5fb53852aaad9;p=ric-plt%2Fa1.git diff --git a/docs/index.rst b/docs/index.rst index 26a89e0..5513baa 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,101 +1,21 @@ -.. ================================================================================== -.. Copyright (c) 2019 Nokia -.. Copyright (c) 2018-2019 AT&T Intellectual Property. -.. -.. 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. -.. ================================================================================== - -A1 Mediator -=========== - -API -=== - -You can see the API (OpenAPI3 spec) at ``a1/openapi.yml``. You can also -see the “pretty” version if you run the container at -``http://localhost:10000/ui/``. - -Unit Testing -============ - -Note, this requires rmr to be installed! - -:: - - tox - open htmlcov/index.html - -Integration testing -=================== - -This tests A1’s external API with two test receivers. Note, this -currently depends on helm+k8s, meaning you cannot run this if -this is not installed. - -If you've never run the integration tests before, build the test receiver -:: +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. SPDX-License-Identifier: CC-BY-4.0 - cd integration_tests - docker build --no-cache -t testreceiver:latest . +Welcome to O-RAN SC A1 Documentation +===================================== -Else, from the root, -:: +.. toctree:: + :maxdepth: 2 + :caption: Contents: - tox -c tox-integration.ini - -This script: -1. Deploys 3 helm charts into a local kubernetes installation -2. Port forwards a pod ClusterIP to localhost -3. Uses “tavern” to run some tests against the server -4. Barrages the server with apache bench -5. Tears everything down - - -Running -======= - -Optional ENV Variables ----------------------- - -You can set the following ENVs to change the A1 behavior: 1) -``RMR_RCV_RETRY_INTERVAL`` the number of milliseconds that execution -will defer (back to the server loop to handle http request if -applicable) when an expected ack is not received by rmr call. The -default is ``1000`` (1s). The time for the full HTTP request to -``PUT /policies`` will be > this if an ACK is not recieved within 10ms, -which is an initial delay until the first rcv is tried. 2) -``RMR_RETRY_TIMES`` the number of times failed rmr operations such as -timeouts and send failures should be retried before A1 gives up and -returns a 503. The default is ``4``. - -K8S ---- -The "real" helm chart for A1 is in the LF it/dep repo. That repo holds all of the helm charts for the RIC platform. There is a helm chart in `integration_tests` here for running the integration tests as discussed above. - -Local Docker ------------- - -building -~~~~~~~~ -:: - - docker build --no-cache -t a1:X.Y.Z . - -.. _running-1: - -running -~~~~~~~ - -:: + overview.rst + developer-guide.rst + installation-guide.rst + release-notes.rst +.. + user-guide.rst + api-docs.rst - docker run -dt -p 10000:10000 -v /path/to/localrt:/opt/route/local.rt -v /path/to/ricmanifest:/opt/ricmanifest.json a1:X.Y.Z -v +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search`