<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]] * [[Fedora 19]] to [[https://wiki.amahi.org/index.php/Fedora_14 Amahi 11|Fedora 1427]] or * [[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>"http: 14281005c1263105862f5fe0bb1825963f330a53//dl.amahi.org/u1204_hda_migration.sh.txt" -O u1204_hda_migration.sh</nowiki>:<u>Fedora 19</u>:''f19_hda_migration.sh'' script (sha1sum 777a27a4aa0f5192420585da0303f0b0defedd8d): wget <nowiki>https"http://dl.dropboxusercontentamahi.org/f19_hda_migration.sh.txt" -O f19_hda_migration.comsh</nowiki>:<u>Fedora 21/23/25</u>:''f21_hda_migration.sh'' script (sha1sum 5de37d8a18b9ea51a31c7964da9b7e41b74d34e7): wget <nowiki>"http:/1380867/hda_migrationdl.amahi.org/f21_hda_migration.sh.txt" -O f21_hda_migration.sh</nowiki>
* Make it executable:
::<u>Ubuntu 12.04.x</u> chmod 755 u1204_hda_migration.sh:<u>Fedora 19</u> chmod 755 f19_hda_migration.sh:<u>Fedora 21/23/25</u> chmod 755 hda_migrationf21_hda_migration.sh
* Run the script:
::<u>Ubuntu 12.04.x</u> ./u1204_hda_migration.sh:<u>Fedora 19</u> ./hda_migrationf19_hda_migration.sh:<u>Fedora 21/23/25</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 ==
We are now ready to being updating the new HDA with our previous HDA settings. Start by selecting ''Setup'' from the Amahi Dashboard main page (<nowiki>http://hda</nowiki>).
* <u>'''Users Tab'''</u>
:Create ''New users''. Refer to '''USERS TAB''' section in the ''migration text''.
* <u>'''Shares Tab'''</u>
:Choose the appropriate section and complete as noted.
:*''Details'' section: Create ''Shares''. Refer to '''SHARES TAB''' section in the ''migration text''.
:*''Settings'' section. Update ''Work Group Name'' if needed. Refer to '''SETTINGS''' under the '''SHARES TAB''' section in the ''migration text''.
* <u>'''Network Tab'''</u>
:Choose the appropriate section and complete as noted.
:*''Fixed IPs'' section: Create ''Fixed IPs''. Refer to '''FIXED IP''' under the '''NETWORK TAB''' section in the ''migration text''.
::*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>
:Enable ''Advanced Settings'' and/or ''Guest Dashboard''. Refer to '''SETTINGS TAB''' section in the ''migration text''.
If you do not want to use [https://wiki.amahi.org/index.php/Greyhole Greyhole], you can '''SKIP''' this section.
Otherwise install , 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 /> or <u>Automated</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>Additional 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.
<u>Verify Operational</u><br />
Before proceeding to the next section, verify Greyhole is working properly. This can be done by monitoring the log:
tail -f /var/log/grehole.log