docs/installation-guide.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. Copyright (C) 2023 OpenInfra Foundation Europe. All rights reserved.
   4
   5 Installation Guide
   6 ==================
   7
   8 Abstract
   9 --------
  10
  11 This document describes how to install the Non-RT RIC components, their dependencies and required system resources.
  12
  13 Software Installation and Deployment
  14 ------------------------------------
  15
  16 Install with Helm
  17 +++++++++++++++++
  18
  19 Helm charts and an example recipe are provided in the `it/dep repo <https://gerrit.o-ran-sc.org/r/admin/repos/it/dep>`_,
  20 under "nonrtric". By modifying the variables named "installXXX" in the beginning of the example recipe file, which
  21 components that will be installed can be controlled. Then the components can be installed and started by running the
  22 following command:
  23
  24       .. code-block:: bash
  25
  26         bin/deploy-nonrtric -f nonrtric/RECIPE_EXAMPLE/example_recipe.yaml
  27
  28 Install with dependent components
  29 +++++++++++++++++++++++++++++++++
  30
  31 The scripts for the deployments of rApp Manager and its dependent components are available in *rappmanager/scripts/install* directory.
  32
  33 ACM components should be configured with couple of other components for the participants to work.
  34
  35 In case some of the installation is already setup or not set by the installation scripts, the below environment variables can be used to set the configurations ACM through installation scripts.
  36
  37 +--------------------+--------------------------------------------+----------------------------------------------+
  38 | **Variable Name**  | **Description**                            | **Default Value**                            |
  39 +--------------------+--------------------------------------------+----------------------------------------------+
  40 | CHART_REPO_HOST    | Address of the chart repository.           | \http://IP_ADDRESS:8879/charts               |
  41 |                    |                                            |                                              |
  42 |                    | It will be used by Kubernetes participant. | IP_ADDRESS: IP of the host in which          |
  43 |                    |                                            | the installation scripts are running.        |
  44 +--------------------+--------------------------------------------+----------------------------------------------+
  45 | A1PMS_HOST         | Address of the A1PMS.                      | \http://policymanagementservice.nonrtric:9080|
  46 |                    |                                            |                                              |
  47 |                    | It will be accessed from A1PMS participant.|                                              |
  48 +--------------------+--------------------------------------------+----------------------------------------------+
  49
  50 All components can be installed using the command below,
  51
  52       .. code-block:: bash
  53
  54         ./install-all.sh
  55
  56 Individual components can be installed using the commands below,
  57
  58 To install the tools required for other installer scripts.
  59
  60       .. code-block:: bash
  61
  62         ./install-base.sh
  63
  64 To install the ACM, and it's related components.
  65
  66       .. code-block:: bash
  67
  68         ./install-acm.sh
  69
  70 To install the Kserve, and it's related components.
  71
  72       .. code-block:: bash
  73
  74         ./install-kserve.sh
  75
  76 To installs the NONRTRIC components.
  77
  78       .. code-block:: bash
  79
  80         ./install-nonrtric.sh
  81
  82
  83 Uninstallation
  84 ++++++++++++++
  85 To uninstall all the components
  86
  87       .. code-block:: bash
  88
  89         ./uninstall-all.sh