Amahi 10 Upgrade

From Amahi Wiki
Jump to: navigation, search
Warning!
The Amahi team strongly recommends installing from scratch over the upgrade.


We have tested the fairly clean upgrade cases (with no/few modifications), on virtual machines. In general, there are too many variables involved to 100% ensure success. You must accept risk that your Amahi Server could break on upgrade.

We can only provide limited support in the forums and IRC, though in some cases only commercial support. We continue to recommend a new install over an upgrade as the best option.


NOTE:

Upgrading Amahi 9 to Amahi 10

Preparation

We recommend you turn on a temporary DHCP server, (e.g. in your router) since the network may go down for the duration of the actual upgrade.

Execute all commands as root user or precede commands with sudo

  • Upgrade will work best if apps are uninstalled
  • Back up your data as a precaution


Let's begin!

  • Update everything in the system:
dnf -y update
  • Reboot to pick up new kernels, etc:
shutdown -r now
  • Update everything in the system again:
dnf -y update
  • If there are any updates, do it again. If there are new kernels, reboot:
 shutdown -r now

Execution

Install the upgrade tool:

 dnf -y install fedup

Do the live update over the network:

 fedup -y --network 25 --nogpgcheck --allowerasing

Once the previous fedup command is complete, you will be prompted to run:

 dnf system-upgrade reboot

The actual upgrade will take place now, so you will not be able to access the server (or possibly the network) until it is complete.

It would be good to have a monitor/keyboard on the system to cover the risk that the upgrade process becomes stuck somehow. This also should let you keep up with progress.

Be aware it may take 15 to 30 minutes at a minimum for the upgrade to complete, depending on your hardware.

Finalize

Once the upgrade is complete, execute the following to disable the firewall:

systemctl stop firewalld
systemctl disable firewalld
systemctl stop rolekit
systemctl disable rolekit

You now should be able to access the dashboard at http://hda.

Troubleshooting

Visit the troubleshooting page if you find yourself in trouble.


Go back to Amahi Docs page.