Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
HDA OS Migration Guide (view source)
Revision as of 01:04, 13 December 2021
, 01:04, 13 December 2021→Backup Settings
<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. [https://wiki.amahi.org/index.php/Fedora_14 Fedora 14] or [https://wiki.amahi.org/index.php/Ubuntu Ubuntu 12.04.x] to [https://wiki.amahi.org/index.php/Fedora_19 Fedora 19]). Currently there '''IS NOT''' an automated upgrade path. It is via a manual process. Howevernew install, we have provided a script provided to capture most of the settings you will need for the new Amahi HDA. Hopefully this will make it a more manageable task than in the past.</p>such as:
* [[Amahi 9|Fedora 23]] to [[Amahi 11|Fedora 27]] * [[Amahi 8|Fedora 21]] to [[Amahi 12|Fedora 27]] * [[Fedora 19]] to [[Amahi 11|Fedora 27]] * [[Ubuntu|Ubuntu 12.04.x LTS]] to [[Amahi 11|Fedora 27]]<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #FFB6C1; margin: 3px 3px 1em 3px;"br />Currently there '''IMPORTANT:IS NOT''' an automated upgrade path for Ubuntu or a method for backing up current HDA settings for a reinstall. You It is a manual process! However, we have provided a script to capture most of the settings you will need to document any manual configuration changes or apps installed from sources other for a new Amahi HDA. We hope this will make it a more manageable task than it has been in the [https:past.<//wwwp> == Disclaimer ==<p>Please understand this is a guide to assist you in the migration.amahi There is no guarantee this guidance will work for everyone.org/apps Amahi App Store] While every effort has been taken to accurately document the migration steps, use at your own risk.</divp>
== Backup Settings ==
<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>
== Greyhole Cleanup ==
mount -a
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 use the Amahi [https://www.amahi.org/apps/disk-wizard Disk Wizard] application which provides a Dashboard UI for this process. The [[Adding_a_second_hard_drive_to_your_HDA|adding a second hard drive]] from command-line documentation is also available.
== Install Applications ==
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #FFB6C1; margin: 3px 3px 1em 3px;">'''WARNING:''' Some applications may not be ''LIVE'' for the new Amahi supported OS. Also the application version could be newer than you had installed on your previous systemHDA. As a result, the databases(s) and/or configuration files(s) may not be compatible.</div>
Refer to the '''INSTALLED APPS TAB''' section of the ''migration text'' to determine applications to install. Any [http://www.amahi.org/faq/if-i-pay-for-an-app-when-your-next-version-comes-out-do-i-have-to-pay-for-your-app-again previously purchased applications] from the [https://www.amahi.org/apps Amahi App Store] will be available for install.
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>).
:Create ''New users''. Refer to '''USERS TAB''' section in the ''migration text''.
: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''.
: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''.
: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
