---
# System prepended metadata

title: OSC-RIC Near RT RIC Installation

---

# OSC-RIC Near RT RIC Installation

[TOC]

---

## Definition

OSC-RIC is a RAN Intelligent Controller (RIC) developed by O-RAN Software Community (OSC) to simulate Near RT RIC environment. The architecture for OSC-RIC is similar to the diagram below.

![near_rt_ric_cluster](https://hackmd.io/_uploads/ByWDaYtOee.jpg =300x)

OSC-RIC utilize Kubernetes cluster to simulate the necessary component for the Near RT RIC environment such as the E2 Termination.

## System Requirements

>[!Important] Operating System Notice
> You cannot use WSL2 as the environment.

|  System   |   Requirement    |
|:---------:|:----------------:|
|    OS     | Ubuntu 20.04 LTS |
|  Storage  |      100 GB      |
|    RAM    |    16 - 32 GB    |
| CPU Cores |       8-16       |


>[!Note] **Notes**
> Make sure you already update and upgrade the packages.
> ```bash!
> sudo apt update -y && sudo apt upgrade -y
> ```

## Clone the Repository

We will be using the ***j-release*** branch since its the most update branch.

```bash!
sudo su
cd ~

git clone https://github.com/o-ran-sc/ric-plt-ric-dep.git -b j-release ric-dep
```

## Setup k8s and Helm

```bash!
ric-dep/bin/install_k8s_and_helm.sh
```

:::success
:::spoiler Output
![image](https://hackmd.io/_uploads/B1-zS1SDex.png =500x)
::::::

**Check Installation:**

```bash!
kubectl get pods -A
```

:::success
:::spoiler Output
![image](https://hackmd.io/_uploads/SyeBH1BDlx.png =500x)
::::::

## Install Helm Common Template

```bash!
cd ric-dep/bin
./install_common_templates_to_helm.sh
```

:::success
:::spoiler Output
![image](https://hackmd.io/_uploads/B1C_8JSwgg.png =500x)
::::::

### Make Docker Run Without Sudo

```bash!
sudo groupadd docker
sudo usermod -aG docker $USER
```

Logout then login again to apply changes. To test if its working:

```bash!
docker ps
```

## Setup Near RT RIC with Template

```bash!
./install -f ../RECIPE_EXAMPLE/example_recipe_oran_j_release.yaml
```

**Check:**
```bash!
kubectl get pods -n ricplt
```

:::success
:::spoiler Expected Output
![image](https://hackmd.io/_uploads/SJawdkBPee.png =500x)
::::::
