Difference between revisions of "Amahi 11 Upgrade"

From Amahi Wiki
Jump to: navigation, search
 
(2 intermediate revisions by the same user not shown)
Line 7: Line 7:
  
 
:'''NOTE:'''
 
:'''NOTE:'''
:* There is no upgrade path from [[Fedora_14|Fedora 14]] or [[Ubuntu|Ubuntu 12.04 LTS]] to [[Amahi 10]].  This will require a new install.  The [[HDA OS Migration Guide]] might be helpful.     
+
:* There is no upgrade path from [[Fedora_14|Fedora 14]] or [[Ubuntu|Ubuntu 12.04 LTS]] to [[Amahi 11]].  This will require a new install.  The [[HDA OS Migration Guide]] might be helpful.     
 
:* For [[Fedora_19|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).
 
:* For [[Fedora_19|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).
  
Line 13: Line 13:
 
== Preparation ==
 
== 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.
 
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.
 
+
{{MessageBox|
 +
backgroundcolor = #faa|
 +
image =Warning.png|
 +
heading =WARNING|
 +
message = At a minimum [https://www.amahi.org/apps/disk-wizard Disk Wizard], [https://www.amahi.org/apps/disk-stats Disk Stats], [https://www.amahi.org/apps/greyhole-ui Greyhole UI],<br>[https://www.amahi.org/apps/web-apps Web Apps], and [https://www.amahi.org/apps/db-backups Database Backup] '''MUST''' be uninstalled!}}
 
Execute all commands as <code>root</code> user or precede commands with <code>sudo</code>
 
Execute all commands as <code>root</code> user or precede commands with <code>sudo</code>
* At a minimum [https://www.amahi.org/apps/disk-wizard Disk Wizard], [https://www.amahi.org/apps/disk-stats Disk Stats], [https://www.amahi.org/apps/greyhole-ui Greyhole UI], [https://www.amahi.org/apps/web-apps Web Apps], and [https://www.amahi.org/apps/db-backups Database Backup] '''MUST''' be uninstalled
 
 
* Upgrade will work best if '''ALL''' apps are uninstalled (highly recommended)
 
* Upgrade will work best if '''ALL''' apps are uninstalled (highly recommended)
 
* '''Back up your data as a precaution'''
 
* '''Back up your data as a precaution'''
 +
* '''NOT ALL''' apps in previous Amahi versions are available for Amahi 11.  Check the [https://www.amahi.org/apps App Store] before proceeding.
  
  

Latest revision as of 00:35, 18 April 2019

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:

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.

Warning.png WARNING
At a minimum Disk Wizard, Disk Stats, Greyhole UI,
Web Apps, and Database Backup MUST be uninstalled!


Execute all commands as root user or precede commands with sudo

  • Upgrade will work best if ALL apps are uninstalled (highly recommended)
  • Back up your data as a precaution
  • NOT ALL apps in previous Amahi versions are available for Amahi 11. Check the App Store before proceeding.


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.