Hey! Listen! This post is part of a series on the Ubiquiti EdgeRouter Lite. Check them all out!
|2019-06-28||Migrating away from the Ubiquiti EdgeRouter Lite|
|2019-02-03||EdgeRouter CNAME records|
|2017-10-03||Dyn DDNS on EdgeRouter|
|2017-04-25||DuckDNS on EdgeRouter|
|2017-01-08||Ubiquiti EdgeRouter serial console settings|
|2016-11-29||Ubiquiti UniFi controller setup on Raspberry Pi 3|
|2016-08-30||EdgeRouter Lite Dnsmasq setup|
|2016-06-13||EdgeRouter Lite software upgrade|
|2016-05-12||EdgeRouter Lite OpenVPN setup|
|2016-04-29||Ubiquiti EdgeRouter Lite setup|
I’m planning on upgrading my EdgeRouter Lite (ERL) to the newly-released v1.9.1 (I’m following my upgrade guide). This time, I’m using a serial cable to connect to my ERL. This is the first time I’ve used serial, so I’m going to document the process.
Serial connectors (standard RS-232) are often included on networking and enterprise equipment. Serial comes in a number of different physical connectors, called D-subminiature, including DB25 and DB9.
Serial is a very old technology, so why is it still around? Serial is slow, doesn’t transmit power, and isn’t good for runs longer than a few meters. However, serial is a very basic connection, which means is it reliable, simple, and is almost universal. In the case of the ERL, it is easy to break the configuration in a way that locks you out. You can assign the wrong firewall rule to the wrong port, disable password authentication and then delete your SSH keys, etc… Serial is an always-on, dead-simple, reliable connection to your ERL. The only downside is that you need to physically be connected to the ERL.
The ERL uses a standard ethernet serial port, so you’ll need a RJ45 (ethernet) to DB9 (serial) adapter. If your computer doesn’t have a DB9 serial port, you’ll also need a DB9 to USB adapter. If you only want to use one cable, you can use an all-in-one serial-to-usb cable, like this one from Amazon. If you’ve ever used Cisco products, any teal Cisco serial cable will work (Ubiquiti did that on purpose).
The serial settings for Ubiquiti products are listed on the Ubiquiti website, and shown below.
- Baud rate: 115200
- Data bits: 8
- Parity: NONE
- Stop bits: 1
- Flow control: NONE
Those same settings are sometimes abbreviated in the format shown below.
115200 8N1 OFF
First, check Device Manager for your COM port. In my case, it was COM3.
Next, connect to the ERL with the serial console of your choice. I’m using PuTTY on Windows. The settings you need are under Connection –> Serial, shown below.
If you get a blank screen (shown below), just press Enter once to get the prompt to login.
Typically, you’ll need to add your user to a group to use the serial console. In Arch Linux, the group is uucp, but it may be different depending on your distribution.
sudo gpasswd -a username uucp
Start by plugging in your serial cable to identify which port it is connected to. My device was at /dev/ttyUSB0.
dmesg | grep -iE 'serial|tty'
Next, you’ll need to install a program to use the serial console. I’m using picocom, but you can also use minicom, screen, etc…
sudo picocom -b 115200 -d 8 -f n -p 1 -y n /dev/ttyUSB0
Again, if you get a blank screen, just press Enter once to get the prompt to login.
Hope this helps!