GUI
The OSDx Web GUI is a modern web-based management interface for OSDx routers. It provides a comprehensive set of tools for monitoring, configuring, diagnosing, and managing the router through an intuitive graphical interface accessible from any standard web browser.
The Web GUI is organized into the following sections:
Status – real-time monitoring and read-only information about the router.
Dashboard
ARP Table
DHCP Leases
NTP
Interfaces
DNS
IP Routes
Traffic
NAT
Configuration – allows admin users to modify router settings.
General Settings
NTP Service
Syslog
Static Routing
Traffic Policy
Services (SSH, Telnet, Web, DNS)
NAT
Users Administration
Interfaces
Diagnostics – network troubleshooting tools with real-time streaming output.
Ping
Traceroute
DNS Lookup
Traffic Monitor
Administration – system management tools for admin users.
Software Upgrade
Restart Device
Tech Support
Logging
Configuration
The syntax to set up service web is as follows:
set service web [ ... ]
To enable the web interface, you must configure at least one of the following protocols:
http: to enable the HTTP server (unencrypted, port 80 by default).https: to enable the HTTPS server (encrypted, port 443 by default).
The available options for http are:
host: to specify the bind address for the server.port: to specify the port for the server.
The available options for https are:
host: to specify the server bind address.port: to specify the server’s port number.ssl-ciphers: to specify the SSL cipher suites allowed (OpenSSL cipher string format).ssl-protocol: to specify the SSL/TLS protocol version allowed.x509: to configure the X.509 certificate (required for HTTPS).
Troubleshooting
This section covers common issues when using the OSDx Web GUI and offers potential solutions.
Connection issues
Cannot access the web interface
Make sure the router’s IP address is correct and reachable (ping from your computer). Check that the web service is enabled. Ensure the correct protocol is being used (HTTPS on port 443 by default). Check for firewalls blocking the management port. Try HTTP on port 80 if HTTPS is not configured.
SSL/TLS certificate warning in browser
The router uses a self-signed certificate by default. Click “Advanced” > “Proceed to site” to continue. In production environments, install a valid SSL certificate via Configuration > Services > Web.
Page loads but shows blank or broken content
Clear the browser’s cache (Ctrl+Shift+Delete). Disable browser extensions that may cause an interferance. Make sure JavaScript is enabled. Try a different browser or open an incognito/private window.
Authentication issues
Login fails with “Invalid username or password”
Make sure the credentials are correct and check Caps Lock. Verify the user account exists on the system. Contact an administrator if you forgot your password.
Account is locked after failed login attempts
Wait for the auto-unlock timeout (configured in Users Administration > Unlock Time). An administrator can reset the account. If Unlock Time is 0, only an admin can manually unlock it.
Session expires unexpectedly
Check the Idle Timeout setting in Users Administration. A value of 0 disables the timeout. Increase the value if sessions expire too quickly.
“Insufficient privileges” error on a page
Your account role cannot access this section. An “Admin” role is necessary to access Configuration and Administration features. Contact an administrator to upgrade your permissions.
Configuration issues
“Router configuration is not available at this moment”
Another session or process has locked the configuration. Wait a few seconds and retry. If the issue persists, check whether another admin is making changes. As a last resort, restart the web service from CLI.
Changes not taking effect after saving a form
You must click on “Commit” (in the sidebar) to apply these changes to the running configuration. Saving them in a form only serves to record them. After committing, click “Save” to apply changes across reboots.
Yellow warning icons on sidebar items
They indicate uncommitted (pending) configuration changes in that section. Click on “Commit” to apply all pending changes, or “Discard” to revert them.
Lost connectivity after committing changes
If you changed the management IP or web service port, the browser can no longer reach the router at the old address. Connect to the new IP/port. If the change was a mistake, access the router via console (serial/SSH) and revert the configuration.