Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
no edit summary
<p>The purpose of this tutorial is to provide a method for migrating Amahi HDA settings from one Amahi supported OS to another (i.e. via a new install, such as: * [[Amahi 10|Fedora 25]] to [[Amahi 11|Fedora 27]] * [[Amahi 9|Fedora 23]] to [[Amahi 11|Fedora 27]] * [[Amahi 8|Fedora 21]] to [[Amahi 12|Fedora 27]] * [[https://wiki.amahi.org/index.php/Fedora_14 Fedora 1419] or ] to [[Amahi 11|Fedora 27]] * [[https://wiki.amahi.org/index.php/Ubuntu |Ubuntu 12.04.xLTS]] to [https://wiki.amahi.org/index.php/Fedora_19 [Amahi 11|Fedora 1927]]). <br />
<br />
Currently there '''IS NOT''' an automated upgrade pathfor Ubuntu or a method for backing up current HDA settings for a reinstall. It is a manual process. ! However, we have provided a script to capture most of the settings you will need for the a new Amahi HDA. We hope this will make it a more manageable task than it has been in the past.</p>
== Disclaimer ==
<p>As with any other migration process, you will need to back up your HDA settings. In order to make the new system look and feel like your current one, there are certain components we need to capture.</p>
<p>To make this as painless as possible, a script is being provided. Once you run the script, it will record all the important information such as users, shares, apps installed, network, and Greyhole settings configuration (if installed) , and other settings in a text file. You can then copy that file to a safe location for use once the new system is ready to be configured.</p>
[https://wiki.amahi.org/index.php/Open_Terminal_as_root As root user], do the following:
* Navigate to the root directory:
cd /root
* Download script for appropriate Amahi version:::<u>Ubuntu 12.04.x</u>:''hda_migrationu1204_hda_migration.sh'' script (sha1sum 0b65de7520a420b68f137601cdb479784538f762) wget <nowiki>"https: 14281005c1263105862f5fe0bb1825963f330a53//drive.google.com/uc?export=download&id=0B64TOKt5XksaeU1DNzM5TUlSbFk" -O u1204_hda_migration.sh</nowiki>:<u>Fedora 19</u>:''f19_hda_migration.sh'' script (sha1sum 777a27a4aa0f5192420585da0303f0b0defedd8d): wget <nowiki>"https://dldrive.dropboxusercontentgoogle.com/uc?export=download&id=0B64TOKt5Xksac29mUGJLQld3SXc" -O f19_hda_migration.sh</nowiki>:<u>Fedora 21/138086723/hda_migration25</u>:''f21_hda_migration.sh'' script (sha1sum d70fa6e21ccea4a5b1815f848836a2382be05ad3): wget <nowiki>"https://drive.google.com/uc?export=download&id=0B64TOKt5XksaUDZRODFtM2ZHZDg" -O f21_hda_migration.sh</nowiki>
* Make it executable:
::<u>Ubuntu 12.04.x</u> chmod 755 hda_migrationu1204_hda_migration.sh:<u>Fedora 19</u> chmod 755 f19_hda_migration.sh:<u>Fedora 21/23/25</u> chmod 755 f21_hda_migration.sh
* Run the script:
::<u>Ubuntu 12.04.x</u> ./hda_migrationu1204_hda_migration.sh:<u>Fedora 19</u> ./f19_hda_migration.sh:<u>Fedora 21/23/25/27</u> ./f21_hda_migration.sh
If all goes well, you will see a message similar to the one below:
<pre>
Copy '''hda_production_migration.txt''' (hereon referred to as ''migration text'') to another machine and view the contents. Ensure all your settings were accurately captured before proceeding to the next section.
You can also print the file to make it easy to follow along as you go through the migrations steps. See [[HDA_OS_MigrationHDA_OS_Migration_Guide#Additional Tips|Additional Tips]] below for optional steps you may want to complete.
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #FFB6C1; margin: 3px 3px 1em 3px;">'''IMPORTANT:''' You will need to document any manual configuration changes or apps installed from sources other than the [https://www.amahi.org/apps Amahi App Store].</div>
If there are any errors, compare with the '''fstab''' section of the ''migration text''. '''DO NOT''' proceed to the next section until all drives are correctly mounted.
To add additional drives to your HDA for Greyhole, please follow use the [[Adding_a_second_hard_drive_to_your_HDA|adding a second hard drive]] guidance. The Amahi [https://www.amahi.org/apps/disk-wizard Disk Wizard] (in''development'') application will provide which provides a Dashboard UI for this process in the future. The [[Adding_a_second_hard_drive_to_your_HDA|adding a second hard drive]] from command-line documentation is also available.
== Install Applications ==
::*Change ''DNS Provider'' if needed. Refer to '''DNS PROVIDER''' under the '''NETWORK TAB''' section in the ''migration text''.
::*Update ''Gateway'' if needed. Refer to '''GATEWAY''' under the '''NETWORK TAB''' section in the ''migration text''.
::*Update ''Dynamic IP Range'' (Fedora 21/23<!--/25--> '''ONLY''') if needed. Refer to '''DYNAMIC IP RANGE''' under the '''NETWORK TAB''' section in the ''migration text''.
<u>Settings Tab</u>
Otherwise, you have two options for installing Greyhole:
<u>Manual</u><br />
Follow the [[Amahi_Create_Manual_Greyhole_Setup|Manual configuration]] and [[Reconnect existing Greyhole storage pool]] guidance. Refer to '''greyhole.conf''' section in the ''migration text'' as needed.<br />
<u>Greyhole UI ApplicationAutomated</u><br />Install the [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application. In the Amahi Dashboard, navigate to the '''Drive Pooling''' tab and choose:
* '''Partitions''' section and select the appropriate ''Locations'' for the ''Pool''. Refer to '''greyhole.conf''' section (''storage_pool_directory'' line) in the ''migration text'' to verify the correct partitions are chosen.
::<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">'''NOTE:''' If [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application was installed on your previous HDA, you should refer to '''SHARES TAB''' (''Disk Pool Copies'' column) section in the ''migration text'' to determine the appropriate setting.</div>
<u>Greyhole Advanced OptionsAdditional Settings</u><br />
[https://wiki.amahi.org/index.php/Greyhole#Greyhole_Advanced_Options Greyhole Advanced Options] are configured in ''greyhole.yml'' file (''/var/hda/platform/html/config''). Compare the contents with the '''greyhole.yml''' section in the ''migration text'' for any differences. Make changes as needed.
