X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Finstallation-guides.rst;h=f451c81bab8061a1d7687d5efc74396034c0cebe;hb=refs%2Fchanges%2F75%2F2275%2F3;hp=05231f544959dd1c1ca8c69ddc043b27eb512bb0;hpb=c3b6c2008abef7f8ee148892a5e03c345f0a217d;p=it%2Fdep.git diff --git a/docs/installation-guides.rst b/docs/installation-guides.rst old mode 100755 new mode 100644 index 05231f54..f451c81b --- a/docs/installation-guides.rst +++ b/docs/installation-guides.rst @@ -1,10 +1,10 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. SPDX-License-Identifier: CC-BY-4.0 .. ===============LICENSE_START======================================================= -.. Copyright (C) 2019 AT&T Intellectual Property +.. Copyright (C) 2019-2020 AT&T Intellectual Property .. =================================================================================== -.. This documentation file is distributed under the Creative Commons Attribution -.. 4.0 International License (the "License"); you may not use this file except in +.. This documentation file is distributed under the Creative Commons Attribution +.. 4.0 International License (the "License"); you may not use this file except in .. compliance with the License. You may obtain a copy of the License at .. .. http://creativecommons.org/licenses/by/4.0 @@ -15,113 +15,90 @@ .. limitations under the License. .. ===============LICENSE_END========================================================= -.. contents:: - :depth: 3 - :local: +=================== +Installation Guides +=================== -======== -Abstract -======== - -This document describes how to install , it's dependencies and required system resources. +This document describes how to install the RIC components deployed by scripts and Helm charts +under the it/dep repository, including the dependencies and required system resources. .. contents:: :depth: 3 :local: Version history ---------------------- +=============== +--------------------+--------------------+--------------------+--------------------+ | **Date** | **Ver.** | **Author** | **Comment** | | | | | | +--------------------+--------------------+--------------------+--------------------+ -| 20XX-XX-XX | 0.1.0 | | First draft | -| | | | | -+--------------------+--------------------+--------------------+--------------------+ -| | 0.1.1 | | | -| | | | | -+--------------------+--------------------+--------------------+--------------------+ -| | 1.0 | | | -| | | | | +| 2019-11-25 | 0.1.0 |Lusheng Ji | First draft | | | | | | +--------------------+--------------------+--------------------+--------------------+ -Introduction -============ -.. - -.: - -This document describes the supported software and hardware configurations for the reference component as well as providing guidelines on how to install and configure such reference system. +Overview +======== -The audience of this document is assumed to have good knowledge in RAN network nd Linux system. +The installation of Amber Near Realtime RAN Intelligent Controller is spread onto two separate +Kubernetes clusters. The first cluster is used for deploying the Near Realtime RIC (platform and +applications), and the other is for deploying other auxiliary functions. They are referred to as +RIC cluster and AUX cluster respectively. +The following diagram depicts the installation architecture. -Preface -======= -.. +.. image:: images/nrtric-amber.png + :width: 600 -: +Within the RIC cluster, Kubernetes resources are deployed using three name spaces: ricinfra, ricplt, and ricxapp. Similarly, within the AUX cluster, Kubernetes resources are deployed using two name spaces: ricinfra, and ricaux. -Before starting the installation of , some planning must preceed. +For each cluster, there is a Kong ingress controller that proxies incoming API calls into the cluster. +With Kong, service APIs provided by Kubernetes resources can be accessed at the cluster node IP and +port via a URL path. For cross-cluster communication, in addition to Kong, each Kubernetes namespace +has a special Kubernetes service defined with an endpoint pointing to the other cluster's Kong. This +way any pod can access services exposed at the other cluster via the internal service hostname and port of +this special service. The figure below illustrates the details of how Kong and external services work +together to realize cross-cluster communication. -.. note:any preperation you need before setting up sotfware and hardware +.. image:: images/kong-extservice.png + :width: 600 -Hardware requirements -===================== -.. +VirtualBox VMs as Installation Hosts +==================================== -: +The deployment of Amber Near Realtime RIC can be done on a wide range of hosts, including +bare metal servers, OpenStack VMs, and VirtualBox VMs. This section provides detailed instructions +for setting up Oracle VirtualBox VMs to be used as installation hosts. -Following minimum hardware requirements must be met for installation of : +.. include:: ./installation-virtualbox.rst -+--------------------+----------------------------------------------------+ -| **HW Aspect** | **Requirement** | -| | | -+--------------------+----------------------------------------------------+ -| **# of servers** | | -+--------------------+----------------------------------------------------+ -| **CPU** | | -| | | -+--------------------+----------------------------------------------------+ -| **RAM** | | -| | | -+--------------------+----------------------------------------------------+ -| **Disk** | | -| | | -+--------------------+----------------------------------------------------+ -| **NICs** | | -| | | -| | | -| | | -| | | -| | | -+--------------------+----------------------------------------------------+ +One-Node Kubernetes Cluster +=========================== +This section describes how to set up a one-node Kubernetes cluster onto a VM installation host. +.. include:: ./installation-k8s1node.rst -Software installation and deployment -========================================== -.. +Installing Near Realtime RIC in RIC Cluster +=========================================== -: +After the Kubernetes cluster is installed, the next step is to install the (Near Realtime) RIC Platform. -This section describes the installation of the installation on the reference hardware. +.. include:: ./installation-ric.rst +Installing Auxiliary Functions in AUX Cluster +============================================= -References -========== -.. +.. include:: ./installation-aux.rst -: -OpenStack -^^^^^^^^^^^ +Installing RIC Applications +=========================== +.. include:: ./installation-xapps.rst