Bouncer/docs/installation-guide.rst

   1 # ==================================================================================
   2 # Copyright (c) 2020 HCL Technologies Limited.
   3 #
   4 # Licensed under the Apache License, Version 2.0 (the "License");
   5 # you may not use this file except in compliance with the License.
   6 # You may obtain a copy of the License at
   7 #
   8 # http://www.apache.org/licenses/LICENSE-2.0
   9 #
  10 # Unless required by applicable law or agreed to in writing, software
  11 # distributed under the License is distributed on an "AS IS" BASIS,
  12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 # See the License for the specific language governing permissions and
  14 # limitations under the License.
  15 # ==================================================================================
  16
  17
  18 Installation Guide
  19 ==================
  20
  21 .. contents::
  22    :depth: 3
  23    :local:
  24
  25 Abstract
  26 --------
  27
  28 This document describes how to install the Bouncer xAPP.
  29
  30 Version history
  31
  32 +--------------------+--------------------+--------------------+--------------------+
  33 | **Date**           | **Ver.**           | **Organization**   | **Comment**        |
  34 |                    |                    |                    |                    |
  35 +--------------------+--------------------+--------------------+--------------------+
  36 | 2020-11-17         |1.0.0               |HCL Technologies    | Cherry Release     |
  37 |                    |                    |                    |                    |
  38 +--------------------+--------------------+--------------------+--------------------+
  39
  40
  41 Introduction
  42 ------------
  43
  44 This document provides guidelines on how to install and configure the Bouncer xAPP in various environments/operating modes.
  45 The audience of this document is assumed to have good knowledge in RIC Platform.
  46
  47
  48 Preface
  49 -------
  50 The Bouncer xAPP can be run directly as a Linux binary, as a docker image, or in a pod in a Kubernetes environment.  The first
  51 two can be used for testing/evaluation. The last option is how an xAPP is deployed in the RAN Intelligent Controller environment.
  52 This document covers all three methods.
  53
  54
  55
  56
  57 Software Installation and Deployment
  58 ------------------------------------
  59 The build process assumes a Linux environment with a gcc (>= 4.0)  compatible compiler and  has been tested on Ubuntu. For building docker images,
  60 the Docker environment must be present in the system.
  61
  62
  63 Build Process
  64 ~~~~~~~~~~~~~
  65 The Bouncer xAPP can be either tested as a Linux binary or as a docker image.
  66    1. **Linux binary**:
  67       The Bouncer xAPP may be compiled and invoked directly. Pre-requisite software packages that must be installed prior to compiling are documented in the Dockerfile in the repository. README file in the repository mentions the steps to be followed to make "b-xapp-main" binary.
  68
  69    2. **Docker Image**: From the root of the repository, run   *docker --no-cache build -t <image-name> ./* .
  70
  71
  72 Deployment
  73 ~~~~~~~~~~
  74 **Invoking  xAPP docker container directly** (not in RIC Kubernetes env.):
  75         xAPP descriptor(config-file.json) is available say under directory /home/ubuntu/config-file.json,  the docker image can be invoked as *docker run --net host -it --rm -v "/home/test-config:/opt/ric/config" --name  "B-xAPP" <image>*.
  76
  77