Steps to Upgrade OMV 4.x (Arrakis) to 5.x (Usul)

I had an OMV system running 4.1.35-1 (Arrakis). Initially I tried using the steps from OMV’s ryecoaaron: https://forum.openmediavault.org/index.php?thread/27909-eta-for-omv-5-0-2020-2021-2022/&postID=219830#post219830
(This included having to use a Python fix for the weakref.py error: https://jc-lan.org/2020/04/26/openmediavault-weakref-python-error-when-updating)

However my progress came to a halt at this step:
omv-salt deploy run nginx

When I received this error
-bash: omv-salt: command not found

Below are the alternative steps I used to complete the upgrade. At a high level we first upgrade the Debian OS, then go back and upgrade/repair OMV package. It is based on this guide: https://blog.sakuragawa.moe/upgrade-omv-4-to-5-a-painful-path/

  1. sed -i 's/arrakis/usul/g' /etc/apt/sources.list.d/openmediavault.list
  2. sed -i 's/stretch/buster/g' /etc/apt/sources.list
  3. apt update
  4. On the next two steps, if prompted then choose: Don’t touch keymap, install all package maintainer’s configuration files (several of these) and restart services during package upgrades without asking
  5. apt -y --auto-remove --allow-downgrades --no-install-recommends upgrade
    apt -y --auto-remove --allow-downgrades --no-install-recommends dist-upgrade
  6. Now reboot
  7. apt -y purge openmediavault
  8. apt install -y --auto-remove --allow-downgrades openmediavault
  9. apt-get install usrmerge
  10. omv-confdbadm migrate conf 5.0.0
  11. omv-confdbadm populate
  12. sudo apt-get -y purge php7.0*
  13. omv-firstaid
  14. Choose option 9 – Clear web control panel cache
  15. Try to access OMV web interface
  16. Perform a final reboot to fix any broken services
  17. NOTE: if you had notifications enabled previously, log in to the web interface and disable them under the General Settings. Apply changes, then immediately revert back to Enabled and apply changes again.
  18. OPTIONAL: if you had a static IP and DNS server configured you will need to reconfigure your name server. In the web interface remove it, save then add it back. OR you can do the following:
    nano /etc/resolv.conf
    Add a line with the IP of your DNS: nameserver x.x.x.x
  19. OPTIONAL: reinstall OMV-extras (https://omv-extras.org)
This entry was posted in Uncategorized. Bookmark the permalink.