> For the complete documentation index, see [llms.txt](https://docs.gxc.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gxc.io/release-notes/onyx-release-notes/onyx-4.1.3-release-notes.md).

# Onyx 4.1.3 Release Notes

## Release Information <a href="#release-information" id="release-information"></a>

This Release Notes provides information about the 4G and 5G Onyx 4.1.3 release.

**Release Highlights**

1. **Onyx 5G NR support on the Onyx NG2**: the Onyx 5G NR can now be deployed on the Onyx NG2 network gateway.
2. **Onyx 5G NR performance improvements**: a single cell supports 128 UEs in both 40 MHz and 100 MHz configurations.
3. **QoS profile configuration for all Non-GBR QCIs on 5G (LTE parity)**: the QoS Category on 5G APNs can now be configured in the Onyx Portal, the same as LTE. You can choose High, Medium or Low Priority Data, or a Custom profile with QCI 5 to 9, ARP priority and pre-emption settings.

### Impacted Components

Components that have the 4.1.3 upgrade.

| Component                   | Upgrade Applicable |
| --------------------------- | ------------------ |
| Onyx Edge Core              | **Yes (5G only)**  |
| Onyx Edge NR                | **Yes**            |
| Portal                      | **Yes**            |
| 4G APs (G100 / G101 / G501) | No change          |
| 5G APs (G105 / G505 / G506) | No change          |
| Mesh Node                   | No change          |
| FHM                         | No change          |

### Component Compatibility Information <a href="#component-compatibility-information" id="component-compatibility-information"></a>

This release has been verified to be compatible with the following component software versions.

<p align="center"><strong>4G Component Software Version Compatibility</strong></p>

| Component                                                                                       | Release        |
| ----------------------------------------------------------------------------------------------- | -------------- |
| Onyx Portal                                                                                     | 4.1.3          |
| Onyx Edge                                                                                       | 4.1.3          |
| Mesh Node                                                                                       | 3.1.0          |
| <p>G100 Indoor Access Point</p><p>G101 Outdoor Access Point</p><p>G501 Outdoor Access Point</p> | BaiBLQ\_3.1.14 |

<p align="center"><strong>5G Component Software Version Compatibility</strong></p>

| Component                                                                                                                                                                                                                                                                                                                                                                                                                           | Release                                                    |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Onyx Portal                                                                                                                                                                                                                                                                                                                                                                                                                         | 4.1.3                                                      |
| Onyx Edge                                                                                                                                                                                                                                                                                                                                                                                                                           | 4.1.3                                                      |
| Onyx FHM                                                                                                                                                                                                                                                                                                                                                                                                                            | 2.0.7                                                      |
| Mesh Node                                                                                                                                                                                                                                                                                                                                                                                                                           | 4.1.3                                                      |
| <p>G105-n48F Indoor Access Point</p><p>G105-n48P Indoor Access Point</p><p>G105-n77 Indoor Access Point</p><p>G105-n78F Indoor Access Point</p><p>G105-n78P Indoor Access Point</p><p>G227 Indoor Access Point</p><p>G228 Outdoor Access Point</p><p>G244 Outdoor Access Point</p><p>G505-n48P Outdoor Access Point</p><p>G506-n77 Outdoor Access Point</p><p>G506-n78 Outdoor Access Point</p><p>G509-n79 Outdoor Access Point</p> | <p>For details, contact GXC Technical Support.<br><br></p> |

## New Features, Enhancements, & Behavior Changes

This section describes new features, enhancements, and behavior changes introduced in this release.

### Onyx Portal Changes

#### QoS Category Configuration for 5G APNs

This change is applicable only to 5G networks.

The QoS Category on the Add APN and Edit APN forms (**Traffic > APNs > Add APN / Edit**) was fixed at **Low Priority Data (QCI 9)** and could not be changed. High Priority Data, Medium Priority Data, Low Priority Data and Custom can now be selected, the same as for LTE APNs. Each selection is saved and reopens as chosen.

| QoS Category                | QCI    | ARP priority | Pre-emption                             |
| --------------------------- | ------ | ------------ | --------------------------------------- |
| High Priority Data          | 6      | 15           | Off                                     |
| Medium Priority Data        | 8      | 15           | Off                                     |
| Low Priority Data (default) | 9      | 15           | Off                                     |
| Custom                      | 5 to 9 | 1 to 14      | Capability and vulnerability, on or off |

With **Custom**, you set the QCI (5 to 9), the ARP priority level (1 is the highest priority) and the pre-emption capability and vulnerability. All values are Non-GBR and apply to the APN's default QoS flow.

The field is labeled QCI on both 4G and 5G rather than 5QI. This will be revisited when dedicated bearers are implemented for 5G.

The full range of standard Non-GBR QCIs is now open, so you can test different QoS settings with your RAN and choose the ones that give the best performance on your network.

#### Subscriber Bulk Assign for Customer Super Admins

This change is applicable to both 4G and 5G networks.

Bulk subscriber assignment was available only to GXC administrators. Customer Super Admins can now bulk assign subscribers on their own networks.

#### APN Configuration Form Corrections

This change is applicable to both 4G and 5G networks.

Several corrections were made to the Add APN and Edit APN forms:

* Moving focus onto the read-only APN ID field no longer reports "APN ID already present" or disables Save APN, so an existing APN can be edited.
* Selecting Custom again on an APN already set to Custom no longer resets QCI to 5 and ARP to 1.
* A Custom APN no longer accepts an ARP value of 15 and then reopens as a preset category or with no category set.
* Deleting an APN no longer adds a second set of QCI and Pre-emption columns to the APN list.

#### New Account Email Rendering

This change is applicable to both 4G and 5G networks.

Images now render correctly in the email sent when a new customer account is created.

### Core Network Changes

#### Uplink Flow Cleanup

This change is applicable only to 5G networks.

Uplink flows that are no longer in use are now removed rather than accumulating on the Onyx Edge over time.

### RAN Changes

#### Onyx NG2 Platform Support

This change is applicable only to 5G networks.

The Onyx 5G NR (Onyx Edge NR) is now supported on the Onyx NG2 network gateway, which runs the Core, the Central Unit and the Distributed Unit on a single 1U appliance and serves PTP timing to the radio units connected to it.

For hardware details see [NG2 Specification Sheet](https://docs.gxc.io/hw/5g/5g-network-appliances/onyx-ng2/ng2-specification-sheet).

#### Multi-UE Performance and Stability Improvements

This change is applicable only to 5G networks.

The Onyx 5G NR has been improved for cells serving many devices at once:

* **Capacity**: a single cell supports up to 128 connected UEs passing traffic, in both 40 MHz and 100 MHz configurations. Devices now connect reliably while heavy bidirectional traffic is running.
* **Stability**: the distributed unit no longer crashes or restarts under sustained multi-device traffic.
* **Connection retention**: devices are no longer released unexpectedly when the cell is under full downlink load.
* **Connection recovery**: RRC re-establishment now completes, so a device no longer remains attached without carrying traffic. Random access started by a scheduling request failure now resolves contention and restores the uplink grant. The gNB no longer pauses random access responses and uplink grants across the whole cell, which previously made many devices fail at once.
* **Radio robustness**: RSRP saturation detection has been added for devices very close to the radio unit.

#### Continuous Radio KPI Reporting

This change is applicable only to 5G networks.

Downlink RSRP, RSRQ and SINR key performance indicators continue to be reported after an upgrade, and per-subscriber metrics continue to be reported after a device moves from idle to connected.

#### Packet Delivery Timing on Prose Radio Units

This change is applicable only to 5G networks.

Late packet delivery observed on Prose radio units once a device started passing data has been corrected.

## **Resolved Issues**

There are no previously reported open issues resolved in this release.

## Open Issues <a href="#open-issues" id="open-issues"></a>

{% hint style="info" %}
**NOTE**: Open issues reported in previous releases, unless subsequently reported as resolved, may exist in this release.
{% endhint %}

There are no new open issues reported in this release.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.gxc.io/release-notes/onyx-release-notes/onyx-4.1.3-release-notes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
