12
edits
Changes
From Amahi Wiki
Greyhole UI App Transition Guide (view source)
Revision as of 00:54, 10 January 2017
, 00:54, 10 January 2017→Adding drives
This guide will provide a step by step transition from the manual Greyhole installation to using the [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application for Amahi 7or greater. Going forward, this is the preferred method of installing Greyhole.
== Disclaimer ==
While following this guide should not result in any data loss, we cannot guarantee that it won't cause any problems with your HDA. <span style="color:red">'''Please proceed with caution as you follow this guide.!'''</span>
The [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application does not support previous manual Greyhole installations, meaning all your current Greyhole settings will be overwritten. You will have to reconfigure it using the dashboard.
== Backup Current Settings ==
We need to back up or note our current settings prior to installing the application. There are many ways to do this. Lets keep it simple and copy the ''/etc/greyhole.conf file to a share.
Please ensure these are removed before proceeding with the next section. They will be automatically added by the application to each share. but not reflected in the ''Extra Parameters'' field.
:'''NOTE:''' If you are using the [[Mount_Shares_Locally|Mount Shares Locally]] service, as a precaution recommend you stop it as well.
service mount_shares_locally stop
== Adding drives ==
If you need to add additional drives to your HDA for Greyhole, please follow the [[Adding_a_second_hard_drive_to_your_HDA|adding a second hard drive]] guidance for Amahi 7. The Amahi [https://www.amahi.org/apps/disk-wizard Disk Wizard] application provides a Dashboard UI for this process in Amahi 8 or greater '''ONLY'''.
If you have completed the addition of the drive via disk wizard you then need to add the drive to the storage pool.
Once that has been completed run fsck.
To balance the data among old and new drives you should first run the following command to clean up trash
greyhole -a
Then run this command to balance the drives data.
greyhole -l
== Install Application ==
== Configure Greyhole ==
'''NOTE:''' Ensure you have enabled [[Advanced_Settings|Advanced Settings]] before proceeding.
Now that you have the application installed, select the Drive Pooling tab.
* <u>Storage Pool</u>
:The first thing you will want to do is select the appropriate drives for the storage pool.
:[[File:Partitions.PNG|400px350px]]
:If you are unsure which drives were used, you can open the ''greyhole.conf'' file we saved in our Docs share in any editor and consult your previous configuration.
:[[File:Greyhole_ui_fsck.png|300px]]
== Verification Verify Results ==
You can monitor activity as always in the Greyhole log.
tail -f /var/log/greyhole.log
the [[Greyhole_troubleshooting|Greyhole Troubleshooting]] area for assistance.
:'''NOTE:''' If you stopped [[Mount_Shares_Locally}|Mount Shares Locally]] script earlier, you can now safely start it.
service mount_shares_locally start
== Additional Settings ==
There are limited settings configured using the [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application. If you have additional settings you configured manually in the past, see [[Greyhole#Greyhole_Advanced_Options|Greyhole Advanced Options]] for guidance on adding those to Greyhole.
== Tips and Best Practices ==
Refer to [[Greyhole_Tips|Greyhole Tips]] for additional guidance.
== Troubleshooting ==
If you have any problems, please submit a [https://bugs.amahi.org bug report] or stop by the Amahi IRC channel [http://webchat.freenode.net/?channels=amahi #amahi] for real-time assistance.
