Installation Guide — Project name not set documentation

# Installation Guide

## Abstract

This document describes how to install the software for SMO O2, it’s dependencies and required system resources.

Version history

Date | Ver. | Author | Comment
20XX-XX-XX | 0.1.0 |  | First draft
| 0.1.1 |  |
| 1.0 |  |

## 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.

The audience of this document is assumed to have good knowledge in RAN network nd Linux system.

## Preface

### Tacker Preface

Before starting the installation of Tacker, make sure git is installed on the system.

## Hardware Requirements

### Tacker Hardware Requirements

Following minimum hardware requirements must be met for installation of Tacker:

HW Aspect | Requirement
# of servers | 1
CPU | 4
RAM | 16G
Disk | 80G
NICs | 1

## Software Installation and Deployment

### Tacker Installation

This section describes the installation of the Tacker installation on the reference hardware.

- Installation Using Install Script

  The install script can be retrieved from smo-o2 repository:

      $ git clone https://gerrit.o-ran-sc.org/r/smo/o2

  Usage:

      $ cd o2/tacker/scripts
      $ ./install.sh <HOST_IP>

      <HOST_IP>: You should set host IP for API endpoint of Tacker.

  This script installs the Tacker via Devstack (Standalone mode). It uses the latest repositories (Devstack and Tacker).

  If you want to use other version, you have to change the URL.

  e.g.:

      git clone https://opendev.org/openstack-dev/devstack -b stable/yoga
      wget https://opendev.org/openstack/tacker/raw/branch/stable/yoga/devstack/local.conf.standalone

- Installation using openstack-helm

  Below is the method for installing INF o-cloud and Tacker using openstack-helm. Please refer to Step 3, 4, and 5 for Tacker installation.

  - https://wiki.o-ran-sc.org/display/IN/ETSI-DMS+on+INF+O-Cloud%2C+Tacker+installation+guide

  Reference: About openstack-helm

  - https://wiki.openstack.org/wiki/Openstack-helm

- Manual Installation

  See the following documents.

  - https://docs.openstack.org/tacker/latest/install/manual_installation.html

## Software Configuration

- Enabling Fault Management

  This section describes how to enable Fault Management in Tacker.

  1. Fault management is disabled by default in Tacker. To enable it, update the fault_management configuration parameters in the tacker.conf file, setting this value to “true”.

         $ vi /etc/tacker/tacker.conf
         ...
         [prometheus_plugin]
         # Enable prometheus plugin fault management (boolean value)
         fault_management = true
         ...

  2. After modifying the configuration file, restart the Tacker services for the changes to take effect.

         $ sudo systemctl restart devstack@tacker-conductor.service
         $ sudo systemctl restart devstack@tacker.service

  3. Confirm that the Tacker service is running properly.

         $ sudo systemctl status devstack@tacker-conductor.service
         ● devstack@tacker-conductor.service - OpenStack tacker conductor service
              Loaded: loaded (/etc/systemd/system/devstack@tacker-conductor.service; enabled; vendor preset: enabled)
              Active: active (running) since Fri 2024-06-14 06:56:50 UTC; 16s ago
            Main PID: 1447858 (tacker-conducto)
               Tasks: 1 (limit: 77041)
              Memory: 153.7M
                 CPU: 2.222s
              CGroup: /system.slice/system-devstack.slice/devstack@tacker-conductor.service
                      └─1447858 /opt/stack/data/venv/bin/python3.10 /opt/stack/data/venv/bin/tacker-conductor --config-file /etc/tacker/tacker.co>

            Jun 14 06:56:50 instance-vnfm-ubuntu22-5th-20231207 systemd[1]: Started OpenStack tacker conductor service.
            Jun 14 06:56:51 instance-vnfm-ubuntu22-5th-20231207 tacker-conductor[1447858]: /opt/stack/data/venv/lib/python3.10/site-packages/oslo_db>
            Jun 14 06:56:51 instance-vnfm-ubuntu22-5th-20231207 tacker-conductor[1447858]:   warnings.warn(

         $ sudo systemctl status devstack@tacker.service
         ● devstack@tacker.service - OpenStack tacker service
              Loaded: loaded (/etc/systemd/system/devstack@tacker.service; enabled; vendor preset: enabled)
              Active: active (running) since Fri 2024-06-14 06:58:36 UTC; 4s ago
            Main PID: 1448235 (tacker-server)
               Tasks: 1 (limit: 77041)
              Memory: 144.5M
                 CPU: 2.090s
              CGroup: /system.slice/system-devstack.slice/devstack@tacker.service
                      └─1448235 /opt/stack/data/venv/bin/python3.10 /opt/stack/data/venv/bin/tacker-server --config-file /etc/tacker/tacker.conf

## References