{"id":2135,"date":"2023-05-22T10:29:25","date_gmt":"2023-05-22T14:29:25","guid":{"rendered":"https:\/\/lowtek.ca\/roo\/?p=2135"},"modified":"2023-05-22T10:29:25","modified_gmt":"2023-05-22T14:29:25","slug":"openwrt-21-02-to-22-03-upgrade","status":"publish","type":"post","link":"https:\/\/lowtek.ca\/roo\/2023\/openwrt-21-02-to-22-03-upgrade\/","title":{"rendered":"OpenWRT 21.02 to 22.03 upgrade"},"content":{"rendered":"

Here are my notes on upgrading OpenWRT, they are based on my previous post on upgrading<\/a>.<\/p>\n

In this case I\u2019m upgrading specifically TP-Link Archer C7 v2<\/a> – the process will be similar for other OpenWRT devices but it’s always worth reviewing the device page. I’ve also got some v5 versions, and this means a slightly different firmware, but the same exact process.<\/p>\n

For a major version upgrade it is worth reading the release notes First start by reading the release notes<\/a> – nothing seems to be specific to my device that requires any special considerations, so I can just proceed.<\/p>\n

An upgrade from OpenWrt 21.02 or 22.03 to OpenWrt 22.03.5 is supported in many cases with the help of the sysupgrade utility which will also attempt to preserve the configuration.<\/p><\/blockquote>\n

I personally prefer the cli based process, so we’ll be following that documentation<\/a>.<\/p>\n

Step 1.<\/strong> While I do nightly automated backups, I should also just do a web UI based backup<\/a> – this is mostly for peace of mind<\/p>\n

Step 2.<\/strong> Download the correct sysupgrade binary -the easy way to do this is by using the firmware selector tool<\/a>. I recommend that you take the time to verify the sha256sum<\/code> of your download, this is rarely an issue but I have experienced bad downloads and it’s hard to debug after the fact.<\/p>\n

It is recommend to check you have enough RAM free – thankfully the archer has a lot of RAM (which is used for the \/tmp filesystem too) so I have lots of space.<\/p>\n

Step 3.<\/strong> Get ready to flash – if you review the post install steps, you\u2019ll see that while the sysupgrade will preserve all of our configuration files – it won\u2019t preserve any of the packages.<\/p>\n

This script will print out all of the packages you’ve installed.<\/p>\n

cat << \"EOF\" > \/tmp\/listuserpackages.awk\r\n#!\/usr\/bin\/awk -f\r\nBEGIN {\r\n    ARGV[ARGC++] = \"\/usr\/lib\/opkg\/status\"\r\n    cmd=\"opkg info busybox | grep '^Installed-Time: '\"\r\n    cmd | getline FLASH_TIME\r\n    close(cmd)\r\n    FLASH_TIME=substr(FLASH_TIME,17)\r\n}\r\n\/^Package:\/{PKG= $2}\r\n\/^Installed-Time:\/{\r\n    INSTALLED_TIME= $2\r\n    # Find all packages installed after FLASH_TIME\r\n    if ( INSTALLED_TIME > FLASH_TIME ) {\r\n        cmd=\"opkg whatdepends \" PKG \" | wc -l\"\r\n        cmd | getline WHATDEPENDS\r\n        close(cmd)\r\n        # If nothing depends on the package, it is installed by user\r\n        if ( WHATDEPENDS == 3 ) print PKG\r\n    }\r\n}\r\nEOF\r\n \r\n# Run the script\r\nchmod +x \/tmp\/listuserpackages.awk\r\n\/tmp\/listuserpackages.awk<\/pre>\n
Save the list away so you can easily restore things post install. There is a flaw with this script as I’ll point out later, but in many cases it’ll work fine for you.<\/p>\n
On my dumb access points I get this list of packages<\/p>\n
prometheus-node-exporter-lua-netstat\r\nprometheus-node-exporter-lua-wifi\r\nprometheus-node-exporter-lua-openwrt\r\nprometheus-node-exporter-lua-wifi_stations\r\nrsync\r\nprometheus-node-exporter-lua-nat_traffic\r\nlibpcap1<\/pre>\n
Mostly I have the prometheus exporter (for metrics) and rsync<\/code> (for backups) installed. My main gateway has a few more packages (vnstat<\/code> and sqm<\/code>) but it’s similar.<\/p>\n
Step 4.<\/strong> Time to flash. Place the firmware you downloaded onto the openwrt router in \/tmp<\/code> and run sysupgrade<\/code>.<\/p>\n
# Flash firmware\r\nsysupgrade -v \/tmp\/openwrt-22.03.5-ath79-generic-tplink_archer-c7-v5-squashfs-sysupgrade.bin<\/pre>\n
This is a bit scary \u2014 because you lose your ssh connection as part of the upgrade.\u00a0 It took about a minute and a half of radio silence before the device came back.\u00a0 However, I was then greeted with the new web UI – and over ssh I get the 22.03.5 version splash.<\/p>\n
Step 5.<\/strong> Check for any package updates – usually I leave things well enough alone, but we just did a full upgrade so it’s worth making sure we are fully current. Note, this may mess with the script in step 3 since the install dates will change for other components.<\/p>\n
opkg update\r\nopkg list-upgradable<\/pre>\n
If you get any packages listed, we can easily upgrade using opkg upgrade <pkg name><\/code><\/p>\n
Step 6.<\/strong>\u00a0 Install packages captured in step 3. Do this by creating a simple script to opkg install <pkg name><\/code> for each package.<\/p>\n
opkg install prometheus-node-exporter-lua-netstat\r\nopkg install prometheus-node-exporter-lua-wifi\r\nopkg install prometheus-node-exporter-lua-openwrt\r\nopkg install prometheus-node-exporter-lua-wifi_stations\r\nopkg install rsync\r\nopkg install prometheus-node-exporter-lua-nat_traffic\r\nopkg install libpcap1<\/pre>\n
Post install, take a careful look at the output of the installs, and look for any *-opkg<\/code> files in \/etc\/config<\/code> or \/etc<\/code>. These are config files which conflicted with local changes.<\/p>\n
Sometimes you will want to keep your changes – others you’ll want to replace your local copy with the new -opkg<\/code> file version. Take your time working through this as it will avoid tricky problems to debug later.<\/p>\n
When I upgraded my main router, vnstat<\/code> seems to have been busted in some way. The data file was no longer readable (and it’s backup) – I suspect that some code change caused the format to be incompatible. I had to remove and recreated a new one<\/a>. Oh well.<\/p>\n
Things mostly went smoothly, it took about 30mins per openwrt device and I was going slowly and taking notes. There was one tiny glitch in the upgrade. The \/root\/.ssh<\/code> directory was wiped out – I use this to maintain a key based ssh\/scp<\/code> from each of my dumb AP to the main router.<\/p>\n
Bonus.<\/strong> I found a new utility: Attended Sysupgrade<\/a>. This is pretty slick as it makes it very easy to roll minor versions (so 22.03.02 -> 22.03.05 for example) but it will not do a major upgrade (21.03 -> 22.03). I’ve installed this on all of my openwrt devices and will use it to stay current. It takes care of all of the upgrade steps above.. but it does suffer the same ‘glitch’ in that \/root\/.ssh<\/code> is wiped out. The other downside is that the custom firmware that is built, breaks the script in step 3 – since the flash install date is the same for all of the components. I’ll need to go refactor that script for my next upgrade.<\/p>\n","protected":false},"excerpt":{"rendered":"
Here are my notes on upgrading OpenWRT, they are based on my previous post on upgrading. In this case I\u2019m upgrading specifically TP-Link Archer C7 v2 – the process will be similar for other OpenWRT devices but it’s always worth reviewing the device page. I’ve also got some v5 versions, and this means a slightly … Continue reading “OpenWRT 21.02 to 22.03 upgrade”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6,21],"tags":[],"class_list":["post-2135","post","type-post","status-publish","format-standard","hentry","category-computing","category-network"],"_links":{"self":[{"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/posts\/2135","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/comments?post=2135"}],"version-history":[{"count":2,"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/posts\/2135\/revisions"}],"predecessor-version":[{"id":2137,"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/posts\/2135\/revisions\/2137"}],"wp:attachment":[{"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/media?parent=2135"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/categories?post=2135"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lowtek.ca\/roo\/wp-json\/wp\/v2\/tags?post=2135"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}