For the complete documentation index, see llms.txt. This page is also available as Markdown.

4G Onyx Portal 4.x Alerts Reference

This reference describes Onyx Portal 4G alerts listed in order of type, module, and name in alphabetical order.

Onyx Portal 4G Predefined Alerts

Type
Module
Alert Name
Severity

Access Point

C-Plane

Major

Access Point

C-Plane

S1 Disconnected

Major

Access Point

CU-Plane

Cell Service Down

Major

Access Point

CU-Plane

Major

Access Point

CU-Plane

IPSec Certificate Expiry

Minor

Access Point

CU-Plane

IPSec Connection Down

Major

Access Point

Domain Proxy

CBSD Lesser BW Granted

Major

Access Point

Domain Proxy

CBSD New Grant

Warning

Access Point

Domain Proxy

Warning

Access Point

Domain Proxy

CBSD Registration Failure

Major

Access Point

M-Plane

Offline

Major

Access Point

M-Plane

TR-069 Session Stuck

Major

Access Point

M-Plane

Unexpected TR-069 Fault

Minor

Access Point

MCU-Plane

Major

Access Point

MCU-Plane

Major

DAS

Domain Proxy

TP CBSD New Grant

Warning

DAS

Domain Proxy

Warning

DAS

Domain Proxy

Warning

DAS

Domain Proxy

Major

Mesh Node

Domain Proxy

CPE CBSD New Grant

Warning

Mesh Node

Domain Proxy

Warning

Mesh Node

Domain Proxy

Major

Mesh Node

M-Plane

Offline

Critical

Mesh Node

MCU-Plane

Tunnel Down

Major

Mesh Node

MCU-Plane

Watchdog Powercycle

Minor

Mesh Node

Platform

CPU Usage

Minor

Mesh Node

Platform

Disk Usage

Major

Mesh Node

Platform

Memory Usage

Minor

Mesh Node

Provisioning Server

Warning

Onyx Edge (Core)

C-Plane

Authentication Failure

Warning

Onyx Edge (Core)

C-Plane

DHCP Server Failed

Major

Onyx Edge (Core)

C-Plane

S1 Setup Failure

Major

Onyx Edge (Core)

C-Plane

SCTP Outbound Stalled

Major

Onyx Edge (Core)

C-Plane

UE Attach Failure

Warning

Onyx Edge (Core)

C-Plane

Warning

Onyx Edge (Core)

C-Plane

UE Session Failure

Warning

Onyx Edge (Core)

CU-Plane

HA Peer Down

Major

Onyx Edge (Core)

CU-Plane

IPSec Service Down

Critical

Onyx Edge (Core)

CU-Plane

Major

Onyx Edge (Core)

M-Plane

Offline

Critical

Onyx Edge (Core)

MCU-Plane

Service Down

Critical

Onyx Edge (Core)

Platform

CPU Usage

Minor

Onyx Edge (Core)

Platform

Disk Usage

Major

Onyx Edge (Core)

Platform

Memory Usage

Minor

Onyx Edge (Core)

Provisioning Server

Warning

Orchestrator

Domain Proxy

SAS Connection Failure

Critical

Onyx Portal 4G Semi-Custom Alerts

Type
Module
Alert Name
Severity

Mesh Node

MCU-Plane

Major

Mesh Node

MCU-Plane

Major

Mesh Node

MCU-Plane

Major


Common Indications

Alerts Counter Panel Indication

The Onyx Portal Alerts Counter panel displays separate counters for active Critical, Major, and Minor alerts. All other active alerts are grouped under the "Other" counter.

When an alert is triggered, the corresponding counter's value increases by one.

Clicking the Alerts counter panel takes you to the Alerts > "Active Alerts" page.

To view an alert's details, click the alert's name.

Cell Transmission Down Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • Onyx Portal > Dashboard > Access Point tile > Service Status icon: Depending on the percentage of affected APs, the icon will be amber or red.

  • Onyx Portal > Dashboard > Subscribers tile: If the AP results in loss of online subscribers, the connected subscribers count will change.

  • Onyx Portal > Dashboard > Downlink/Uplink Traffic tile: The traffic reduces as the AP is no longer serving.

  • Onyx Portal > Dashboard > Data Usage tile: The usage reduces as the AP is no longer serving.

  • Onyx Portal > Dashboard > Access Point SAS Status tile: Authorized AP count may reduce if this is due to a grant issue. Other counts may increase depending on the issue.

  • Onyx Portal > Equipment > Access Point tab > view AP's details > Overview tab > Access Point Details tile > Service Status icon: red.


Predefined Alerts

Predefined alert rules are delivered preconfigured with the Onyx Solution and can only be created, modified, or deleted by GXC.

Access Point Alerts

Access Point C-Plane Alerts

Neighbor Tables Incomplete

Trigger Condition

When the AP is unable to populate all Neighbor Frequency Entries or Neighbor Cell Table Entries. The AP has a limit of 8 Neighbor Frequency Entries and 16 Neighbor Cell Table Entries.

Probable Causes

Number of discovered neighbors exceeds the AP's table capacity limits.

Clear Condition

When all neighbor entries are successfully populated within the table limits.

Severity

Major

System Impact

Handovers to neighboring cells may fail, potentially causing dropped connections or service degradation for UE moving between coverage areas.

Indications

The AP Events page will log an event identifying which Neighbor Frequency Entries or Neighbor Cell Table Entries could not be populated.

Corrective Actions

Configure explicit neighbors in the network settings and limit the neighbor count to only the actual neighboring cells to which handover is expected.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Onyx Portal > Alerts > Active Alerts tab: The alert has cleared.


S1 Disconnected

Trigger Condition

When an AP reports that it is not S1-connected via TR-069 for at least 15 minutes.

Probable Causes

  • The AP has an issue.

  • On the Onyx Edge, the MME/SCTP services are down.

Clear Condition

When the AP reports that it is S1-connected.

Severity

Major

System Impact

The AP stops transmitting.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • Onyx Portal > Dashboard > Access Point tile > Service Status icon: red, although it may take some time to change.

  • Onyx Portal > Dashboard > Mesh Node tile > Online icon: If a Mesh Node is connected via this AP, depending on the percentage of Mesh Nodes affected, the Online icon will turn red or amber, although it may take some time.

  • Onyx Portal > Dashboard > Subscribers tile: If the AP results in loss of online subscribers, the connected subscribers count will change.

  • Onyx Portal > Dashboard > Downlink/Uplink Traffic tile: The traffic will reduce as this AP is no longer serving.

  • Onyx Portal > Dashboard > Data Usage tile: The usage will reduce as this AP is no longer serving.

  • Onyx Portal > Equipment > Access Point tab > view AP's details > Overview tab > Service Status and Interface Status icons: / red, although it may take some time for the Service Status icon to change.

  • Onyx Portal > Equipment > Onyx Edge tab > view Onyx Edge's details > Overview tab > Onyx Edge Details tile > Interface Status icon: Depending on the number of APs that disconnected, red or amber.

  • Onyx Portal > Equipment > Mesh Node tab > view Mesh Node's details > Overview tab > Mesh Node Details tile > Online icon: red, if it is connected via the affected AP.

Corrective Actions (perform in order)

  1. Check if the Onyx Edge's services are healthy. If the services are restarting, contact GXC Technical Support.

  2. Check if any maintenance activity is currently in progress.

  3. Check the AP's IPSec status (if applicable).

  4. Check the AP's events and alerts and resolve any faults (Onyx Portal > Equipment > Access Point tab > view AP's details > Events & Alerts tab). Any faults will be represented as "unexpected_fault_received" event, and new alerts as "enb_alarm_raised" event.

  5. Check the AP's logs and resolve any errors (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab).

  6. Reboot the AP.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Onyx Portal > Dashboard: All tiles return to their pre-incident states.

Related Alerts

  • Onyx Edge (Core) MCU-Plane Service Down Alert — Triggered if all APs connected to the Onyx Edge are S1 Disconnected.


Access Point CU-Plane Alerts

Cell Service Down

Trigger Condition

When an AP cell does not transmit for at least 15 minutes.

Probable Causes

The grant is either unavailable or unauthorized, preventing the AP from transmitting.

Clear Condition

When the cell starts transmitting again.

Severity

Major

System Impact

The AP stops transmitting.

Indications

Corrective Actions

  1. Check if any maintenance activity is currently in progress.

  2. Check the AP's IPSec status (if used).

  3. Check the AP's events and alerts and resolve any faults (Onyx Portal > Equipment > Access Point tab > view AP's details > Events & Alerts tab). Any fault will be represented as an "unexpected_fault_received" event, and new alert as an "enb_alarm_raised" event.

  4. Check the AP's logs and resolve any errors (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab).

  5. If SAS is enabled, check if grants are available and authorized for the AP to transmit (Onyx Portal > Equipment > Access Point tab > view AP's details > Overview tab > SAS Status display).

  6. Check the AP's DP logs for any failures and take necessary action (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab > DP Logs section).

  7. If grants are not available or not authorized, if possible, change the preferences to obtain grants (Onyx Portal > Equipment > Access Point tab > edit AP's details > RAN tab).

  8. If grants are still not available for the minimum acceptable preferences, transmission will not be possible until resources become available with SAS again.

  9. Reboot the AP.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Onyx Portal > Dashboard: All tiles return to their pre-incident states.


DAS Associated Access Point Cell Service Down

Trigger Condition

Cell associated with a DAS has not transmitted for at least five minutes.

Probable Causes

Grants for all DAS Transmission Points (TPs) are unavailable or unauthorized.

Clear Condition

When the cell resumes transmission.

Severity

Major

System Impact

The AP and all associated DAS TPs stop transmitting.

Indications

Corrective Actions (perform in order)

  1. Check if any maintenance activity is in progress.

  2. Check the AP's IPSec status (if applicable).

  3. Review the AP's events and alerts and resolve any faults (Onyx Portal > Equipment > Access Points tab > view AP's details > Events & Alerts tab). Faults will appear as "unexpected_fault_received"; new alerts will appear as "enb_alarm_raised".

  4. Review AP logs and resolve any errors (Onyx Portal > Equipment > Access Points tab > view Access Point details > Logs tab).

  5. Check if grants are available and authorized for all associated DAS TPs to transmit (Onyx Portal > Equipment > DAS > view DAS's details > SAS Status display).

    1. Check DP logs for per-TP failures (Onyx Portal > Equipment > DAS > view DAS's details > Logs tab > DP Logs).

    2. If grants are missing or not authorized, adjust preferences, if possible, to obtain grants (Onyx Portal > Equipment > Access Points tab > edit AP's details > RAN tab).

    3. If grants remain unavailable for the minimum acceptable preferences, transmission will not resume until SAS resources become available.

  6. Reboot the AP.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Onyx Portal > Dashboard: All tiles return to their pre-incident states.

Related Alerts


IPSec Certificate Expiry

What Does This Alert Mean?

  • The IPSec certificate for the AP is expiring soon. This will result in the AP losing S1 connectivity with the MME/Onyx Edge.

  • Note that this alert only captures the certificate as maintained by the Orchestrator. It is the user's responsibility to upload the current certificate on the AP. This alert does not track the actual certificate in the AP.

Trigger Condition

When an AP's IPSec certificate is expiring in three days or less or has already expired.

Clear Condition

When a new IPSec certificate is generated and uploaded to the AP.

Severity

Minor

Corrective Actions

Regenerate a new certificate and upload it to the AP.


IPSec Connection Down

What Does This Alert Mean?

The AP has not yet established a successful IPSec connection with the Onyx Edge. As a result, S1 signaling activity is unlikely to occur.

Trigger Condition

IPSec tunnel between AP and Onyx Edge is not yet up or has gone down.

Clear Condition

When the IPSec tunnel between the AP and Onyx Edge is up.

Severity: Major


Access Point Domain Proxy Alerts

CBSD Lesser BW Granted

Trigger Condition

When a CBSD has been granted less bandwidth than desired, and it continues to be in this state for at least five minutes.

Clear Condition

When either of the following conditions occur:

  • The CBSD gets the desired bandwidth in a grant.

  • The CBSD loses the grant.

Severity

Major

System Impact

The network capacity is reduced from what was planned.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • Onyx Portal > Dashboard > Downlink/Uplink Traffic tile: Traffic will reduce as bandwidth is reduced.

  • Onyx Portal > Dashboard > Data Usage tile: Usage will not increase at the expected rate due to reduced bandwidth.

Corrective Actions

  1. Check if any maintenance activity is currently in progress.

  2. In the AP's DP logs, check Spectrum Inquiry Response to determine available frequencies (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab > DP Logs section).

  3. If Strict Preference is enabled, disable it, if possible (Onyx Portal > Equipment > Access Point tab > edit AP's details > RAN tab > Strict Preference parameter), or change the frequency preference to obtain frequency with higher bandwidth (Onyx Portal > Equipment > Access Point tab > edit AP's details > RAN tab).

  4. Contact GXC Technical Support.

Resolution Verification

  1. All tiles have returned to their pre-incident state.

  2. In the AP's details, verify the granted bandwidth (Onyx Portal > Equipment > Access Point tab > view AP's details > Overview tab > RAN tile > Bandwidth (MHz) parameter).

Related Alerts

Access Point Domain Proxy CBSD New Grant Alert — Triggered in conjunction with the "CBSD Lesser BW Granted" alert.


CBSD New Grant

Trigger Condition

When new grants have been received within the last one hour.

Clear Condition

When no new grants have been received for at least one hour.

Severity

Warning

System Impact

This alert indicates a new grant has been received from SAS. For an AP that is already transmitting, it could change the transmission frequency, bandwidth, power, etc. The operator should verify the new grant will not affect the required KPIs.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • Onyx Portal > Dashboard > Access Point tile > Service Status icon: Depending on the grant authorization and previous transmission state of the AP, green or amber.

  • Onyx Portal > Dashboard > Subscribers tile:

    • If the new grant comes with a lower power level, subscribers at the edge may lose connection.

    • If the AP was not previously transmitting and the grant got authorized as well, previously unconnected subscribers in the coverage area can get connected.

  • Onyx Portal > Dashboard > Downlink/Uplink Traffic tile: The traffic may change depending on AP's previous transmission state, grant authorization, and UE behavior. For example, a reduced bandwidth will not transmit as much data as before.

  • Onyx Portal > Dashboard > Data Usage tile: The usage may change depending on the AP's previous transmission state, grant authorization, and UE behavior.

  • Onyx Portal > Dashboard > Access Point SAS Status tile: Granted/Authorized CBSDs count may change depending on the CBSD's previous state.

  • Onyx Portal > Equipment > Access Point tab > view AP's details > Overview tab > RAN tile: SAS Status will move to Granted and generally to Authorized if no previous grants were available.

  • Onyx Portal > Equipment > Access Point tab > view AP's details > Overview tab > Access Point Details tile > Service Status icon: If the AP was not transmitting previously, the icon can be green.

Corrective Actions

None.

Resolution Verification

None required for initial alert for an AP.

Related Alerts

Access Point Domain Proxy CBSD Lesser BW Granted Alert — Triggered if the new grant does not have the desired bandwidth.

Additional Information

  • This is a notification when a new grant is received from SAS.

  • As each grant change is a separate grant success, this alert can also be used to track grant changes. However, note that the very first grant is also tracked.


CBSD Preferred Frequency Unavailable

Trigger Condition

  • In SC/DC mode, none of the frequencies in the preferred list are available with SAS.

  • In CA mode, no non-overlapping frequency pair from the preferred list is available with SAS.

Clear Condition

Any of the following:

  • Preferred frequencies are available again.

  • CBSD is deregistered.

Severity

Warning

System Impact

  • Network radio transmissions may not occur as planned, potentially causing interference from neighboring cells.

  • This alert indicates that transmission on preferred frequencies is not fully possible. If Strict Preference is enabled, the AP will stop transmitting.

  • In other cases, the AP will continue transmitting on whatever frequency is received via SAS grant.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • In case Strict Preference is disabled (Onyx Portal > Equipment > Access Point tab > view AP's details), the granted frequency would not be part of the preferred list.

  • In case Strict Preference is enabled, see Cell Transmission Down Indications.

Corrective Actions

  1. Change the preference list (Onyx Portal > Equipment > Access Point tab > edit AP's details > RAN tab).

  2. The available frequency can be found in the "Spectrum Inquiry Response" log type (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab > DP Logs section > "Spectrum Inquiry Response" log type). Filter for "From SAS To DP logs".

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Alert counts revert to their pre-incident levels.

  • Onyx Portal > Dashboard: All tiles revert to their pre-incident states.


CBSD Registration Failure

Trigger Condition

CBSD registrations have failed within the past hour.

Clear Condition

No CBSD registrations have failed for at least an hour.

Severity

Major

System Impact

The AP becomes non-functional, as it cannot obtain any grants to transmit.

Indications

Corrective Actions

  1. Check the AP's DP logs for the failure reason and take necessary action (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab > DP Logs section).

  2. The most probable cause is a mismatch of parameters between the Onyx Portal and the SAS Portal. Verify the CBSD registration on the Federated Wireless Portal has the correct information. Verify the FCC ID, Serial Number, CBSD Type and Category, Location, and Antenna parameters.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Alert counts revert to their pre-incident levels.

  • Onyx Portal > Dashboard: All tiles revert to their pre-incident states.


Access Point M-Plane Alerts

Offline

Trigger Condition

When no TR-069 Inform messages have been received for the past 20 minutes (15 minutes in alert condition + five minutes for changing the metric). This may occur, for example, if the AP is powered off.

Clear Condition

When TR-069 connection is re-established with the AP.

Severity

Major

System Impact

  • Management access to the AP will be down. Configurations, alerts, events, metrics, etc. between the Onyx Portal and the AP will not be in sync.

  • User traffic may be unavailable depending on the mode of failure.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • Onyx Portal > Dashboard > Access Point tile > Online icon: This AP is offline. Depending on other APs in the network, the Online icon may change to red or amber. Hover information shows the offline APs.

  • Onyx Portal > Dashboard > Access Point tile > Service Status icon: Depending on other APs in the network, the Service Status icon may change to grey or amber.

  • Onyx Portal > Dashboard > Mesh Node tile: If the AP service is down and it provides connection for the Mesh Node, the Mesh Node will also go offline.

  • Onyx Portal > Dashboard > Subscribers tile: If the AP results in loss of online subscribers, the connected subscribers count will change.

  • Onyx Portal > Dashboard > Downlink/Uplink Traffic tile: If S1 is down, the traffic will commensurately reduce.

  • Onyx Portal > Dashboard > Data Usage tile: If S1 is down, the usage will commensurately reduce.

  • Onyx Portal > Dashboard > Access Point SAS Status tile: For SAS-enabled APs that are not online for the last four hours:

    • If unregistered, it will not get registered until it is online.

    • Any grants will be relinquished, and the AP will move to Registered state.

  • Onyx Portal > Equipment > Access Point tab > view AP's details > Overview tab > Access Point Details tile > Online icon: red. All other statuses will turn grey.

Corrective Actions

  1. Check if any maintenance activity is currently in progress.

  2. Check for any power outages at the equipment's location.

  3. Verify that the AP is associated with the correct Onyx Edge.

  4. Verify network connectivity between the AP and the Onyx Edge.

  5. Get assistance from local AP technician.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Onyx Portal > Dashboard: All tiles return to their pre-incident states.

Related Alerts Onyx Edge (Core) MCU-Plane Service Down Alert — Triggered if all APs connected to the Onyx Edge are offline.


TR-069 Session Stuck

Trigger Condition

The Access Point TR-069 session has started but not completed for more than 15 minutes, indicating the session is stuck in an error loop.

Clear Condition

The TR-069 session completes successfully.

Severity

Major

System Impact

  • Configuration between the AP and the Onyx Portal will not be in sync; as a result, the AP will not function as expected.

  • Potential loss of traffic.

Indications

  • Onyx Portal > Dashboard > common counter indications.

  • AP Details page:

    • AP Properties section:

      • Config/FSM State parameter will show STUCK

      • Hover over Config/FSM State to see Engineering Debug Info:

        • Last Session Start Time — Confirms when the session got stuck

        • Last Session End Time — Will be old or --, confirming the session did not complete

Corrective Actions

Check enodebd logs for errors related to the stuck TR-069 session.

Resolution Verification

  • From the Dashboard:

    • The Alerts count has returned to the condition prior to the incident.

    • All tiles have returned to the condition prior to the incident.

Related Alerts


Unexpected TR-069 Fault

Trigger Condition

When unexpected TR-069 faults are received from AP in the last one hour.

Probable Causes

  • One or more of the commands issued by the Onyx Edge (enodebd-service) was rejected by the AP.

  • This alert could also trigger when grant details and the AP neighbor configurations are not compatible.

Clear Condition

When no unexpected TR-069 faults are received from the AP for at least one hour.

Severity

Minor

System Impact

  • Configuration between the AP and the Onyx Portal will be out of sync; as a result, the AP will not be functioning as expected.

  • Potential loss of traffic.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • Onyx Portal > Dashboard > Access Point tile > Online icon: If the problem causes the AP to go offline, depending on other APs, the Online icon may be red or amber. Hover information shows the offline APs.

  • Onyx Portal > Dashboard > Access Point tile > Service Status icon: If the problem repeats on every TR-069 session, the Service Status icon can fluctuate between red and green, or stay red, depending on the point in session at which the fault happens.

  • Onyx Portal > Dashboard > Mesh Node tile > Online icon: If the fault is preventing enabling transmission in a currently non-transmitting AP, the Mesh Node will go offline .

  • Onyx Portal > Dashboard > Subscribers tile: If the AP results in loss of online subscribers, the connected subscribers count will change.

  • Onyx Portal > Dashboard > Downlink/Uplink Traffic tile: If S1 is down, the traffic will commensurately reduce.

  • Onyx Portal > Dashboard > Data Usage tile: If S1 is down, the usage will commensurately reduce.

  • Onyx Portal > Dashboard > Access Point SAS Status tile: For SAS-enabled APs having recurrent faults for the last four hours:

    • If unregistered, the AP will not get registered until it becomes free of faults.

    • If the AP has grants, they will be relinquished, and the AP will move to Registered state.

  • Onyx Portal > Dashboard > Backhaul (SGi) Health tile: Only affected when AP is already in a non-transmitting state and fault is preventing the Onyx Edge from enabling transmission.

Corrective Actions

  1. Check if any maintenance activity is currently in progress.

  2. Navigate to the Events view (Onyx Portal > Equipment > Access Point tab > view AP's details > Events & Alerts tab > Events section). The event associated with the fault typically provides additional details. It is possible that the fault is due to misconfiguration, and the event details usually identify the specific misconfigured parameter.

  3. Check the AP's logs and resolve any errors (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab).

  4. Check and update the specific parameter in the Onyx Portal and the AP equipment.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Onyx Portal > Dashboard: All tiles return to their pre-incident states.

Related Alerts

Access Point M-Plane Offline Alert


Access Point MCU-Plane Alerts

Cell Unwarranted Transmission

Trigger Condition

When even though transmission is disabled, an AP's cell transmits for at least 15 minutes.

Clear Condition

When the cell stops transmission.

Severity

Major

System Impact

  • The AP cell may transmit when not expected, potentially causing interference to neighboring radio equipment.

  • This may result in a violation of federal spectrum regulations.

Indications

Corrective Actions

  1. Check if any maintenance activity is currently in progress.

  2. Check the AP's events and alerts and resolve any faults (Onyx Portal > Equipment > Access Point tab > view AP's details > Events & Alerts tab). Any faults will be represented as "unexpected_fault_received" event, and new alerts as "enb_alarm_raised" event.

  3. Check the AP's logs and resolve any errors (Onyx Portal > Equipment > Access Point tab > view AP's details > Logs tab).

  4. Reboot the AP.

  5. If the condition does not clear, contact GXC Technical Support.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Onyx Portal > Dashboard: All tiles return to their pre-incident states.


Mesh Filter-Frequency Mismatch

Trigger Condition

  • The Mesh Node filter and frequency of its attached Mesh AP are in an incompatible state for at least five minutes.

  • The frequency for Mesh AP attached to the Mesh Node is not compatible with filter settings on the Mesh Node. The filter setting is determined by the frequency of the Gateway AP to which the Mesh Node is attached.

Clear Condition

The Mesh Node filter and frequency of its attached Mesh AP become compatible.

Severity

Major

System Impact

  • The Mesh system will not work, and the user may not get much feedback.

  • The Mesh Node small cell filter will reject frequencies used by the Mesh AP, perhaps generating a VSWR fault on the AP, or the small cell hardware may not fault and instead simply fail to connect to any UE in the area (UE signal will be filtered out).

  • Some devices can be damaged by Tx energy being returned.

Indications

Corrective Actions

  • Check the frequency of the Gateway AP to which the Mesh Node is connected.

    • The frequencies of the Gateway AP and the Mesh Node's Mesh AP must be in opposite halves of the CBRS band (3550–3700 MHz).

    • The CBRS band is divided at 3625 MHz, where Low Band refers to the 3550–3625 MHz range, and High Band refers to the 3625–3700 MHz range.

  • If the Mesh AP is in the same half of the CBRS band as the Gateway AP, move the Mesh AP to the opposite half.

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Alert counts revert to their pre-incident levels.

  • Onyx Portal > Dashboard: All tiles revert to their pre-incident states.


DAS TP Alerts

DAS TP Domain Proxy Alerts

CBSD New Grant

Trigger Condition

When new grants have been received from SAS in the last hour.

Clear Condition

When no new grants have been received for at least an hour.

Severity

Warning

System Impact

  • For a DAS TP that is already transmitting, a new grant may change the transmission frequency, bandwidth, or power level.

  • If sufficient power is not granted, transmission may be affected.

  • Operators should verify that the new grant parameters will not adversely affect required KPIs.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • Dashboard: Common Dashboard Counter Indication.

  • DAS details page > SAS Status: Status will change to green or amber based on grant authorization state and the previous transmission state of the DAS TP.

  • Subscribers tile:

    • If the new grant comes with a lower power level, subscribers at the edge may lose connection.

    • If the AP was not previously transmitting and the DAS grant got authorized as well, previously unconnected subscribers in the coverage area can get connected.

  • CBRS SAS Status tile: The Granted/Authorized CBSDs count may change depending on the CBSD's previous state.

  • DAS overview: SAS status will move to Granted and generally to Authorized if no previous grants were available.

Corrective Actions

None required. This is an informational alert.

Resolution Verification

None required for initial alert.

Related Alerts

Additional Information

  • This alert serves as a notification when a new grant is received from SAS.

  • Each grant change triggers this alert, allowing operators to track all grant modifications.

  • The initial grant for a DAS TP also triggers this alert.


CBSD Preferred Frequency Unavailable

Trigger Condition

For DAS TPs, when the preferred frequency selected for the associated AP is unavailable from SAS.

Clear Condition

When any of the following occurs:

  • The preferred frequency becomes available again.

  • The CBSD is deregistered.

Severity

Warning

System Impact

  • The associated AP and DAS TP will stop transmitting because the preferred frequency is not available from SAS.

  • Subscribers in the coverage area will lose connectivity.

Indications

  • Onyx Portal > Alerts Counter Panel Indication.

  • DAS Associated AP Overview (Onyx Portal > Equipment > Access Points tab > view AP's details): The AP's configured frequency will not appear in the available SAS spectrum.

Corrective Actions

Change the AP frequency to an available frequency (Onyx Portal > Equipment > Access Points tab > edit AP > RAN tab).

To identify available frequencies:

  • View the Available Spectrum graph for the DAS TP (Onyx Portal > Equipment > DAS tab > view DAS's details), or

  • Check the Spectrum Inquiry Response log (Onyx Portal > Equipment > DAS tab > view DAS's details > Logs tab > DP Logs section > Spectrum Inquiry Response log type, filter for "From SAS To DP" logs).

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Alert counts revert to their pre-incident levels.

  • Onyx Portal > Dashboard: All tiles revert to their pre-incident states.


CBSD Preferred Max Power Unavailable

Trigger Condition

When the preferred maximum power configured for the DAS TP is unavailable from SAS.

Clear Condition

When any of the following occurs:

  • The preferred maximum power becomes available again.

  • The CBSD is deregistered.

Severity

Warning

System Impact

  • Radio transmissions are not operating as planned, potentially due to interference from neighboring cells.

  • This alert indicates reduced transmission coverage caused by lower transmit power granted by the SAS.

Indications

DAS Associated AP Overview (Onyx Portal > Equipment > DAS tab > view DAS's details): The Preferred Max Power and Granted Power values will differ.

Corrective Actions

  1. Identify available power levels: Check the Spectrum Inquiry Response log (Onyx Portal > Equipment > DAS tab > view DAS's details > Logs tab > DP Logs section > Spectrum Inquiry Response log type, filter for "From SAS To DP" logs).

  2. Change the Preferred Max Power to an available value (Onyx Portal > Equipment > DAS tab > edit DAS's details > Transmission Point Details).

Resolution Verification

  • Onyx Portal > Alerts Counter Panel: Returns to pre-incident alert counts.

  • Verify from the Dashboard that the alert has cleared.