Managing wSeries and eSeries appliances via Serial Console

Overview

The w4 / w8 / e3 / e3w / e6 / e6w / e6wl appliances support management via serial console for troubleshooting purposes. 

Note: Serial console management is generally not necessary and should only be used if advised by a support technician.

Finding the right cable

The w8, e3, and e3w appliances support serial console access through micro USB. A USB A to micro USB is included with the appliance contents. 

usb2musb.png

The w4, e6, e6w, e6wl appliances support serial console access through an RJ45 interface. These appliances do not include a console cable, but you can purchase separately a USB to RJ45 serial cable.

usb2rj45.jpg

Connecting from your management system

The necessary baud rate for connecting to all of the appliances is 115200. For specific connection details for your operating system see below:

Windows

On Microsoft Windows 10 and 11, the USB to Serial driver is usually built-in.

  1. With the cable connected to your Windows computer and the appliance, check your Device Manager.
  2. Locate the "Ports (COM & LPT)" section for a Prolific-USB-to-Serial Comm Port. 
  3. Confirm the COM port associated to the device.
  4. Install the Putty utility.
  5. Open Putty and create a new connection of type "Serial"
  6. Enter the COM port (e.g. COM3) and the speed "115200"
  7. Click Open

PuTTY_BasicSettings.png

macOS

Recent versions of macOS include the necessary USB drivers and utilities for managing your appliance via serial console. To confirm, open the Terminal app and list your /dev directory "ls /dev". If your cable is connected to both your Mac and the appliance, you should see a device starting with "tty.usbserial". If you do not see a similar named device try a different cable.

Once you confirm the device name, use the built-in "screen" utility with the following command:

screen /dev/tty.usbserial-210 115200

Note: In the connection string above, the USB serial device name is tty.usbserial-210. This name may be slightly different depending on your system and cable. 

serial-macos-connect.png

Once you connect to the device, press the return key to access the login prompt.

Note: The login is "root" and the password is the same as the web administration admin account.

serial-login.png

After successful login, you can proceed to the troubleshooting menu.

serial-menu.png

Menu Option Function
Remap Interfaces Reorder the hardware interfaces.
Configure Interface Basic configuration settings for interfaces.
Ping Initiate a ping test to a target of your choice.
Remote Support Toggles remote support access for this appliance.
Upgrade Check for and initiate any available software upgrade.
Reboot Restart the hardware appliance.
Shutdown Shut down the hardware appliance.
Reset To Factory Defaults Restore the software to defaults, undoing any configurational changes that have been made.
Exit to Shell Exit this console and return to the command line.

 

Accessing the console menu from the command line

This menu can be accessed by running the following command from the command line or SSH terminal.

/usr/share/untangle/bin/ut-textui.py

Follow
Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk