Gitiles
Code Review Sign In
gerrit.nordix.org / oransc / ric-app / hw-go / eb2fc4f608d8a94f5f659b2603cd1661c807cd6e
commiteb2fc4f608d8a94f5f659b2603cd1661c807cd6e[log] [tgz]
authorsubhash kumar singh <subh.singh@samsung.com>Tue Jun 01 18:43:32 2021 +0530
committersubhash kumar singh <subh.singh@samsung.com>Tue Jun 01 18:48:54 2021 +0530
treef553d1245654c86f2e9ac43fa65f6505f28322af
parent02ac560d10a1374557a9b644d618c52e23d1a3fc [diff]
Example to read configuration

Example to demonstrate reading configuration.

Signed-off-by: subhash kumar singh <subh.singh@samsung.com>
Change-Id: Ife41214be107c76f31d61addc2f91fd1678796e4
2 files changed
tree: f553d1245654c86f2e9ac43fa65f6505f28322af
  1. config/
  2. docs/
  3. container-tag.yaml
  4. Dockerfile
  5. go.mod
  6. go.sum
  7. hwApp.go
  8. INFO.yaml
  9. LICENSES.txt
  10. README.md
README.md

O-RAN-SC Hello World Xapp in Golang

This repository contains open-source code for a prototype golang xAPP for near real-time RAN Intelligent Controller which makes use of golang Xapp Framework.

This xAPP aims to provide basic implementation of :

  1. A1 interfaces interactions

  2. Read-write operations into a persistent storage.

  3. xAPP Configuration management

  4. RMR Health Check

  5. xAPP SDL Check

  6. Raising alarms

  7. Generating metrics

  8. E2 Interface intereactions

Introduction

This document provides guidelines on how to install and configure the HW Golang xAPP in various environments/operating modes. The audience of this document is assumed to have good knowledge in RIC Platform.

Preface

This xAPP can be run directly as a Linux binary, as a docker image, or in a pod in a Kubernetes environment. The first two can be used for dev testing. The last option is how an xAPP is deployed in the RAN Intelligent Controller environment. This covers all three methods.

  1. Docker

  2. Linux Binary

  3. Kubernetes

: Software Installation and Deployment

The build process assumes a Linux environment with golang >= 1.15 and has been tested on Ubuntu. For building docker images, the Docker environment must be present in the system.

##Build Process

The HW xAPP can be either tested as a Linux binary or as a docker image.

  1. Linux binary: TBD

  2. Docker Image: From the root of the repository, run docker --no-cache build -t ./ .

##Deployment

Invoking xAPP docker container directly (not in RIC Kubernetes env.): One can include the pod.yaml for including it in k8s build. Replace the image name with one built. TBD: Adding hw-python to nexus repo

Testing

Unit tests TBD

License


   Copyright (c) 2021 Samsung Electronics Co., Ltd. All Rights Reserved.

   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.