Manage Onyx Edge
The Onyx Edge is the core network function of the 5G Onyx system. It provides connectivity between the Onyx Portal and the FHMs and APs. The Onyx Edge terminates Control Plane signaling from the APs, handles management plane communications from the Onyx Portal, and enforces traffic policies on subscriber data (User Plane) traffic.
View Onyx Edge Details
This section describes how to view Onyx Edge details.
View Onyx Edge (NR+Core) Details
This section describes how to view details of Onyx Edge (NR+Core).
View Summary Details of All Onyx Edge (NR+Core)
To view the summary details of all Onyx Edge (NR+Core) in a 5G network:
In the navigation pane, click Equipment > Onyx Edge (NR+Core) tab or Onyx Edge tab.
The Equipment page > Onyx Edge (NR+Core) tab or the Onyx Edge tab displays the summary details of all Onyx Edge (NR+Core) configured in the network.
Onyx Edge (n) – (n) Indicates the number of Onyx Edge (NR+Core) in the network.
Status of services running on the Onyx Edge.
Green – Indicates all critical services are up and running, none of the critical services were restarted in the last five minutes, and the Onyx Edge's Interface Status is green.
Amber – Indicates all critical services are up and running, but critical services have restarted up to three times in the last five minutes, and the Onyx Edge's Interface Status is green or amber.
Red – Indicates some critical service has gone down in the last five minutes, or critical services have restarted up to three times in the last five minutes, or the Onyx Edge's Interface Status is red.
Grey – Indicates the Onyx Edge is offline, or data is not available.
Hover your cursor over the Service Status icon to view the list of services that are up/down/restarted.
Name – The Onyx Edge's name.
Venue / VM – The name of the venue or the VM hosting the Onyx Edge.
AP/FHM – The number of APs/FHMs that are connected to the Onyx Edge is displayed in green, and those that are disconnected in red. To view the AP/FHM names, hover your cursor over the counts.
Subs – The number of subscribers connected to the Onyx Edge.
Online – The Onyx Edge's online status indicating its reachability from the Onyx Portal.
Green – Indicates the Onyx Edge has checked-in with Onyx Portal in the last five minutes.
Red – Indicates the Onyx Edge has not checked-in with the Onyx Portal in the last five minutes.
Hover your cursor over the Online Status icon to view the following details.
Interface Status – Indicates connection status of N6 and RAN (Fronthaul) interfaces.
Green – Indicates all APs are AMF-connected to the Onyx Edge, the N6 interface is up and has IP, and N6 link is active (periodic ICMP checks every five minutes).
Amber – Indicates at least one AP is AMF-connected, but some are not, the N6 interface is UP and has IP (N6 link is active).
Red – Indicates none of the APs are AMF-connected (that is all APs are AMF-disconnected or management-disconnected (AMF status is unknown)), or the N6 interface is not up or is not active (N6 link activity check through ICMP).
Grey – Indicates the Onyx Edge is offline.
Hover your cursor over the "Interface Status" icon to view the following details.
Sync Status — Indicates the Onyx Edge's synchronization status with the timing source.
Green – The Onyx Edge is in sync with the timing source.
Red – The Onyx Edge is out of sync with the timing source.
Grey – The Onyx Edge is offline, or sync status is not available.
Hover your cursor over the Sync Status icon to view the following details:
Compute Resource – Indicates utilization of the Onyx Edge's computing resources – CPU, memory, and disk utilization percentage.
Green – Indicates all parameters are below 50%.
Amber – Indicates at least one parameter is above 50% and below 70%.
Red – Indicates at least one parameter is above 70%.
Grey – Indicates the Onyx Edge is offline.
Hover your cursor over the Compute Resource icon to view the following details:
Disk Utilization – Percentage of disk space used for the volume mounted at root.
CPU Utilization – System-wide CPU utilization as percentage over one second.
Memory Utilization – Percentage of memory used.
Actions – Options to view details, edit, and delete the Onyx Edge.
Upgrade Onyx Edge – (GXC Administrators only.) To upgrade the Onyx Edge software on the Onyx Edge AGWs in the network. For information on managing Onyx Edge upgrades, see Manage Onyx Edge Software Upgrades.
Show Graphs / Hide Graphs — Collapsible panel of Onyx Edge performance charts. Default: Collapsed to improve page performance.
UE Throughput – Trend chart of the throughput of all UE for the selected Onyx Edge, direction, and duration. The chart represents downlink throughput in blue and uplink throughput in green color.
Onyx Edge Connected with Onyx Portal – Trend chart of the number of Onyx Edge connected with the Onyx Portal in the selected duration.
UE Attach Status – Chart of control plane transaction success/failure status for the selected Onyx Edge, transaction type, and duration. Success count is displayed in green, and failure count in red color.
You can select the event type from the following:
Registration (Initial) – First network registration attempt after UE power-on or SIM activation.
Registration (MobUpd) – Registration updates triggered by UE mobility (changing tracking areas).
Registration (Periodic) – Scheduled periodic re-registration to maintain network presence.
Auth Request – Authentication procedure events.
PDN Establishment Request – Session setup for data connectivity.
Service Request – Resume of idle-mode UE sessions.
View Details of an Onyx Edge (NR+Core)
To view the details of an Onyx Edge (NR+Core) in a 5G network:
In the navigation pane, click Equipment > Onyx Edge (NR+Core) tab or Onyx Edge tab.
The Equipment page > Onyx Edge (NR+Core) tab or Onyx Edge tab displays the summary details of all Onyx Edge (NR+Core) configured in the network.
To view the details of a particular Onyx Edge (NR+Core), in the Onyx Edge (n) panel, click its name.
The <onyx edge name> page displays the following details:
Overview tab:
Onyx Edge Details:
Name – The Onyx Edge's name.
Host Name – The Onyx Edge's hostname.
Description – The Onyx Edge's description.
NR Version – The Onyx Edge's NR software version.
Core Version – The Onyx Edge's Core software version.
Up Time – The duration for which the Onyx Edge has been operational without any downtime or interruptions.
Management IP – The management IP address for the Onyx Edge.
N6 IP – The IP address and subnet of the N6 interface.
Hardware Address – The Onyx Edge's eth0 hardware address.
NR Upgrade Status – Status of the last NR software upgrade.
Core Upgrade Status – Status of the last Onyx Edge software upgrade.
To view the Core or NR upgrade details, click the corresponding status. The Upgrade Status dialog box displays the following details:
Description – Description of the last upgrade's status.
Old Version – The Onyx Edge software version before the upgrade.
New Version – The new Onyx Edge software version.
Updated At – The timestamp at which the last upgrade completed.
Start Time – The timestamp at which the last upgrade started.
Venue – The name of the venue hosting the Onyx Edge. To view the venue's details, click its name.
More Info >> – Click to view the following additional details. The More Details dialog box is displayed.
Hardware UUID – The Onyx Edge's Hardware Universally Unique Identifier (UUID) used for device authentication to ensure secure communication. To copy the hardware UUID to the clipboard, click the
copy icon.Challenge Key – The Onyx Edge's Challenge Key used in challenge-response authentication mechanism. To copy the challenge key to the clipboard, click the
copy icon.
The Onyx Edge's health status.
Online – The Onyx Edge's online status indicating its reachability from the Onyx Portal.
Green – Indicates the Onyx Edge has checked-in with Onyx Portal in the last five minutes.
Red – Indicates the Onyx Edge has not checked-in with the Onyx Portal in the last five minutes.
Hover your cursor over the Online Status icon to view the following details.
Interface Status – The Onyx Edge's interface status indicating the connection status of SGi and RAN (S1) interfaces.
Green – Indicates all APs are MME-connected to the Onyx Edge, the SGi interface is up and has IP, and SGi link is active (periodic ICMP checks every five minutes).
Amber – Indicates at least one AP is MME-connected, but some are not, the SGi interface is UP and has IP (SGi link is active).
Red – Indicates none of the APs are MME-connected (that is all APs are MME-disconnected or management-disconnected (MME status is unknown)), or the SGi interface is not up or is not active (SGi link activity check through ICMP).
Grey – Indicates the Onyx Edge is offline, or data is not available.
Hover your cursor over the Interface Status icon to view the following details.
Compute Resource – Status of the Onyx Edge's computing resources.
Green – Indicates all parameters are below 50%.
Amber – Indicates at least one parameter is above 50% and below 70%.
Red – Indicates at least one parameter is above 70%.
Grey – Indicates the Onyx Edge is offline.
Hover your cursor over the Compute Resource Status icon to view the following details:
Disk Utilization – Percentage of disk space used for the volume mounted at root.
CPU Utilization – System-wide CPU utilization as percentage over one second.
Memory Utilization – Percentage of memory used.
Service Status – Status of the Onyx Edge's services. Hover your cursor over the "Service Status" icon to view details.
Green – Indicates all critical services are up and running, none of the critical services were restarted in the last five minutes, and the Onyx Edge's Interface Status is green.
Amber – Indicates all critical services are up and running, but critical services have restarted up to three times in the last five minutes, and the Onyx Edge's Interface Status is green or amber.
Red – Indicates some critical service has gone down in the last five minutes, or critical services have restarted up to three times in the last five minutes, or the Onyx Edge's Interface Status is red.
Grey – Indicates the Onyx Edge is offline, or data is not available.
Hover your cursor over the Service Status icon to view the following details.
Sync Status – Indicates the Onyx Edge's synchronization status with the timing source.
- Green – The Onyx Edge is in sync with the timing source.
- Red – The Onyx Edge is out of sync with the timing source.
- Grey – The Onyx Edge is offline, or sync status is not available.
Hover your cursor over the Sync Status icon to view the following details:
PHC State — Status of the Precision Hardware Clock (PHC) used for accurate packet timestamping.
SyncE State — Status of Synchronous Ethernet (SyncE) frequency synchronization over the physical layer.
GPS State — Status of the GPS receiver used as the primary time reference source.
Data Usage – The Onyx Edge's data usage for the selected duration.
Download – The download data usage for the selected duration.
Upload – The upload data usage for the selected duration.
Dynamic Services – Status of the Onyx Edge's dynamic services.
CPE Monitoring – The status of the CPE Monitoring service—Enabled or Disabled. When enabled, the Onyx Edge sends ICMP pings every minute to each connected UE. The measured round-trip time (RTT) latency is reported in the per-subscriber details. See Subscribers > Subscriber details > UE Latency parameter.
Spectrum Analyzer – The Spectrum Analyzer service's status—Enabled or Disabled. When enabled, it provides real-time, per-cell analysis and visualization of uplink and downlink power characteristics across the RF spectrum, allowing administrators to monitor signal quality, detect interference, and optimize network performance. For more information, see Spectrum Analyzer.
APN-VLAN Details – (Displayed only in VLAN mode.) For each APN, the following details are displayed. Note that APNs are common to all Onyx Edge in the network.
APN Name – The APN's name. To view the APN's details, click its name.
VLAN – The VLAN ID.
Local IP – The local IP address / subnet of the Onyx Edge on the VLAN.
Default GW IP – The Onyx Edge's IP address.
Default GW MAC – The Onyx Edge's MAC address.
UE-IP-Block: IP Block – Indicates whether the UE IP block feature is enabled or disabled.
UE-IP-Block: Start IP – The start IP address of the UE IP block range.
UE-IP-Block: End IP – The end IP address of the UE IP block range.
Core: The Onyx Edge's Core settings.
UE IP Configuration:
IP Range – (Displayed only in NAT Mode.) The IP address range from which the Onyx Edge allocates IP addresses to UE.
IP Retention Time (Sec) – The duration (in seconds) for which a UE's IP address is retained/leased after it disconnects.
DNS Server for UE:
Onyx Edge-as-DNS-Server – Indicates if the Onyx Edge functions as the DNS server—Enabled or Disabled.
DNS Second Server – (Displayed only when Onyx Edge-as-DNS-Server is enabled.) Enabled or Disabled. When enabled, if the "ONYX-Edge-as-DNS-Server" is unavailable, or if it fails to resolve domain name, the UE will contact the secondary DNS server for domain name resolution.
DNS Primary – The primary DNS server's IP address.
DNS Secondary – The secondary DNS server's IP address.
Management Interface – (VLAN Mode only) The UE IP address allocation mode—Static or DHCP.
Management IP Subnet – (Displayed only if UE IP allocation mode is Static.) The management IP address for Onyx Edge to reach corporate network/internet.
N6 IP – (Displayed only if UE IP allocation mode is Static.) The IP address of the N6 interface.
Gateway – (Displayed only if UE IP allocation mode is Static.) The corporate gateway router IP address.
DNS Primary – (Displayed only if UE IP allocation mode is Static.) The primary DNS server's IP address.
DNS Secondary – (Displayed only if UE IP allocation mode is Static.) The secondary DNS server's IP address.
SGI Management VLAN – (Displayed only for VLAN mode if UE IP allocation mode is Static.) The SGi Management VLAN ID.
NAS Security Algorithms
Integrity Algorithm – The NAS integrity protection algorithm in use.
Encryption Algorithm – The NAS encryption algorithm in use.
DHCP Server Monitoring — (Displayed only in VLAN mode) Indicates whether DHCP Server Monitoring is active for this Onyx Edge — Enabled, Disabled.
Frequency — (Displayed only in VLAN mode if DHCP Server Monitoring is enabled) How often the system checks DHCP server availability, in minutes.
MAC — (Displayed only in VLAN mode if DHCP Server Monitoring is enabled) The MAC address used by the monitoring probe when sending DHCP requests.
VLAN — (Displayed only in VLAN mode if DHCP Server Monitoring is enabled) The VLAN on which the monitoring probe sends DHCP requests, ensuring the check targets the correct network segment.
RAN: The Onyx Edge's (NR+Core) RAN settings.
Band – The frequency band in use.
Slot Pattern – The slot pattern configuration indicating the DL/UL frame structure.
DDDDDDDSUU (DL 77%, UL 21%) – Allocates approximately 77% subframes for downlink and 21% for uplink.
DDDSU (DL 74%, UL 23%) – Allocates approximately 74% subframes for downlink and 23% for uplink.
DDSUU (DL 54%, UL 43%) – Allocates approximately 54% subframes for downlink and 43% for uplink.
DSUUU (DL 34%, UL 63%) – Allocates approximately 34% subframes for downlink and 63% for uplink.
DSUUUUDSUU (DL 25%, UL 72%) – Allocates approximately 25% subframes for downlink and 72% for uplink.
DDSUUUUUUU (DL 20%, UL 77%) – Allocates approximately 20% subframes for downlink and 77% for uplink.
Multi-Port Attach – Indicates whether the Multi Port Attach feature is enabled or disabled. For more information, see Multi-Port Attach Support.
Timing Source – The timing synchronization source in use (e.g., GPS).
Integrity Algorithm – The RAN integrity protection algorithm in use.
Encryption Algorithm – The RAN encryption algorithm in use.
The table displays the following cell-specific details:
Name – The cell's name.
Cell Local ID – The local ID assigned to the cell within the gNB.
gNB ID – The unique ID assigned to the gNB serving this cell.
BW – The channel bandwidth allocated for the cell.
Freq – The frequency at which the cell operates.
AP/FHM – The associated AP or FHM linked to this cell.
PCI – The Physical Cell Identifier (PCI) assigned to the cell.
PSS – The Primary Synchronization Signal (PSS) index assigned to the cell.
SAS – The status of the cell's SAS registration.
Actions – Option to start the Spectrum Analyzer for a cell. For more information, see Spectrum Analyzer.
Connected Access Point / FHM – Details of APs/FHMs connected to the Onyx Edge:
The AP's/FHM's RF Tx status.
Name – The AP's/FHM's name.
Serial No. – The AP/FHM equipment's vendor-assigned serial number.
IP Address – The AP's/FHM's IP address.
Online – The AP's/FHM's online status.
Interface Status – The AP's/FHM's interface status.
Sync Status – The AP's sync status.
Connected APs – (Displayed only for FHM entries.) Click to view the list of APs connected to through the FHM.
Subscribers – Details of subscribers connected to the Onyx Edge.
Status – The subscriber account's status.
Name – The subscriber account's name.
IMSI – The subscriber's IMSI. To view the subscriber account's details, click the IMSI.
Subscriber Group ID – The subscriber group that the subscriber account is associated with. To view the subscriber group's details, click its name. For information on subscriber groups, see Manage Subscriber Groups.
gNB ID/Cell ID – The gNB ID (Onyx Edge ID) and Cell ID to which the subscriber is connected.
View All Subscribers – Click to view details of all subscriber accounts in the network. The Subscribers page > Subscriber tab is displayed.
Backhaul Speedtest – Prioritized list of iPerf-compatible speedtest servers used to measure backhaul link performance, with an edit control to manage the list. The following details are shown for each entry:
Priority – The priority order in which speedtest servers are tried.
URL – The hostname/URL of the speedtest server.
Port Range – The port range used for the speedtest.
Click the Events & Alerts tab.
Alerts – Details of Onyx Edge related alerts for the selected severity level:
You can select the alert severity level from All, Major, Minor, Critical, or Others.
Date – The alert’s creation timestamp.
Status – The alert’s status.
Alert Name – The alert’s name.
Severity – The alert’s severity.
To view an alert’s details, click the corresponding row.
Events – Details of Onyx Edge related events for the selected events and time duration:
NR / Core – Switch between NR and Core network events.
To change the date and time range, select the required timestamps in the
fields. The events list automatically updates to display the corresponding logs.Timestamp – The event’s creation timestamp.
Module – The specific module or source from which the event originated. To filter the events based on module, click the Module column header and select one or more modules.
Event Type – The event’s type. To filter the events based on the event type, click the Event Type header and select one or more event types.
Entity – The entity’s name.
Event Description – The event’s description.
To view more details for a particular event, click the corresponding
(view details) icon.
Click the Logs tab.
Logs (n) – The number of logs for the Onyx Edge in the selected type and date and time range.
NR / Core – Allows switching between NR and Core network logs.
Download Logs – To download the logs in .csv format, in the
field, enter the number of logs to be included in the .csv file, then click 
. Default value: 1000. The downloaded .csv file includes details such as the timestamp, service, tag, type, and log text.Date and Time Range – To view logs in a specific date and time range, select the required timestamps in the
fields. The logs list automatically updates to display the corresponding logs.Search Logs – To search for a log, in the
field, enter your search term. The logs list updates automatically to display matching logs.Timestamp – The date and time at which the log was created.
Service – The specific service associated with the log.
Tag – The event’s tag—a label associated with the log entry.
Type – The log’s type.
Output – The log’s message.
Click the Handover tab.
The Handover Configuration table displays the following details for each cell:
Name – The cell's name.
PCI – The Physical Cell Identifier assigned to the cell.
Frequency – The cell's operating frequency.
Neighbors – The cell's configured neighbor relations, with Explicit, Desired, and Configured neighbor-list values.
Hysteresis (dB) – The hysteresis margin applied before triggering a handover measurement report.
Time To Trigger (ms) – The duration a triggering condition must persist before the handover event fires.
RSRP – Threshold values (dBm) for each configured handover event: A1, A2, A3 Offset, A5-Serving Cell, and A5-Neighbor Cell.
Actions – (Enabled only when the Onyx Edge is online.) In the upper-right corner of the page, click the Actions button to access the following options:
Upgrade – (GXC Administrators, Super Administrators, and Administrators only.) Upgrade the Onyx Edge’s software version, move the Onyx Edge to the required target upgrade group. For more information, see Move an Onyx Edge from one Upgrade Group to Another.
Reboot Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Reboot the Onyx Edge. Services will be down while the equipment reboots.
Restart Services on Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Restart the Onyx Edge’s core services. Connectivity will be down until the services resume.
Ping – (GXC Administrators, Super Administrators, and Administrators only.) Ping the Onyx Edge’s host.
Enter the following details, then click Ping.
Host – (Required) The host’s IP address.
Packets (default 4) – (Optional) The number of packets to send. Default: 4.
Detach Subscriber – (GXC Administrators, Super Administrators, and Administrators only.) Forcibly detach an active subscriber/UE.
Enter the following details, then click Execute.
Subscriber IMSI – The subscriber’s IMSI.
Force Config Sync – (GXC Administrators, Super Administrators, and Administrators only.) Trigger a full configuration synchronization.
Force Status Sync from Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Trigger Onyx Edge state synchronization. This action control is useful when investigating stale status displays or validating a change without waiting for the next periodic sync.
Force Subscriber Config Sync – (GXC Administrators and Super Administrators only.) Trigger a configuration synchronization for a specific subscriber.
Trigger Debug Information Collection – (GXC Administrators, Super Administrators, and Administrators only.) Collect logs and telemetry from Onyx Edge.
List Debug Information Files in OE – (GXC Administrators, Super Administrators, and Administrators only.) View downloadable debug files available on the Onyx Edge.
Generic Command – (GXC Administrators only.) Run generic commands on the Onyx Edge.
The Run Onyx Edge Command dialog box is displayed.
Enter the following details, then click Execute:
Command – (Required) The command to run.
Parameters – (Optional) Parameters for the command.
View Onyx Edge (Core) Details
This section describes how to view Onyx Edge (Core) details in a 5G network.
View Summary Details of All Onyx Edge (Core)
To view the summary details of all Onyx Edge (Core) in a 5G network:
In the navigation pane, click Equipment > Onyx Edge (Core) tab or Onyx Edge tab.
The Equipment page > Onyx Edge (Core) tab or Onyx Edge tab displays the summary details of all Onyx Edge (Core) configured in the network.
Onyx Edge (n) – (n) indicates the number of Onyx Edge (Core) in the network.
Status of services running on the Onyx Edge (Core).
Green – Indicates all critical services are up and running, none of the critical services were restarted in the last five minutes, and the Onyx Edge's Interface Status is green.
Amber – Indicates all critical services are up and running, but critical services have restarted up to three times in the last five minutes, and the Onyx Edge's Interface Status is green or amber.
Red – Indicates some critical service has gone down in the last five minutes, or critical services have restarted up to three times in the last five minutes, or the Onyx Edge's Interface Status is red.
Grey – Indicates the Onyx Edge is offline, or data is not available.
Hovering your cursor over the "Service Status" icon displays view the list of services that are up/down/restarted.
Name – The Onyx Edge's name.
Venue / VM – The name of the venue or the VM hosting the Onyx Edge.
Subs – The number of subscribers connected to the Onyx Edge.
Online – The Onyx Edge's online status indicating its reachability from the Onyx Portal.
Green – Indicates the Onyx Edge has checked-in with Onyx Portal in the last five minutes.
Red – Indicates the Onyx Edge has not checked-in with the Onyx Portal in the last five minutes.
Hovering your cursor over the "Online Status" icon displays the last synced at (last check-in) timestamp.
Interface Status – Indicates connection status of N6 and RAN (Fronthaul) interfaces.
Green – Indicates all APs are MME-connected to the Onyx Edge, the SGi interface is up and has IP, and SGi link is active (periodic ICMP checks every five minutes).
Amber – Indicates at least one AP is MME-connected, but some are not, the SGi interface is UP and has IP (SGi link is active).
Red – Indicates none of the APs are MME-connected (that is all APs are MME-disconnected or management-disconnected (MME status is unknown)), or the SGi interface is not up or is not active (SGi link activity check through ICMP).
Grey – Indicates the Onyx Edge is offline.
Hovering your cursor over the "Interface Status" icon displays additional details.
Compute Resource – Indicates utilization of the Onyx Edge's computing resources – CPU percentage, Memory percentage, and Disk Utilization percentage.
Green – Indicates all parameters are below 50%.
Amber – Indicates at least one parameter is above 50% and below 70%.
Red – Indicates at least one parameter is above 70%.
Grey – Indicates the Onyx Edge is offline.
Hovering your cursor over the "Compute Resource Status" icon displays the following details:
Disk Utilization – Percentage of disk space used for the volume mounted at root.
CPU Utilization – System-wide CPU utilization as percentage over one second.
Memory Utilization – Percentage of memory used.
Actions – Options to view details, edit, and delete the Onyx Edge.
Upgrade Core Onyx Edge – (GXC Administrators only.) To upgrade the Onyx Edge software on the Onyx Edge AGWs in the network. For information on managing Onyx Edge upgrades, see Manage Onyx Edge Software Upgrades.
Onyx Edge Pool (n) — (n) indicates the count of Onyx Edge pools in the network. For information on adding and managing Onyx Edge pools, see Manage Onyx Edge Core-Only HA Pools.
The Onyx Edge pool's HA connectivity status.
Green – One Onyx Edge is functioning as the Primary ACS, and the others as Standby ACS.
Amber – One Onyx Edge is functioning as the Primary ACS, but one or more of the other Onyx Edge are non-functional.
Red – All Onyx Edge are non-functional, or their status is not available.
Grey – All Onyx Edge are offline.
Hovering your cursor over the "HA Connectivity Status" icon displays which Onyx Edge are designated as the Primary and Standby ACS.
Name — The Onyx Edge pool's name.
HA IP Address — Currently only for GXC use.
Associated Onyx Edges — The count of Onyx Edge nodes currently associated with this pool.
Actions — Options to view details, edit, or delete the pool.
Show Graphs / Hide Graphs — Collapsible panel of Onyx Edge performance charts, each filterable by Onyx Edge instance and time range.
Defaults to collapsed to improve page performance.
UE Throughput – Trend chart of the throughput of all UE for the selected Onyx Edge, direction, and duration. The chart represents downlink throughput in blue and uplink throughput in green color.
Onyx Edge Connected with Onyx Portal – Trend chart of the number of Onyx Edge connected with the Onyx Portal in the selected duration.
UE Attach Status – Chart of control plane transaction success/failure status for the selected Onyx Edge, transaction type, and duration.
Success count is displayed in green, and failure count in red color. You can select the event type from the following:
Registration (Initial)
Registration (MobUpd)
Registration (Periodic)
Auth Request
PDN Establishment Request
Service Request
View Details of an Onyx Edge (Core)
To view the details of an Onyx Edge (Core) in a 5G network:
In the navigation pane, click Equipment > Onyx Edge (Core) tab or Onyx Edge tab.
The Equipment page > Onyx Edge (Core) tab or Onyx Edge tab displays the summary details of all Onyx Edge (Core) configured in the network.
To view the details of a particular Onyx Edge (Core), in the Onyx Edge (n) panel, click its name.
The <Onyx-Edge-Name> page displays the following details:
Overview tab:
Onyx Edge Details:
Type – The Onyx Edge's deployment type.
Name – The Onyx Edge's name.
Pool Name — The AMF/Onyx Edge pool that the Onyx Edge is associated with. To view the pool's details, click the pool's name. The <Onyx-Edge-Pool-Name> page is displayed.
Host Name – The Onyx Edge's hostname.
Description – The Onyx Edge's description.
N6 Interface (Eth0) – (Displayed only in NAT mode) The N6 interface's IP address.
N6 Interface (Uplink br0) – (Displayed only in VLAN mode) The N6 interface's IP address.
NG Interface (Eth1) – The NG interface's eth1 IP address.
Version – The Onyx Edge's software version.
Upgrade Status – Status of the last Onyx Edge software upgrade.
To view the upgrade details, click the status. The Upgrade Status dialog box displays the following details:
Description – Description of the last upgrade's status.
Old Version – The Onyx Edge software version before the upgrade.
New Version – The new Onyx Edge software version.
Updated At – The timestamp at which the last upgrade completed.
Start Time – The timestamp at which the last upgrade started.
Venue – The name of the venue hosting the Onyx Edge. To view the venue's details, click its name.
Up Time – The duration for which the Onyx Edge has been operational without any downtime or interruptions.
Hardware Address – (Displayed only for Onyx Edge On-Premises) The Onyx Edge's eth0 hardware address.
More Info >> – Click to view the following additional details. The More Details dialog box is displayed.
Hardware UUID – The Onyx Edge's Hardware Universally Unique Identifier (UUID) used for device authentication to ensure secure communication. To copy the hardware UUID to the clipboard, click the copy icon.
Challenge Key – The Onyx Edge's Challenge Key used in challenge-response authentication mechanism. To copy the challenge key to the clipboard, click the copy icon.
AGW User Configuration – The AGW User account's password, displayed only if it has been set.
SSH Keys – The AGW User account's SSH key used for secure, password-less access to the system using public-private key authentication, displayed only if it has been added.
The Onyx Edge's health status.
Online – The Onyx Edge's online status indicating its reachability from the Onyx Portal.
Green – Indicates the Onyx Edge has checked-in with Onyx Portal in the last five minutes.
Red – Indicates the Onyx Edge has not checked-in with the Onyx Portal in the last five minutes.
Hovering your cursor over the "Online Status" icon displays the last check-in timestamp.
Interface Status – The Onyx Edge's interface status indicating the connection status of SGi and RAN (S1) interfaces.
Green – Indicates all APs are AMF-connected to the Onyx Edge, the SGi interface is up and has IP, and SGi link is active (periodic ICMP checks every five minutes).
Amber – Indicates at least one AP is MME-connected, but some are not, the SGi interface is UP and has IP (SGi link is active).
Red – Indicates none of the APs are MME-connected (that is all APs are MME-disconnected or management-disconnected (MME status is unknown)), or the SGi interface is not up or is not active (SGi link activity check through ICMP).
Grey – Indicates the Onyx Edge is offline, or data is not available.
Hovering your cursor over the "Interface Status" icon displays additional details.
Compute Resource – Status of the Onyx Edge's computing resources.
Green – Indicates all parameters are below 50%.
Amber – Indicates at least one parameter is above 50% and below 70%.
Red – Indicates at least one parameter is above 70%.
Grey – Indicates the Onyx Edge is offline.
Hovering your cursor over the "Compute Resource Status" icon displays the following details:
Disk Utilization – Percentage of disk space used for the volume mounted at root.
CPU Utilization – System-wide CPU utilization as percentage over one second.
Memory Utilization – Percentage of memory used.
Service Status – Status of the Onyx Edge's services. Hover your cursor over the "Service Status" icon to view details.
Green – Indicates all critical services are up and running, none of the critical services were restarted in the last five minutes, and the Onyx Edge's Interface Status is green.
Amber – Indicates all critical services are up and running, but critical services have restarted up to three times in the last five minutes, and the Onyx Edge's Interface Status is green or amber.
Red – Indicates some critical service has gone down in the last five minutes, or critical services have restarted up to three times in the last five minutes, or the Onyx Edge's Interface Status is red.
Grey – Indicates the Onyx Edge is offline, or data is not available.
Hovering your cursor over the "Service Status" icon displays the list of services that are up/down/restarted.
Data Usage – The Onyx Edge's data usage for the selected duration.
Download – The download data usage for the selected duration.
Upload – The upload data usage for the selected duration.
Dynamic Services – Status of the Onyx Edge's dynamic services.
Event Aggregation – Indicates the status of event aggregation for Onyx Edge services. Aggregated events are displayed in event lists and charts in the Onyx Portal interface. This feature is always enabled and cannot be disabled.
Log Aggregation – Indicates the status of log aggregation from gateway services. Aggregated logs are displayed in log lists and charts in the Onyx Portal interface. This feature is always enabled and cannot be disabled.
CPE Monitoring – The status of the CPE Monitoring service—Enabled or Disabled. When enabled, the Onyx Edge sends ICMP pings every minute to each connected UE. The measured round-trip time (RTT) latency is reported in the per-subscriber details. See the Subscribers > Subscriber details > UE Latency parameter.
Core: The Onyx Edge's Core settings.
UE-IP-Configuration:
IP Range – (Displayed only in NAT mode.) The IP range from which the Onyx Edge allocates IP addresses to UE.
IP Retention Time (sec) – The duration (in seconds) for which a UE's IP address is retained/leased after it disconnects.
DNS Server for UE:
Onyx Edge-as-DNS-Server – Indicates if the Onyx Edge functions as the DNS server—Enabled or Disabled.
DNS Second Server – (Displayed only when Onyx Edge-as-DNS-Server is enabled.) Enabled or Disabled. When enabled, if the "ONYX-Edge-as-DNS-Server" is unavailable, or if it fails to resolve domain name, the UE will contact the secondary DNS server for domain name resolution.
DNS Primary – The primary DNS server's IP address.
DNS Secondary – The secondary DNS server's IP address.
N6 Interface:
N6 Interface – The UE IP address allocation mode—Static or DHCP.
IP Subnet – (Displayed only if UE IP allocation mode is Static.) The management IP address for Onyx Edge to reach corporate network/internet.
Gateway – (Displayed only if UE IP allocation mode is Static.) The corporate gateway router IP address.
DNS Primary – (Displayed only if UE IP allocation mode is Static.) The primary DNS server's IP address.
DNS Secondary – (Displayed only if UE IP allocation mode is Static.) The secondary DNS server's IP address.
N6 Management VLAN – (Displayed only in VLAN mode if UE IP allocation mode is Static.) The N6 Management VLAN ID.
NAS Security Algorithms
Integrity Algorithm – The NAS integrity protection algorithm in use.
Encryption Algorithm – The NAS encryption algorithm in use.
DHCP Server Monitoring — (Displayed only in VLAN mode) Indicates whether DHCP Server Monitoring is active for this Onyx Edge — Enabled, Disabled.
Frequency — (Displayed only in VLAN mode if DHCP Server Monitoring is enabled) How often the system checks DHCP server availability, in minutes.
MAC — (Displayed only in VLAN mode if DHCP Server Monitoring is enabled) The MAC address used by the monitoring probe when sending DHCP requests.
VLAN — (Displayed only in VLAN mode if DHCP Server Monitoring is enabled) The VLAN on which the monitoring probe sends DHCP requests, ensuring the check targets the correct network segment.
Backhaul Speedtest – Prioritized list of iPerf-compatible speedtest servers used to measure backhaul link performance. The following details are shown for each entry:
Priority – The priority order in which speedtest servers are tried.
URL – The hostname/URL of the speedtest server.
Port Range – The port range used for the speedtest.
APN-VLAN Details – (Displayed only in VLAN mode.) For each APN, the following details are displayed. Note that APNs are common to all Onyx Edge in the network.
APN Name – The APN's name. To view the APN's details, click its name.
VLAN ID – The VLAN ID.
Local IP – The local IP address / subnet of the Onyx Edge on the VLAN.
Default GW IP – The Onyx Edge's IP address.
Default GW MAC – The Onyx Edge's MAC address.
UE-IP-Block: IP Block – Indicates whether the UE IP block feature is enabled or disabled.
UE-IP-Block: Start IP – The start IP address of the UE IP block range.
UE-IP-Block: End IP – The end IP address of the UE IP block range.
RAN: The Onyx Edge's (Core) RAN settings.
Subscribers – Details of subscribers connected to the Onyx Edge.
Status – The subscriber account's status.
Name – The subscriber account's name.
IMSI – The subscriber's IMSI. To view the subscriber account's details, click the IMSI.
Subscriber Group ID – The subscriber group that the subscriber account is associated with. To view the subscriber group's details, click its name. For information on subscriber groups, see Manage Subscriber Groups.
View All Subscribers – Click to view details of all subscriber accounts in the network. The Subscribers page > Subscriber tab is displayed.
Click the Events & Alerts tab.
Alerts – Details of Onyx Edge related alerts for the selected severity level.
You can select the alert severity level from All, Major, Minor, Critical, or Others.
To view an alert's details, click the corresponding row.
Date – The alert's creation timestamp.
Status – The alert's status.
Alert Name – The alert's name.
Severity – The alert's severity.
Events – Details of Onyx Edge related events for the selected events and time duration:
NR / Core – Allows switching between NR and Core network events.
To change the date and time range, select the required timestamps in the
date/time fields. The events list automatically updates to display the corresponding logs.Timestamp – The event's creation timestamp.
Module – The specific module or source from which the event originated. To filter events based on module, click the Module column header and select one or more modules.
Event Type – The event's type. To filter the events based on the event type, click the Event Type header and select one or more event types.
Entity – The entity's name.
Event Description – The event's description.
To view more details for a particular event, click the corresponding
(view details) icon.
Click the Logs tab.
Logs (n) – The number of logs for the Onyx Edge in the selected type and date and time range.
NR / Core – Allows switching between NR and Core network logs.
Download Logs – To download the logs in .csv format, in the
field enter the number of logs to be included in the .csv file, then click the 
icon. Default value: 5000. The downloaded .csv file includes details such as the timestamp, service, tag, type, and log text.Date and Time Range – To view logs in a specific date and time range, select the required timestamps in the
date/time fields. The logs list automatically updates to display the corresponding logs.Search Logs – To search for a log, enter your search term in the
search field. The logs list updates automatically to display matching logs.Timestamp – The date and time at which the log was created.
Service – The specific service associated with the log.
Tag – The event's tag—a label associated with the log entry.
Type – The log's type.
Output – The log's message.
Actions – (Enabled only when the Onyx Edge is online.) In the upper-right corner of the page, click the Actions button to access the following options.
Upgrade – (GXC Administrators, Super Administrators, and Administrators only.) Upgrade the Onyx Edge's software version, move the Onyx Edge to the required target upgrade group. For more information, see Move an Onyx Edge from One Upgrade Group to Another.
Reboot Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Reboot the Onyx Edge. Services will be down while the equipment reboots.
Restart Services on Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Restart the Onyx Edge's core services. Connectivity will be down until the services resume.
Ping – (GXC Administrators, Super Administrators, and Administrators only.) Ping the Onyx Edge's host.
Enter the following details, then click Ping.
Host – (Required) The host's IP address.
Packets (default 4) – (Optional) The number of packets to send. Default: 4.
Reboot AP – (GXC Administrators, Super Administrators, and Administrators only.) Reboot all or a specific AP.
Enter the following details, then click Execute.
Reboot AP – Select to reboot a specific AP in the network. In the Select an AP dropdown, select the AP's serial number.
Reboot All APs – Select to reboot all APs in the network.
Detach Subscriber – (GXC Administrators, Super Administrators, and Administrators only.) Forcibly detach an active subscriber/UE.
Enter the following details, then click Execute.
Subscriber IMSI – The subscriber's IMSI.
Force Config Sync – (GXC Administrators, Super Administrators, and Administrators only.) Trigger a full configuration synchronization.
Force Status Sync from Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Trigger Onyx Edge state synchronization. This action control is useful when investigating stale status displays or validating a change without waiting for the next periodic sync.
Force Subscriber Config Sync – (GXC Administrators and Super Administrators only.) Trigger a configuration synchronization for a specific subscriber.
Trigger Debug Information Collection – (GXC Administrators, Super Administrators, and Administrators only.) Collect logs and telemetry from Onyx Edge.
List Debug Information Files in OE – (GXC Administrators, Super Administrators, and Administrators only.) View downloadable debug files available on the Onyx Edge.
Generic Command – (GXC Administrators only.) Run generic commands on the Onyx Edge.
The Run Onyx Edge Command dialog box is displayed. Enter the following details, then click Execute:
Command – (Required) The command to run.
Parameters – (Optional) Parameters for the command.
Add Onyx Edge
This section describes how to add an Onyx Edge in the following modes:
Add Onyx Edge (NR+Core)
This section describes how to add an Onyx Edge (NR+Core) in the following modes:
Add Onyx Edge (NR+Core) in NAT Mode
To add an Onyx Edge (NR+Core) in NAT mode:
In the navigation pane, click Equipment.
The Equipment page > Onyx Edge tab displays the summary details of all Onyx Edge configured in the network.
In the upper-right corner of the page, click Add Node > Add Onyx Edge.
The Create Onyx Edge page > Onyx Edge tab is displayed.
Enter the following details:
Type – (Required) Select the Onyx Edge type NR+Core. Default value: NR+Core.
Venue – (Required) Select the venue hosting the Onyx Edge.
Onyx Edge Name – (Required) The Onyx Edge's name.
Host Name – (Optional) The Onyx Edge's host name to be displayed in the Onyx Edge equipment's interface. The host name must be an alphanumeric string of 5–64 characters, and can contain uppercase, lowercase, and numeric characters. It cannot contain white spaces or special characters.
Description – (Required) The Onyx Edge's description.
Provisioning – The Provisioning Server uses the Onyx Edge's eth0 hardware address to generate and provision the keys required for it to operate with the Onyx Portal.
Onyx Edge HW Address – (Required) The Onyx Edge's eth0 hardware address.
To obtain the eth0 hardware address:
Towards the end of the Onyx Edge ISO software installation, the screen displays the Onyx Edge's eth0 hardware address.
If you have management access to the Onyx Edge, run the
show_gateway_info.pycommand. From the command's output get the eth0 hardware address displayed against the OnyxEdge ID parameter.If you do not have management access to the Onyx Edge, contact GXC Technical Support.
In the lower-right corner of the page, click Configure Core.
The Create Onyx Edge page > Core tab is displayed.
Enter the following details.
UE IP Configuration
IP Range – (Required) The IP address range from which the Onyx Edge will allocate IP addresses to UE. For example, 192.168.128.0/24.
IP Retention Time – (Required) The duration (in seconds) for which a UE's IP address is retained/leased after it disconnects. Default: 604800 (7 days).
DNS Server for UE
Onyx Edge-as-DNS-Server – Enable or disable the Onyx Edge functioning as the DNS server for UE. Default setting: enabled.
DNS Primary – (Displayed only when Onyx Edge-as-DNS-Server is disabled. Required.) The primary DNS server IP address. Default value: 8.8.8.8.
DNS Secondary – (Displayed only when Onyx Edge-as-DNS-Server is disabled. Required.) The secondary DNS server IP address. Default value: 8.8.4.4.
Second Server – (Displayed only when Onyx Edge-as-DNS-Server is enabled.) If the ONYX-Edge-as-DNS-Server is unavailable, or if it fails to resolve the domain name, the UE will contact this Second DNS Server for domain name resolution.
DNS Server IP – (Displayed only when Second Server is enabled. Or, if Onyx Edge-as-DNS-Server is disabled. Required.) IP address of the second DNS server.
Management Interface
Static – Select to configure the management network parameters. Default setting: disabled.
Management IP/Subnet – (Required) The management IP address for Onyx Edge to reach corporate network/Internet. Example: 1.1.1.1/24.
N6 IP – (Required) The N6 interface's IP address. Example: 1.1.1.1.
Gateway – (Required) The corporate gateway router IP address. Example: 1.1.1.1.
DNS Primary – (Required) The primary DNS server IP address. Example: 8.8.8.8.
DNS Secondary – The secondary DNS server IP address. Example: 8.8.4.4.
DHCP – Select to enable DHCP for management interface, to get IP address for the management interface. Default setting: enabled.
NAS Security Algorithms – Configure the security algorithms used for Non-Access Stratum (NAS) signaling — the control plane protocol between UE and the 5G Core.
Integrity Algorithm – Algorithm used to ensure NAS message integrity.
NIA1 – 128-SNOW 3G integrity protection
NIA2 – (Default) 128-bit AES-based integrity protection (standard 5G/LTE algorithm)
Encryption Algorithm – Algorithm used to encrypt NAS messages.
NEA2 – (Default) 128-bit AES-based ciphering
NEA0 – Null encryption
In the lower-right corner of the page, click Configure RAN.
The Create Onyx Edge page > RAN tab is displayed.
Enter the following details.
Slot Pattern – (Required) Select the DL/UL Subframe Assignment (SA). The DL/UL Distribution SA configuration refers to allocating specific subframes within the radio frame for downlink and uplink data transmissions, facilitating efficient data exchange between the AP and UE.
Same as Network – Inherits the network-level DL/UL Distribution configuration. To view the network-level slot pattern, hover your cursor over the Same as Network option.
DDDDDDDSUU (DL 77%, UL 21%) – Allocates approximately 77% subframes for downlink and 21% for uplink.
DDDSU (DL 74%, UL 23%) – Allocates approximately 74% subframes for downlink and 23% for uplink.
DDSUU (DL 54%, UL 43%) – Allocates approximately 54% subframes for downlink and 43% for uplink.
DSUUU (DL 34%, UL 63%) – Allocates approximately 34% subframes for downlink and 63% for uplink.
DSUUUUDSUU (DL 25%, UL 72%) – Allocates approximately 25% subframes for downlink and 72% for uplink.
DDSUUUUUUU (DL 20%, UL 77%) – Allocates approximately 20% subframes for downlink and 77% for uplink.
Band – Click to select the frequency band used for communication between UE and the network.
N48 – A 5G frequency band (3550–3700 MHz) that offers a balance of coverage and capacity with shared spectrum access.
N78 – A widely adopted 5G frequency band (3300–3800 MHz) ideal for enhanced mobile broadband in urban and suburban areas, offering high data rates and capacity for various commercial 5G applications.
N77 – A broader mid-band frequency that ranges from 3300–4200 MHz, often utilized in global 5G networks to provide high-capacity and low-latency connectivity.
RAN Security Algorithms – RAN security protects traffic between UE and the RAN.
Encryption / Integrity Algorithms (Required)
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
Timing Source – Select the timing synchronization source for the Onyx Edge RAN.
Free Running – The Onyx Edge uses its internal oscillator as the timing reference, with no external synchronization. Suitable for isolated single-cell deployments where inter-cell time alignment is not required.
GPS – The Onyx Edge synchronizes to a GPS receiver for accurate, UTC-traceable time/phase synchronization. Required for multi-cell TDD deployments to ensure correct DL/UL slot coordination and prevent inter-cell interference. Requires a GPS antenna with clear sky visibility at the deployment site.
Multi-Port Attach – Enable or disable the Multi-Port Attach feature, which allows UE to attach through any active AP's transmission port, improving coverage and connection success rates by removing restrictions to specific ports. For more information, see Multi-Port Attach Support.
Add Cell – Click to add a cell. The Add Cell dialog box is displayed.
In the General tab, enter the following details.
Applicable to N48 with SAS disabled, N77, and N78 bands:
SAS Enabled – (Applicable only to N48 band.) Keep disabled. Default setting: disabled.
Name – (Required) The cell's name.
BW (MHz) – (Required) Select the bandwidth.
Freq (MHz) – (Required) Click to select the frequency.
Associated AP/FHM [Band N**] – Click to select the associated AP/FHM.
PSS (for PCI) – (Required) Click to select the Primary Synchronization Signal (PSS) index used for cell identification during UE synchronization. Contact GXC Technical Support for the correct PSS value for your deployment.
Applicable to N48 band with SAS enabled:
SAS Enabled – Enable. Default setting: disabled.
Name – (Required) The cell's name.
User ID – (Required) The SAS account's user ID.