Difference between revisions of "Amahi 8 Upgrade"

From Amahi Wiki
Jump to: navigation, search
Line 2: Line 2:
 
<div style<nowiki>=</nowiki>"color:darkred">The Amahi staff '''strongly''' recommends the  [[Amahi_8_Install|Amahi 8 Install from Scratch]] over the Amahi 8 Upgrade.<br />
 
<div style<nowiki>=</nowiki>"color:darkred">The Amahi staff '''strongly''' recommends the  [[Amahi_8_Install|Amahi 8 Install from Scratch]] over the Amahi 8 Upgrade.<br />
 
<br />
 
<br />
There are too many variables involved to ensure success, therefore we can '''ONLY''' stress that you must accept risk that your Amahi Server could break if you perform the upgrade.  We can  provide limited support in such cases!<br />
+
There are too many variables involved to ensure success, therefore we can '''ONLY''' stress that you must accept risk that your Amahi Server could break if you perform the upgrade.  We can  only provide limited support on a case-by-case basis!<br />
 
<br />
 
<br />
 
There have been successful cases with the upgrade, but those were systems that used [[Express Disc]] install for [[Amahi 7]].  There were no manual system modifications or applications installed when performing the upgrade.<br />
 
There have been successful cases with the upgrade, but those were systems that used [[Express Disc]] install for [[Amahi 7]].  There were no manual system modifications or applications installed when performing the upgrade.<br />

Revision as of 02:18, 17 September 2015

Warning!
The Amahi staff strongly recommends the Amahi 8 Install from Scratch over the Amahi 8 Upgrade.


There are too many variables involved to ensure success, therefore we can ONLY stress that you must accept risk that your Amahi Server could break if you perform the upgrade. We can only provide limited support on a case-by-case basis!

There have been successful cases with the upgrade, but those were systems that used Express Disc install for Amahi 7. There were no manual system modifications or applications installed when performing the upgrade.

Cases that have failed appear to be related to installed applications or manual modifications, such as VNC or Gnome Desktop added to the system.

We are still gathering data, but will continue to recommend a new install over an upgrade of the existing Amahi 7 system.



NOTE: There is no upgrade path from Fedora 14 or Ubuntu 12.04 LTS to Amahi 8. This will require a new install. The HDA OS Migration Guide might be helpful.

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

  • Apps should be uninstalled to ensure success
  • Ensure you have your data backed up as a precaution
  • Update everything in the system:
yum -y update
  • Reboot to pick up new kernels, etc:
reboot
  • Update everything in the system again:
yum -y update
  • If there are any updates, do it again. If there are new kernels, reboot:
reboot
  • Follow with the upgrade below

Execution

Install the upgrade tool:

 sudo yum -y install fedup

Do the live update over the network:

 sudo fedup --network 21 --product=server
NOTE: If the upgrade does not let you due to issues with (for example) extra packages aded by Amahi-installed apps, you may want to add --nogpgcheck option, i.e.

sudo fedup --network 21 --product=server --nogpgcheck

You may see warnings similar to the following warning but you can ignore them for now. We will clean it up before the upgrade is complete.

WARNING: problems were encountered during transaction test:
broken dependencies
perl-PlRPC-0.2020-13.fc19.noarch requires perl-4:5.16.3-266.fc19.x86_64
ruby-mysql-2.8.2-9.fc19.x86_64 requires ruby-libs-2.0.0.353-16.fc19.x86_64
Continue with the upgrade at your own risk.


Once the previous fedup command is complete, reboot the server (the command will tell you):

 sudo reboot

The actual upgrade will take place now, so you will not be able to access the server (or 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.

Once the upgrade is complete, from the command line execute:

sudo yum check

The following message or similar will be displayed:

perl-PlRPC-0.2020-13.fc19.noarch has missing requires of perl(:MODULE_COMPAT_5.16.2)
ruby-mysql-2.8.2-9.fc19.x86_64 has missing requires of libruby.so.2.0()(64bit)
Error: check all


To correct these issues, remove the two bad packages (though this could be dangerous if you had a lot of apps installed (in which case we do not recommend it):

sudo yum remove perl-PlRPC-0.2020-13.fc19.noarch ruby-mysql.x86_64

Ensure all the problems are corrected and execute:

sudo yum check

The response should be check all which indicates everything is correct.

Now check the functionality of the Amahi dashboard after you get a DHCP lease from your HDA in your client(s). If the process completed successfully, you are now running Fedora 21 with the latest Amahi platform.


Ref: FedUp Wiki

Troubleshooting

Visit the troubleshooting page if you find yourself in trouble.


Go back to the Amahi 8 page.