Troubleshooting Information

This section describes basic Onyx Edge troubleshooting information.

View Onyx Edge Details

To view an Onyx Edge’s details:

1

Open the Onyx Edge's Details page (Onyx Portal, click Equipment > Onyx Edge tab > Onyx Edge details page > Overview tab).

The Overview tab displays the selected Onyx Edge's details, including its configuration, status, and connected equipment. For detailed information, see 4G Onyx Portal Operations Guide > View Onyx Edge Details.

2

To view Onyx Edge's events and alerts, click the Events & Alerts tab.

The Events & Alerts tab displays alerts and events generated by the Onyx Edge.

The Alerts panel lists device alerts with the Date, Status, Alert Name, and Severity, and includes a filter to view specific alert types.

The Events panel displays system events for the selected date/time and duration. The table includes the Timestamp, Module, Event Type, Entity, and Event Description, with filtering options for several fields.

For detailed information, see 4G Onyx Portal Operations Guide > View Onyx Edge Details.

3

To view Onyx Edge's logs, click the Logs tab.

The Logs tab displays Onyx Edge logs for the selected date/time and duration, and log details including timestamp, service, tag, type, and log text are displayed.

To download the logs in .csv format, click Download. In the Download Logs dialog box, select the timestamps and the limit, which specifies the maximum number of logs to be included in the .csv file, then click Save. The downloaded .csv file contains log details including timestamp, service, tag, type, and log text.

For detailed information, see 4G Onyx Portal Operations Guide > View Onyx Edge Details.

View Connected APs, Mesh Nodes, and Subscribers

To view the list of active APs, Mesh nodes, and subscribers connected to an Onyx Edge:

1

For the list of active APs, view the Onyx Edge’s details page > Overview tab > Connected Access Point section.

2

For the list of Mesh Nodes, view the Onyx Edge’s details page > Overview tab > Mesh Node section.

3

For the list of active subscribers, view the Onyx Edge’s details page > Overview tab > Subscribers section.

For detailed information, see 4G Onyx Portal Operations Guide > View Onyx Edge Details.

Run Commands on the Onyx Edge

This section describes how to:

• Run Commands on Onyx Edge from Onyx Portal
• Run Commands on Onyx Edge as agw_user

Run Commands on Onyx Edge from Onyx Portal

To run generic commands on an Onyx Edge from the Onyx Portal:

1

In the Onyx Edge’s details page (Onyx Portal > Equipment > Onyx Edge tab > Onyx Edge details page), in the upper-right corner of the page, click Actions.

NOTE: The Actions button is enabled only when the Onyx Edge is online.

• 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 the 4G Onyx Portal Operations Guide > Move an Onyx Edge from one Upgrade Group to Another section.
• Reboot Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Reboot the Onyx Edge. Services will be down while the equipment reboots.

  A confirmation dialog box is displayed. To confirm, click Yes.
• Restart Services on Onyx Edge – (GXC Administrators, Super Administrators, and Administrators only.) Restart the Onyx Edge’s core services. All active UE will be detached. Connectivity will be down until the services resume.

  A confirmation dialog box is displayed. To confirm, click Yes.
• 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.
• Reboot Neighbor Updated AP – (GXC Administrators, Super Administrators, and Administrators only.) Schedule reboots for APs with pending neighbor changes:

  • Reboot all APs with reboot pending at a chosen time, including immediately.
  • Reboot a specific AP by serial number, if it has a reboot pending, at a chosen time including immediately.
• 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 Subscriber Config Sync – (GXC Administrators, Super Administrators, and 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.

Run Commands on Onyx Edge as agw_user

As agw_user, you can SSH into and run the following commands on your Onyx Edge.

To SSH into an Onyx Edge as agw_user, run the following command:

ssh agw_user@<ip_address>

For more information, see agw_user.

Command Descriptions

change_password

Prompts to change the current password for agw_user.

Usage: change_password [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example:

onyxedge> change_password

collect_tech_dump

Collects system logs and diagnostic information from the Onyx Edge and creates a tech dump archive in /var/core/tech_dump/.

Usage: collect_tech_dump [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example:

onyxedge> collect_tech_dump

gateway power-off

Powers off the Onyx Edge safely.

Usage: gateway power-off [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example:

onyxedge> gateway power-off

gateway reboot

Reboots the Onyx Edge.

Usage: gateway reboot [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example:

onyxedge> gateway reboot

gateway restore-factory-defaults

Restores the Onyx Edge to its factory default settings.

Usage: gateway restore-factory-defaults [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example:

onyxedge> gateway restore-factory-defaults

history

Manages and displays previously entered commands.

Usage: history [-h] [-r] [-e] [-o FILE] [-t TRANSCRIPT_FILE] [-c] [-s] [-v] [-a] [arg]

Optional Arguments:

• -h, --help: Displays help information for the command.
• -r, --run: Run selected history items.
• -e, --edit: Edit and then run selected history items.
• -o, --output_file: Output commands to a script file.
• -t, --transcript: Output commands and results to a transcript file.
• -c, --clear: Clear all history.
• -s, --script: Output commands in script format.
• -v, --verbose: Display detailed command information.
• -a, --all: Display all commands from previous sessions.

Example: This command runs the third command from history.

onyxedge> history -r 3

ping

Sends ICMP echo requests to test network connectivity.

Usage: ping [-h] [-c COUNT] host

Positional Argument:

• host: The host to ping.

Optional Arguments:

• -h, --help: Displays help information for the command.
• -c, --count COUNT: Number of pings to send (for infinite pings use 0).

Example: This command sends five ping requests to the host 10.0.0.1.

onyxedge> ping -c 5 10.0.0.1

quit

Exits the Onyx Edge CLI application.

Usage: quit [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example:

onyxedge> quit

scp_to

Securely copies files to a host using SCP.

Usage: scp_to -u USER -o HOST [-h] [-d TECHDUMP] [-c CORE] [-s] [-t TARGET_PATH]

Required Arguments:

• -u, --user: Username to use for SCP.
• -o, --host: The target host to SCP to. Optional Arguments:
• -h, --help: Displays help information for the command.
• -d, --techdump: Specifies the tech dump file to SCP.
• -c, --core: Specifies the core file to SCP.
• -s, --ssh-pubkey: Copies the Onyx Edge’s SSH public key.
• -t, --target-path: Specifies the path on the target host.

Example: This command copies the tech dump to the host at 10.0.0.2.

onyxedge> scp_to -u admin -o 10.0.0.2 -d /var/log/techdump.tar.gz

show authorized-keys

Displays the SSH authorized keys on the system, which can be used for secure access.

Usage: show authorized-keys

Example:

onyxedge> show authorized-keys

show files

Lists available system files such as core dumps and tech dumps.

Usage: show files {cores, tech-dumps}

Positional Arguments:

• cores: Lists core dump files (if any).
• tech-dumps: Lists tech dump files.

Example: Lists all available tech dump files.

onyxedge> show files tech-dumps

show gateway-info

Displays detailed Onyx Edge information, including hardware ID and challenge key.

Usage: show gateway-info [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example: Displays the Onyx Edge’s hardware ID and challenge key.

onyxedge> show gateway-info

show networking

Displays information about the network interfaces and IPs of the Onyx Edge system.

Usage: show networking [-h] {links, ipv4}

Positional Arguments:

• links: Displays the network interface details (e.g., link status, MTU, etc.).
• ipv4: Shows the IPv4 addresses associated with network interfaces. Optional Arguments:
• -h, --help: Displays help information for the command.

Examples:

• Displays detailed information for all network interfaces (e.g., eth0, eth1).

onyxedge> show networking links

• Displays the IPv4 addresses assigned to interfaces like eth0, eth1, etc.

onyxedge> show networking ipv4

show services

Displays the status of all services on the Onyx Edge system.

Usage: show services [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example: Displays the status (e.g., active/inactive) of all services running on the system.

onyxedge> show services

show ssh-key

Displays the Onyx Edge’s SSH public key, which can be used for SCP file transfers.

Usage: show ssh-key [-h]

Optional Arguments:

• -h, --help: Displays help information for the command.

Example: Displays the Onyx Edge’s SSH public key to be added to other hosts for secure transfers.

onyxedge> show ssh-key

Related Documentation

• 4G Onyx Portal Operations Guide
• GXC Glossary

Contact GXC

To get in touch with GXC, please visit https://gxc.io/contact-us/.