drbd-utils: update for stx 5.0
[pti/rtp.git] / docs / overview.rst
index ea04455..be73ed3 100644 (file)
 .. SPDX-License-Identifier: CC-BY-4.0
 .. Copyright (C) 2019 Wind River Systems, Inc.
 
-RTP Overview 
-============
+Infrastructure Overview (INF)
+=============================
 
-This project implements a real time platform to deploy the O-CU and O-DU.
+This project implements a real time platform (rtp) to deploy the O-CU and O-DU.
 
-In O-RAN architecture, the O-DU and O-CU could have different deployed scenarios. 
-In general the performance sensitive parts of the 5G stack require real time platform, 
+In O-RAN architecture, the O-DU and O-CU could have different deployed scenarios.
+The could be container based or VM based, in this release, we only cover the container one. 
+In general the performance sensitive parts of the 5G stack require real time platform,
+especially for O-DU, the L1 and L2 are requiring the real time feature,
 the platform should support the Preemptive Scheduling feature. 
-
-For example, from implementation perspective, the non-virtualized DU, 
-VM based DU and container based DU are requiring a real time host system. 
 Following requirements are going to address the container based solution:
 
-1.Support Node Feature Discovery
-
+1.Support the real time kernel
 
-2.Support CPU Affinity and Isolation
+2.Support Node Feature Discovery
 
+3.Support CPU Affinity and Isolation
 
-3.Support Dynamic HugePages Allocation
+4.Support Dynamic HugePages Allocation
 
 
 And for the network requirements, the following should be supported:
+
 1.Multiple Networking Interface
 
 
 2.High performance data plane including the DPDK based vswitch and PCI pass-through/SR-IOV.
 
+In the Cherry release, besides the Bronze release features, it has the 2 server mode supported. And these 2 servers will be active and standby mode to provide the high availability (HA) capability.
+The controller functionality and storage functionality will be deployed at the 2 servers with standby-active mode managed by "service management". If one server or one service in one server has error, it will be switched from active to standby one to maintain the service availability.
+
+In the Bronze release, the following components and services are enabled:
+
+1. Fault Management
+
+   - Framework for infrastructure services to raise and persist alarm and event data.
+   
+     - Set, clear and query customer alarms
+
+     - Generate customer logs for significant events
+
+   - Maintains an Active Alarm List
+
+   - Provides REST API to query alarms and events, also available through SNMP traps
+
+   - Support for alarm suppression
+
+   - Operator alarms
+
+     - On platform nodes and resources
+
+     - On hosted virtual resources
+
+   - Operator logs - Event List
+
+     - Logging of sets/clears of alarms
+
+     - Related to platform nodes and resources
+    
+     - Related to hosted virtual resources
+
+2. Configuration Management
+
+   - Manages Installation and Commissioning
+   
+     - Auto-discover of new nodes
+
+     - Full Infrastructure management
+
+     - Manage installation parameters (i.e. console, root disks)
+
+   - Nodal Configuration
+
+     - Node role, role profiles
+
+     - Core, memory (including huge page) assignments
+
+     - Network Interfaces and storage assignments
+
+   - Hardware Discovery
+
+     - CPU/cores, SMT, processors, memory, huge pages
+
+     - Storage, ports
+
+     - GPUs, storage, Crypto/compression H/W
+
+3. Software Management
+
+   - Manages Installation and Commissioning
+
+     - Auto-discover of new nodes
+
+     - Full Infrastructure management
+
+     - Manage installation parameters (i.e. console, root disks)
+
+   - Nodal Configuration
 
-It will support the X86_64 and ARM.
+     - Node role, role profiles
 
+     - Core, memory (including huge page) assignments
 
-This is based on Yocto/OpenEmbedded, so it includes a Yocto/OpenEmbedded compatible
-layers meta-oran and wrapper scripts to pull all required Yocto/OE layers to build
-out the reference platform.
+     - Network Interfaces and storage assignments
+
+   - Hardware Discovery
+
+     - CPU/cores, SMT, processors, memory, huge pages
+
+     - Storage, ports
+
+     - GPUs, storage, Crypto/compression H/W
+4. Host Management
+
+   - Full life-cycle and availability management of the physical hosts
+
+   - Detects and automatically handles host failures and initiates recovery
+
+   - Monitoring and fault reporting for:
+
+     - Cluster connectivity
+
+     - Critical process failures
+
+     - Resource utilization thresholds, interface states
+
+     - H/W fault / sensors, host watchdog
+
+     - Activity progress reporting
+
+   - Interfaces with board management (BMC)
+
+     - For out of band reset
+
+     - Power-on/off
+
+     - H/W sensor monitoring
+5. Service Management
+
+   - Manages high availability of critical infrastructure and cluster services
+
+     - Supports many redundancy models: N, or N+M
+
+     - Active or passive monitoring of services
+
+     - Allows for specifying the impact of a service failure and escalation policy
+
+     - Automatically recovers failed services
+
+   - Uses multiple messaging paths to avoid split-brain communication failures
+
+     - Up to 3 independent communication paths
+
+     - LAG can also be configured for multi-link protection of each path
+
+     - Messages are authenticated using HMAC
+
+     - SHA-512 if configured / enabled on an interface by-interface basis
+6. Support the ansible bootstrap to implement the zero touch provisioning
+
+Enable the ansible configuration functions for infrastructure itself including the image installation and service configuration.
+
+
+NOTE: These features leverage the StarlingX (www.starlingx.io). And in Bronze release, these features are only avalaible for IA platform.
+
+NOTE: In Bronze release single server solution is supported only. All the functionalities include controller functions, storage functions and compute functions are integrated in the single server.  
 
 About Yocto and OpenEmbedded
 ----------------------------
@@ -51,8 +183,15 @@ OpenEmbedded is the recommended build system of the Yocto Project, which is a Li
 Foundation workgroup that assists commercial companies in the development of Linux-based
 systems for embedded products.
 
+
+About StarlingX
+---------------
+StarlingX is a complete cloud infrastructure software stack for the edge used by the most demanding applications in industrial IOT, telecom, video delivery and other ultra-low latency use cases. With deterministic low latency required by edge applications, and tools that make distributed edge manageable, StarlingX provides a container-based infrastructure for edge implementations in scalable solutions that is ready for production now.
+
 Contact info
 ------------
 If you need support or add new features/components, please feel free to contact the following:
+
 - Jackie Huang <jackie.huang@windriver.com>
-- Xiaohua Zhang <xiaohua.zhang@windriver.com>
+
+- Xiaohua Zhang <xiaohua.zhang@windriver.com>