.. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 .. .. Copyright (C) 2019 AT&T Intellectual Property Release-Notes ============= This document provides the release notes for Amber Release of Open Test Framework (OTF). .. contents:: :depth: 3 :local: Version history --------------- +--------------------+--------------------+--------------------+--------------------+ | **Date** | **Ver.** | **Author** | **Comment** | | | | | | +--------------------+--------------------+--------------------+--------------------+ | 2019-11-12 | 0.1.0 | Rohan Patel (AT&T) | First draft | | | | | | +--------------------+--------------------+--------------------+--------------------+ | 2020-06-16 | 0.1.2 | Jackie Chen (AT&T) | new VTH development| | | | | | +--------------------+--------------------+--------------------+--------------------+ | | 1.0 | | | | | | | | +--------------------+--------------------+--------------------+--------------------+ Summary ------- This release(0.1.2) will include new VTHs that were developed for oran community.The following are VTHs were developed: - dmaap - A1-mediator - smo-o1 - SDNC - A1-policy-manager Most of the vth were built according to health-check use cases(Workflow #2,#3,#4) via: https://wiki.o-ran-sc.org/display/RSAC/Health-Check+Use+Case Release Data ------------ +--------------------------------------+--------------------------------------+ | **Project** | OTF | | | | +--------------------------------------+--------------------------------------+ | **Repo/commit-ID** | it/otf | | | | +--------------------------------------+--------------------------------------+ | **Release designation** | Bronze | | | | +--------------------------------------+--------------------------------------+ | **Release date** | 2020-06-16 | | | | +--------------------------------------+--------------------------------------+ | **Purpose of the delivery** | update repo with VTHs | | | | +--------------------------------------+--------------------------------------+ Feature Additions ^^^^^^^^^^^^^^^^^ **JIRA BACK-LOG:** +--------------------------------------+--------------------------------------+ | **JIRA REFERENCE** | **SLOGAN** | | | | +--------------------------------------+--------------------------------------+ | | | | | | +--------------------------------------+--------------------------------------+ Bug Corrections ^^^^^^^^^^^^^^^ **JIRA TICKETS:** +--------------------------------------+--------------------------------------+ | **JIRA REFERENCE** | **SLOGAN** | | | | +--------------------------------------+--------------------------------------+ | | | | | | | | | +--------------------------------------+--------------------------------------+ | | | | | | | | | +--------------------------------------+--------------------------------------+ Deliverables ^^^^^^^^^^^^ Software Deliverables +++++++++++++++++++++ Code: https://gerrit.o-ran-sc.org/r/gitweb?p=it/otf.git;a=summary Repository contains several applications: oran-ric-test-head: - VTH that enables interaction with xAPP manager - Functionality includes list, deploy, delete xApps otf-aaf-credential-generator: - contains helm chart for AAF information otf-camunda: - Test Control Unit Engine - Application handles deployment and execution of OTF test strategies otf-cert-secret-builder: - contains helm chart for certificate and credential information otf-frontend: - OTF Portal / GUI - Application provides portal for OTF and allows users to deploy, execute, schedule, and view test executions otf-ping-test=head: - VTH that capability to ping a server otf-robot-test-head: - VTH that enables the execution of Robot tests otf-service-api: - Test Control Unit API - Application exposes apis that allow clients to execute test instances, create test instances, and query execution status. otf-sst-test-head: - VTH that enables ssh capability to remote server dmaap-vth: - VTH used to subscribe and publish topics/message via dmaap api a1-mediator-vth: - VTH used to communicate with A1-mediator - Built according to: https://gerrit.o-ran-sc.org/r/gitweb?p=ric-plt/a1.git;a=blob;f=a1/openapi.yaml - Functionality includes: - health-check on A1 - list registered policy types - GET,DELETE,PUT policy types - list policy instance - GET,DELETE,PUT policy instance - Retrieve policy instance status smo-o1-vth: - Performs health checks to verify that O1 interface is alive by getting alarm list a1-policy-manager-vth: - Used to communicate with A1 policy management service api - Built according to: https://docs.o-ran-sc.org/projects/o-ran-sc-nonrtric/en/latest/policy-agent-api.html#policy-agent-api - Has all functionality that is available in the above link. The vth will require the action and method necessary information e.g. query values and json data and forward the request to the service a1-sdnc-vth: - Used to communicate with SDNC A1 Controller api - built according to: https://docs.o-ran-sc.org/projects/o-ran-sc-nonrtric/en/latest/sdnc-a1-controller-api.html - Has all functionality that is available in the above link. The vth will require the action and method necessary information e.g. query values and json data and forward the request to the service Instructions on how to build and run these applications can be found in the otf-installation.txt file located in the it/otf repository. Documentation Deliverables ++++++++++++++++++++++++++ OTF Documentation can be found in the link below: Documentation: https://wiki.o-ran-sc.org/pages/viewpage.action?pageId=10715484 The videos and documents located here contain information about how to use the OTF platform, create and execute tests, and troubleshoot workflows. Known Limitations, Issues and Workarounds ----------------------------------------- System Limitations ^^^^^^^^^^^^^^^^^^ Known Issues ^^^^^^^^^^^^ **JIRA TICKETS:** +--------------------------------------+--------------------------------------+ | **JIRA REFERENCE** | **SLOGAN** | | | | +--------------------------------------+--------------------------------------+ | | | | | | | | | +--------------------------------------+--------------------------------------+ | | | | | | | | | +--------------------------------------+--------------------------------------+ Workarounds ^^^^^^^^^^^ References ----------