# 4G & 5G Onyx Portal 3.1.3 Release Notes
## Release Information
This release note provides information about the 4G and 5G Onyx Portal 3.1.3 release.
### Component Compatibility Information
This release has been verified to be compatible with the following component releases.
Component Compatibility Information for 4G Networks
| For details, contact GXC Technical Support. |
## New Features, Enhancements, and Behavior Changes
This section describes new features, enhancements, and behavior changes introduced in this release.
### Analytics Enhancements
{% hint style="info" %}
**NOTE:** This change is applicable to both 4G and 5G networks.
{% endhint %}
This release introduces enhanced analytics functionality, providing administrators with improved insights into network performance, health monitoring, and operational status. The analytics interface now features a three-tab layout that improves navigation and data organization. This update consolidates performance metrics and introduces new health monitoring capabilities for more comprehensive network oversight.
* **Performance Summary Report** — Formerly **Summary Report**, displays an intuitive, high-level snapshot of key network performance KPIs. Metrics remain organized into logical, easy-to-navigate categories.
* **Performance Analytics** — Formerly **Plots**, displays time-series visualization charts for selected criteria, providing:
* Trend analysis for identifying performance patterns and anomalies over time
* Configurable chart selection via **Manage Reports** button
* Download capability using the **Download All Charts** button
* **Health Analytics** — New in this release.
NOTE: Health Analytics is a restricted-use feature. For more information, contact GXC Technical Support.
The **Health Analytics** tab provides detailed operational and system-level health metrics for network components enabling operators to identify potential issues and system anomalies before they impact service quality.
For detailed information, refer to *4G Onyx Portal 3.1.3 Operations Guide > Analytics,* or *5G Onyx Portal 3.1.3 Operations Guide > Analytics*.
### AP Config/FSM State Parameter
{% hint style="info" %}
**NOTE:** This change is applicable only to 4G networks.
{% endhint %}
In the AP details, the **Config/FSM State** parameter (**Equipment** > **Access Point** tab > Access Point details > **Overview** tab > **AP Properties** section) now displays the current configuration synchronization status between the Onyx Portal and the AP.
The **Config/FSM State** parameter displays one of the following status values:
* **Updating Configuration** — Configuration changes made in the Onyx Portal have not yet been applied to the AP.
* **In Sync** — Configuration between Onyx Portal and the AP is in sync.
* **Disconnected** — The AP is offline and not connected to the Onyx Portal.
* **Rebooting** — The AP is currently rebooting.
* **Stuck** — Configuration update has not completed within 10 minutes of being pushed from the Onyx Portal as the AP is rejecting the configuration.
Hovering over the Config/FSM State value displays additional details in the info tooltip.
This information is intended for troubleshooting and includes:
* **AP-Level Information:**
* **Last Session End Time** — End timestamp of the most recent TR069 session (displayed in local time).
* **Portal Config Time** — Timestamp when the configuration was last updated in the Onyx Portal (displayed in local time).
* **Last Session Start Time** — Start timestamp of the most recent TR069 session (displayed in local time).
* **AP Config Receive Time** — Timestamp when the AP last received the configuration update (displayed in local time).
* **FSM State** — The Finite State Machine (FSM) state of the AP.
* **CBSD-Level Information (CBSD-AP Only)** — For each Citizens Broadband Radio Service Device (CBSD) associated with the AP:
* **Last Session End Time** — End timestamp of the most recent TR069 session (displayed in local time).
* **Portal Config Time** — Timestamp when the CBSD configuration was last updated in the Onyx Portal.
* **AP Config Receive Time** — Timestamp when the AP last received the CBSD configuration update (displayed in local time).
If any debug information is unavailable, the system displays -- (double dashes) in place of value.
### Configurable Security Algorithms
The Onyx Edge now supports configurable security algorithms for both Non-Access Stratum (NAS) and Radio Access Network (RAN) layers.
#### Configurable NAS Security Algorithms
{% hint style="info" %}
**NOTE:** This change is applicable to both 4G and 5G networks.
{% endhint %}
NAS security protects signaling between UE and the core network. The Onyx Edge now supports configuring NAS Integrity and Encryption Algorithm directly in the Onyx Edge configuration.
In 4G networks, supported options include:
* **Integrity Algorithm:**
* **EIA2** — (Default) 128-AES integrity protection
* **EIA1** — 128-SNOW 3G integrity protection
* **Encryption Algorithm:**
* **EEA2** — 128-AES encryption
* **EEA0** — (Default) Null encryption
In 5G networks, supported options include:
* **Integrity Algorithm:**
* **NIA2** — (Default) 128-AES integrity protection
* **NIA1** — 128-SNOW 3G integrity protection
* **Encryption Algorithm:**
* **NEA2** — (Default) 128-AES encryption
* **NEA0** — Null encryption
The NAS security algorithms can be configured in Add/Edit Onyx Edge > **Core** tab > **NAS Security Algorithms**.
The Onyx Edge details page > **Overview** tab > **Core** > **NAS Security Algorithms** section displays an Onyx Edge's current NAS Security Algorithm configuration.
In 4G networks:
In 5G networks:
Selected algorithms apply to all UE connecting through the configured Onyx Edge.
#### Configurable RAN Security Algorithms
{% hint style="info" %}
**NOTE:** This change is applicable only to 5G networks.
{% endhint %}
RAN security protects traffic between UE and the RAN. The Onyx Edge now supports configuring RAN Encryption and Integrity Algorithms directly in the Onyx Edge configuration. Supported options include:
* **NEA2/NIA2** — (Default) 128-AES encryption and integrity
* **NEA1/NIA1** — 128-SNOW 3G encryption and integrity
* **NEA0/NIA1** — Null encryption with 128-SNOW 3G integrity
The RAN Security Algorithms can be configured in Add/Edit Onyx Edge > **RAN** tab > **RAN Security Algorithms**.
The Onyx Edge details page > **Overview** tab > **RAN** section displays an Onyx Edge's current RAN Security Algorithm configuration.
Selected algorithms apply to all UE connecting through the configured Onyx Edge.
### Distributed Antenna System Support
{% hint style="info" %}
**NOTE:** This change is applicable only to 4G networks.
{% endhint %}
The Onyx 4G Platform introduces Distributed Antenna System (DAS) support, enabling operators to extend cellular coverage across large, complex, or high-density environments such as hospitals, high-rise buildings, stadiums, and campuses, where concrete, steel construction, and multi-floor layouts create Radio Frequency (RF) obstacles that traditional AP deployments cannot overcome.
The platform supports both Active DAS and Passive DAS architectures. Active DAS uses RF over Fiber distribution with minimal loss (2–5 dB), ideal for large venues exceeding 50,000 square feet and distances over 2 kilometers. Passive DAS uses RF coax cable distribution with passive splitters and couplers, suitable for small-to-medium venues under 20,000 square feet and cost-sensitive deployments. Both architectures are supported through Wilson DAS (pre-configured equipment) and Generic DAS (manually configured third-party equipment). All deployments require a GXC G501 AP operating in Single Carrier or Carrier Aggregation mode.
Administrators can configure transmission points using two methods. Manual addition allows individual transmission point configuration. Bulk import enables Comma Separated Value (CSV) file upload of up to 1,000 transmission points per file (maximum 5 MB), streamlining large-scale deployments.
Full Spectrum Access System (SAS) integration ensures automated Federal Communications Commission (FCC) Part 96 Citizens Broadband Radio Service (CBRS) compliance. Each transmission point registers as an individual CBSD with the SAS, enabling automated grant management and real-time spectrum coordination. The system supports multi-step registration type. The platform implements intelligent power management through constant gain architecture, where AP power changes result in proportional transmission point adjustments. The system operates with coordinated grant management, functioning at the lowest granted power level across all transmission points to maintain compliance.
Coverage ranges from 5,000–12,000 square feet per transmission point in dense indoor environments to 50,000–100,000 square feet for outdoor deployments. User capacity varies from 10–20 concurrent users per transmission point under heavy usage to 30–50 users under light usage conditions, depending on deployment configuration and environmental factors.
The Onyx Portal provides centralized management for adding, editing, and deleting DAS equipment, configuring transmission points individually or via CSV bulk import, and monitoring real-time system status, CBSD registration, and grant levels. DAS management requires GXC Administrator, Partner Administrator, Super Administrator, or Administrator role permissions.
For detailed information, refer to *4G Onyx Portal 3.1.3 Operations Guide > Manage Equipment > Manage DAS*.
### Managed Neighbor Relations
{% hint style="info" %}
**NOTE:** This change is applicable only to 4G networks.
{% endhint %}
This release introduces a fundamental change in how neighbor relationships are managed in the 4G Onyx Platform. This release transitions from Automatic Neighbor Relations (ANR) to administrator-controlled neighbor configuration, providing complete control over handover behavior, enabling optimization for specific deployment scenarios and operational requirements.
In the previous release, ANR was enabled by default with automatic neighbor discovery through UE measurements. This provided limited control over neighbor relationships.
This release supports the following neighbor configuration modes:
* **Automatic Neighbor Configuration** — This mode configures all cells associated with an Onyx Edge as prospective neighbors.
* **Manual Neighbor Configuration (Explicit Neighbors)** — This mode allows administrators to select specific neighbor cells and define their priority order.
{% hint style="info" %}
**NOTE:** The AP "Neighbor Cell Table" has a limit of 16 cell entries. Priority order determines which neighbors are added when the limit is reached.
{% endhint %}
{% hint style="info" %}
**NOTE:** The AP "Neighbor Frequency Table" has a limit of eight unique frequencies. If an AP has more than eight neighbors with different frequencies, priority order determines which frequencies are included.
{% endhint %}
{% hint style="info" %}
**NOTE:** Changes to neighbor tables result in a reboot of all affected APs, whether from the Onyx Portal or triggered by SAS grant changes.
{% endhint %}
AP handover and neighbor details are displayed in the AP details > **Handover** tab.
AP neighbor and advanced handover configurations are managed in the Add/Edit AP > **Handover** tab.
For detailed information, refer to *4G Onyx Handovers Application Note*.
### Multi-Port Attach SAS Enhancements
{% hint style="info" %}
**NOTE:** This change is applicable only to 5G networks.
{% endhint %}
The 5G Onyx Platform now supports Multi-Port Attach for SAS-enabled deployments, enabling enhanced spectrum management and regulatory compliance for CBRS networks.
Introduced in Onyx 3.1.2 release, the Multi-Port Attach feature extends advanced multi-port capability across all critical 5G channels allowing User Equipment (UE) to dynamically select the best available transmission port instead of being restricted to specific ports. This capability significantly improves network coverage and connection success rates by eliminating limitations that can cause coverage gaps in multi-antenna deployments, while also reducing OPEX by delivering the same coverage and reliability with fewer APs.
With this release, when Multi-Port Attach is enabled, each AP can be configured with multiple antenna ports (1–4 per sector) with each antenna gain configuration generating a unique Citizens Broadband Radio Service Device (CBSD) record. The system automatically manages CBSD generation, registration, and lifecycle operations. During configuration, the backend extracts antenna gain details and converts each antenna gain entry into a corresponding CBSD record, maintaining CBSD serial numbers as a list under each AP's metadata. This granular approach enables precise power and antenna management per AP while maintaining full compliance with SAS requirements.
The Multi-Port Attach support is enabled/disabled per Onyx Edge in the Add/Edit Onyx Edge > **RAN** tab.
For detailed information, refer to *5G Onyx Multi-Port Attach Application Note*.
### RAN Time Sync Configuration
{% hint style="info" %}
**NOTE:** This change is applicable only to 5G networks.
{% endhint %}
The Onyx Edge RAN configuration now includes a Timing Source setting, allowing you to specify the time synchronization source.
Available options:
* **FREE\_RUNNING** — Uses internal clock without external time synchronization.
* **GPS** — Synchronizes timing using GPS signals for precise time and frequency references.
This configuration enables you to select the appropriate timing source based on your deployment requirements. GPS synchronization is recommended for production environments to meet 3GPP timing standards and ensure proper inter-cell coordination.
Configure this in Add/Edit Onyx Edge > **RAN** tab > **Timing Source**.
The Onyx Edge details page > **Overview** tab > **RAN** section displays the current Timing Source configuration.
#### Sync Status Display
{% hint style="info" %}
**NOTE:** This change is applicable only to 5G networks.
{% endhint %}
The Onyx Edge Sync Status icon (Onyx Edge details page > **Overview** tab > **Onyx Edge Details** section) now indicates whether the clock synchronization services are running and properly synchronized.
* **(Green)** — The system is operating normally with the desired timing source.
* **(Red)** — One or more clock services have encountered an error or synchronization failure.
Hovering over the Sync Status icon displays the following details in the info tooltip:
Sync status hover details:
* **SyncE State** — Status from the Synchronous Ethernet service
* **PHC State** — Status from the PTP Hardware Clock (PHC) service
* **TS State** — Status from the Time Synchronization (TS) service
### Onyx Portal Predefined Alerts
{% hint style="info" %}
**NOTE:** This change is applicable to both 4G and 5G networks.
{% endhint %}
The following 4G predefined alert rules are new in this release (Type > Module > **Predefined Alert Rule Name**):
* Access Point > Control Plane > **Neighbor Tables Incomplete**
* Access Point > CU-Plane > **DAS Associated Access Point Cell Service Down**
* DAS > Domain Proxy > **TP CBSD New Grant**
* DAS > Domain Proxy > **TP CBSD Preferred Frequency Unavailable**
* DAS > Domain Proxy > **TP CBSD Preferred Max Power Unavailable**
* DAS > Domain Proxy > **TP CBSD Registration Failure**
For detailed information on these alert rules, refer to the *4G Onyx Portal Alerts Reference*.
The following 5G predefined alert rules are new in this release (Type > Module > **Predefined Alert Rule Name**):
* Access Point > CU-Plane > **Multiport Cell Service Down**
* FHM > Control Plane > **Packet Loss Detected**
* FHM > Management Plane > **Offline**
* Onyx Edge (NR) > S-Plane > **GPS Signal Not Available**
* Onyx Edge (NR) > S-Plane > **PHC2SYS Offset is Too High**
* Onyx Edge (NR) > S-Plane > **TS2PHC Offset is Too High**
For detailed information on these alert rules, refer to the *5G Onyx Portal Alerts Reference*.
### Signal Analyzer Enhancements
{% hint style="info" %}
**NOTE:** This change is applicable only to 5G Onyx Edge (NR+Core) deployments.
{% endhint %}
This release introduces the following enhancements to the Signal Analyzer user interface and analysis capabilities.
* **Multi-Antenna Visualization in 2×2 Grid Layout** — For FHM deployments with multiple antenna configurations, the Signal Analyzer now displays up to four antennas simultaneously in a 2×2 grid layout. Each antenna plot (Antenna 0 through 3) shows uplink and downlink measurements with independent interactive features including tooltips and zoom capability, enabling quick identification of antenna-specific issues and performance comparison across the array.
* **RU Selection for Multi-RU Deployments** — In multi-RU deployments, you can now select specific RUs or all RUs for analysis.
{% hint style="warning" %}
**CAUTION:** Selecting a specific RU in FHM deployments causes service disruption to other RUs as transmission is disabled during analysis. Schedule targeted RU analysis during maintenance windows or select all RUs for continuous monitoring without service impact.
{% endhint %}
* **Power Measurement Units** — All power measurements now use dBm (decibels relative to one milliwatt) instead of dBFS (decibels relative to full scale), aligning with industry-standard RF measurement practices. Historical dBFS data cannot be directly compared with new dBm measurements.
* **Updated Visual Design: New Color Scheme** — Uplink measurements now display in orange (previously blue) and downlink measurements in teal (previously orange) across all plots. This consistent color scheme improves visual differentiation and accessibility, reducing cognitive load during analysis.
{% hint style="info" %}
**NOTE:** The Power Over Time plot has been discontinued in this release. This plot previously displayed slot-level time-domain visualization (10ms frame, slots 0–9) for troubleshooting frame structure, validating TDD configuration, and investigating slot-level power anomalies.
{% endhint %}
{% hint style="info" %}
**NOTE:** The downlink graph is no longer displayed when Listen-Only mode is enabled. In Listen-Only mode, the gNB does not transmit, so downlink measurements would only show environmental noise.
{% endhint %}
For detailed information, refer to *5G Spectrum Analyzer Application Note*.
### Subscriber Speed Test Monitoring
{% hint style="info" %}
**NOTE:** This change is applicable to both 4G and 5G networks.
{% endhint %}
Introduced in Onyx 3.1.2 release, the Subscriber Speed Test enables real-time speed test metrics for subscriber/UE monitoring, providing enhanced visibility into network performance at the per subscriber level.
In this release, the Onyx Portal displays the subscriber speed test results in the subscriber's details page > **Overview** tab > **Speed Test Details** section, and includes the following details:
* **Last Speed Test** — Timestamp of the most recently executed speed test.
* **Uplink Speed** — Measures upload data transfer rate (Mbps).
* **Downlink Speed** — Measures download data transfer rate (Mbps).
* **Jitter** — Tracks latency variation (ms) for connection stability assessment.
* **Ping (RTT)** — Measures round-trip time (ms) for latency evaluation.
Speed test results display as "--" when no data is available.
Speed test functionality requires compatible UE/subscriber equipment.
### Venue-Level SAS Analytics
{% hint style="info" %}
**NOTE:** This change is applicable to both 4G and 5G networks.
{% endhint %}
The Onyx 4G and 5G Platforms now support Venue-Level SAS Analytics, providing comprehensive visibility into surrounding CBRS deployments registered with the SAS. This feature enables network administrators to identify and analyze third-party SAS deployments operating near their venue locations, supporting informed channel selection decisions and proactive interference mitigation strategies. By executing a configurable box search centered on the venue location, administrators can discover which neighboring systems are operating within a specified range (measured in miles), view the specific channels, and understand the complete RF environment before deploying or reconfiguring network equipment.
Venue Analytics includes intelligent filtering capabilities that allow users to focus their analysis on specific CBRS channels, streamlining the process of evaluating channel options and identifying spectrum availability. The feature distinguishes between Category A and Category B CBSD deployments, providing critical context about the scale and interference potential of nearby systems. Category A devices, which are limited to lower power levels and typically represent indoor or small cell deployments, are displayed separately from Category B devices, which operate at higher power levels and represent macro cell or outdoor coverage infrastructure.
Venue Analytics includes intelligent filtering capabilities that allow users to focus their analysis on specific CBRS channels, streamlining the process of evaluating channel options and identifying spectrum availability. The feature distinguishes between Category A and Category B CBSD deployments, providing critical context about the scale and interference potential of nearby systems. Category A devices, which are limited to lower power levels and typically represent indoor or small cell deployments, are displayed separately from Category B devices, which operate at higher power levels and represent macro cell or outdoor coverage infrastructure. This classification helps administrators prioritize their interference analysis and select channels with minimal impact from high-power neighboring transmitters.
This feature directly addresses the challenge of optimizing spectrum utilization in increasingly dense CBRS deployment environments. By providing real-time access to federated SAS data about adjacent deployments, Venue Analytics empowers network planners to identify optimal channel assignments that minimize interference, avoid congested portions of the spectrum, and ensure reliable network performance. The geographic visualization and detailed deployment information enable both proactive planning during initial venue setup and reactive troubleshooting when investigating unexpected interference issues, making Venue Analytics an essential tool for successful private cellular network operations.
Venue-level SAS analytics can be accessed per venue in the Venue details > **SAS Analytics** tab.
For detailed information, refer to *4G Onyx Portal 3.1.3 Operations Guide > Manage Venues,* or *5G Onyx Portal 3.1.3 Operations Guide > Manage Venues*.
## Resolved Issues
There are no issues reported resolved in this release.
## Open Issues
{% hint style="info" %}
**NOTE:** Open issues reported in previous releases, unless subsequently reported as resolved, may exist in this release.
{% endhint %}
The following new open issue is reported in this release.
### Intermittent Missing Data Points in 4G and 5G Analytics Graphs
When viewing Performance Analytics, data points may occasionally be missing from throughput and traffic volume graphs, including Average Downlink Throughput, Average Uplink Throughput, Downlink Traffic Volume, and Uplink Traffic Volume graphs.
This issue occurs intermittently and does not affect the underlying data collection or network performance.
The issue is under investigation and will be addressed in an upcoming release.
**Workaround:** If data appears incomplete, adjust the time window or refresh the analytics view. Data collection continues normally and complete historical data remains available through alternative time ranges.
## Revision History
Date
Updates
2025-12-11
Initial release.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.gxc.io/release-notes/release-notes-archive/onyx-portal-release-notes/4g-and-5g-onyx-portal-3.1.3-release-notes.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.