EdgeRouter – Upgrading EdgeOS firmware

 

Video Tutorial (Web GUI)


Instructions for Upgrading Via CLI


In this article, readers will learn how to update the EdgeRouter firmware via the CLI.

Currently two firmware images can be stored on the EdgeRouter. This is convenient; if an upgrade doesn’t work properly, then it’s easy to revert back to the old version. 

To see the current version:

ubnt@RTR:~$ show version   Version:      v0.9.5  Build ID:     13450177  Build on:     08/15/12 01:02  Copyright:    2012 Ubiquiti, Inc  HW model:     EdgeRouter Lite 3-Port  HW S/N:       1226TDC9FDB170D87  Uptime:       18:03:12 up 4 min,  1 user,  load average: 0.32, 0.25, 0.11  

You can add a new image from a local file or a URL:

ubnt@RTR:~$ add system image ?  Possible completions:       File name or URL of system image file to be installed     

For example to use a direct download link (use actual URL of course):

add system image http://dl.ubnt.com/...

To add a new image from a local file:

ubnt@RTR:~$ add system image egdeos-120821.tar  Preparing to upgrade... Done  Copying upgrade image... Done  Removing old image... Done  Checking upgrade image... Done  Finishing upgrade... Done  Upgrade completed  ubnt@RTR:~$  

Note: When a new image is added, the entire /config directory is copied to the new image, so it will have the same configuration as the last saved config. Openvpn keys saved in /config/auth will also get copied.

To see both images and the status of which is running and which will be running after the next reboot:

ubnt@RTR:~$ show system image   The system currently has the following image(s) installed:  v0.9.5.13455361.120821.0102    (default boot)   v0.9.5.13450177.120815.0102    (running image)   A reboot is needed to boot default image  

After a reboot, the new image is both running and default:

ubnt@RTR:~$ show system image   The system currently has the following image(s) installed:  v0.9.5.13455361.120821.0102    (running image) (default boot)   v0.9.5.13450177.120815.0102  

To see how much storage each image is using:

ubnt@RTR:~$ show system image storage   Image name                        Read-Only   Read-Write        Total  ------------------------------ ------------ ------------ ------------  v0.9.5.13455361.120821.0102           69060          460        69520  v0.9.5.13450177.120815.0102           69056        77428       146484  

To switch to the other image, like if a revert is needed following upgrade:

ubnt@RTR:~$ set system image default-boot   The system currently has the following image(s) installed:  v0.9.5.13455361.120821.0102    (running image) (default boot)   v0.9.5.13450177.120815.0102      Are you sure you want to switch images? (Yes/No) [Yes]:    Moving images...   Done  Switched from   Version:      v0.9.5.13455361.120821.0102  to   Version:      v0.9.5.13450177.120815.0102  

If you want to delete the other image, you have:

ubnt@RTR:~$ delete system image   The system currently has the following image(s) installed:  v0.9.5.13455361.120821.0102    (running image) (default boot)   v0.9.5.13450177.120815.0102      You are about to delete image [v0.9.5.13450177.120815.0102]  Are you sure you want to delete ? (Yes/No) [Yes]:   Removing old image... Done


Leave a Reply

Your email address will not be published. Required fields are marked *