Skip to content

Using the web UI

The switch has two web pages:

URL Page
https://<switch-ip>/ Status page: what the switch is doing, and its settings.
https://<switch-ip>/update/ Firmware update page.

Both work in any current browser, over HTTPS only.

Logging in

The switch makes its own HTTPS certificate on the first boot, so the browser warns that it does not know who issued it. Accept it once for the switch's address; a factory reset makes a new certificate, and the browser warns again.

  • First login. A new switch, or one after a factory reset, has no admin account and shows only a form to create it: a username (a lower case letter or _, then up to 31 lower case letters, digits, _ or -; not a name the switch uses itself, such as root) and a password (8 to 128 characters, typed twice). They are the login for the web pages, SSH and the serial console; SSH lets nobody in before. The username stays until a factory reset. Continue then reloads the page.
  • Every other time, the browser asks for the admin username and password. It remembers them until it is closed.

If the page says "Not logged in", the login was cancelled or the password has changed: reload the page.

Status page

The status page of a switch with VLANs, spanning tree, SNMP and a DHCP lease

The status page shows the state of the switch at a glance. Its Edit, Add and Delete buttons change the configuration, see Changing settings.

It updates itself every 5 seconds while it is visible. Refresh updates it at once, and the time of the last update is next to it.

  • The switch's host name and firmware version.
  • Save configuration keeps the changes made since the last save across a reboot. It is highlighted while there are unsaved changes.
  • Firmware update opens the firmware update page in a new tab.

Cards

Below the header, one card per feature. What each card shows and what its dialogs change is described on the feature's page:

Card Feature page
System System information
Management Management IP address
Ports Ports
VLANs VLANs
Spanning tree Spanning tree
LLDP LLDP
SNMP SNMP
Administration Password and factory reset

When the page shows an error

"Cannot read the switch's state" means the page could not get the data from the switch, for example while it reboots. The page keeps trying every 5 seconds and recovers by itself.

Changing settings

An Edit (or Add, Delete) button opens a dialog. Apply sends the change to the switch, and it takes effect at once. If the switch refuses the change, the dialog stays open and shows why, for example VLAN 20 is not declared in vlans. Nothing has changed then.

Save, or lose it on reboot

Applied changes are not saved. A yellow banner says so until you click Save configuration. A reboot goes back to the saved configuration, which is also how you recover from a change that cut you off.

The page does not update itself while a dialog is open.

The web UI covers the everyday settings. Each feature page says what is not in the web UI; that is configured with the CLI or RESTCONF.

Firmware update page

The firmware update page

The update page is SWUpdate's own web interface, behind the same login as the status page. How to use it, and what to watch out for, is described in Firmware update. In short:

  • Software Update: drop a .swu file here, or click to choose one. The upload and installation start at once.
  • The status line below it ("Update not started", "Updated successfully", "Update failed") and the progress bar show how far it got.
  • Messages (click to open) lists what SWUpdate is doing, including the reason when an update fails. It only shows messages of updates that run while the page is open.
  • Restart System (top right) reboots the switch at once. Committed but unsaved configuration changes are lost.