Amahi 11 Upgrade

Warning!

The Amahi team strongly recommends installing from scratch over the upgrade. If that is not possible, UNINSTALL AS MANY APPS AS POSSIBLE BEFORE THE UPGRADE (and reinstall after 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:

• There is no upgrade path from Fedora 14 or Ubuntu 12.04 LTS to Amahi 10. This will require a new install. The HDA OS Migration Guide might be helpful.
• For Amahi 7 users, an Amahi 8 Upgrade, Amahi 9 Upgrade and Amahi 10 Upgrade will be needed before the Amahi 11 upgrade can be accomplished (be advised this is untested).

Upgrading Amahi 10 to Amahi 11

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

• At a minimum Disk Wizard, Disk Stats, Greyhole UI, Web Apps, and Database Backup MUST be uninstalled
• Upgrade will work best if ALL apps are uninstalled (highly recommended)
• 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 27 --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. It may take *much longer* on a slower network or 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.