Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
Created page with "{{Warning| <div style<nowiki>=</nowiki>"color:darkred">The Amahi team strongly recommends installing from scratch over the upgrade.<br /> <br /> We have tested the..."
{{Warning|
<div style<nowiki>=</nowiki>"color:darkred">The Amahi team strongly recommends [[Amahi_9|installing from scratch]] over the upgrade.<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.
<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>}}
:'''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.
== Upgrading Amahi 8 to Amahi 9 Beta ==
=== 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 <code>root</code> user or precede commands with <code>sudo</code>
* Works best if apps are uninstalled
* Back up your data as a precaution
* 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">
yum -y update
</div>
* Reboot to pick up new kernels, etc:
<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>
* Update everything in the system again:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
yum -y update
</div>
* If there are any updates, do it again. If there are new kernels, reboot:
<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>
=== Execution ===
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">
yum -y install fedup
</div>
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">
fedup -y --network 23
</div>
If during the upgrade you see a prompt similar to the one below, enter '''y''' to continue (there may be multiple prompts depending on Amahi apps installed):
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
<i><pre>warning: /var/lib/dnf/system-upgrade/libgudev-230-2.fc23.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 34ec9cba: NOKEY
Importing GPG key 0x34EC9CBA:
Userid : "Fedora (23) <fedora-23-primary@fedoraproject.org>"
Fingerprint: EF45 5106 80FB 0232 6B04 5AFB 3247 4CF8 34EC 9CBA
From : /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-23-x86_64
Is this ok [y/N]:</pre></i></div>
To avoid these prompts, you can 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 -y --network 23 --nogpgcheck
</div>
Once the previous fedup command is complete, you will be prompted to run:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
dnf system-upgrade reboot
</div>
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.
== Troubleshooting ==
Visit the [[troubleshooting]] page if you find yourself in trouble.
Go back to the [[Amahi 9]] page.
<div style<nowiki>=</nowiki>"color:darkred">The Amahi team strongly recommends [[Amahi_9|installing from scratch]] over the upgrade.<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.
<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>}}
:'''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.
== Upgrading Amahi 8 to Amahi 9 Beta ==
=== 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 <code>root</code> user or precede commands with <code>sudo</code>
* Works best if apps are uninstalled
* Back up your data as a precaution
* 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">
yum -y update
</div>
* Reboot to pick up new kernels, etc:
<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>
* Update everything in the system again:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
yum -y update
</div>
* If there are any updates, do it again. If there are new kernels, reboot:
<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>
=== Execution ===
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">
yum -y install fedup
</div>
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">
fedup -y --network 23
</div>
If during the upgrade you see a prompt similar to the one below, enter '''y''' to continue (there may be multiple prompts depending on Amahi apps installed):
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
<i><pre>warning: /var/lib/dnf/system-upgrade/libgudev-230-2.fc23.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 34ec9cba: NOKEY
Importing GPG key 0x34EC9CBA:
Userid : "Fedora (23) <fedora-23-primary@fedoraproject.org>"
Fingerprint: EF45 5106 80FB 0232 6B04 5AFB 3247 4CF8 34EC 9CBA
From : /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-23-x86_64
Is this ok [y/N]:</pre></i></div>
To avoid these prompts, you can 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 -y --network 23 --nogpgcheck
</div>
Once the previous fedup command is complete, you will be prompted to run:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
dnf system-upgrade reboot
</div>
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.
== Troubleshooting ==
Visit the [[troubleshooting]] page if you find yourself in trouble.
Go back to the [[Amahi 9]] page.
