> 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/docs/network-configuration-and-operations-guides/5g-onyx-portal-4.x-operations/manage-equipment/manage-fhm.md).
# Manage FHM
The FHM (Fronthaul Manager) is a component in the Onyx 5G architecture that manages the fronthaul connections between the APs and the Onyx Edge (Core). It helps handle data transmission, synchronization, and resource allocation for efficient 5G network operations.
## View FHM Details
This section describes how to view FHM details in a 5G network.
* [*View Summary Details of All FHM*](#view-summary-details-of-all-fhm)
* [*View an FHM's Details*](#view-details-of-an-fhm)
### View Summary Details of All FHM
**To view the summary details of all FHM configured in a 5G network:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **FHM** tab.
The **Equipment** page > **FHM** tab displays the summary details of all FHM configured in the network.
* **FHM (n)** – The count of FHMs configured in the network.
* **Name** – The FHM's name.
* **Serial Number** – The FHM equipment's vendor-assigned serial number. Click to view the FHM's details.
* **Device Class** – The FHM equipment's device class.
* **Access Point** – The number of APs associated with the FHM.
* **Online Status** – Indicates the FHM's online status, which is determined by its reachability from the Onyx Portal.
*  (green) – Indicates the FHM is management connected, and the last reported time is < 5 mins from current time.
*  (red) – Indicates any of the following conditions:
* FHM is not management connected
* Time reported >= 5 mins from current time
* FHM is not associated with any Onyx Edge
*  (grey) – Indicates the gateway of the associated Onyx Edge is offline.
Hovering your cursor over the "Online Status" icon displays the FHM's last check-in timestamp.
* **Interface Status** – Indicates the FHM's interface status—the fronthaul connection state of the FHM and its associated APs.
*  (green) – Passthrough is reported as true for all associated APs.
*  (red) – Passthrough is reported as false, or status information is unavailable for all associated APs.
*  (amber) – Passthrough is reported as false, or status information is unavailable for at least one, but not all, associated APs.
*  (grey) – FHM is not management-connected.
Hovering your cursor over the "Interface Status" icon displays following details:
* **Access Point** – Name of individual AP.
* **Interface** – Ethernet port used for the fronthaul link.
* **Passthrough** – Indicates whether fronthaul passthrough is active (true or false).
* **Sync Status** – Indicates the FHM's sync status.
* **Actions** – Options to view details, edit, and delete an FHM.
{% endstep %}
{% endstepper %}
### View an FHM's Details
**To view details of an FHM in a 5G network:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **FHM** tab.
The **Equipment** page > **FHM** tab displays the summary details of all FHMs configured in the network.
{% endstep %}
{% step %}
To view the details of a particular FHM, click its serial number.
The ***\*** page displays the FHM's details.
* **Name** – The FHM's name.
* **Serial** – The FHM equipment's vendor-assigned serial number.
* **Description** – The FHM's description.
* **IP Address** – The FHM's IP address.
* **MAC Address** – The FHM's MAC address.
The FHM's health status:
* **Online** – Indicates the FHM's online status, determined by its reachability from the Onyx Portal.
*  (green) – Indicates the FHM is management connected, and the last reported time is < 5 mins from current time.
*  (red) – Indicates any of the following conditions:
* FHM is not management connected
* Time reported >= 5 mins from current time
* FHM is not associated with any Onyx Edge
* (grey) – Indicates the gateway of the associated Onyx Edge is offline.
Hovering your cursor over the "Online Status" icon displays the FHM's last check-in timestamp.
* **Interface Status** – Indicates the fronthaul connection status of the AP.
FHM Interface Status icon indicators:
*  (green) – Passthrough is reported as true for all associated APs.
*  (red) – Passthrough is reported as false, or status information is unavailable for all associated APs.
*  (amber) – Passthrough is reported as false, or status information is unavailable for at least one, but not all, associated APs.
*  (grey) – FHM is not management-connected.
Hovering your cursor over the Interface Status icon displays the following details:
* **Access Point** – Name of individual AP.
* **Interface** – Ethernet port used for the fronthaul link.
* **Passthrough** – Indicates whether the fronthaul passthrough is active (true or false).
* **Service Status** – Indicates the FHM's transmission status.
*  (green) – RF TX is ON
*  (red) – RF TX is OFF
*  (grey) – AP is offline
* **Sync Status** – Indicates the FHM's sync status.
*  (green) – AP timing status is true
*  (red) – AP timing status is false
*  (grey) – AP is offline
Hovering your cursor over the "Sync Status" icon displays the following information:
* Value of the timing status
* IN\_SYNC if true
* LATE/EARLY if false
* **Onyx Edge** – The associated Onyx Edge.
* **FHM Properties**
* **Model** – The FHM equipment's model—GXC-FHM-001.
* **Software Version** – The FHM's current software version.
* **Up Time** – The time duration since the FHM was last restarted. For example, 2d 10h 17m 58s.
* **Reported Time** – Timestamp of the last update received from the FHM.
* **Associated Access Points** – Details of APs connected to the FHM.
* Service Status – Indicates the AP's service status.
*  (green) – Indicates the RF Tx status is on.
*  (red) – Indicates the RF Tx status is off.
*  (grey) – Indicates the AP is offline.
* **Name** – The AP's name.
* **Serial No.** – The AP equipment's vendor-assigned serial number.
* **IP Address** – The AP's IP address.
* **Online** – Indicates the AP's online status, which is determined by its reachability from the Onyx Portal.
*  (green) – Indicates the AP has checked-in with the Onyx Portal in the last five minutes.
*  (red) – Indicates the AP has not checked-in with the Onyx Portal in the last five minutes. Or, the time reported is older than five minutes.
*  (grey) – Indicates the associated Onyx Edge is offline.
Hovering your cursor over the "Online Status" icon displays the online status.
* **Interface Status** – Indicates the AP's fronthaul interface status.
*  (green) – Indicates the AP fronthaul interface is connected.
*  (red) – Indicates the AP fronthaul interface is disconnected.
*  (grey) – Indicates the AP is offline or the fronthaul interface status is unavailable.
Hovering your cursor over the "Interface Status" icon displays the fronthaul connection status.
* **Sync Status** – Indicates the AP’s time synchronization state with its configured clock source (such as GPS or PTP).
*  (green) – Indicates the AP is in sync with the clock source.
*  (amber) – Indicates the sync is degraded.
*  (red) – Indicates the AP is not in sync.
*  (grey) – Indicates the Sync status is not available or the AP is offline.
Hovering over the Sync Status icon displays detailed synchronization states:
* **PTP** – Precision Time Protocol – Indicates whether time synchronization is locked or unlocked.
* **SyncE** – Synchronous Ethernet – Indicates whether frequency synchronization is locked or unlocked.
* **Fiber Length (km)** — Length of fiber cable used to connect this AP to the FHM, in kilometers. The system uses this parameter to automatically calculate and apply RU transmit delay compensation, improving timing alignment across RUs connected via different fiber lengths.
* **Subscribers** — Details of all subscribers connected through every AP associated with the FHM.
* **Status** — The subscriber's current session state.
* **Name** — The subscriber account's name.
* **IMSI** — The subscriber's IMSI — a unique identifier assigned to each subscriber SIM.
* **Subscriber Group Name** — The subscriber group to which the subscriber belongs.
* **gNB ID/Cell ID** — The gNB ID/Cell ID top which the subscriber is associated. Click to view the corresponding AP details page.
{% hint style="info" %}
**NOTE:** When an AP is directly associated with an Onyx Edge, details of subscribers connected to that AP are displayed in the AP's Details page. For APs associated with an FHM, subscriber details are displayed only in the FHM details page.
{% endhint %}
{% endstep %}
{% step %}
Click the **Events & Alerts** tab.
The **Events & Alerts** tab displays the following details.
* **Alerts** panel
* A filter dropdown allows alerts to be filtered by status. If no alerts are present, the panel displays "No Records Found".
* **Date** — The date and time the alert was raised.
* **Status** — The alert's current status.
* **Alert Name** — The alert's name.
* **Severity** — The alert's severity level.
* **Events** panel
* A date and time range selector at the top of the Events panel filters events by time window.
* The Module and Event Type columns include filter controls, and the Entity column includes a search control.
* **Timestamp** — The date and time the event occurred.
* **Module** — The system module that generated the event.
* **Event Type** — The type of event, such as device\_configuration\_updated, device\_connected, device\_disconnected, etc.
* **Entity** — The vendor-assigned serial number of the FHM equipment associated with the event.
* **Event Description** — A plain-language description of the event.
* To access additional event details, click the corresponding view details icon.
{% endstep %}
{% endstepper %}
## Add FHM
{% hint style="info" %}
**NOTE:** You can add FHMs only if you are a GXC Administrator, Partner Administrator, Super Administrator, or an Administrator.
{% endhint %}
**To add an FHM:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **FHM** tab.
The **Equipment** page > **FHM** tab displays the summary details of all FHM configured in the network.
{% endstep %}
{% step %}
In the upper-right corner of the page, click **Add Node** > **Add FHM**.
The **Create FHM** page is displayed.
{% endstep %}
{% step %}
Enter the following details:
* **Name** – (Required) The FHM's name. The name must be unique and must be an alphanumeric string of up to 32 characters.
* **Serial Number** – (Required) The FHM equipment's vendor-assigned serial number. The serial number must be an alphanumeric string of up to 32 characters and may include the "-" (hyphen) character.
* **MAC Address** – (Required) The FHM's MAC address.
* **Device Class** – (Required) Click to select the FHM equipment's model.
* **Selected RU Configuration** – Select the APs to associate with the FHM. You can only associate free unassociated APs.
* **Fiber Length (km)** – The fiber length between each AP and this FHM. The system uses
\
these values to automatically calculate and apply AP transmit delay compensation,
\
improving timing alignment across APs connected via different fiber lengths. Enter a positive numeric value up to two decimal places (e.g., 0.25, 3.50).
{% endstep %}
{% step %}
To save the FHM, in the upper-right corner of the page, click **Save FHM**.
{% endstep %}
{% endstepper %}
## Edit FHM
{% hint style="info" %}
**NOTE:** You can edit FHM details only if you are a GXC Administrator, Partner Administrator, Super Administrator, or an Administrator.
{% endhint %}
**To edit an FHM:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **FHM** tab.
The **Equipment** page > **FHM** tab displays the summary details of all FHMs configured in the network.
{% endstep %}
{% step %}
For the FHM that you want to edit, in the **Actions** column, click the corresponding ⋮ (options) icon, then click **Edit**.
The **Edit FHM** page displays the equipment's details.
{% endstep %}
{% step %}
Edit the following details as required.
* **Name** – (Required) The FHM's name.
* **Serial Number** – (Read-only) The FHM equipment's vendor-assigned serial number. This field cannot be modified after the FHM is created.
* **MAC Address** – (Read-only) The FHM's MAC address. This field cannot be modified after the FHM is created.
* **Device Class** – (Read-only) The FHM equipment's model. This field cannot be modified after the FHM is created.
* **Selected RU Configuration** – Select the APs to associate with the FHM. You can only associate free unassociated APs.
* **Fiber Length (km)** – The fiber length between each AP and this FHM. The system uses
\
these values to automatically calculate and apply AP transmit delay compensation,
\
improving timing alignment across APs connected via different fiber lengths. Enter a positive numeric value up to two decimal places (e.g.,
0.25, 3.50). Changes to fiber length trigger a configuration update to the Onyx Edge, ensuring compensation is applied immediately.
{% endstep %}
{% step %}
To save your edits, in the upper-right corner of the page, click **Save FHM**.
{% endstep %}
{% endstepper %}
## Reboot FHM
{% hint style="info" %}
**NOTE:** You can reboot FHMs only if you are a Super Administrator or an Administrator.
{% endhint %}
**To reboot an FHM:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **FHM** tab.
The **Equipment** page > **FHM** tab displays the summary details of all FHMs configured in the network.
{% endstep %}
{% step %}
Click the Serial Number of the FHM that you want to reboot.
The ***\*** page displays the FHM's details.
{% endstep %}
{% step %}
In the upper-right corner of the page, click **Actions**, then click **Reboot**.
A confirmation dialog box is displayed.
{% endstep %}
{% step %}
To confirm rebooting the FHM, click **Yes**.
{% endstep %}
{% endstepper %}
## Delete FHM
{% hint style="info" %}
**NOTE:** You can delete FHMs only if you are a GXC Administrator, Partner Administrator, Super Administrator, or an Administrator.
{% endhint %}
{% hint style="info" %}
**NOTE:** Before you can delete an FHM, you must disassociate any APs associated with that FHM. For more information, see [*Edit FHM*](#edit-fhm).
{% endhint %}
**To delete an FHM:**
{% stepper %}
{% step %}
In the navigation pane, click **Equipment** > **FHM** tab.
The **Equipment** page > **FHM** tab displays the summary details of all FHMs configured in the network.
{% endstep %}
{% step %}
For the equipment that you want to delete, in the **Actions** column, click the corresponding ⋮ (options) icon, then click **Delete**.
A confirmation dialog box is displayed.
{% endstep %}
{% step %}
To confirm deleting the FHM, click **Yes**.
{% endstep %}
{% endstepper %}
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.gxc.io/docs/network-configuration-and-operations-guides/5g-onyx-portal-4.x-operations/manage-equipment/manage-fhm.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
(grey) – Indicates the gateway of the associated Onyx Edge is offline.
Hovering your cursor over the "Online Status" icon displays the FHM's last check-in timestamp.
* **Interface Status** – Indicates the fronthaul connection status of the AP.
FHM Interface Status icon indicators:
*  (green) – Passthrough is reported as true for all associated APs.
*  (red) – Passthrough is reported as false, or status information is unavailable for all associated APs.
*  (amber) – Passthrough is reported as false, or status information is unavailable for at least one, but not all, associated APs.
*  (grey) – FHM is not management-connected.
Hovering your cursor over the Interface Status icon displays the following details:
* **Access Point** – Name of individual AP.
* **Interface** – Ethernet port used for the fronthaul link.
* **Passthrough** – Indicates whether the fronthaul passthrough is active (true or false).
* **Service Status** – Indicates the FHM's transmission status.
*  (green) – RF TX is ON
*  (red) – RF TX is OFF
*  (grey) – AP is offline
* **Sync Status** – Indicates the FHM's sync status.
*  (green) – AP timing status is true
*  (red) – AP timing status is false
*  (grey) – AP is offline
Hovering your cursor over the "Sync Status" icon displays the following information:
* Value of the timing status
* IN\_SYNC if true
* LATE/EARLY if false
* **Onyx Edge** – The associated Onyx Edge.
* **FHM Properties**
* **Model** – The FHM equipment's model—GXC-FHM-001.
* **Software Version** – The FHM's current software version.
* **Up Time** – The time duration since the FHM was last restarted. For example, 2d 10h 17m 58s.
* **Reported Time** – Timestamp of the last update received from the FHM.
* **Associated Access Points** – Details of APs connected to the FHM.
* Service Status – Indicates the AP's service status.
*  (green) – Indicates the RF Tx status is on.
*  (red) – Indicates the RF Tx status is off.
*  (grey) – Indicates the AP is offline.
* **Name** – The AP's name.
* **Serial No.** – The AP equipment's vendor-assigned serial number.
* **IP Address** – The AP's IP address.
* **Online** – Indicates the AP's online status, which is determined by its reachability from the Onyx Portal.
*  (green) – Indicates the AP has checked-in with the Onyx Portal in the last five minutes.
*  (red) – Indicates the AP has not checked-in with the Onyx Portal in the last five minutes. Or, the time reported is older than five minutes.
*  (grey) – Indicates the associated Onyx Edge is offline.
Hovering your cursor over the "Online Status" icon displays the online status.
* **Interface Status** – Indicates the AP's fronthaul interface status.
*  (green) – Indicates the AP fronthaul interface is connected.
*  (red) – Indicates the AP fronthaul interface is disconnected.
*  (grey) – Indicates the AP is offline or the fronthaul interface status is unavailable.
Hovering your cursor over the "Interface Status" icon displays the fronthaul connection status.
* **Sync Status** – Indicates the AP’s time synchronization state with its configured clock source (such as GPS or PTP).
*  (green) – Indicates the AP is in sync with the clock source.
*  (amber) – Indicates the sync is degraded.
*  (red) – Indicates the AP is not in sync.
*  (grey) – Indicates the Sync status is not available or the AP is offline.
Hovering over the Sync Status icon displays detailed synchronization states:
* **PTP** – Precision Time Protocol – Indicates whether time synchronization is locked or unlocked.
* **SyncE** – Synchronous Ethernet – Indicates whether frequency synchronization is locked or unlocked.
* **Fiber Length (km)** — Length of fiber cable used to connect this AP to the FHM, in kilometers. The system uses this parameter to automatically calculate and apply RU transmit delay compensation, improving timing alignment across RUs connected via different fiber lengths.
* **Subscribers** — Details of all subscribers connected through every AP associated with the FHM.
* **Status** — The subscriber's current session state.
* **Name** — The subscriber account's name.
* **IMSI** — The subscriber's IMSI — a unique identifier assigned to each subscriber SIM.
* **Subscriber Group Name** — The subscriber group to which the subscriber belongs.
* **gNB ID/Cell ID** — The gNB ID/Cell ID top which the subscriber is associated. Click to view the corresponding AP details page.
{% hint style="info" %}
**NOTE:** When an AP is directly associated with an Onyx Edge, details of subscribers connected to that AP are displayed in the AP's Details page. For APs associated with an FHM, subscriber details are displayed only in the FHM details page.
{% endhint %}
{% endstep %}
{% step %}
Click the **Events & Alerts** tab.
The **Events & Alerts** tab displays the following details.
