CLI

Common Language Infrastructure

Management →
Introduced in R99 Also in: Services, User Equipment, Management

CLI is the Common Language Infrastructure, a standardized framework for managing multi-vendor telecommunications network elements and services using a common syntax and semantics for configuration, fault, and performance management.

Category
Management
Introduced
R99
Where
Radio Access Network › NG-RAN (5G)
Also touches
3 segments
Specifications
19 specs
CLI Description Purpose Related Classification Detected Changes Specifications

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

Part ofOAM
Specific typesOIP

Detected Changes Across Releases

from 3GPP Change Requests

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

Rel-15 5 changes

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
Rel-16 14 changes

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

Rel-17 6 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
Rel-19 8 changes

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.

SpecificationTitleRelease
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