Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→References
[[Category:apps]]
Specifically, Greyhole:
* Combines the space from multiple drives into a single volume
* Distributes files across all drives in the pool
* Creates multiple copies of files in admin-specified shares
<br />
Recommend you consult [https://github.com/gboudreau/Greyhole/wiki/WhatNotToPutInGreyholeShares what not to put in Greyhole shares] as a precaution when determining which shares to select.
{{Warning|<div style<nowiki>=</nowiki>"color:darkred">You can add additional drives to your should <u>'''NEVER'''</u> change or delete files in the shared directories (''/var/hda and prepare them /files/*'' by default) directly on the HDA, using the terminal, or the Gnome file browser, for use the shares for which you checked the ''Uses pool'' option in the Amahi dashboard. If you want to work with files on Greyhole by following shares on the HDA, you should [[Adding a second hard drive to your HDA|this tutorialMount Shares Locally]].<br/><br/>You should be safe reading existing files directly, or adding new files directly, as long as don't care that your new files will only be moved into the storage pool during the next check, which runs automatically at midnight (or manually using ''greyhole --fsck''). Until then, your new files will be stored in your shared directories (normally ''/var/hda/files/share_name/'').
== First things first Amahi 6 ==
You need to go in the Settings tab, and enable '''select [[Advanced_Settings|Enable Advanced Settings''']].<br/> Without Advanced Settings enabled, you won't see the following page and options.
[[File:Storage_Pool_1.png|600px|thumb|left]]
Select the drives you want available for your storage pool.
The next step is to select the share you want to replicate across the pool.
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.
[[File:Greyhole_Options_1.png|600px|thumb|left]]
Check the option for "Uses pool" and choose the number of drives to replicate this share. In this instance we have chosen to use all drives available to the greyhole pool.
Here's an example of how those should appear:
To specify the following to Greyhole in greyhole.conf:
sticky_files <nowiki>=</nowiki> Videos/Movies/
stick_into <nowiki>=</nowiki> /mnt/hdd1/gh
stick_into <nowiki>=</nowiki> /mnt/hdd5/gh
sticky_files <nowiki>=</nowiki> Backups/CrashPlan/
stick_into <nowiki>=</nowiki> /mnt/hdd0/gh}}</pre>
one should specify this in the greyhole.yml file, where '''precise indentation matters''':
- - Music/
- - Videos/Movies/
- /mnt/hdd5/gh
- - Backups/CrashPlan/
- - /mnt/hdd0/gh}} For your changes to be effective, you'll need to force Amahi to regenerate the greyhole.conf file. You can do so by editing a share, clicking it's path, and just clicking the Save button without actually changing the path. == Copying your data into Greyhole shares the first time == When you start using Greyhole, you might want to copy or move all your existing files into your new shares that use the storage pool. Note: This is not necessary if your files are already in Amahi shares. If they are there, and you enable the ''Uses pool'' option in the 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/pre>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 > Storage Pool page.# Go in the Shares > 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 = ''/media/External Drive/Movies''# Enable the ''Uses pool'' option for each of your shares, and select 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 file copies. If the previous location is just empty directories (no symlinks), 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 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 pool, and are accessible via the Samba shares you have defined in the Amahi dashboard.
If you do not see any errors, then your ready for the next step. Otherwise, ensure you correct the errors before proceeding.
Greyhole is already using MySQL in Amahi 6.0
''To Convert to MySQL, run as root:''
To see what DB engine is Greyhole using, do this:
== 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.
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.
= Reconnect the Greyhole storage pool after re-install of Fedora / Amahi = References == <!--After re-install, recreate all your shares exacty as they were.<br>Add the shares to the storage pool.<br>As root, run greyhole --fsck.<br>This will recreate the symlinks in the landing zone * Good [http:/var/hda/filesrevxatlarge.<br>-->* Disconnect all data drives before you reinstallblogspot. This will prevent you from destroying them by mistake during the Fedoracom/Amahi install!* Install Amahi per the regular instructions.* Connect the data drives, and use hda-diskmount to remount all of them.Note that if you can, it would be faster if you can re-mount the drives in the same paths they used to have. '''Example:''' If you have one 1TB and one 2TB, and the 1TB was mounted as /var2011/hda04/files/drives/drive1, and the 2TB was mounted as /var/hda/files/drives/drive2, it would be better to rerestoring-mount that like that on your new HDA. If you mount them otherwise, it will still work, but Greyhole will work a while to redeleted-build the links in your share before they can be usable.* Select the drives in the Amahi Dashboard: Setup > Shares > Storage Pool* Refiles-create your shares in the Amahi Dashboard: Setup > Shares.Make sure to select 'Use Pool', and select the correct number of extra copies.If you don't remember all the shares you had, just check inside the 'gh' folder found at the root of your drives to get a reminder! '''Example:'''{{Code|ls -1 /var/hda/files/drives/*/gh/ <nowiki>|</nowiki> grep -v : <nowiki>|</nowiki> sort -u}} * Launch a fsck to have Greyhole rebuild your shares.{{Code|greyhole --fsck}} Until this completes, some of your files will be missing from your sharesand. = Greyhole Troubleshooting = Page: [[Greyhole troubleshootinghtml article]] = Landing Zone Considerations = The landing zone or LZ is the area where files arrive first before being distributed to their final destination. See details in the [[on Greyhole landing zone]] pagewith terms explained. = Manually updating Greyhole for Amahi =Page: [[Greyhole updating]]
