<div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;">'''NEW:''' [https://github.com/gboudreau/= What is Greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide] '''NEW:''' [[Greyhole troubleshooting]] guide</div>==

== What [http://www.greyhole.net/ Greyhole] is Amahi's [[Storage pooling]] technology of choice. Storage Pooling combines the space of multiple disk drives and makes them look as if they were all part of a single pool of disk space. Greyhole was designed independently of Amahi, however, with feedback and great work, the Greyhole ==team made it suitable for integration with Amahi.

This feature is installed by default, but requires a few simple steps to begin utilizing the features. You can add additional drives to your hda HDA and prepare them for use in Greyhole by following [[Adding Adding_a_second_hard_drive_to_your_HDA|adding a second hard drive to your HDA|this tutorial]]guidance or use the Amahi [https://www. To add a drive to your Greyhole storage pool. Open your HDA dashboard and navigate to the Shares tabamahi. Then click on the Storage Pool suborg/apps/disk-category. You will see a page similar to the one belowwizard Disk Wizard] (Amahi 8 or greater).

== WARNING =={{Warning|<div style<nowiki>=</nowiki>"color:darkred">You should <u>'''NEVER'''</u> change or delete files in the shared directories (''/var/hda/files/*'' by default) directly on the HDA, using the terminal, or the Gnome file browser, for the shares for which you checked the ''Uses pool'' option in the Amahi dashboard. If you want to work with files on Greyhole shares on the HDA, you should [[Mount Shares Locally]].<br/>

Also, touching anything inside the '''gh''' directories that Greyhole creates at the root of your partitions is a recipe for disaster. [[Greyhole not on root | We strongly discourage you from using the root partition in a drive pool]].</div><br/>}}

== First things first Amahi 7 or greater ==Amahi application [https://www.amahi.org/apps/greyhole-ui Greyhole UI] provides this capability. Refer to the [[Greyhole_UI_App_Transition_Guide|Greyhole UI Application Transition guide]] for details on installation and configuration.

== Amahi 7 ==Options available for install and configuration'''NOTE:''' If you would still like to setup your Greyhole pool manually, please see [[Amahi_Create_Manual_Greyhole_Setup|Manual Greyhole Setup]].

* You need to go in the Settings tab, and select [https://www[Advanced_Settings|Enable Advanced Settings]].amahi Without Advanced Settings enabled, you won't see the following page and options.org/apps/greyhole-ui Greyhole UI] plugin (automated with dashboard integration)

The automated option is designed for new Amahi 7 installations and the preferred method of install. It does not support previous manual Greyhole installations. Recommend you back up or note your settings from ''/etc/greyhole.conf'' and uninstall amahi-greyhole prior to installing the plugin. [[Open_Terminal|As root user]], execute: yum -e amahi-greyholeYou can then follow guidance in [[Greyhole#Greyhole_Advanced_Options|Greyhole Advanced Options]] to add any settings not included in the automated configuration. === Storage Pool === <!--[[File:Storage_Pool_1.png|600px]]-->Picture coming soon...

=== Greyhole <b><u>Share Options ===</u></b><br />

<!--[[File:Greyhole_Options_1.png|600px]]-->Picture coming soon...

== Amahi 6 Advanced Options == You need to go in the Settings tab, and enable [[Advanced_Settings|Enable Advanced Settings]]. Without Advanced Settings enabled, you won't see the following page and options.

=== Storage Pool ===[[File:Storage_Pool_1You can further configure Greyhole by manually editing '''/var/hda/platform/html/config/greyhole.png|600px]]yml'''.

Select the drives you want available for your storage pool:'''NOTE:''' Options duplicated in ''/etc/greyhole.conf will be overridden by grehole.yml.

=== To see what options are available, and what they do, refer to the [https://github.com/gboudreau/Greyhole Options ===/blob/master/greyhole.example.conf sample greyhole.conf] provided with Greyhole.

The next step greyhole.yml is in in [http://en.wikipedia.org/wiki/YAML YAML] format. Most of it should be easy enough to select the share you want to replicate across modify. The only exception would be the poolsticky_files (and optional sticky_into) options.<br/>

For your changes to be effectiveOnce finished, it's important that you'll need check to force Amahi to regenerate see the greyhole.conf fileis properly formatted. You can To do so by editing a share, clicking it's path, and just clicking the Save button without actually changing do the path.following: cd /var/hda/platform/html/config== Copying data to shares for the first time == echo 'require "yaml"; YAML::load(File.open("greyhole.yml"))' | irb

When If you start using Greyholedo not see any errors, then your ready for the next step. Otherwise, ensure you might want to copy or move all your existing files into your new shares that use correct the storage poolerrors before proceeding.

Note: This is not necessary if your files are already in Amahi shares. If they are thereFor the changes to be effective, and you enable the ''Uses pool'' option in the will need to force Amahi dashboard, the files will start getting moved around into the drives in your storage pool during the night (starting at midnight), when the nightly storage pool check starts.<br/>The instructions below are for users who have more data to copy into the Greyhole shares than their currently free space in the /var/hda/files/ folder.:

One way to do that is to mount the shares that use the Greyhole storage pool, either on the HDA itself, or on a client computer on your local network, and copy your data from their existing location into the mounted shares.This can be time consuming, but it is the safest way to use Greyhole. Another way to move your files from their current location into the storage pool is to share their current location using an Amahi share that ''Uses pool'', then let Greyhole's nightly check move the files from there into the pool. Here's a more detailed walkthrough for this method: # Setup the Greyhole Storage Pool in the Amahi dashboard, Shares <u> Storage Pool page.# Go in the Shares Ubuntu</u> Shares page. In there, make sure you have an existing share for each share you have data for. Create new ones if you need, remove the ones you don't need.# Edit the ''path'' of each of those shares, and enter the current location of your existing data. For example, the Movies share could have a path = ''<br /media/External Drive/Movies''># Enable the ''Uses pool'' option for each of your shares, and select :Regenerate the number of extra copies you'd like, if any.# Now, you either need to wait for Greyhole's nightly check to start, or you can start it manually from a terminal, as root, using this command: greyhole --fsck# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares > Storage Pool). All that should be left in the previous location of your data (''/media/External Drive/Movies'' from the previous example) should be symbolic links pointing to the new conf file copies. If the previous location is just empty directories (no symlinks)by editing a share, do not panic. This is normal if your previous location is an NTFS or FAT partition (drive).# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name# Back in the Amahi dashboard, edit the path of the shares once again, and put back ''/var/hda/files/share_name'' (i.e. the folders where you moved the symbolic links).# If you used an NTFS or FAT partition for the previous location, you'll need another fsck to create the symlinks where they should be. Either wait for midnight, or launch clicking it manually, from a command line, as root: ''greyhole --fsck''  You're done. All your existing data is now stored in the various drives included in your storage pools path, and are accessible via just clicking the Samba shares you have defined in Save button without actually changing the Amahi dashboardpath. == Adding a new drive to your HDA and storage pool ==See [[Adding_a_second_hard_drive_to_your_HDA|Adding a new drive to your HDA]] and to your Greyhole storage pool. == Drive Mounted as /media ==Including any drive mounted as /media/Something in your storage pool is usually a bad idea.<br/> Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.<br/> This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing. Follow this guide to [[Adding a second hard drive to your HDA|permanently mount your drives]] before you include them in your storage pool. == Forcing a fsck ==Greyhole comes with a crontab file that schedules daily and weekly fsck runs. The daily cron (usually runs at 4am) will only run if the configuration changed in the last 24 hours. The weekly fsck (usually runs at 4am on Sundays) will always run, whether the configuration changed or not.<br />To force a fsck at any other time, simply execute

:As Restart the Dashboard with any one of these alternatives as [[Open_terminal|root user]]: greyhole --fsck:* touch /var/hda/platform/html/tmp/restart.txt:* systemctl restart httpd.service:* reboot

:<u>Ubuntu</u> sudo greyhole --fsck == Monitoring Greyhole ==Sometimes you might want to monitor what Greyhole is doing, for example when writing data to your Then regenerate the greyhole shares for the first time. Here are a few commands you can type set up by changing any setting in a terminal to follow along. '''Scrolling view of total Greyhole operations queue:''' while [ 1 == 1 ]; do greyhole --view-queue | grep Total; sleep 60; done '''Alternate way to watch Greyhole operations queue:''' watch -d greyhole --view-queue '''Scrolling log of what files Greyhole is working on right now:''' tail -f /var/log/greyhole.log  '''NOTE:''' The Amahi application [http://www.amahi.org/apps/greyhole-logmon Greyhole LogMon] to view the Greyhole log Shares or in your web browserDrive pooling.

== Disable Greyhole Tips and Best Practices ==For those who do not use Greyhole, you can disable it. This is based on the fact you never have used it by enabling 'Uses pool' on any share. Recommend using extreme caution as this could have unpredictable results. <u>Amahi 6 (Ubuntu 12.04.x)</u><br />Perform the following steps as user '''root''' (Ubuntu):  update-rc.d -f greyhole remove rm /etc/monit.d/greyhole.conf service monit restart service greyhole stop '''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software. Doing so will break your HDA.

<u>Amahi 7 (Fedoara 19)</u> systemctl stop amahi-greyholeRefer to [[Greyhole_Tips|Greyhole Tips]] for additional guidance.service systemctl disable amahi-greyhole.service yum -e amahi-greyhole

== Testing and Reliability ==

= Reconnect the Greyhole storage pool = If you upgrade and/or reinstall Amahi and need to get your drives with data on them to the new system, follow this [[Reconnect_existing_Greyhole_storage pool|Reconnect existing Greyhole storage pool]] guide. References = Greyhole Troubleshooting = See * Good [[Greyhole troubleshooting]]http://revxatlarge.blogspot. = Landing Zone Considerations = The landing zone or LZ is the area where com/2011/04/restoring-deleted-files arrive first before being distributed to their final destination-in-greyhole-and. See details in the [[html article] on Greyhole landing zone]] pagewith terms explained.

= Manually updating Greyhole for Amahi =See [[Greyhole updating]] for details. = Emptying Greyhole Trash =:<u>Fedora</u><br />:As root user: greyhole --empty-trash :<u>Ubuntu</u> sudo greyhole --empty-trash About the trash: The trash is used like a Recycle Bin.That means you'll need to manually empty it once in a while.To do so, use the --empty-trash parameter (see above).Another option is to create a 'Greyhole Trash' Samba share.More details about that * [https://github.com/gboudreau/Greyhole/wiki/AboutTrash here]. = Moving drives/data out of Greyhole =You may need to remove a drive from Greyhole and transfer the share files to another drive. See [[Greyhole moving data out of the pool]Wiki]. = Changing Greyhole drive mount points =Refer to [[Changing Greyhole Mount Points]]. = Reference =* Good [http://revxatlarge.blogspot.com/2011/04/restoring-deleted-files-in-greyhole- Provides additional guidance and.html article] on Greyhole with terms explainedinformation.

* [https://github.com/gboudreau/Greyhole/wiki Greyhole Wiki/MigrateFromWHS Windows Home Server (WHS) Drive Extender Migration Guide]: Provides guidance for various tasksMove from WHS to Amahi and Greyhole.