Description
The Common Language Infrastructure (CLI) is a comprehensive management framework defined by 3GPP to standardize the interface between Operation and Maintenance (O&M) systems and network elements (NEs) from different vendors. It establishes a common command-line syntax, command structure, and semantic meaning for management operations, allowing network operators to use consistent procedures across heterogeneous network equipment. This infrastructure is crucial for automating network management tasks, performing bulk configurations, and ensuring that operational scripts and tools work uniformly regardless of the underlying hardware or software implementation.
Architecturally, CLI operates as a management interface typically accessed via secure shell (SSH) or telnet sessions to network elements like base stations (gNBs, eNBs), core network functions (AMF, SMF, UPF), and user equipment. The framework defines a hierarchical command structure with modes (like global configuration mode, interface configuration mode), context-sensitive help, command completion, and standardized output formats. Key components include the command parser, which interprets user input according to the defined syntax; the authorization and authentication module, which controls access based on user privileges; and the command executor, which translates valid commands into specific actions on the network element's management plane.
CLI's role in the network extends beyond basic configuration to encompass fault management (show commands for alarms and logs), performance monitoring (counters and statistics retrieval), security management (access control lists, certificate management), and software management (image upgrades, patch management). The infrastructure supports both interactive sessions for manual operations and scripted sessions for automation, with output formats designed for both human readability and machine parsing (e.g., XML, JSON in later releases). This dual capability makes CLI essential for day-to-day network operations as well as large-scale orchestration systems.
Implementation-wise, CLI commands are mapped to underlying management protocols and data models, such as NETCONF/YANG or proprietary interfaces. While CLI presents a unified text-based interface to the operator, it acts as a facade that translates commands into protocol-specific operations on the managed entity. The framework also defines conventions for command grouping (e.g., all radio-related commands under a 'radio' hierarchy), standardized parameter names (e.g., cellId, plmnId), and consistent error messages, which significantly reduces the learning curve for engineers working with equipment from multiple vendors.
Purpose & Motivation
CLI was created to address the critical problem of operational complexity in multi-vendor telecommunications networks. Before standardization, each equipment manufacturer implemented proprietary command-line interfaces with different syntaxes, command structures, and behaviors, forcing network operators to maintain separate skill sets, operational procedures, and automation tools for each vendor's equipment. This fragmentation increased operational costs, raised the risk of human error during configuration changes, and hindered large-scale network automation. The Common Language Infrastructure provides a unified management layer that abstracts vendor-specific implementations, enabling consistent network operations.
Historically, as 2G networks evolved into 3G (UMTS) with R99, the need for standardized management became apparent due to the increasing diversity of network elements and the emergence of multi-vendor deployments. CLI was introduced to create a common operational language that would survive technology generations from 3G through 4G to 5G. It solves the fundamental challenge of managing network elements that may have different internal architectures but need to present a consistent management interface to network operators.
The infrastructure addresses limitations of previous approaches by providing not just command standardization but also semantic consistency—ensuring that commands with the same name across different vendors produce equivalent results. This enables operators to write reusable scripts, develop standardized operational procedures, and train personnel on a single interface paradigm. By reducing vendor lock-in at the operational level, CLI promotes healthier competition in the telecommunications equipment market while giving operators greater flexibility in network design and vendor selection.
Classification
Detected Changes Across Releases
from 3GPP Change RequestsSpecific changes extracted from the „Change history“ tables of 3GPP specifications (33 CRs across 4 releases). Complements the general historical overview above with the evidence-based evolution of this function.
In Release 15, the newly introduced CLI function involved clarifications and corrections to common control resource configurations for the access stratum. Specifically, this included defining the frequency reference point for the commonControlResourceSet and providing clarification for the commonSearchSpaceList within PDCCH-ConfigCommon. Additionally, procedures were introduced for transferring common configuration during handover and for correcting the presence conditions for common parameters related to secondary cells.
- Correction to commonControlResourceSet TS 38.331CR0418
- Clarification of commonControlResourceSet frequency reference point TS 38.331CR1045
- CR on transferring common configuration during handover and SN change TS 38.331CR1053
- Clarification to commonSearchSpaceList in PDCCH-ConfigCommon TS 38.331CR1116
- Correction of presence conditions for common PSCell parameters TS 38.331CR1224
In Release 16, the new CLI (Cross Link Interference) function introduced UE behavior for SRS (Sounding Reference Signal) measurements, specific handling procedures in the RRC specification (TS 38.331), and support on the Xn interface (XnAP). The release also included configuration details and multiple corrections to the initial SRS-RSRP reception and general CLI procedures to solidify the feature's implementation.
- Introduction of UE behaviour for SRS measurements for CLI TS 38.214CR0043
- Introduction of CLI handling and RIM in TS38.331 TS 38.331CR1494
- BL CR to 38.423: CLI support on XnAP TS 38.423CR0089
- Support for CLI TS 38.473CR0287
- Correction on SRS-RSRP reception procedure for CLI TS 38.214CR0094
- CLI Corrections TS 38.300CR0217
+ 8 more changes
In Release 17, the CLI function was enhanced with the introduction of common RACH partitioning aspects and associated common signalling procedures for RACH partitioning. This included specific corrections to ensure these features were properly applicable. Furthermore, the release conducted inclusive language reviews across several core specifications, including TS 38.300 and TS 38.331.
- Introduction of Common RACH Partitioning Aspects TS 38.331CR2951
- CR on FDMed unicast PDSCH and group-common PDSCH TS 38.214CR0410
- Correction for features applicable for common signalling for RACH Partitioning TS 38.331CR3469
- Inclusive language review on 3GPP TS 31.102 TS 31.102CR0911
- Inclusive Language Review for TS 38.300 TS 38.300CR0401
- Inclusive Language Review for TS 38.331 TS 38.331CR2459
In Release 19, the enhancements for CLI (Common Language Infrastructure) primarily involved clarifications and corrections to existing UE-to-UE interference mitigation procedures. Specifically, the release provided clarification on the number of simultaneous L1 CLI-RSSI and L1 SRS-RSRP measurement resources a UE can handle, and it corrected the maximum number of associated measurement resource sets. Additionally, it introduced corrections to the CLI Indication procedures over the XnAP and F1AP interfaces.
- Introduction of common PDCCH repetition (Rel-19 NTN) for TN [Common_PDCCH_rep_TN] TS 38.300CR1058
- Updates of Rel-19 UE capability, including [Simul_SRSCS], [Common_PDCCH_rep_TN], [Pos_SRSHop] TS 38.331CR5590
- Clarification on the number of simultaneous L1 CLI-RSSI and simultaneous L1 SRS-RSRP measurement resources TS 38.214CR0745
- Correction on the maximum number of SRS-RSRP measurement resource sets and CLI-RSSI measurement resource sets TS 38.214CR0746
- Clarification to UE-to-UE CLI mitigation in SBFD operation TS 38.300CR1080
- Introduction of SIB1 PDSCH repetition for FR1 TN [Common_PDCCH_rep_TN] TS 38.300CR1085
+ 2 more changes
Explore further
Broader topics and technologies where CLI plays a role.
Defining Specifications
3GPP specifications that define or reference CLI, with the latest known release. Sourced from the 3GPP document catalog — see methodology.
| Specification | Title | Release |
|---|---|---|
| TR 21.905 vj00 | 3GPP Technical Terms and Definitions | Rel-19 |
| TS 23.057 vj00 | Mobile Execution Environment (MExE) Specification | Rel-19 |
| TS 23.218 vj00 | IMS Call Model Specification | Rel-19 |
| TS 28.552 vk10 | 5G Performance Management Measurements | Rel-20 |
| TS 31.102 vj40 | USIM Application Specification | Rel-19 |
| TS 32.101 vj00 | Management principles and high-level requirements | Rel-19 |
| TS 33.831 vc00 | Study on Spoofed Call Detection & Prevention | Rel-12 |
| TS 37.340 vj00 | Multi-Connectivity Operation Overview | Rel-19 |
| TS 38.214 vj10 | NR Physical Layer Procedures for Data | Rel-19 |
| TS 38.215 vj10 | NR Physical Layer Measurements | Rel-19 |
| TS 38.300 vj00 | NG-RAN Overall Description | Rel-19 |
| TS 38.331 vj00 | NR Radio Resource Control (RRC) Protocol Specification | Rel-19 |
| TS 38.401 vj10 | NG-RAN Architecture Specification | Rel-19 |
| TS 38.420 vj10 | Introduction to Xn interface specifications | Rel-19 |
| TS 38.423 vj10 | Xn Application Protocol (XnAP) specification | Rel-19 |
| TS 38.470 vj10 | F1 Interface Introduction | Rel-19 |
| TS 38.473 vj10 | 5G F1 Application Protocol (F1AP) | Rel-19 |
| TR 38.828 vg10 | CLI and RIM for NR | Rel-16 |
| TR 38.858 vi20 | Technical Report on Evolution of NR Duplex Operation | Rel-18 |