Difference between revisions of "Amahi 10 Upgrade"

From Amahi Wiki
Jump to: navigation, search
(grammar & minor edits)
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{MessageBox|
 
backgroundcolor = #ffaaaa|
 
image =Warning.png|
 
heading =WARNING|
 
message = This is only for developers.  Not ready for Production! 
 
See [http://docs.amahi.org Amahi Docs] for the officially supported version, Amahi 9 on Fedora 23.}}
 
 
{{Warning|
 
{{Warning|
 
<div style<nowiki>=</nowiki>"color:darkred">The Amahi team strongly recommends [[Amahi_10_Install|installing from scratch]] over the upgrade.<br />
 
<div style<nowiki>=</nowiki>"color:darkred">The Amahi team strongly recommends [[Amahi_10_Install|installing from scratch]] over the upgrade.<br />
 
<br />
 
<br />
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 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.
 
<br />
 
<br />
 
  We can only provide limited support in the [https://forums.amahi.org forums] and [http://talk.amahi.org IRC], though in some cases only [[commercial support]]. We continue to recommend a new install over an upgrade as the best option.</div>}}
 
  We can only provide limited support in the [https://forums.amahi.org forums] and [http://talk.amahi.org IRC], though in some cases only [[commercial support]]. We continue to recommend a new install over an upgrade as the best option.</div>}}
  
 
:'''NOTE:'''   
 
:'''NOTE:'''   
:* There is no upgrade path from [[Fedora_14|Fedora 14]] or [[Ubuntu|Ubuntu 12.04 LTS]] to [[Amahi 9]].  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 10]].  This will require a new install.  The [[HDA OS Migration Guide]] might be helpful.   
 
:* For [[Fedora_19|Amahi 7]] users, an [[Amahi 8 Upgrade]] and [[Amahi 9 Upgrade]] will be needed before the [[Amahi 10]] upgrade can be accomplished (be advised this is untested).
 
:* For [[Fedora_19|Amahi 7]] users, an [[Amahi 8 Upgrade]] and [[Amahi 9 Upgrade]] will be needed before the [[Amahi 10]] upgrade can be accomplished (be advised this is untested).
  
Line 20: Line 14:
 
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.
  
All commands are executes 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>
* Works best if apps are uninstalled
+
* Upgrade will work best if apps are uninstalled
* Back up your data as a precaution
+
* '''Back up your data as a precaution'''
 +
 
 +
 
 +
Let's begin!
 +
 
 
* Update everything in the system:
 
* Update everything in the system:
 
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
 
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">

Revision as of 21:24, 19 May 2017

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.