Amahi 9 Upgrade

	WARNING
	Amahi 9 for Fedora 23 Maintenance Support ONLY! Please use a supported release!

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:

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

Upgrading Amahi 8 to Amahi 9

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.

All commands are executes as root user or precede commands with sudo

• Works best if apps are uninstalled
• Back up your data as a precaution
• Update everything in the system:

yum -y update

• Reboot to pick up new kernels, etc:

shutdown -r now

• Update everything in the system again:

yum -y update

• If there are any updates, do it again. If there are new kernels, reboot:

 shutdown -r now

Execution

Install the upgrade tool:

 yum -y install fedup

Do the live update over the network:

 fedup -y --network 23 --nogpgcheck

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.