RouteMaster V2.8.0 includes a new Web-based UI for control and configuration. This operates alongside the existing main UI, and currently only offers a subset of the main UI functions. Eventually the Web UI will be enhanced to include all functions available in the application UI, which will then be deprecated. Newer configuration features may only be accessible via the Web UI.
Prior to V2.8, RouteMaster included an internal web server to allow users to run web-based router control panels designed with Rascular Helm. The web server was enabled in the Client Settings dialog, under the Web Panels tab. The server only ran while RouteMaster was in the ‘Run’ state.
From V2.8 onwards, the web server is configured using a dedicated dialog. If enabled, the server runs even when RouteMaster is ‘stopped’. Select Configure Web Server from the Settings menu.
Check the Internal Web Server box, and select a suitable TCP port that’s not already in use on your system. To prevent accidental access to the Web UI, you can optionally specify a username and password. See the section below on Web UI Security.
Opening the Web UI
Oncethe server’s configured, you can open the Web UI using Open Web Interface from the menu. Or, by just entering the URL directly in your browser.
The Web UI is shown below. A navigation section on the left allows different pages to be viewed, and the UI can be operated in Dark or Light modes.
Status
The Status page shows the current RouteMaster status, including enabled client protocols and client licenses. Buttons allow RouteMaster to be stopped and restarted.
Panels
Any web-based control panels are available here. Additional panels can be designed and uploaded to RouteMaster using Helm Designer. A panel opened in Scaled mode will automatically resize to the browser window.
Router Configuration
The Router Configuration page allows you to view and edit settings for the routers controlled by RouteMaster. It duplicates (and will eventually replace) the router configuration settings from the application UI.
After making changes to the Router Configuration, press Save to ensure they’re committed, then restart RouteMaster from the Status page.
Please note that this page is a work in progress. Not all configuration options are accessible, in particular Multi-Routers and Stacked Routers cannot yet be configured here. If in doubt, use the main application UI to configure routers.
Client Configuration
The client configuration page allows you to edit the settings for each of RouteMaster’s client protocols. It duplicates (and will eventually replace) the client configuration settings from the application UI.
HA Configuration
From RouteMaster V3.0, the High Availability configuration page allows you to enable HA mode and speify the the IP addresses of the Main and Backup systems.
Diagnostics
From the Diagnostics page you can view RouteMaster’s log, check that licenses are valid, and see other diagnostic information.
Under the Tools tab, you can generate a diagnostic Stack Trace for RouteMaster. This allows Rascular to debug problems where RouteMaster has lost control of the router and is failing to reconnect. If you experience a problem like this, please generate a stack trace while the system has failed and email the resulting contents to [email protected].
You can also download the RouteMaster configuration file here, for diagnostic or backup purposes.
Web Interface Security
RouteMaster’s Web UI allows a single username and password to be configured to allow access to the system. This uses HTTP Basic Auth, which prevents accidental access, but – due to use of plaintext HTTP transmissions – does little to prevent malicious access. To ensure the system’s security, firewall rules should be in place to prevent access from unauthorized systems, and TLS mode shold be enabled, with appropriate certificate files installed. Contatc [email protected] for further details on this.