Difference between revisions of "Amahi 8 Upgrade"
m (-y not supported on fedup command. Docs verified) |
|||
(25 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
+ | {{MessageBox| | ||
+ | backgroundcolor = #faa| | ||
+ | image =Warning.png| | ||
+ | heading =WARNING| | ||
+ | message = Amahi 8 for Fedora 21<br />Maintenance Support ONLY! | ||
+ | Please use a supported release!<br />}} | ||
{{Warning| | {{Warning| | ||
<div style<nowiki>=</nowiki>"color:darkred">The Amahi team strongly recommends [[Amahi_8_Install|installing from scratch]] over the upgrade.<br /> | <div style<nowiki>=</nowiki>"color:darkred">The Amahi team strongly recommends [[Amahi_8_Install|installing from scratch]] over the upgrade.<br /> | ||
Line 8: | Line 14: | ||
:'''NOTE:''' There is no upgrade path from [[Fedora_14|Fedora 14]] or [[Ubuntu|Ubuntu 12.04 LTS]] to [[Amahi_8|Amahi 8]]. This will require a new install. The [[HDA OS Migration Guide]] might be helpful. | :'''NOTE:''' There is no upgrade path from [[Fedora_14|Fedora 14]] or [[Ubuntu|Ubuntu 12.04 LTS]] to [[Amahi_8|Amahi 8]]. This will require a new install. The [[HDA OS Migration Guide]] might be helpful. | ||
+ | = Upgrading Amahi 7 to Amahi 8 = | ||
== 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. | ||
All commands are executes as <code>root</code> user or precede commands with <code>sudo</code> | All commands are executes as <code>root</code> user or precede commands with <code>sudo</code> | ||
− | * | + | * Works best if apps are uninstalled |
− | * | + | * '''NOT ALL''' apps available in Amahi 7 are fully operational for Amahi 8. Check the [https://www.amahi.org/apps App Store] before proceeding. |
− | * | + | * Back up your data as a precaution |
* 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"> | ||
Line 31: | Line 38: | ||
reboot | reboot | ||
</div> | </div> | ||
− | |||
== Execution == | == Execution == | ||
Install the upgrade tool: | Install the upgrade tool: | ||
<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"> | ||
− | + | yum -y install fedup | |
</div> | </div> | ||
Do the live update over the network: | Do the live update over the network: | ||
<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"> | ||
− | + | fedup --network 21 --product=server | |
</div> | </div> | ||
− | + | If the upgrade does not let you due to issues with (for example) extra packages added by Amahi-installed apps, you may want to add ''--nogpgcheck'' option, i.e. | |
− | + | <div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left"> | |
− | + | fedup --network 21 --product=server --nogpgcheck | |
− | </div | + | </div> |
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. | 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. | ||
<div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;"> | <div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;"> | ||
− | + | <i><pre>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.</pre></i></div><br /> | |
Once the previous fedup command is complete, reboot the server (the command will tell you): | Once the previous fedup command is complete, reboot the server (the command will tell you): | ||
<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"> | ||
− | + | shutdown -r now | |
</div> | </div> | ||
− | The actual upgrade will take place now, so you will not be able to access the server (or the network) until it is complete. | + | 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. | 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. | ||
Line 68: | Line 74: | ||
Once the upgrade is complete, from the command line execute: | Once the upgrade is complete, from the command line execute: | ||
<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"> | ||
− | + | yum check | |
</div> | </div> | ||
The following message or similar will be displayed: | The following message or similar will be displayed: | ||
<div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;"> | <div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;"> | ||
− | + | <i><pre>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</pre></i></div><br /> | |
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): | 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): | ||
<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"> | ||
− | + | yum remove perl-PlRPC-0.2020-13.fc19.noarch ruby-mysql.x86_64 | |
</div> | </div> | ||
Ensure all the problems are corrected and execute: | Ensure all the problems are corrected and execute: | ||
<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"> | ||
− | + | yum check | |
</div> | </div> | ||
The response should be <code>check all</code> which indicates everything is correct. | The response should be <code>check all</code> which indicates everything is correct. | ||
Line 91: | Line 97: | ||
Ref: [https://fedoraproject.org/wiki/FedUp FedUp Wiki] | Ref: [https://fedoraproject.org/wiki/FedUp FedUp Wiki] | ||
− | + | = Troubleshooting = | |
Visit the [[troubleshooting]] page if you find yourself in trouble. | Visit the [[troubleshooting]] page if you find yourself in trouble. | ||
− | + | = Reference = | |
− | + | Refer to the [[HDA Admin How To]] page for Amahi Server administrator guidance. |
Latest revision as of 04:41, 29 December 2016
WARNING | |
---|---|
Amahi 8 for Fedora 21 Maintenance Support ONLY! Please use a supported release! |
Warning! |
---|
The Amahi team strongly recommends installing from scratch over the upgrade.
|
- 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.
Upgrading Amahi 7 to Amahi 8
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
- NOT ALL apps available in Amahi 7 are fully operational for Amahi 8. Check the App Store before proceeding.
- Back up your data 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
Execution
Install the upgrade tool:
yum -y install fedup
Do the live update over the network:
fedup --network 21 --product=server
If the upgrade does not let you due to issues with (for example) extra packages added by Amahi-installed apps, you may want to add --nogpgcheck option, i.e.
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):
shutdown -r now
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.
Once the upgrade is complete, from the command line execute:
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):
yum remove perl-PlRPC-0.2020-13.fc19.noarch ruby-mysql.x86_64
Ensure all the problems are corrected and execute:
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.
Reference
Refer to the HDA Admin How To page for Amahi Server administrator guidance.