d01358d7ed696b4ab64a312d69bb0174b28a87ce
[oam.git] / docs / overview.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. SPDX-License-Identifier: CC-BY-4.0
3 .. Copyright (C) 2019 highstreet technologies and others
4
5 OAM Operation and Maintenance Overview
6 ======================================
7
8 The O-RAN SC OAM provides administrative and operator
9 functions for O-RAN components, such as Near-Realtime-RAN-Inelegent-Controller,
10 O-RAN Centralized Unit, O-RAN Distributed Unit and O-RAN Radio Unit. 
11
12 The project follows the specifications for the O1 interface as provided by
13 O-RAN Working Group1. 
14
15
16 Project Resources
17 -----------------
18
19 The project uses the following Linux Foundation resources:
20
21 * The source code is maintained in this Gerrit:
22     `<https://gerrit.o-ran-sc.org/r/admin/repos/oam>`_
23
24 * The build (CI) jobs are in this Jenkins:
25     `<https://jenkins.o-ran-sc.org/view/oam/>`_
26
27 * Issues are tracked in this Jira:
28     `<https://jira.o-ran-sc.org/projects/OAM/>`_
29
30 * Project information is available in this Wiki:
31     `<https://wiki.o-ran-sc.org/display/OAM/Operations+and+Maintenance>`_
32
33
34 Scope
35 -----
36
37 According to the O-RAN-SC-OAM-Architecture document all ManagedElements 
38 (near-real-time-RIC, O-CU-CP, O-CU-UP, O-DU and O-RU) implement the 
39 O1-interface.
40
41 The O-RAN-OAM-interface specification defines
42
43 - a NetConf-Server for Configuration Management (CM) and
44 - a http-client for Fault Managment (FM), Performance Management (PM) and other 
45   events on each Management-Service-Provider (MnS-Provider) running on the 
46   ManagedElement (ME).
47
48 THe O-RAN-SC-OAM project provides reference implementation according to the 
49 O-RAN OAM (WG1) documents. In addition we provide a common MnS-Consumer for 
50 development and module test purposes.  The assumption is that the projects 
51 for the ManagedElements can concentrate on the more important user-plane.
52
53 Of cause each project needs its own OAM repo to address the specific needs 
54 of the ManagedElement.