<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.amahi.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Gboudreau</id>
	<title>Amahi Wiki - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.amahi.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Gboudreau"/>
	<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php/Special:Contributions/Gboudreau"/>
	<updated>2026-05-13T18:35:43Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.34.2</generator>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Amahi_Create_Manual_Greyhole_Setup&amp;diff=84350</id>
		<title>Amahi Create Manual Greyhole Setup</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Amahi_Create_Manual_Greyhole_Setup&amp;diff=84350"/>
		<updated>2014-05-15T13:44:24Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{AdvancedUsers}}&lt;br /&gt;
The following guidance is provided to assist users with setting up [[Greyhole]] in Amahi 7.  This has been tested with no issues.  Please note this is &amp;lt;u&amp;gt;ONLY&amp;lt;/u&amp;gt; a work around until Greyhole is integrated into the Amahi 7 dashboard.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;NOTE:&amp;lt;/b&amp;gt;  There is no guarantee this will work for you or not cause problems with your Amahi 7 install.  Please proceed with caution as carelessness could cause data loss.  Also you might want to check out the [[Greyhole]] wiki page for additional information, such as working with shares locally on the HDA.&lt;br /&gt;
&lt;br /&gt;
As [[Open_Terminal_as_root|root user]], perform the following steps:&lt;br /&gt;
* Install the package:&lt;br /&gt;
&amp;lt;pre&amp;gt;yum -y install amahi-greyhole&amp;lt;/pre&amp;gt;&lt;br /&gt;
* Set up a mysql database and user to access it:&lt;br /&gt;
&amp;lt;pre&amp;gt;hda-create-db-and-user greyhole&amp;lt;/pre&amp;gt;&lt;br /&gt;
* Load the database schema:&lt;br /&gt;
&amp;lt;pre&amp;gt;mysql -u greyhole -pgreyhole  greyhole &amp;lt; /usr/share/greyhole/schema-mysql.sql&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Initialize the basic settings for Greyhole, configure /etc/greyhole.conf:&lt;br /&gt;
* Make sure the settings for the database are correct: &amp;lt;u&amp;gt;db_user&amp;lt;/u&amp;gt; and &amp;lt;u&amp;gt;db_password&amp;lt;/u&amp;gt; should be &amp;lt;i&amp;gt;greyhole&amp;lt;/i&amp;gt;&lt;br /&gt;
* Add a line for each drive in the storage pool at the end of the file.  The example below is for two drives:&lt;br /&gt;
&amp;lt;pre&amp;gt;storage_pool_drive = /var/hda/files/drives/drive2/gh, min_free: 10gb&lt;br /&gt;
storage_pool_drive = /var/hda/files/drives/drive3/gh, min_free: 10gb&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
:'''NOTE''':  If you have not initialized your newly added hard drives, refer to [[Adding_a_second_hard_drive_to_your_HDA|adding new hard drives]].&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&amp;lt;b&amp;gt;NOTE:&amp;lt;/b&amp;gt;  Although the /etc/greyhole.conf contents indicate &amp;lt;b&amp;gt;storage_pool_drive&amp;lt;/b&amp;gt;, it should be &amp;lt;b&amp;gt;storage_pool_directory&amp;lt;/b&amp;gt;.  If you don't set it correctly, Greyhole will not work.&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
* Now configure the number of copies per share.  The example below sets the shares as follows:&lt;br /&gt;
** Books: max copies (which is 2 for 2 drives)&lt;br /&gt;
** Pictures: 2 copies (i.e. 1 extra copy)&lt;br /&gt;
** Movies: no extra copies (data loss will occur if one of your drive fails)&lt;br /&gt;
&amp;lt;pre&amp;gt;num_copies[Books] = max&lt;br /&gt;
num_copies[Pictures] = 2&lt;br /&gt;
num_copies[Movies] = 1&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* In the Dashboard, Shares tab add the following to [[Share_Extra_Parameters|Extra Parameters]] for each share you will be configuring to use Greyhole:&lt;br /&gt;
&amp;lt;pre&amp;gt;dfree command = /usr/bin/greyhole-dfree&lt;br /&gt;
vfs objects = greyhole&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Finally, enable greyhole permanently and start the service:&lt;br /&gt;
&amp;lt;pre&amp;gt;systemctl enable amahi-greyhole.service&lt;br /&gt;
systemctl start amahi-greyhole.service&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* You can monitor activity by watching /var/log/greyhole.log file:&lt;br /&gt;
&amp;lt;pre&amp;gt;tail -f /var/log/greyhole.log&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* If you intend to modify or work with your files locally on the HDA, refer to [[Mount_Shares_Locally|Mount Shares Locally]] for guidance.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Return to [[Amahi_7_installation|Amahi 7 Installation]] page.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_grinder&amp;diff=84344</id>
		<title>Greyhole grinder</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_grinder&amp;diff=84344"/>
		<updated>2014-05-15T13:41:44Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;This page is for ideas to develop a more comprehensive test suite for Greyhole  so that we take it to a whole new level.&lt;br /&gt;
&lt;br /&gt;
The idea is to knock down hard to find bugs and keep them down.&lt;br /&gt;
&lt;br /&gt;
Are you good at breaking things? Are you good at scripting? Do you like storage? This is a great opportunity to contribute, making things rock solid.&lt;br /&gt;
&lt;br /&gt;
Here are the current test cases (in PHP): https://github.com/gboudreau/Greyhole/blob/master/test_cases.php&lt;br /&gt;
&lt;br /&gt;
Can we improve them (say in other scripting languages)?&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_grinder&amp;diff=84338</id>
		<title>Greyhole grinder</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_grinder&amp;diff=84338"/>
		<updated>2014-05-15T13:41:32Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;This page is for ideas to develop a more comprenhensive test suite for Greyhole  so that we take it to a whole new level.&lt;br /&gt;
&lt;br /&gt;
The idea is to knock down hard to find bugs and keep them down.&lt;br /&gt;
&lt;br /&gt;
Are you good at breaking things? Are you good at scripting? Do you like storage? This is a great opportunity to contribute, making things rock solid.&lt;br /&gt;
&lt;br /&gt;
Here are the current test cases (in PHP): https://github.com/gboudreau/Greyhole/blob/master/test_cases.php&lt;br /&gt;
&lt;br /&gt;
Can we improve them (say in other scripting languages)?&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=84332</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=84332"/>
		<updated>2014-05-15T13:40:04Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: /* First things first */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;&amp;quot;&amp;gt;&lt;br /&gt;
'''NEW:''' [https://github.com/gboudreau/Greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide]&lt;br /&gt;
&lt;br /&gt;
'''NEW:''' [[Greyhole troubleshooting]] guide&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
[http://www.greyhole.net/ Greyhole] is Amahi's [[Storage pooling]] technology. 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.&lt;br /&gt;
Specifically, Greyhole:&lt;br /&gt;
* Combines the space from multiple drives into a single volume&lt;br /&gt;
* Distributes files across all drives in the pool&lt;br /&gt;
* Creates multiple copies of files in admin-specified shares&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. Open your HDA dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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]].&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
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]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''NOTE:'''  All commands are executed as root user (Fedora) or preceded with sudo (Ubuntu).&lt;br /&gt;
&lt;br /&gt;
== Forcing a fsck ==&lt;br /&gt;
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.&amp;lt;br /&amp;gt;&lt;br /&gt;
To force a fsck at any other time, simply execute&lt;br /&gt;
 sudo greyhole --fsck&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;NOTE:&amp;lt;/b&amp;gt;  Amahi 7 currently does not include Greyhole configuration integrated with the dashboard.  See [[Amahi_7_Create_Manual_Greyhole_Setup|Greyhole Manual Configuration]] for details.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Ubuntu) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole Options (Ubuntu) ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole Advanced Options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing '''/var/hda/platform/html/config/greyhole.yml'''.&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [https://gist.github.com/1379102 sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Music/&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Videos/Movies/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd1/gh&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd5/gh&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Backups/CrashPlan/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd0/gh&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying data to shares for the first time ==&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Adding a new drive to your HDA and storage pool ==&lt;br /&gt;
See [[Adding_a_second_hard_drive_to_your_HDA|Adding a new drive to your HDA]] and to your Greyhole storage pool.&lt;br /&gt;
&lt;br /&gt;
== Drive Mounted as /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow this guide to [[Adding a second hard drive to your HDA|permanently mount your drives]] before you include them in your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Monitoring Greyhole ==&lt;br /&gt;
Sometimes you might want to monitor what Greyhole is doing, for example when writing data to your greyhole shares for the first time. Here are a few commands you can type in a terminal to follow along.&lt;br /&gt;
&lt;br /&gt;
'''Scrolling view of total Greyhole operations queue:'''&lt;br /&gt;
 while [ 1 == 1 ]; do greyhole --view-queue | grep Total; sleep 60; done&lt;br /&gt;
&lt;br /&gt;
'''Alternate way to watch Greyhole operations queue:'''&lt;br /&gt;
 watch -d greyhole --view-queue&lt;br /&gt;
&lt;br /&gt;
'''Scrolling log of what files Greyhole is working on right now:'''&lt;br /&gt;
 tail -f /var/log/greyhole.log&lt;br /&gt;
&lt;br /&gt;
'''Amahi application to view the Greyhole log in your web browser:'''  [http://www.amahi.org/apps/greyhole-logmon Greyhole LogMon]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--== Convert Greyhole from SQLite to MySQL ==&lt;br /&gt;
Greyhole is already using MySQL in Amahi 6.0&lt;br /&gt;
&lt;br /&gt;
Greyhole was previously using SQLite as the default database for queueing up tasks on Amahi. This was unique to Amahi as Greyhole was originally designed to use MySQL for this task.&lt;br /&gt;
&lt;br /&gt;
There are some major performance benefits to using MySQL over SQLite when writing large amounts of files. Switching can be especially useful when moving data to Greyhole shares for the first time. For now there is a script you can run if you want to switch over. This script has been tested to be safe while Greyhole is working but should be used with discretion.&lt;br /&gt;
&lt;br /&gt;
''To Convert to MySQL, run as root:''&lt;br /&gt;
&lt;br /&gt;
 /usr/share/greyhole/db_migration-sqlite2mysql.sh&lt;br /&gt;
&lt;br /&gt;
To see what DB engine is Greyhole using, do this:&lt;br /&gt;
&lt;br /&gt;
 grep db_engine /etc/greyhole.conf&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Disable Greyhole ==&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Perform the following steps as user '''root''' (Ubuntu):&lt;br /&gt;
&lt;br /&gt;
 update-rc.d -f greyhole remove&lt;br /&gt;
 rm /etc/monit.d/greyhole.conf&lt;br /&gt;
 service monit restart&lt;br /&gt;
 service greyhole stop&lt;br /&gt;
&lt;br /&gt;
'''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software.  Doing so will break your HDA.&lt;br /&gt;
&lt;br /&gt;
= Testing and Reliability =&lt;br /&gt;
&lt;br /&gt;
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.&lt;br /&gt;
&lt;br /&gt;
= Reconnect the Greyhole storage pool =&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
= Greyhole Troubleshooting =&lt;br /&gt;
&lt;br /&gt;
See [[Greyhole troubleshooting]].&lt;br /&gt;
&lt;br /&gt;
= Landing Zone Considerations =&lt;br /&gt;
&lt;br /&gt;
The landing zone or LZ is the area where files arrive first before being distributed to their final destination. See details in the [[Greyhole landing zone]] page.&lt;br /&gt;
&lt;br /&gt;
= Manually updating Greyhole for Amahi =&lt;br /&gt;
See [[Greyhole updating]] for Amahi 6 (Ubuntu) '''ONLY'''.&lt;br /&gt;
&lt;br /&gt;
= Emptying Greyhole Trash =&lt;br /&gt;
 greyhole --empty-trash&lt;br /&gt;
About the trash: The trash is used like a Recycle Bin.&lt;br /&gt;
That means you'll need to manually empty it once in a while.&lt;br /&gt;
To do so, use the --empty-trash parameter (see above).&lt;br /&gt;
Another option is to create a 'Greyhole Trash' Samba share.&lt;br /&gt;
More details about that [https://github.com/gboudreau/Greyhole/wiki/AboutTrash here].&lt;br /&gt;
&lt;br /&gt;
= Moving drives/data out of Greyhole =&lt;br /&gt;
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]].&lt;br /&gt;
&lt;br /&gt;
= Changing Greyhole drive mount points =&lt;br /&gt;
Refer to [[Changing Greyhole Mount Points]].&lt;br /&gt;
&lt;br /&gt;
= Reference =&lt;br /&gt;
* Good [http://revxatlarge.blogspot.com/2011/04/restoring-deleted-files-in-greyhole-and.html article] on Greyhole with terms explained.&lt;br /&gt;
&lt;br /&gt;
* [https://github.com/gboudreau/Greyhole/wiki Greyhole Wiki]:  Provides guidance for various tasks.&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=84326</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=84326"/>
		<updated>2014-05-15T13:38:25Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: /* Emptying Greyhole Attic */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;&amp;quot;&amp;gt;&lt;br /&gt;
'''NEW:''' [https://github.com/gboudreau/Greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide]&lt;br /&gt;
&lt;br /&gt;
'''NEW:''' [[Greyhole troubleshooting]] guide&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
[http://www.greyhole.net/ Greyhole] is Amahi's [[Storage pooling]] technology. 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.&lt;br /&gt;
Specifically, Greyhole:&lt;br /&gt;
* Combines the space from multiple drives into a single volume&lt;br /&gt;
* Distributes files across all drives in the pool&lt;br /&gt;
* Creates multiple copies of files in admin-specified shares&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. Open your HDA dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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]].&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
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]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''NOTE:'''  All commands are executed as root user (Fedora) or preceded with sudo (Ubuntu).&lt;br /&gt;
&lt;br /&gt;
== Forcing a fsck ==&lt;br /&gt;
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.&amp;lt;br /&amp;gt;&lt;br /&gt;
To force a fsck at any other time, simply execute&lt;br /&gt;
 sudo greyhole --fsck&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;NOTE:&amp;lt;/b&amp;gt;  Amahi 7 currently does not include Greyhole configuration integrated with the dashboard.  See [[Amahi_7_installation#Greyhole|Greyhole Configuration]] for details.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Ubuntu) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole Options (Ubuntu) ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole Advanced Options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing '''/var/hda/platform/html/config/greyhole.yml'''.&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [https://gist.github.com/1379102 sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Music/&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Videos/Movies/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd1/gh&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd5/gh&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Backups/CrashPlan/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd0/gh&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying data to shares for the first time ==&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Adding a new drive to your HDA and storage pool ==&lt;br /&gt;
See [[Adding_a_second_hard_drive_to_your_HDA|Adding a new drive to your HDA]] and to your Greyhole storage pool.&lt;br /&gt;
&lt;br /&gt;
== Drive Mounted as /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow this guide to [[Adding a second hard drive to your HDA|permanently mount your drives]] before you include them in your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Monitoring Greyhole ==&lt;br /&gt;
Sometimes you might want to monitor what Greyhole is doing, for example when writing data to your greyhole shares for the first time. Here are a few commands you can type in a terminal to follow along.&lt;br /&gt;
&lt;br /&gt;
'''Scrolling view of total Greyhole operations queue:'''&lt;br /&gt;
 while [ 1 == 1 ]; do greyhole --view-queue | grep Total; sleep 60; done&lt;br /&gt;
&lt;br /&gt;
'''Alternate way to watch Greyhole operations queue:'''&lt;br /&gt;
 watch -d greyhole --view-queue&lt;br /&gt;
&lt;br /&gt;
'''Scrolling log of what files Greyhole is working on right now:'''&lt;br /&gt;
 tail -f /var/log/greyhole.log&lt;br /&gt;
&lt;br /&gt;
'''Amahi application to view the Greyhole log in your web browser:'''  [http://www.amahi.org/apps/greyhole-logmon Greyhole LogMon]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--== Convert Greyhole from SQLite to MySQL ==&lt;br /&gt;
Greyhole is already using MySQL in Amahi 6.0&lt;br /&gt;
&lt;br /&gt;
Greyhole was previously using SQLite as the default database for queueing up tasks on Amahi. This was unique to Amahi as Greyhole was originally designed to use MySQL for this task.&lt;br /&gt;
&lt;br /&gt;
There are some major performance benefits to using MySQL over SQLite when writing large amounts of files. Switching can be especially useful when moving data to Greyhole shares for the first time. For now there is a script you can run if you want to switch over. This script has been tested to be safe while Greyhole is working but should be used with discretion.&lt;br /&gt;
&lt;br /&gt;
''To Convert to MySQL, run as root:''&lt;br /&gt;
&lt;br /&gt;
 /usr/share/greyhole/db_migration-sqlite2mysql.sh&lt;br /&gt;
&lt;br /&gt;
To see what DB engine is Greyhole using, do this:&lt;br /&gt;
&lt;br /&gt;
 grep db_engine /etc/greyhole.conf&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Disable Greyhole ==&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Perform the following steps as user '''root''' (Ubuntu):&lt;br /&gt;
&lt;br /&gt;
 update-rc.d -f greyhole remove&lt;br /&gt;
 rm /etc/monit.d/greyhole.conf&lt;br /&gt;
 service monit restart&lt;br /&gt;
 service greyhole stop&lt;br /&gt;
&lt;br /&gt;
'''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software.  Doing so will break your HDA.&lt;br /&gt;
&lt;br /&gt;
= Testing and Reliability =&lt;br /&gt;
&lt;br /&gt;
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.&lt;br /&gt;
&lt;br /&gt;
= Reconnect the Greyhole storage pool =&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
= Greyhole Troubleshooting =&lt;br /&gt;
&lt;br /&gt;
See [[Greyhole troubleshooting]].&lt;br /&gt;
&lt;br /&gt;
= Landing Zone Considerations =&lt;br /&gt;
&lt;br /&gt;
The landing zone or LZ is the area where files arrive first before being distributed to their final destination. See details in the [[Greyhole landing zone]] page.&lt;br /&gt;
&lt;br /&gt;
= Manually updating Greyhole for Amahi =&lt;br /&gt;
See [[Greyhole updating]] for Amahi 6 (Ubuntu) '''ONLY'''.&lt;br /&gt;
&lt;br /&gt;
= Emptying Greyhole Trash =&lt;br /&gt;
 greyhole --empty-trash&lt;br /&gt;
About the trash: The trash is used like a Recycle Bin.&lt;br /&gt;
That means you'll need to manually empty it once in a while.&lt;br /&gt;
To do so, use the --empty-trash parameter (see above).&lt;br /&gt;
Another option is to create a 'Greyhole Trash' Samba share.&lt;br /&gt;
More details about that [https://github.com/gboudreau/Greyhole/wiki/AboutTrash here].&lt;br /&gt;
&lt;br /&gt;
= Moving drives/data out of Greyhole =&lt;br /&gt;
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]].&lt;br /&gt;
&lt;br /&gt;
= Changing Greyhole drive mount points =&lt;br /&gt;
Refer to [[Changing Greyhole Mount Points]].&lt;br /&gt;
&lt;br /&gt;
= Reference =&lt;br /&gt;
* Good [http://revxatlarge.blogspot.com/2011/04/restoring-deleted-files-in-greyhole-and.html article] on Greyhole with terms explained.&lt;br /&gt;
&lt;br /&gt;
* [https://github.com/gboudreau/Greyhole/wiki Greyhole Wiki]:  Provides guidance for various tasks.&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=84320</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=84320"/>
		<updated>2014-05-15T13:35:24Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: /* Forcing an fsck */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;&amp;quot;&amp;gt;&lt;br /&gt;
'''NEW:''' [https://github.com/gboudreau/Greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide]&lt;br /&gt;
&lt;br /&gt;
'''NEW:''' [[Greyhole troubleshooting]] guide&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
[http://www.greyhole.net/ Greyhole] is Amahi's [[Storage pooling]] technology. 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.&lt;br /&gt;
Specifically, Greyhole:&lt;br /&gt;
* Combines the space from multiple drives into a single volume&lt;br /&gt;
* Distributes files across all drives in the pool&lt;br /&gt;
* Creates multiple copies of files in admin-specified shares&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. Open your HDA dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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]].&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
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]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''NOTE:'''  All commands are executed as root user (Fedora) or preceded with sudo (Ubuntu).&lt;br /&gt;
&lt;br /&gt;
== Forcing a fsck ==&lt;br /&gt;
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.&amp;lt;br /&amp;gt;&lt;br /&gt;
To force a fsck at any other time, simply execute&lt;br /&gt;
 sudo greyhole --fsck&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;NOTE:&amp;lt;/b&amp;gt;  Amahi 7 currently does not include Greyhole configuration integrated with the dashboard.  See [[Amahi_7_installation#Greyhole|Greyhole Configuration]] for details.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Ubuntu) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole Options (Ubuntu) ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole Advanced Options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing '''/var/hda/platform/html/config/greyhole.yml'''.&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [https://gist.github.com/1379102 sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Music/&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Videos/Movies/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd1/gh&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd5/gh&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Backups/CrashPlan/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd0/gh&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying data to shares for the first time ==&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Adding a new drive to your HDA and storage pool ==&lt;br /&gt;
See [[Adding_a_second_hard_drive_to_your_HDA|Adding a new drive to your HDA]] and to your Greyhole storage pool.&lt;br /&gt;
&lt;br /&gt;
== Drive Mounted as /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow this guide to [[Adding a second hard drive to your HDA|permanently mount your drives]] before you include them in your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Monitoring Greyhole ==&lt;br /&gt;
Sometimes you might want to monitor what Greyhole is doing, for example when writing data to your greyhole shares for the first time. Here are a few commands you can type in a terminal to follow along.&lt;br /&gt;
&lt;br /&gt;
'''Scrolling view of total Greyhole operations queue:'''&lt;br /&gt;
 while [ 1 == 1 ]; do greyhole --view-queue | grep Total; sleep 60; done&lt;br /&gt;
&lt;br /&gt;
'''Alternate way to watch Greyhole operations queue:'''&lt;br /&gt;
 watch -d greyhole --view-queue&lt;br /&gt;
&lt;br /&gt;
'''Scrolling log of what files Greyhole is working on right now:'''&lt;br /&gt;
 tail -f /var/log/greyhole.log&lt;br /&gt;
&lt;br /&gt;
'''Amahi application to view the Greyhole log in your web browser:'''  [http://www.amahi.org/apps/greyhole-logmon Greyhole LogMon]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--== Convert Greyhole from SQLite to MySQL ==&lt;br /&gt;
Greyhole is already using MySQL in Amahi 6.0&lt;br /&gt;
&lt;br /&gt;
Greyhole was previously using SQLite as the default database for queueing up tasks on Amahi. This was unique to Amahi as Greyhole was originally designed to use MySQL for this task.&lt;br /&gt;
&lt;br /&gt;
There are some major performance benefits to using MySQL over SQLite when writing large amounts of files. Switching can be especially useful when moving data to Greyhole shares for the first time. For now there is a script you can run if you want to switch over. This script has been tested to be safe while Greyhole is working but should be used with discretion.&lt;br /&gt;
&lt;br /&gt;
''To Convert to MySQL, run as root:''&lt;br /&gt;
&lt;br /&gt;
 /usr/share/greyhole/db_migration-sqlite2mysql.sh&lt;br /&gt;
&lt;br /&gt;
To see what DB engine is Greyhole using, do this:&lt;br /&gt;
&lt;br /&gt;
 grep db_engine /etc/greyhole.conf&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Disable Greyhole ==&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Perform the following steps as user '''root''' (Ubuntu):&lt;br /&gt;
&lt;br /&gt;
 update-rc.d -f greyhole remove&lt;br /&gt;
 rm /etc/monit.d/greyhole.conf&lt;br /&gt;
 service monit restart&lt;br /&gt;
 service greyhole stop&lt;br /&gt;
&lt;br /&gt;
'''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software.  Doing so will break your HDA.&lt;br /&gt;
&lt;br /&gt;
= Testing and Reliability =&lt;br /&gt;
&lt;br /&gt;
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.&lt;br /&gt;
&lt;br /&gt;
= Reconnect the Greyhole storage pool =&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
= Greyhole Troubleshooting =&lt;br /&gt;
&lt;br /&gt;
See [[Greyhole troubleshooting]].&lt;br /&gt;
&lt;br /&gt;
= Landing Zone Considerations =&lt;br /&gt;
&lt;br /&gt;
The landing zone or LZ is the area where files arrive first before being distributed to their final destination. See details in the [[Greyhole landing zone]] page.&lt;br /&gt;
&lt;br /&gt;
= Manually updating Greyhole for Amahi =&lt;br /&gt;
See [[Greyhole updating]] for Amahi 6 (Ubuntu) '''ONLY'''.&lt;br /&gt;
&lt;br /&gt;
= Emptying Greyhole Attic =&lt;br /&gt;
 greyhole --empty-attic&lt;br /&gt;
About the attic: The attic is used like a Recycle Bin, or Trash.&lt;br /&gt;
That means you'll need to manually empty it once in a while.&lt;br /&gt;
To do so, use the --empty-attic parameter (see above).&lt;br /&gt;
Another option is to create a 'Greyhole Attic' Samba share.&lt;br /&gt;
More details about that [https://github.com/gboudreau/Greyhole/wiki/AboutTrash here].&lt;br /&gt;
&lt;br /&gt;
= Moving drives/data out of Greyhole =&lt;br /&gt;
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]].&lt;br /&gt;
&lt;br /&gt;
= Changing Greyhole drive mount points =&lt;br /&gt;
Refer to [[Changing Greyhole Mount Points]].&lt;br /&gt;
&lt;br /&gt;
= Reference =&lt;br /&gt;
* Good [http://revxatlarge.blogspot.com/2011/04/restoring-deleted-files-in-greyhole-and.html article] on Greyhole with terms explained.&lt;br /&gt;
&lt;br /&gt;
* [https://github.com/gboudreau/Greyhole/wiki Greyhole Wiki]:  Provides guidance for various tasks.&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46627</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46627"/>
		<updated>2011-09-17T23:38:35Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
All the steps below should be executed as root.&lt;br /&gt;
&lt;br /&gt;
== Option 1 - Use the Greyhole YUM repository ==&lt;br /&gt;
&lt;br /&gt;
1. If you didn't already, add the Greyhole YUM repository to your YUM configuration.&lt;br /&gt;
{{Code|curl -o /etc/yum.repos.d/greyhole.repo http://www.greyhole.net/releases/rpm/greyhole.repo.disabled}}&lt;br /&gt;
&lt;br /&gt;
2. If you want to use this repository every time yum is used (including for Amahi automatic updates), change '''''/etc/yum.repos.d/greyhole.repo''''' from:&lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;0}}&lt;br /&gt;
to &lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;1}}&lt;br /&gt;
'''NOTE:'''  You can safely skip this step if you want to manually update in the future.&lt;br /&gt;
&lt;br /&gt;
3. Update hda-greyhole to the latest version: &lt;br /&gt;
{{Code|yum --enablerepo&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;greyhole update hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Option 2 - Manually install the latest RPM ==&lt;br /&gt;
&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
=== Troubleshooting ===&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the following command to reinstall the currently installed RPM:&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh --force http://www.greyhole.net/releases/rpm/`uname -i`/`rpm -qa hda-greyhole`.rpm}}&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46621</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46621"/>
		<updated>2011-09-17T23:37:49Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
All the steps below should be executed as root.&lt;br /&gt;
&lt;br /&gt;
== Option 1 - Use the Greyhole YUM repository ==&lt;br /&gt;
&lt;br /&gt;
1. If you didn't already, add the Greyhole YUM repository to your YUM configuration.&lt;br /&gt;
{{Code|curl -o /etc/yum.repos.d/greyhole.repo http://www.greyhole.net/releases/rpm/greyhole.repo.disabled}}&lt;br /&gt;
&lt;br /&gt;
2. If you want to use this repository every time yum is used (including for Amahi automatic updates), change '''''/etc/yum.repos.d/greyhole.repo''''' from:&lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;0}}&lt;br /&gt;
to &lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;1}}&lt;br /&gt;
'''NOTE:'''  You can safely skip this step if you want to manually update in the future.&lt;br /&gt;
&lt;br /&gt;
3. Update hda-greyhole to the latest version: &lt;br /&gt;
{{Code|yum --enablerepo&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;greyhole update hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Option 2 - Manually install the latest RPM ==&lt;br /&gt;
&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
=== Troubleshooting ===&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh --force http://www.greyhole.net/releases/rpm/`uname -i`/`rpm -qa hda-greyhole`.rpm}}&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46615</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46615"/>
		<updated>2011-09-17T23:32:58Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
All the steps below should be executed as root.&lt;br /&gt;
&lt;br /&gt;
== Option 1 - Use the Greyhole YUM repository ==&lt;br /&gt;
&lt;br /&gt;
1. If you didn't already, add the Greyhole YUM repository to your YUM configuration.&lt;br /&gt;
{{Code|curl -o /etc/yum.repos.d/greyhole.repo http://www.greyhole.net/releases/rpm/greyhole.repo.disabled}}&lt;br /&gt;
&lt;br /&gt;
2. If you want to use this repository every time yum is used (including for Amahi automatic updates), change '''''/etc/yum.repos.d/greyhole.repo''''' from:&lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;0}}&lt;br /&gt;
to &lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;1}}&lt;br /&gt;
'''NOTE:'''  You can safely skip this step if you want to manually update in the future.&lt;br /&gt;
&lt;br /&gt;
3. Update hda-greyhole to the latest version: &lt;br /&gt;
{{Code|yum --enablerepo&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;greyhole update hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Option 2 - Manually install the latest RPM ==&lt;br /&gt;
&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
=== Troubleshooting ===&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh --force http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46609</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46609"/>
		<updated>2011-09-17T12:16:28Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
== Option 1 - Use the Greyhole YUM repository ==&lt;br /&gt;
&lt;br /&gt;
1. If you didn't already, add the Greyhole YUM repository to your YUM configuration.&lt;br /&gt;
{{Code|curl -o /etc/yum.repos.d/greyhole.repo http://www.greyhole.net/releases/rpm/greyhole.repo.disabled}}&lt;br /&gt;
&lt;br /&gt;
2. If you want to use this repository every time yum is used (including for Amahi automatic updates), change '''''/etc/yum.repos.d/greyhole.repo''''' from:&lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;0}}&lt;br /&gt;
to &lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;1}}&lt;br /&gt;
'''NOTE:'''  You can safely skip this step if you want to manually update in the future.&lt;br /&gt;
&lt;br /&gt;
3. Update hda-greyhole to the latest version: &lt;br /&gt;
{{Code|yum --enablerepo&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;greyhole update hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Option 2 - Manually install the latest RPM ==&lt;br /&gt;
&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
=== Troubleshooting ===&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh --force http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46603</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46603"/>
		<updated>2011-09-17T12:08:55Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
== Option 1 - Use the Greyhole YUM repository ==&lt;br /&gt;
&lt;br /&gt;
1. If you didn't already, add the Greyhole YUM repository to your YUM configuration.&lt;br /&gt;
{{Code|curl -o /etc/yum.repos.d/greyhole.repo http://www.greyhole.net/releases/rpm/greyhole.repo.disabled}}&lt;br /&gt;
&lt;br /&gt;
2. If you want to use this repository every time yum is used (including for Amahi automatic updates), change '''''/etc/yum.repos.d/greyhole.repo''''' from:&lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;0}}&lt;br /&gt;
to &lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;1}}&lt;br /&gt;
'''NOTE:'''  You can safely skip this step if you want to manually update in the future.&lt;br /&gt;
&lt;br /&gt;
3. Update hda-greyhole to the latest version: &lt;br /&gt;
{{Code|yum --enablerepo&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;greyhole update hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Option 2 - Manually install the latest RPM ==&lt;br /&gt;
&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
=== Troubleshooting ===&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm --force}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46597</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46597"/>
		<updated>2011-09-17T11:22:27Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
== Option 1 - Use the Greyhole YUM repository ==&lt;br /&gt;
&lt;br /&gt;
1. If you didn't already, add the Greyhole YUM repository to your YUM configuration.&lt;br /&gt;
{{Code|curl -o /etc/yum.repos.d/greyhole.repo http://www.greyhole.net/releases/rpm/greyhole.repo}}&lt;br /&gt;
&lt;br /&gt;
2. If you want to use this repository every time yum is used (including for Amahi automatic updates), change '''''/etc/yum.repos.d/greyhole.repo''''' from:&lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;0}}&lt;br /&gt;
to &lt;br /&gt;
{{Text|Text=enabled&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;1}}&lt;br /&gt;
'''NOTE:'''  You can safely skip this step if you want to manually update in the future.&lt;br /&gt;
&lt;br /&gt;
3. Update hda-greyhole to the latest version: &lt;br /&gt;
{{Code|yum --enablerepo&amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt;greyhole update hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Option 2 - Manually install the latest RPM ==&lt;br /&gt;
&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
=== Troubleshooting ===&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/rpm/`uname -i`/hda-greyhole-0.9.13-1.`uname -i`.rpm --force}}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=46591</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=46591"/>
		<updated>2011-09-16T23:18:22Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;&amp;quot;&amp;gt;&lt;br /&gt;
'''NEW:''' [https://github.com/gboudreau/Greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide]&lt;br /&gt;
&lt;br /&gt;
'''NEW:''' [[Greyhole troubleshooting]] guide&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
[http://www.greyhole.net/ Greyhole] is Amahi's [[Storage pooling]] technology. 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.&lt;br /&gt;
Specifically, Greyhole:&lt;br /&gt;
* Combines the space from multiple drives into a single volume&lt;br /&gt;
* Distributes files across all drives in the pool&lt;br /&gt;
* Creates multiple copies of files in admin-specified shares&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. Open your HDA dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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]].&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
Also, touching anything inside the '''gh''' directories that Greyhole creates at the root of your partitions is a recipe for disaster.&lt;br /&gt;
&lt;br /&gt;
We [[Greyhole not on root | strongly discourage you from using the root partition in a drive pool]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
You need to go in the Settings tab, and enable '''Advanced Settings'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Without Advanced Settings enabled, you won't see the following page and options.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Partitions) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole options ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole advanced options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing the following file:&amp;lt;br/&amp;gt;&lt;br /&gt;
'''/var/hda/platform/html/config/greyhole.yml'''&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [http://raw.github.com/gboudreau/Greyhole/master/greyhole.example.conf sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
{{Text|Text=sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Music/&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Videos/Movies/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd1/gh&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd5/gh&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Backups/CrashPlan/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd0/gh}}&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
{{Text|Text=sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh}}&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying your data into Greyhole shares the first time ==&lt;br /&gt;
&lt;br /&gt;
When you start using Greyhole, you might want to copy or move all your exiting files into your new shares that use the storage pool.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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 nightly check move the files from there into the pool.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Adding a new drive to your HDA and storage pool ==&lt;br /&gt;
This wiki page discusses how to add a new drive to your HDA and to your greyhole storage pool&lt;br /&gt;
[[Adding_a_second_hard_drive_to_your_HDA]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Drive Mounted as /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow this guide to [[Adding a second hard drive to your HDA|permanently mount your drives]], before you include them in your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Monitoring Greyhole ==&lt;br /&gt;
Sometimes you might want to monitor what Greyhole is doing, for example when writing data to your greyhole shares for the first time. Here are a few commands you can type in a terminal to follow along.&lt;br /&gt;
&lt;br /&gt;
'''Scrolling view of total Greyhole operations queue:'''&lt;br /&gt;
{{Code|while [ 1 &amp;lt;nowiki&amp;gt;==&amp;lt;/nowiki&amp;gt; 1 ]; do greyhole --view-queue &amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt; grep Total; sleep 60; done}}&lt;br /&gt;
&lt;br /&gt;
'''Scrolling log of what files Greyhole is working on right now:'''&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
== Convert Greyhole from SQLite to MySQL ==&lt;br /&gt;
Greyhole is already using MySQL in Amahi 6.0&lt;br /&gt;
&lt;br /&gt;
Greyhole was previously using SQLite as the default database for queueing up tasks on Amahi. This was unique to Amahi as Greyhole was originally designed to use MySQL for this task.&lt;br /&gt;
&lt;br /&gt;
There are some major performance benefits to using MySQL over SQLite when writing large amounts of files. Switching can be especially useful when moving data to Greyhole shares for the first time. For now there is a script you can run if you want to switch over. This script has been tested to be safe while Greyhole is working but should be used with discretion.&lt;br /&gt;
&lt;br /&gt;
''To Convert to MySQL, run as root:''&lt;br /&gt;
&lt;br /&gt;
{{Code|/usr/share/greyhole/db_migration-sqlite2mysql.sh}}&lt;br /&gt;
&lt;br /&gt;
To see what DB engine is Greyhole using, do this:&lt;br /&gt;
&lt;br /&gt;
{{Code|grep db_engine /etc/greyhole.conf}}&lt;br /&gt;
&lt;br /&gt;
== Disable Greyhole ==&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Perform the following steps as user '''root''':&lt;br /&gt;
&lt;br /&gt;
{{Code|chkconfig greyhole off&lt;br /&gt;
rm /etc/monit.d/greyhole.conf&lt;br /&gt;
service monit restart&lt;br /&gt;
service greyhole stop}}&lt;br /&gt;
&lt;br /&gt;
'''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software.  Doing so will break your HDA.&lt;br /&gt;
&lt;br /&gt;
= Testing and Reliability =&lt;br /&gt;
&lt;br /&gt;
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.&lt;br /&gt;
&lt;br /&gt;
= Reconnect the Greyhole storage pool after re-install of Fedora / Amahi =&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--After re-install, recreate all your shares exacty as they were.&amp;lt;br&amp;gt;&lt;br /&gt;
Add the shares to the storage pool.&amp;lt;br&amp;gt;&lt;br /&gt;
As root, run greyhole --fsck.&amp;lt;br&amp;gt;&lt;br /&gt;
This  will recreate the symlinks in the landing zone /var/hda/files.&amp;lt;br&amp;gt;--&amp;gt;&lt;br /&gt;
* Disconnect all data drives before you reinstall. This will prevent you from destroying them by mistake during the Fedora/Amahi install!&lt;br /&gt;
* Install Amahi per the regular instructions.&lt;br /&gt;
* Connect the data drives, and use hda-diskmount to remount all of them.&lt;br /&gt;
Note that if you can, it would be faster if you can re-mount the drives in the same paths they used to have.&lt;br /&gt;
&lt;br /&gt;
'''Example:''' If you have one 1TB and one 2TB, and the 1TB was mounted as /var/hda/files/drives/drive1, and the 2TB was mounted as /var/hda/files/drives/drive2, it would be better to re-mount that like that on your new HDA. If you mount them otherwise, it will still work, but Greyhole will work a while to re-build the links in your share before they can be usable.&lt;br /&gt;
* Select the drives in the Amahi Dashboard: Setup &amp;gt; Shares &amp;gt; Storage Pool&lt;br /&gt;
* Re-create your shares in the Amahi Dashboard: Setup &amp;gt; Shares.&lt;br /&gt;
Make sure to select 'Use Pool', and select the correct number of extra copies.&lt;br /&gt;
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!&lt;br /&gt;
&lt;br /&gt;
'''Example:'''&lt;br /&gt;
{{Code|ls -1 /var/hda/files/drives/*/gh/ &amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt; grep -v : &amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt; sort -u}}&lt;br /&gt;
&lt;br /&gt;
* Launch a fsck to have Greyhole rebuild your shares.&lt;br /&gt;
{{Code|greyhole --fsck}}&lt;br /&gt;
&lt;br /&gt;
Until this completes, some of your files will be missing from your shares.&lt;br /&gt;
&lt;br /&gt;
= Greyhole Troubleshooting =&lt;br /&gt;
&lt;br /&gt;
Page: [[Greyhole troubleshooting]]&lt;br /&gt;
&lt;br /&gt;
= Landing Zone Considerations =&lt;br /&gt;
&lt;br /&gt;
The landing zone or LZ is the area where files arrive first before being distributed to their final destination. See details in the [[Greyhole landing zone]] page.&lt;br /&gt;
&lt;br /&gt;
= Manually updating Greyhole for Amahi =&lt;br /&gt;
Page: [[Greyhole updating]]&lt;br /&gt;
&lt;br /&gt;
= Emptying Greyhole Attic =&lt;br /&gt;
{{Code|greyhole --empty-attic}}&lt;br /&gt;
About the attic: The attic is used like a Recycle Bin, or Trash.&lt;br /&gt;
That means you'll need to manually empty it once in a while.&lt;br /&gt;
To do so, use the --empty-attic parameter (see above).&lt;br /&gt;
Another option is to create a 'Greyhole Attic' Samba share.&lt;br /&gt;
More details about that here: https://github.com/gboudreau/Greyhole/wiki/AboutTrash&lt;br /&gt;
&lt;br /&gt;
= Reference =&lt;br /&gt;
Good [http://revxatlarge.blogspot.com/2011/04/restoring-deleted-files-in-greyhole-and.html article] on Greyhole with terms explained.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=46537</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=46537"/>
		<updated>2011-09-12T14:07:27Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;&amp;quot;&amp;gt;&lt;br /&gt;
'''NEW:''' [http://code.google.com/p/greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide]&lt;br /&gt;
&lt;br /&gt;
'''NEW:''' [[Greyhole troubleshooting]] guide&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
[http://greyhole.pommepause.com/ Greyhole] is Amahi's [[Storage pooling]] technology. 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.&lt;br /&gt;
Specifically, Greyhole:&lt;br /&gt;
* Combines the space from multiple drives into a single volume&lt;br /&gt;
* Distributes files across all drives in the pool&lt;br /&gt;
* Creates multiple copies of files in admin-specified shares&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. Open your HDA dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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]].&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
Also, touching anything inside the '''gh''' directories that Greyhole creates at the root of your partitions is a recipe for disaster.&lt;br /&gt;
&lt;br /&gt;
We [[Greyhole not on root | strongly discourage you from using the root partition in a drive pool]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
You need to go in the Settings tab, and enable '''Advanced Settings'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Without Advanced Settings enabled, you won't see the following page and options.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Partitions) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole options ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole advanced options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing the following file:&amp;lt;br/&amp;gt;&lt;br /&gt;
'''/var/hda/platform/html/config/greyhole.yml'''&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [http://raw.github.com/gboudreau/Greyhole/master/greyhole.example.conf sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
{{Text|Text=sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Music/&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Videos/Movies/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd1/gh&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd5/gh&lt;br /&gt;
 sticky_files &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; Backups/CrashPlan/&lt;br /&gt;
     stick_into &amp;lt;nowiki&amp;gt;=&amp;lt;/nowiki&amp;gt; /mnt/hdd0/gh}}&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
{{Text|Text=sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh}}&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying your data into Greyhole shares the first time ==&lt;br /&gt;
&lt;br /&gt;
When you start using Greyhole, you might want to copy or move all your exiting files into your new shares that use the storage pool.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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 nightly check move the files from there into the pool.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Adding a new drive to your HDA and storage pool ==&lt;br /&gt;
This wiki page discusses how to add a new drive to your HDA and to your greyhole storage pool&lt;br /&gt;
[[Adding_a_second_hard_drive_to_your_HDA]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Drive Mounted as /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow this guide to [[Adding a second hard drive to your HDA|permanently mount your drives]], before you include them in your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Monitoring Greyhole ==&lt;br /&gt;
Sometimes you might want to monitor what Greyhole is doing, for example when writing data to your greyhole shares for the first time. Here are a few commands you can type in a terminal to follow along.&lt;br /&gt;
&lt;br /&gt;
'''Scrolling view of total Greyhole operations queue:'''&lt;br /&gt;
{{Code|while [ 1 &amp;lt;nowiki&amp;gt;==&amp;lt;/nowiki&amp;gt; 1 ]; do greyhole --view-queue &amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt; grep Total; sleep 60; done}}&lt;br /&gt;
&lt;br /&gt;
'''Scrolling log of what files Greyhole is working on right now:'''&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
== Convert Greyhole from SQLite to MySQL ==&lt;br /&gt;
Greyhole is already using MySQL in Amahi 6.0&lt;br /&gt;
&lt;br /&gt;
Greyhole was previously using SQLite as the default database for queueing up tasks on Amahi. This was unique to Amahi as Greyhole was originally designed to use MySQL for this task.&lt;br /&gt;
&lt;br /&gt;
There are some major performance benefits to using MySQL over SQLite when writing large amounts of files. Switching can be especially useful when moving data to Greyhole shares for the first time. For now there is a script you can run if you want to switch over. This script has been tested to be safe while Greyhole is working but should be used with discretion.&lt;br /&gt;
&lt;br /&gt;
''To Convert to MySQL, run as root:''&lt;br /&gt;
&lt;br /&gt;
{{Code|/usr/share/greyhole/db_migration-sqlite2mysql.sh}}&lt;br /&gt;
&lt;br /&gt;
To see what DB engine is Greyhole using, do this:&lt;br /&gt;
&lt;br /&gt;
{{Code|grep db_engine /etc/greyhole.conf}}&lt;br /&gt;
&lt;br /&gt;
== Disable Greyhole ==&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Perform the following steps as user '''root''':&lt;br /&gt;
&lt;br /&gt;
{{Code|chkconfig greyhole off&lt;br /&gt;
rm /etc/monit.d/greyhole.conf&lt;br /&gt;
service monit restart&lt;br /&gt;
service greyhole stop}}&lt;br /&gt;
&lt;br /&gt;
'''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software.  Doing so will break your HDA.&lt;br /&gt;
&lt;br /&gt;
= Testing and Reliability =&lt;br /&gt;
&lt;br /&gt;
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.&lt;br /&gt;
&lt;br /&gt;
= Reconnect the Greyhole storage pool after re-install of Fedora / Amahi =&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--After re-install, recreate all your shares exacty as they were.&amp;lt;br&amp;gt;&lt;br /&gt;
Add the shares to the storage pool.&amp;lt;br&amp;gt;&lt;br /&gt;
As root, run greyhole --fsck.&amp;lt;br&amp;gt;&lt;br /&gt;
This  will recreate the symlinks in the landing zone /var/hda/files.&amp;lt;br&amp;gt;--&amp;gt;&lt;br /&gt;
* Disconnect all data drives before you reinstall. This will prevent you from destroying them by mistake during the Fedora/Amahi install!&lt;br /&gt;
* Install Amahi per the regular instructions.&lt;br /&gt;
* Connect the data drives, and use hda-diskmount to remount all of them.&lt;br /&gt;
Note that if you can, it would be faster if you can re-mount the drives in the same paths they used to have.&lt;br /&gt;
&lt;br /&gt;
'''Example:''' If you have one 1TB and one 2TB, and the 1TB was mounted as /var/hda/files/drives/drive1, and the 2TB was mounted as /var/hda/files/drives/drive2, it would be better to re-mount that like that on your new HDA. If you mount them otherwise, it will still work, but Greyhole will work a while to re-build the links in your share before they can be usable.&lt;br /&gt;
* Select the drives in the Amahi Dashboard: Setup &amp;gt; Shares &amp;gt; Storage Pool&lt;br /&gt;
* Re-create your shares in the Amahi Dashboard: Setup &amp;gt; Shares.&lt;br /&gt;
Make sure to select 'Use Pool', and select the correct number of extra copies.&lt;br /&gt;
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!&lt;br /&gt;
&lt;br /&gt;
'''Example:'''&lt;br /&gt;
{{Code|ls -1 /var/hda/files/drives/*/gh/ &amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt; grep -v : &amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt; sort -u}}&lt;br /&gt;
&lt;br /&gt;
* Launch a fsck to have Greyhole rebuild your shares.&lt;br /&gt;
{{Code|greyhole --fsck}}&lt;br /&gt;
&lt;br /&gt;
Until this completes, some of your files will be missing from your shares.&lt;br /&gt;
&lt;br /&gt;
= Greyhole Troubleshooting =&lt;br /&gt;
&lt;br /&gt;
Page: [[Greyhole troubleshooting]]&lt;br /&gt;
&lt;br /&gt;
= Landing Zone Considerations =&lt;br /&gt;
&lt;br /&gt;
The landing zone or LZ is the area where files arrive first before being distributed to their final destination. See details in the [[Greyhole landing zone]] page.&lt;br /&gt;
&lt;br /&gt;
= Manually updating Greyhole for Amahi =&lt;br /&gt;
Page: [[Greyhole updating]]&lt;br /&gt;
&lt;br /&gt;
= Emptying Greyhole Attic =&lt;br /&gt;
{{Code|greyhole --empty-attic}}&lt;br /&gt;
About the attic: The attic is used like a Recycle Bin, or Trash.&lt;br /&gt;
That means you'll need to manually empty it once in a while.&lt;br /&gt;
To do so, use the --empty-attic parameter (see above).&lt;br /&gt;
Another option is to create a 'Greyhole Attic' Samba share.&lt;br /&gt;
More details about that here: https://github.com/gboudreau/Greyhole/wiki/AboutTrash&lt;br /&gt;
&lt;br /&gt;
= Reference =&lt;br /&gt;
Good [http://revxatlarge.blogspot.com/2011/04/restoring-deleted-files-in-greyhole-and.html article] on Greyhole with terms explained.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46531</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46531"/>
		<updated>2011-09-11T19:57:09Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
== Option 1 - Use the Greyhole YUM repository ==&lt;br /&gt;
&lt;br /&gt;
1. If you didn't already, add the Greyhole YUM repository to your YUM configuration.&lt;br /&gt;
{{Code|curl -o /etc/yum.repos.d/greyhole.repo http://www.greyhole.net/releases/rpm/greyhole.repo}}&lt;br /&gt;
&lt;br /&gt;
2. If you want to use this repository every time yum is used (including for Amahi automatic updates), change enabled=0 to enabled=1 in /etc/yum.repos.d/greyhole.repo. You can safely skip this step if you want to manually update in the future.&lt;br /&gt;
&lt;br /&gt;
3. Update hda-greyhole to the latest version: &amp;lt;code&amp;gt;yum --enablerepo=greyhole update hda-greyhole&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Option 2 - Manually install the latest RPM ==&lt;br /&gt;
&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;{{Code|rpm -Uvh http://www.greyhole.net/releases/hda-greyhole-0.9.12-1.`uname -i`.rpm}}&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|tail -f /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
=== Troubleshooting ===&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;{{Code|rpm -Uvh http://www.greyhole.net/releases/hda-greyhole-0.9.12-1.`uname -i`.rpm --force}}&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46525</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46525"/>
		<updated>2011-09-11T18:24:10Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
== Instructions ==&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;{{Code|rpm -Uvh http://www.greyhole.net/releases/hda-greyhole-0.9.12-1.`uname -i`.rpm}}&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|nano /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Troubleshooting ==&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;{{Code|rpm -Uvh http://www.greyhole.net/releases/hda-greyhole-0.9.12-1.`uname -i`.rpm --force}}&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46519</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46519"/>
		<updated>2011-09-11T18:22:04Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
== Instructions ==&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
&amp;lt;blockquote&amp;gt;http://www.greyhole.net/download/archives.html&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
: Unsure whether you have i386 or x86_64? Run in terminal:&lt;br /&gt;
{{Code|uname -i}}&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;{{Code|rpm -Uvh http://www.greyhole.net/releases/hda-greyhole-0.9.12-1.`uname -i`.rpm}}&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|nano /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Troubleshooting ==&lt;br /&gt;
'''Can't access your shares after you upgraded ?'''&lt;br /&gt;
Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your Greyhole pooled shares to become unaccessible. Re-installing the same RPM a second time always fix that issue. Use the same command but add the --force parameter&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;blockquote&amp;gt;{{Code|rpm -Uvh http://www.greyhole.net/releases/hda-greyhole-0.9.12-1.`uname -i`.rpm --force}}&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Use the following command to verify that the Samba symlink was indeed created:&lt;br /&gt;
{{Code|ls -l /usr/lib*/samba/vfs/greyhole.so}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46147</id>
		<title>Greyhole updating</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_updating&amp;diff=46147"/>
		<updated>2011-09-01T13:28:52Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Disclaimer ==&lt;br /&gt;
Amahi releases new versions of Greyhole (GH) after they've been tested. If you follow this guide to update your GH install manually you do so on your own risk. If it breaks, it's on you.&lt;br /&gt;
&lt;br /&gt;
== Instructions ==&lt;br /&gt;
1. Find current version:&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
2. Is there a new version?&lt;br /&gt;
{{Link|http://www.greyhole.net/download/}}&lt;br /&gt;
&lt;br /&gt;
3. Browse the archive and copy the link for the latest hda-greyhole (Amahi needs hda-greyhole, the regular greyhole will conflict)&lt;br /&gt;
{{Link|http://www.greyhole.net/download/archives.html}}&lt;br /&gt;
: Unsure whether you have i386 or x86_64? Run in terminal:&lt;br /&gt;
{{Code|uname -i}}&lt;br /&gt;
&lt;br /&gt;
4. Back to terminal, make sure you are root (su). Example update command:&lt;br /&gt;
{{Code|rpm -Uvh http://www.greyhole.net/releases/hda-greyhole-0.9.10-1.i386.rpm}}&lt;br /&gt;
&lt;br /&gt;
5. Check the GH log for any errors that might have occurred after the upgrade&lt;br /&gt;
{{Code|nano /var/log/greyhole.log}}&lt;br /&gt;
&lt;br /&gt;
6. Re-check the version of your newly updated Greyhole install, and enjoy!&lt;br /&gt;
{{Code|rpm -q hda-greyhole}}&lt;br /&gt;
&lt;br /&gt;
== Troubleshooting ==&lt;br /&gt;
'''Can't access your shares after you upgraded ?''' Try to re-install the same RPM a second time. Sometimes, the script included in the RPM can't create the Greyhole module for Samba where it should, and this will cause your shares with Greyhole enabled to become unaccessible. Re-installing the same RPM a second time always fix that issue.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=41659</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=41659"/>
		<updated>2011-06-02T19:14:02Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: Greyhole service does NOT need to be running for mount_shares_locally to work. Only Samba and MySQLd are required. You can access your Greyhole shares without having the Greyhole service running.&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Install the mount_shares_locally initd script:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; overflow: scroll&amp;quot;&amp;gt;&lt;br /&gt;
 curl -o /etc/init.d/mount_shares_locally http://dl.dropbox.com/u/3022105/Amahi/mount_shares_locally&lt;br /&gt;
 chmod +x /etc/init.d/mount_shares_locally&lt;br /&gt;
 chkconfig --add mount_shares_locally&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/init.d/mount_shares_locally (as user root) in a text editor, and replace ''your_username'' (on line 12) with your username.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/your_username/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=your_username&lt;br /&gt;
 password=your_password&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute '''service mount_shares_locally start'''&amp;lt;br/&amp;gt;&lt;br /&gt;
You will find the mounted shares in ''/mnt/samba/*''&amp;lt;br/&amp;gt;&lt;br /&gt;
'''service mount_shares_locally stop''' will unmount the local shares.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Note: if you used /etc/rc.local and /etc/fstab to mount shares locally in the past, you can remove what you added in those files now. The above initd script replaces all this.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Unable to mount localy after upgrading to Amahi6 ==&lt;br /&gt;
If you try to run mount using this script after you upgraded to Amahi6 you might get greeted by this type of error.&lt;br /&gt;
&lt;br /&gt;
 [root@localhost ~]# /etc/init.d/mount_shares_locally start&lt;br /&gt;
 Mounting Samba shares locally: /etc/init.d/mount_shares_locally: line 27: /sbin/mount.cifs: No such file or directory&lt;br /&gt;
 /etc/init.d/mount_shares_locally: line 27: /sbin/mount.cifs: No such file or directory&lt;br /&gt;
 /etc/init.d/mount_shares_locally: line 27: /sbin/mount.cifs: No such file or directory&lt;br /&gt;
 /etc/init.d/mount_shares_locally: line 27: /sbin/mount.cifs: No such file or directory&lt;br /&gt;
 /etc/init.d/mount_shares_locally: line 27: /sbin/mount.cifs: No such file or directory&lt;br /&gt;
 /etc/init.d/mount_shares_locally: line 27: /sbin/mount.cifs: No such file or directory&lt;br /&gt;
 /etc/init.d/mount_shares_locally: line 27: /sbin/mount.cifs: No such file or directory&lt;br /&gt;
                                                           [  OK  ]&lt;br /&gt;
&lt;br /&gt;
It's easily fixed by installing the missing dependency.&lt;br /&gt;
&lt;br /&gt;
{{Code|yum install cifs-utils}}&lt;br /&gt;
&lt;br /&gt;
Now it should work fine to run&lt;br /&gt;
&lt;br /&gt;
{{Code|/etc/init.d/mount_shares_locally start}}&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_landing_zone&amp;diff=36997</id>
		<title>Greyhole landing zone</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_landing_zone&amp;diff=36997"/>
		<updated>2011-03-23T00:49:05Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Important things you have to know about the Greyhole Landing Zone (LZ).'&lt;br /&gt;
&lt;br /&gt;
When you are going to use Greyhole as a disk-pooling service, you have to keep a few important things in mind.&lt;br /&gt;
&lt;br /&gt;
The Amahi install guide suggest a small (20GB) root partition (also called system partition, or simply /).&lt;br /&gt;
While this is enough for most Linux systems, on Amahi with Greyhole, this partition is used as a ''landing zone'' for new files you copy onto your shares.&lt;br /&gt;
&lt;br /&gt;
All the data you copy to your HDA's shares will first ''land'' into your LZ, which is by default located in /var/hda/files/share_name.&lt;br /&gt;
Those folders are used as a temporary location for new files, which will be moved into the pooled drives as soon as possible by the Greyhole service, which runs in background.&lt;br /&gt;
&lt;br /&gt;
Here's a schema presenting the data flow for new files added to your HDA's shares:&lt;br /&gt;
&lt;br /&gt;
[[Image:GreyHoleLandingZone.png]]&lt;br /&gt;
&lt;br /&gt;
== Recommendations ==&lt;br /&gt;
&lt;br /&gt;
# Pick a big enough LZ partition that will allow you to copy enough data. Choosing the biggest drives you have is usually best.&lt;br /&gt;
# Move the LZ from the root partition to the location you picked. That way, if the LZ ever gets filled, it won't affect the rest of your system.&lt;br /&gt;
&lt;br /&gt;
The Greyhole wiki documents [http://code.google.com/p/greyhole/wiki/MovingLandingZone how to relocate your LZ].&lt;br /&gt;
&lt;br /&gt;
If you'd like to learn more about how Greyhole uses the LZ, or just how it works, the Greyhole wiki has [http://code.google.com/p/greyhole/wiki/HowGreyholeWorks more detailed information].&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Amahi_6.0&amp;diff=35749</id>
		<title>Amahi 6.0</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Amahi_6.0&amp;diff=35749"/>
		<updated>2011-03-03T14:39:20Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= FAQ =&lt;br /&gt;
* I installed the Amahi 6 beta. Do i need to reinstall? Good news! NO need to reinstall! The update is automatic a few hours after the repos are updated, your HDA will have the latest bits!&lt;br /&gt;
* Is the Express CD ready? Are all the apps ready? Nope, sorry. We are going to work on the apps and the express CD next!&lt;br /&gt;
* What architectures are supported: 32bit and 64bit x86 architectures (ARM is not yet supported in Amahi 6)&lt;br /&gt;
* Can I upgrade from Amahi 5: yes, with caution and patience. See below. You don't have to, however. Your Amahi 5 server will continue running for years if you let it run!&lt;br /&gt;
* I need help installing Fedora 14! Check the [[Fedora 14 install guide]]&lt;br /&gt;
&lt;br /&gt;
= Release Notes =&lt;br /&gt;
&lt;br /&gt;
* Based on Fedora 14&lt;br /&gt;
* Massive Greyhole-related improvements in Amahi support for it and in GH itself which is shipping at 0.9.1 today (vs 0.7.5 before). See the [[#Greyhole-related_Improvements|section below]] for a listing&lt;br /&gt;
* Initial support for right-to-left-languages, stating with Hebrew support (need work on the themes, see bug [http://bugs.amahi.org/issues/show/773 773])&lt;br /&gt;
* Anonymous/Guest access to shares&lt;br /&gt;
* Easy to add webapp aliases - makes it '''much easier''' to host apps on the web from your own HDA&lt;br /&gt;
* Updates to: Japanese, Romanian, Polish, Spanish, Russian, and many other translations&lt;br /&gt;
* App installer now has a fall-back mirror for app downloads. This will improve app installs substantially&lt;br /&gt;
* Databases from apps are automatically backed up after app uninstall, keeping track of the latest backup&lt;br /&gt;
* Added support for localized share names, user's names, etc. (bugs [http://bugs.amahi.org/issues/show/746 746] [http://bugs.amahi.org/issues/show/749 749])&lt;br /&gt;
* Also updated scriptaculous and prototype (JavaScript libraries)&lt;br /&gt;
* Simplify shares, by only showing tags while in advance settings is on, since they did not evolve to full use&lt;br /&gt;
* Improve recognition of PIDs in server (bug [http://bugs.amahi.org/issues/show/758 758])&lt;br /&gt;
* Improved DNS and DHCP settings, so that they are way more customizable for power users (bug [http://bugs.amahi.org/issues/show/714 714])&lt;br /&gt;
&lt;br /&gt;
= Updating from Amahi 5 to Amahi6 =&lt;br /&gt;
* First, the general recommendations is: '''BACK UP YOUR DATA'''&lt;br /&gt;
* Then do the internet-based [[F12 to F14 update]] including Amahi&lt;br /&gt;
&lt;br /&gt;
* '''Untested:''' the DVD-based method, as outlined in the [[Upgrade your Distro]] page is not well tested as far as we know.&lt;br /&gt;
&lt;br /&gt;
= Greyhole-related Improvements =&lt;br /&gt;
The Greyhole package that is now part of Amahi has been upgraded from version 0.7.5 to 0.9.1 (the latest). Here's what 0.9.1 has to offer, versus 0.7.5 and earlier.&lt;br /&gt;
&lt;br /&gt;
Amahi-Greyhole changes:&lt;br /&gt;
* Amahi-Greyhole now defaults to using MySQL as a back-end, instead of SQLite. This comes with a '''10x performance improvement''' while processing file operations, which will in turn transform into a substantial speed improvement when Greyhole is moving new files into the storage pool, especially for small files.&lt;br /&gt;
* Sync Greyhole configuration with the shares configuration when shares are deleted (bug [http://bugs.amahi.org/issues/show/610 610])&lt;br /&gt;
* Protect against reinstalls and Greyhole DB setup (bug [http://bugs.amahi.org/issues/show/762 762])&lt;br /&gt;
* Fix to make Greyhole handle millions of files in the spool directory. It could lead to hitting memory limits (bug [http://bugs.amahi.org/issues/show/769 769])&lt;br /&gt;
* Double check that shares added to the pool are actual mountpoints (bug [http://bugs.amahi.org/issues/show/611 611])&lt;br /&gt;
&lt;br /&gt;
Greyhole changes:&lt;br /&gt;
* Small performance improvements here and there.&lt;br /&gt;
* --fsck can now find files that are in the storage pool, but for which there is no symlink on the share, and no metadata (tombstone) files.&lt;br /&gt;
* The daily --fsck will now only run when the configuration files changed since the last --fsck. A weekly unconditional --fsck is still scheduled.&lt;br /&gt;
* Keep files last modified and created dates.&lt;br /&gt;
* New --status command-line option, to display what Greyhole is currently doing.&lt;br /&gt;
* Use a spool directory to log pending file operations, instead of using syslog.&lt;br /&gt;
* Fix multiple issues that would cause files to be sent to the attic (Recycle Bin), or end up with the wrong filename or path, when renaming files or directories.&lt;br /&gt;
* Fix to allow space characters in paths to drives included in the storage pool.&lt;br /&gt;
* Fix for non-english systems, that confused Greyhole when looking for free space stats.&lt;br /&gt;
* Fix to ignore comments in smb.conf&lt;br /&gt;
* Fix an issue where having an iTunes library on a Greyhole share could cause problems. In particular, importing a video, and changing it's type to ''TV Shows'' would make the file disappear from the iTunes library.&lt;br /&gt;
* --balance could misbehave when the drive with the most free space had 1+ ''twin'' (other drives with the same amount of free space)&lt;br /&gt;
* Fix an issue that would make Greyhole take a ''long'' time to process directory renames, especially if the renamed directory has many files &amp;amp; subdirectories in it.&lt;br /&gt;
* Greyhole would sometimes use the wrong drive, if a drive included in the pool would be a subdirectory of another. For example, having /var/hda/files and /var/hda/files/drives/drive1 in the storage pool.&lt;br /&gt;
* Fix an issue where Greyhole would crash when there was too many pending file operations (in the spool directory).&lt;br /&gt;
* Fix an infinite loop in --fsck when it would take more than 8 hours to run.&lt;br /&gt;
* Fix an infinite loop when one of the storage pool drive is read-only.&lt;br /&gt;
&lt;br /&gt;
Visit the [http://code.google.com/p/greyhole/source/list Greyhole ChangeLog] for all the gory details&lt;br /&gt;
&lt;br /&gt;
= To Do =&lt;br /&gt;
There are a few things left to do that were originally targeted for this release&lt;br /&gt;
* Disk-wizard&lt;br /&gt;
* Greyhole related fixes&lt;br /&gt;
** Handling non-linux based partitions better [http://bugs.amahi.org/issues/show/543 543]&lt;br /&gt;
** Making it easier to move shares out of the Greyhole pool and &amp;quot;unwind&amp;quot; the files [http://bugs.amahi.org/issues/show/510 510]. Greyhole document on how to [http://code.google.com/p/greyhole/wiki/RemoveShareFromPool remove share from the pool]&lt;br /&gt;
* Apps, Apps, Apps!&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=28117</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=28117"/>
		<updated>2010-12-28T18:09:04Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Install the mount_shares_locally initd script:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; overflow: scroll&amp;quot;&amp;gt;&lt;br /&gt;
 curl -o /etc/init.d/mount_shares_locally http://dl.dropbox.com/u/3022105/Amahi/mount_shares_locally&lt;br /&gt;
 chmod +x /etc/init.d/mount_shares_locally&lt;br /&gt;
 chkconfig --add mount_shares_locally&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/init.d/mount_shares_locally in a text editor, and replace ''your_username'' (on line 12) with your username.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/your_username/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=your_username&lt;br /&gt;
 password=your_password&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute '''service mount_shares_locally start'''&amp;lt;br/&amp;gt;&lt;br /&gt;
You will find the mounted shares in ''/mnt/samba/*''&amp;lt;br/&amp;gt;&lt;br /&gt;
'''service mount_shares_locally stop''' will unmount the local shares.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Note: if you used /etc/rc.local and /etc/fstab to mount shares locally in the past, you can remove what you added in those files now. The above initd script replaces all this.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole_troubleshooting&amp;diff=27967</id>
		<title>Greyhole troubleshooting</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole_troubleshooting&amp;diff=27967"/>
		<updated>2010-12-25T00:28:24Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;When reporting an issue with Greyhole, or asking for help regarding Greyhole, you should provide the following. You'll need to execute the given commands as root.&lt;br /&gt;
&lt;br /&gt;
1. What version of Fedora, Samba &amp;amp; Greyhole are you running?&lt;br /&gt;
      uname -r; rpm -q samba hda-greyhole&lt;br /&gt;
&lt;br /&gt;
2. The content of the /etc/samba/smb.conf &amp;amp; /etc/greyhole.conf files (provide paste URLs):&lt;br /&gt;
      yum -y install fpaste; fpaste /etc/samba/smb.conf; fpaste /etc/greyhole.conf&lt;br /&gt;
&lt;br /&gt;
3. The result of the following commands:&lt;br /&gt;
      mount; fdisk -l; df -h; greyhole --stats&lt;br /&gt;
&lt;br /&gt;
4. The list drives in your storage pool (per Amahi platform):&lt;br /&gt;
      mysql -u root -phda -e &amp;quot;select * from disk_pool_partitions&amp;quot; hda_production&lt;br /&gt;
&lt;br /&gt;
5. A list of the directories on the root of the drives included in your storage pool, obtained with the following command (provide a paste URL):&lt;br /&gt;
      mysql -u root -phda -e &amp;quot;select concat(path, '/gh') from disk_pool_partitions&amp;quot; hda_production | grep -v 'concat(' | xargs ls -la | fpaste&lt;br /&gt;
&lt;br /&gt;
6. The Greyhole work queue:&lt;br /&gt;
      greyhole --view-queue&lt;br /&gt;
If the above command returns nothing, execute '''tail /var/log/greyhole.log''' to see the problem.&lt;br /&gt;
&lt;br /&gt;
7. If you have issues with a particular file (file disappeared, is wrong size, has wrong filename), execute the following to find out what Greyhole did with this file:&lt;br /&gt;
    greyhole --debug filename&lt;br /&gt;
&lt;br /&gt;
Back to the [[Greyhole]] page&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27361</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27361"/>
		<updated>2010-12-20T03:20:16Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Install the mount_shares_locally initd script:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; overflow: scroll&amp;quot;&amp;gt;&lt;br /&gt;
 curl -o /etc/init.d/mount_shares_locally http://dl.dropbox.com/u/3022105/Amahi/mount_shares_locally&lt;br /&gt;
 chmod +x /etc/init.d/mount_shares_locally&lt;br /&gt;
 chkconfig --add mount_shares_locally&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/init.d/mount_shares_locally in a text editor, and replace ''your_username'' (on line 12) with your username.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/&amp;lt;your_username&amp;gt;/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=&amp;lt;your_username&amp;gt;&lt;br /&gt;
 password=&amp;lt;your_password&amp;gt;&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute '''service mount_shares_locally start'''&amp;lt;br/&amp;gt;&lt;br /&gt;
You will find the mounted shares in ''/mnt/samba/*''&amp;lt;br/&amp;gt;&lt;br /&gt;
'''service mount_shares_locally stop''' will unmount the local shares.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Note: if you used /etc/rc.local and /etc/fstab to mount shares locally in the past, you can remove what you added in those files now. The above initd script replaces all this.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27355</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27355"/>
		<updated>2010-12-20T03:08:45Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Install the mount_shares_locally initd script:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; overflow: scroll&amp;quot;&amp;gt;&lt;br /&gt;
 curl -o /etc/init.d/mount_shares_locally http://dl.dropbox.com/u/3022105/Amahi/mount_shares_locally&lt;br /&gt;
 chmod +x /etc/init.d/mount_shares_locally&lt;br /&gt;
 chkconfig --add mount_shares_locally&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/init.d/mount_shares_locally in a text editor, and replace ''your_username'' (on line 12) with your username.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/&amp;lt;your_username&amp;gt;/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=&amp;lt;your_username&amp;gt;&lt;br /&gt;
 password=&amp;lt;your_password&amp;gt;&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/rc.local, and add the following line:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 /sbin/service mount_shares_locally start&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute '''service mount_shares_locally start'''&amp;lt;br/&amp;gt;&lt;br /&gt;
You will find the mounted shares in ''/mnt/samba/*''&amp;lt;br/&amp;gt;&lt;br /&gt;
'''service mount_shares_locally stop''' will unmount the local shares.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Note: if you used /etc/rc.local and /etc/fstab to mount shares locally in the past, you can remove what you added in those files now. The above initd script replaces all this.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27349</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27349"/>
		<updated>2010-12-20T03:08:19Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Install the mount_shares_locally initd script:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; overflow: scroll&amp;quot;&amp;gt;&lt;br /&gt;
 curl -o /etc/init.d/mount_shares_locally http://dl.dropbox.com/u/3022105/Amahi/mount_shares_locally&lt;br /&gt;
 chmod +x /etc/init.d/mount_shares_locally&lt;br /&gt;
 chkconfig --add mount_shares_locally&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/init.d/mount_shares_locally in a text editor, and replace ''your_username'' (on line 12) with your username.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/&amp;lt;your_username&amp;gt;/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=&amp;lt;your_username&amp;gt;&lt;br /&gt;
 password=&amp;lt;your_password&amp;gt;&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/rc.local, and add the following line:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 service mount_shares_locally start&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute '''service mount_shares_locally start'''&amp;lt;br/&amp;gt;&lt;br /&gt;
You will find the mounted shares in ''/mnt/samba/*''&amp;lt;br/&amp;gt;&lt;br /&gt;
'''service mount_shares_locally stop''' will unmount the local shares.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Note: if you used /etc/rc.local and /etc/fstab to mount shares locally in the past, you can remove what you added in those files now. The above initd script replaces all this.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27343</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=27343"/>
		<updated>2010-12-20T03:05:03Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Install the mount_shares_locally initd script:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; overflow: scroll&amp;quot;&amp;gt;&lt;br /&gt;
 curl -o /etc/init.d/mount_shares_locally http://dl.dropbox.com/u/3022105/Amahi/mount_shares_locally&lt;br /&gt;
 chmod +x /etc/init.d/mount_shares_locally&lt;br /&gt;
 chkconfig --add mount_shares_locally&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Edit /etc/init.d/mount_shares_locally in a text editor, and replace ''your_username'' (on line 12) with your username.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/&amp;lt;your_username&amp;gt;/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=&amp;lt;your_username&amp;gt;&lt;br /&gt;
 password=&amp;lt;your_password&amp;gt;&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute '''service mount_shares_locally start'''&amp;lt;br/&amp;gt;&lt;br /&gt;
You will find the mounted shares in ''/mnt/samba/*''&amp;lt;br/&amp;gt;&lt;br /&gt;
'''service mount_shares_locally stop''' will unmount the local shares.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Note: if you used /etc/rc.local and /etc/fstab to mount shares locally in the past, you can remove what you added in those files now. The above initd script replaces all this.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Linux-hda_commands&amp;diff=26845</id>
		<title>Linux-hda commands</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Linux-hda_commands&amp;diff=26845"/>
		<updated>2010-12-16T20:22:28Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= General Linux/HDA Commands =&lt;br /&gt;
  service httpd start = restart web server&lt;br /&gt;
  yum -y update = Automatically update fedora&lt;br /&gt;
  rpm -Uvh http://dl.getdropbox.com/u/364883/Amahi/hda-platform-*.*-*.noarch.rpm = updates HDA&lt;br /&gt;
  rpm -q hda-platform = check to see what version of HDA your running.&lt;br /&gt;
&lt;br /&gt;
= Linux Basic Commands =&lt;br /&gt;
[[Basics|Linux Basic Commands]] most users will need.&lt;br /&gt;
&lt;br /&gt;
= uShare =&lt;br /&gt;
  service amahi-ushare restart = restart ushare after adding new content&lt;br /&gt;
&lt;br /&gt;
= VNCServer =&lt;br /&gt;
  vncserver = Starts the VNCServer&lt;br /&gt;
  vncserver -kill :1 = Stops the VNCServer&lt;br /&gt;
&lt;br /&gt;
= mt-daapd =&lt;br /&gt;
  /etc/init.d/mt-daapd start&lt;br /&gt;
  /etc/init.d/mt-daapd stop&lt;br /&gt;
&lt;br /&gt;
= Greyhole =&lt;br /&gt;
Use just &amp;quot;greyhole&amp;quot; in a Terminal to get the list, since those could change in the future. Currently, they are:&lt;br /&gt;
&lt;br /&gt;
  Usage: greyhole [ACTION] [OPTIONS]&lt;br /&gt;
  &lt;br /&gt;
  Where ACTION is one of:&lt;br /&gt;
    -?, --help            Display this help and exit.&lt;br /&gt;
    -D, --daemon          Start the daemon.&lt;br /&gt;
    -f, --fsck            Schedule a fsck.&lt;br /&gt;
    -l, --balance         Balance available space on storage pool devices.&lt;br /&gt;
    -s, --stats           Display storage pool statistics.&lt;br /&gt;
    -S, --status          Display what the Greyhole daemon is currently doing.&lt;br /&gt;
    -q, --view-queue      Display the current work queue.&lt;br /&gt;
    -a, --empty-attic     Empty the attic.&lt;br /&gt;
    -b, --debug=filename  Debug past file operations.&lt;br /&gt;
    -p, --prerotate       Pre-rotate task (for logrotate).&lt;br /&gt;
    -P, --postrotate      Post-rotate task (for logrotate).&lt;br /&gt;
    -t, --thaw[=path]     Thaw a frozen directory. Greyhole will start working on&lt;br /&gt;
                          files inside &amp;lt;path&amp;gt;. If you don't supply an option, the list&lt;br /&gt;
                          of frozen directories will be displayed.&lt;br /&gt;
    -w, --wait-for[=path] Tell Greyhole that the missing drive at &amp;lt;path&amp;gt; will return&lt;br /&gt;
                          soon, and that it shouldn't re-create additional file copies&lt;br /&gt;
                          to replace it. If you don't supply an option, the available&lt;br /&gt;
                          options (paths) will be displayed.&lt;br /&gt;
    -g, --gone[=path]     Tell Greyhole that the missing drive at &amp;lt;path&amp;gt; is gone for&lt;br /&gt;
                          good. Greyhole will start replacing the missing file copies&lt;br /&gt;
                          instantly. If you don't supply an option, the available&lt;br /&gt;
                          options (paths) will be displayed.&lt;br /&gt;
    -n, --going[=path]    Tell Greyhole that you want to remove a drive. Greyhole will&lt;br /&gt;
                          then make sure you don't loose any files, and that the&lt;br /&gt;
                          correct number of file copies are created to replace the&lt;br /&gt;
                          missing drive. If you don't supply an option, the available&lt;br /&gt;
                          options (paths) will be displayed.&lt;br /&gt;
  &lt;br /&gt;
  For --fsck, the available OPTIONS are:&lt;br /&gt;
    -e, --email-report    Send an email when fsck completes, to report on what was&lt;br /&gt;
                          checked, and any error that was found.&lt;br /&gt;
    -y, --dont-walk-graveyard&lt;br /&gt;
                          Speed up fsck by skipping the scan of the graveyard&lt;br /&gt;
                          directories. Scanning the graveyards is only required to&lt;br /&gt;
                          re-create symbolic links that might be missing from your&lt;br /&gt;
                          shared directories.&lt;br /&gt;
    -c, --if-conf-changed Only fsck if greyhole.conf changed since the last fsck.&lt;br /&gt;
                          Used in the daily cron to prevent unneccesary fsck runs.&lt;br /&gt;
    -d, --dir=path        Only scan a specific directory, and all sub-directories.&lt;br /&gt;
                          The specified directory should be a Samba share, or a&lt;br /&gt;
                          sub-directory of a Samba share.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Talk:Fedora_14_network_install&amp;diff=26011</id>
		<title>Talk:Fedora 14 network install</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Talk:Fedora_14_network_install&amp;diff=26011"/>
		<updated>2010-12-07T11:00:04Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: Created page with &amp;quot;Yo. This could all be packaged as an Amahi app. But then, using Amahi to install another Amahi might have limited usefulness...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Yo. This could all be packaged as an Amahi app.&lt;br /&gt;
But then, using Amahi to install another Amahi might have limited usefulness...&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=25333</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=25333"/>
		<updated>2010-12-02T00:04:15Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;&amp;quot;&amp;gt;&lt;br /&gt;
'''NEW:''' [http://code.google.com/p/greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide]&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
A new feature in Amahi is [[Storage pooling]] using [http://greyhole.pommepause.com/ Greyhole]. Storage Pooling is a technology to pool disk drives and make them look as if they were all part of a single pool of disk space.&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. First open your dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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]].&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
Also, touching anything inside the '''gh''' directories that Greyhole creates at the root of your partitions is a recipe for disaster.&lt;br /&gt;
&lt;br /&gt;
We [[Greyhole not on root | strongly discourage you from using the root partition in a drive pool]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
You need to go in the Settings tab, and enable '''Advanced Settings'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Without Advanced Settings enabled, you won't see the following page and options.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Partitions) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole options ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole advanced options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing the following file:&amp;lt;br/&amp;gt;&lt;br /&gt;
'''/var/hda/platform/html/config/greyhole.yml'''&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [http://greyhole.googlecode.com/svn/trunk/greyhole.example.conf sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
 sticky_files = Music/&lt;br /&gt;
 sticky_files = Videos/Movies/&lt;br /&gt;
     stick_into = /mnt/hdd1/gh&lt;br /&gt;
     stick_into = /mnt/hdd5/gh&lt;br /&gt;
 sticky_files = Backups/CrashPlan/&lt;br /&gt;
     stick_into = /mnt/hdd0/gh&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
 sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying you data into Greyhole shares the first time ==&lt;br /&gt;
&lt;br /&gt;
When you start using Greyhole, you might want to copy or move all your exiting files into your new shares that use the storage pool.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Once 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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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 nightly check move the files from there into the pool.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow [[Adding a second hard drive to your HDA|this guide]] to permanently mount your drives, before you include them in your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Monitoring Greyhole ==&lt;br /&gt;
Sometimes you might want to monitor what Greyhole is doing, for example when writing data to your greyhole shares for the first time. Here are a few commands you can type in a terminal to follow along.&lt;br /&gt;
&lt;br /&gt;
'''Scrolling view of total Greyhole operations queue:'''&lt;br /&gt;
 while [ 1 == 1 ]; do greyhole --view-queue | grep Total; sleep 60; done&lt;br /&gt;
&lt;br /&gt;
'''Scrolling log of what files Greyhole is working on right now:'''&lt;br /&gt;
 tail -f /var/log/greyhole.log&lt;br /&gt;
&lt;br /&gt;
== Disable Greyhole ==&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Perform the following steps as user '''root''':&lt;br /&gt;
&lt;br /&gt;
 chkconfig greyhole off&lt;br /&gt;
 remove /etc/monit.d/greyhole.conf&lt;br /&gt;
 service monit restart&lt;br /&gt;
 service greyhole stop&lt;br /&gt;
&lt;br /&gt;
'''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software.  Doing so will break your HDA.&lt;br /&gt;
&lt;br /&gt;
= Testing and Reliability =&lt;br /&gt;
&lt;br /&gt;
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=25105</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=25105"/>
		<updated>2010-11-29T10:47:57Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Add each share you want to mount locally to your /etc/fstab, like this:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; overflow: scroll&amp;quot;&amp;gt;&lt;br /&gt;
 #smb#//127.0.0.1/&amp;lt;share_name&amp;gt;	/mnt/samba/&amp;lt;share_name&amp;gt;	cifs	credentials=/home/&amp;lt;username&amp;gt;/.smb_credentials,uid=500,gid=100,file_mode=0660,dir_mode=0770,hard,_netdev 0 0&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
You'll need to replace ''&amp;lt;share_name&amp;gt;'' with the actual share name.&amp;lt;br/&amp;gt;&lt;br /&gt;
And ''&amp;lt;username&amp;gt;'' with your username. That user will own all the files in the mounted shares, though all users that are part of the ''users'' group (gid=100) will also be able to write in those mounted shares.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/&amp;lt;username&amp;gt;/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=&amp;lt;your_username&amp;gt;&lt;br /&gt;
 password=&amp;lt;your_password&amp;gt;&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Manually create the /mnt/samba/&amp;lt;share_name&amp;gt; directory.&lt;br /&gt;
&lt;br /&gt;
* Finally, add the following lines in /etc/rc.local:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 # Mount own Samba shares locally&lt;br /&gt;
 /bin/sed -ie 's/#smb#//g' /etc/fstab&lt;br /&gt;
 /bin/mount -a&lt;br /&gt;
 /bin/sed -ie 's@//127.0.0.1@#smb#//127.0.0.1@g' /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute the commands you added in rc.local.&amp;lt;br/&amp;gt;&lt;br /&gt;
rc.local is executed on boot, after all other services have been started.&amp;lt;br/&amp;gt;&lt;br /&gt;
This is necessary because mounts found in fstab are mounted before the Samba service starts, so just having your shares in fstab is not enough. The commands added in rc.local will un-comment your share lines from fstab, then mount them all, then re-comment them again, so that when fstab is executed on boot, it doesn't give you errors about those shares not being available.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=25099</id>
		<title>Mount Shares Locally</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Mount_Shares_Locally&amp;diff=25099"/>
		<updated>2010-11-29T10:45:14Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: Created page with &amp;quot;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed thr...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Mounting your Samba shares locally is useful when you are using Greyhole, and want to write or in any way work with those files locally. Greyhole data should only be accessed through shares, so mounting those shares locally is an easy way to work with Greyhole data safely.&lt;br /&gt;
&lt;br /&gt;
* Add each share you want to mount locally to your /etc/fstab, like this:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 #smb#//127.0.0.1/&amp;lt;share_name&amp;gt;	/mnt/samba/&amp;lt;share_name&amp;gt; cifs credentials=/home/&amp;lt;username&amp;gt;/.smb_credentials,uid=500,gid=100,file_mode=0660,dir_mode=0770,hard,_netdev 0 0&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
You'll need to replace ''&amp;lt;share_name&amp;gt;'' with the actual share name.&amp;lt;br/&amp;gt;&lt;br /&gt;
And ''&amp;lt;username&amp;gt;'' with your username. That user will own all the files in the mounted shares, though all users that are part of the ''users'' group (gid=100) will also be able to write in those mounted shares.&lt;br /&gt;
&lt;br /&gt;
* Create the ''/home/&amp;lt;username&amp;gt;/.smb_credentials'' file. This is a simple text file (use your favorite text editor).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 username=&amp;lt;your_username&amp;gt;&lt;br /&gt;
 password=&amp;lt;your_password&amp;gt;&lt;br /&gt;
 domain=HOME&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Manually create the /mnt/samba/&amp;lt;share_name&amp;gt; directory.&lt;br /&gt;
&lt;br /&gt;
* Finally, add the following lines in /etc/rc.local:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
 # Mount own Samba shares locally&lt;br /&gt;
 /bin/sed -ie 's/#smb#//g' /etc/fstab&lt;br /&gt;
 /bin/mount -a&lt;br /&gt;
 /bin/sed -ie 's@//127.0.0.1@#smb#//127.0.0.1@g' /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To test your new mounts, you can execute the commands you added in rc.local.&amp;lt;br/&amp;gt;&lt;br /&gt;
rc.local is executed on boot, after all other services have been started.&amp;lt;br/&amp;gt;&lt;br /&gt;
This is necessary because mounts found in fstab are mounted before the Samba service starts, so just having your shares in fstab is not enough. The commands added in rc.local will un-comment your share lines from fstab, then mount them all, then re-comment them again, so that when fstab is executed on boot, it doesn't give you errors about those shares not being available.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=25093</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=25093"/>
		<updated>2010-11-29T10:28:41Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: Link to Mount Shares Locally&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;&amp;quot;&amp;gt;&lt;br /&gt;
'''NEW:''' [http://code.google.com/p/greyhole/wiki/MigrateFromWHS Widows Home Server Drive Extender Migration Guide]&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
A new feature in Amahi is [[Storage pooling]] using [http://greyhole.pommepause.com/ Greyhole]. Storage Pooling is a technology to pool disk drives and make them look as if they were all part of a single pool of disk space.&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. First open your dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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]].&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
Also, touching anything inside the '''gh''' directories that Greyhole creates at the root of your partitions is a recipe for disaster.&lt;br /&gt;
&lt;br /&gt;
We [[Greyhole not on root | strongly discourage you from using the root partition in a drive pool]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
You need to go in the Settings tab, and enable '''Advanced Settings'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Without Advanced Settings enabled, you won't see the following page and options.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Partitions) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole options ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole advanced options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing the following file:&amp;lt;br/&amp;gt;&lt;br /&gt;
'''/var/hda/platform/html/config/greyhole.yml'''&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [http://greyhole.googlecode.com/svn/trunk/greyhole.example.conf sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
 sticky_files = Music/&lt;br /&gt;
 sticky_files = Videos/Movies/&lt;br /&gt;
     stick_into = /mnt/hdd1/gh&lt;br /&gt;
     stick_into = /mnt/hdd5/gh&lt;br /&gt;
 sticky_files = Backups/CrashPlan/&lt;br /&gt;
     stick_into = /mnt/hdd0/gh&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
 sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying you data into Greyhole shares the first time ==&lt;br /&gt;
&lt;br /&gt;
When you start using Greyhole, you might want to copy or move all your exiting files into your new shares that use the storage pool.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Once 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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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 nightly check move the files from there into the pool.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow [[Adding a second hard drive to your HDA|this guide]] to permanently mount your drives, before you include them in your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Disable Greyhole ==&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Perform the following steps as user '''root''':&lt;br /&gt;
&lt;br /&gt;
 chkconfig greyhole off&lt;br /&gt;
 remove /etc/monit.d/greyhole.conf&lt;br /&gt;
 service monit restart&lt;br /&gt;
 service greyhole stop&lt;br /&gt;
&lt;br /&gt;
'''DO NOT''' attempt to remove the Greyhole package as it is a dependency of the HDA software.  Doing so will break your HDA.&lt;br /&gt;
&lt;br /&gt;
= Testing and Reliability =&lt;br /&gt;
&lt;br /&gt;
Check out the [[Greyhole grinder]] to help make Greyhole rock solid.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18049</id>
		<title>Adding a second hard drive to your HDA</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18049"/>
		<updated>2010-08-30T00:33:51Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;More hard drives can be added in your Amahi HDA for additional storage space.&lt;br /&gt;
&lt;br /&gt;
We'll detail how to add such hard drives, and how to put them to good use.&lt;br /&gt;
&lt;br /&gt;
=Important Notes=&lt;br /&gt;
&lt;br /&gt;
* This is an how-to on how to add additional drives to your HDA.&lt;br /&gt;
* Amahi cannot be held responsible for any data breakage or destruction arising from the use or misuse of this script. We provide it as a service in good will. You accept this automatically if you use the script.&lt;br /&gt;
&lt;br /&gt;
=Make sure your drive is detected by Fedora=&lt;br /&gt;
&lt;br /&gt;
Open a Terminal, and type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Look for the line that match the hard drive you added.&lt;br /&gt;
&lt;br /&gt;
IDE and SATA hard drives will start with '''ata-''' and USB hard drives will start with '''usb-'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Look for your hard drive model and serial number.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST31000528AS_6VP08W65&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_3QD0LJN8&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_5QD27A57&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-WDC_WD10EADS-00L5B1_WD-WCAU4C700358&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST310003_33AS_9E1CA6FFFFFF-0:0&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST375064_0A_2009031309E2-0:0&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Install prerequisites=&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following (two) commands:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left&amp;quot;&amp;gt;&lt;br /&gt;
yum -y install pmount fuse fuse-libs ntfs-3g gparted util-linux-ng&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Partition and format the hard drive=&lt;br /&gt;
&lt;br /&gt;
This step is optional, and should only be executed if you want to delete the content of your new hard drive, or if the hard drive has not yet been formatted.&lt;br /&gt;
&lt;br /&gt;
You should (unless you have a good reason not to) use GParted to partition and format your hard drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
Not having X installed would qualify as a good reason! In such cases, either use SSH X11 Forwarding (Google that if you'd like to use this), or [[Adding_a_second_hard_drive_to_your_HDA#Using_cfdisk|use cfdisk]] from a [[Open Terminal as root|Terminal, as root]].&lt;br /&gt;
&lt;br /&gt;
You'll probably want to create a single partition, and format it as ''ext3''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that Windows can't read ext3 partitions, so if you want dual-boot Windows on your Amahi PC, or if you intend to connect this hard drive to a Windows computer later, you should format as NTFS instead, and you should do that on Windows before you connect the drive in your HDA.&amp;lt;br/&amp;gt;&lt;br /&gt;
Remember that using NTFS partitions on Linux will be slower that using ext3 partitions, so you should only use NTFS if you really need it.&amp;lt;br/&amp;gt;&lt;br /&gt;
How much slower: compare the blue bars (NTFS-3G) with the red bars (ext3) on [http://www.tuxera.com/products/tuxera-ntfs-commercial/performance/ this graph].&lt;br /&gt;
&lt;br /&gt;
To know what device (/dev/sdX) you need to partition and format, use the following command, in a [[Open Terminal as root|Terminal, as root]]:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -l /dev/disk/by-id/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Find the row corresponding to your hard drive, and look at the end of the line to identify the correct device to use.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ &amp;lt;strong&amp;gt;ls -l /dev/disk/by-id/&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
total 0&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V -&amp;gt; ../../sda&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root 10 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V-part1 -&amp;gt; ../../sda1&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-ST31000528AS_6VP08W65 -&amp;gt; ../../&amp;lt;strong&amp;gt;sdb&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted (or use on the cfdisk command). sda in my primary hard drive, and sdb my second hard drive.&lt;br /&gt;
&lt;br /&gt;
==Using GParted==&lt;br /&gt;
From the HDA desktop (or using VNC), [[Open Terminal as root]] and type '''gparted''' to launch the GParted application.&lt;br /&gt;
&lt;br /&gt;
Select the device (/dev/sdX) that you found above.&amp;lt;br/&amp;gt;&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted.&lt;br /&gt;
&lt;br /&gt;
There are many easy to follow guides online on how to use GParted. You should Google for one, to find one that seems clear to you.&amp;lt;br/&amp;gt;&lt;br /&gt;
[http://www.mepisguides.com/Mepis-6/Install/gparted/gparted-set-partition.html Here's one] that looks simple. Just use ext3 instead of fat32 in you follow that tutorial.&lt;br /&gt;
&lt;br /&gt;
==Using cfdisk==&lt;br /&gt;
From a [[Open Terminal as root|terminal, as root]], type '''cfdisk /dev/sdX''' to launch the cfdisk application.&lt;br /&gt;
&lt;br /&gt;
Make sure to replace /dev/sdX with the actual device (eg. /dev/sdb) that you found above.&lt;br /&gt;
&lt;br /&gt;
If your hard drive contains existing partitions, select them one by one at the top (using up/down arrow keys), then select the '''[ Delete ]''' action (using the left/right arrow keys), then hit ENTER.&lt;br /&gt;
&lt;br /&gt;
You should now only have Free Space listed at the top.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ New ]''' action, and accept the default (Primary, and size).&lt;br /&gt;
&lt;br /&gt;
You should now have a single partition listed at the top, of type Linux.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ Write ]''' action, then '''[ Quit ]'''.&lt;br /&gt;
&lt;br /&gt;
Now that you partitioned your drive, you need to format your newly created partition.&amp;lt;br/&amp;gt;&lt;br /&gt;
To format as EXT3, use this command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mkfs.ext3 -j /dev/sdX1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Replace ext3 with ext4 in the above command to format your partition as EXT4 instead of EXT3.&lt;br /&gt;
&lt;br /&gt;
'''/dev/sdX1''' in the above command refers to the partition your created in cfdisk.&amp;lt;br/&amp;gt;&lt;br /&gt;
Go back in cfdisk, and check the ''Name'' column if you're unsure.&amp;lt;br/&amp;gt;&lt;br /&gt;
If you see ''sdb1'' in the name column, you should use '''/dev/sdb1''' in the above command.&lt;br /&gt;
&lt;br /&gt;
=Mount the hard drive=&lt;br /&gt;
&lt;br /&gt;
A script is provided with Amahi that will look for unmounted partitions in your system, and mount any it finds.&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
hda-diskmount&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
[root@hda ~]$ hda-diskmount&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Ignoring /dev/sda1 - already in /etc/fstab or mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Mounted /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; as '&amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt;' (read-write)&amp;lt;br/&amp;gt;&lt;br /&gt;
	You may want your system to mount it every time you boot.&amp;lt;br/&amp;gt;&lt;br /&gt;
	To do so, add this line VERY CAREFULLY to /etc/fstab and reboot:&amp;lt;br/&amp;gt;&lt;br /&gt;
	&amp;lt;strong style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
All Linux, Windows and Mac partitions on non-removable disks have been mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do '''not''' edit /etc/fstab just yet. What you'll need to add there will depend on how you want to use the extra storage. More about that below.&amp;lt;br/&amp;gt;&lt;br /&gt;
Just note down the information in bold (green, red and blue). We'll use them below.&lt;br /&gt;
&lt;br /&gt;
Note about ext4 in the blue line above: that doesn't necessarily mean your partition is formatted as ext4. It means the ext4 driver will be used to mount your partition. Since that driver is backward compatible, it can be safely used to mount ext2, ext3 and ext4 partitions.&lt;br /&gt;
&lt;br /&gt;
If you get something like ''Disk /dev/dm-0 doesn't contain a valid partition table'' or ''mount: unknown file system type 'lvm2pv''' its because you have LVM's that 'fdisk' can not recognize (or something similar). It's nothing to worry about if you get that when executing the hda-diskmount script.&lt;br /&gt;
&lt;br /&gt;
==Test your hard drive==&lt;br /&gt;
Optionally, you can test your new drive for bad blocks.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that this step can take a ''long'' time to complete! You'll probably want to start it in the evening, to have it completed in the morning.&lt;br /&gt;
&lt;br /&gt;
To do so, [[Open Terminal as root|in a Terminal, as root]], type the following command. Replace &amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; with the (green) value you received from hda-diskmount.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
e2fsck -cn /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
You'll receive a warning that says &amp;quot;WARNING!!!  Running e2fsck on a mounted filesystem may cause SEVERE filesystem damage. Do you really want to continue (y/n)?&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
Answer ''yes''. The -cn option we're using can safely be used on mounted filesystems.&lt;br /&gt;
&lt;br /&gt;
=Use the hard drive=&lt;br /&gt;
&lt;br /&gt;
You have a choice here on how to use your new hard drive storage space. We'll offer some examples.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for all shares==&lt;br /&gt;
&lt;br /&gt;
If you want all your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move all you previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders.&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount.&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/* &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
You'll get a warning about &amp;quot;cannot move `/var/hda/files/drives' to a subdirectory of itself&amp;quot;; that is fine, ignore that.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to unmount your new hard drive, and remount it as /var/hda/files&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you (the blue one), and change the second value (the path).&amp;lt;br/&amp;gt;&lt;br /&gt;
Replace the second value with '''/var/hda/files'''.&lt;br /&gt;
&lt;br /&gt;
hda-diskmount gave me:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt; ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So I should add this instead:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files&amp;lt;/strong&amp;gt; ext4 defaults 1 2&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Make sure you do '''not''' change anything else from the blue line you received from hda-diskmount.&amp;lt;br/&amp;gt;&lt;br /&gt;
It might not be the same thing as the above example; you need to use the values you've received.&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. All your shares in /var/hda/files are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for only some shares==&lt;br /&gt;
&lt;br /&gt;
If you want only some of your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move your previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders (that you want on the new drive).&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount. Replace '''something''' with the name of the share you want to have on your new drive (the share should already exists).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/&amp;lt;strong&amp;gt;something&amp;lt;/strong&amp;gt; &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Repeat with every share you want on your new drive.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to make the mount permanent&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/drives/sdb1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. Your share(s) are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive in your Greyhole storage pool==&lt;br /&gt;
&lt;br /&gt;
If you want to add your new hard drive to your Greyhole storage pool, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll need to make the mount permanent. [[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Finally, you'll need to configure Greyhole to select your new partition.&lt;br /&gt;
&lt;br /&gt;
In the [http://hda/setup?sub=disk_pooling&amp;amp;tab=share Shares &amp;amp;gt; Storage Pool page] of your Amahi dashboard, you'll see a list of mounted partitions, with checkboxes next to each, allowing you to include those partitions in your storage pool.&lt;br /&gt;
&lt;br /&gt;
You should now have a new row in there, referring to /var/hda/files/drives/sdb1.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select it (click the checkbox).&lt;br /&gt;
&lt;br /&gt;
That's it. Your new hard drive just increased your Greyhole storage pool capacity.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18043</id>
		<title>Adding a second hard drive to your HDA</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18043"/>
		<updated>2010-08-29T19:17:24Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;More hard drives can be added in your Amahi HDA for additional storage space.&lt;br /&gt;
&lt;br /&gt;
We'll detail how to add such hard drives, and how to put them to good use.&lt;br /&gt;
&lt;br /&gt;
=Important Notes=&lt;br /&gt;
&lt;br /&gt;
* This is an how-to on how to add additional drives to your HDA.&lt;br /&gt;
* Amahi cannot be held responsible for any data breakage or destruction arising from the use or misuse of this script. We provide it as a service in good will. You accept this automatically if you use the script.&lt;br /&gt;
&lt;br /&gt;
=Make sure your drive is detected by Fedora=&lt;br /&gt;
&lt;br /&gt;
Open a Terminal, and type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Look for the line that match the hard drive you added.&lt;br /&gt;
&lt;br /&gt;
IDE and SATA hard drives will start with '''ata-''' and USB hard drives will start with '''usb-'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Look for your hard drive model and serial number.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST31000528AS_6VP08W65&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_3QD0LJN8&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_5QD27A57&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-WDC_WD10EADS-00L5B1_WD-WCAU4C700358&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST310003_33AS_9E1CA6FFFFFF-0:0&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST375064_0A_2009031309E2-0:0&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Install prerequisites=&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following (two) commands:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left&amp;quot;&amp;gt;&lt;br /&gt;
yum -y install pmount fuse fuse-libs ntfs-3g gparted util-linux-ng&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Partition and format the hard drive=&lt;br /&gt;
&lt;br /&gt;
This step is optional, and should only be executed if you want to delete the content of your new hard drive, or if the hard drive has not yet been formatted.&lt;br /&gt;
&lt;br /&gt;
You should (unless you have a good reason not to) use GParted to partition and format your hard drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
Not having X installed would qualify as a good reason! In such cases, either use SSH X11 Forwarding (Google that if you'd like to use this), or [[Adding_a_second_hard_drive_to_your_HDA#Using_cfdisk|use cfdisk]] from a [[Open Terminal as root|Terminal, as root]].&lt;br /&gt;
&lt;br /&gt;
You'll probably want to create a single partition, and format it as ''ext3''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that Windows can't read ext3 partitions, so if you want dual-boot Windows on your Amahi PC, or if you intend to connect this hard drive to a Windows computer later, you should format as NTFS instead, and you should do that on Windows before you connect the drive in your HDA.&amp;lt;br/&amp;gt;&lt;br /&gt;
Remember that using NTFS partitions on Linux will be slower that using ext3 partitions, so you should only use NTFS if you really need it.&amp;lt;br/&amp;gt;&lt;br /&gt;
How much slower: compare the blue bars (NTFS-3G) with the red bars (ext3) on [http://www.tuxera.com/products/tuxera-ntfs-commercial/performance/ this graph].&lt;br /&gt;
&lt;br /&gt;
To know what device (/dev/sdX) you need to partition and format, use the following command, in a [[Terminal, as root|Open Terminal as root]]:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -l /dev/disk/by-id/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Find the row corresponding to your hard drive, and look at the end of the line to identify the correct device to use.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ &amp;lt;strong&amp;gt;ls -l /dev/disk/by-id/&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
total 0&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V -&amp;gt; ../../sda&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root 10 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V-part1 -&amp;gt; ../../sda1&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-ST31000528AS_6VP08W65 -&amp;gt; ../../&amp;lt;strong&amp;gt;sdb&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted (or use on the cfdisk command). sda in my primary hard drive, and sdb my second hard drive.&lt;br /&gt;
&lt;br /&gt;
==Using GParted==&lt;br /&gt;
From the HDA desktop (or using VNC), [[Open Terminal as root]] and type '''gparted''' to launch the GParted application.&lt;br /&gt;
&lt;br /&gt;
Select the device (/dev/sdX) that you found above.&amp;lt;br/&amp;gt;&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted.&lt;br /&gt;
&lt;br /&gt;
There are many easy to follow guides online on how to use GParted. You should Google for one, to find one that seems clear to you.&amp;lt;br/&amp;gt;&lt;br /&gt;
[http://www.mepisguides.com/Mepis-6/Install/gparted/gparted-set-partition.html Here's one] that looks simple. Just use ext3 instead of fat32 in you follow that tutorial.&lt;br /&gt;
&lt;br /&gt;
==Using cfdisk==&lt;br /&gt;
From a [[Terminal, as root|Open Terminal as root]], type '''cfdisk /dev/sdX''' to launch the cfdisk application.&lt;br /&gt;
&lt;br /&gt;
Make sure to replace /dev/sdX with the actual device (eg. /dev/sdb) that you found above.&lt;br /&gt;
&lt;br /&gt;
If your hard drive contains existing partitions, select them one by one at the top (using up/down arrow keys), then select the '''[ Delete ]''' action (using the left/right arrow keys), then hit ENTER.&lt;br /&gt;
&lt;br /&gt;
You should now only have Free Space listed at the top.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ New ]''' action, and accept the default (Primary, and size).&lt;br /&gt;
&lt;br /&gt;
You should now have a single partition listed at the top, of type Linux.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ Write ]''' action, then '''[ Quit ]'''.&lt;br /&gt;
&lt;br /&gt;
Now that you partitioned your drive, you need to format your newly created partition.&amp;lt;br/&amp;gt;&lt;br /&gt;
To format as EXT3, use this command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mkfs.ext3 -j /dev/sdX1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Replace ext3 with ext4 in the above command to format your partition as EXT4 instead of EXT3.&lt;br /&gt;
&lt;br /&gt;
'''/dev/sdX1''' in the above command refers to the partition your created in cfdisk.&amp;lt;br/&amp;gt;&lt;br /&gt;
Go back in cfdisk, and check the ''Name'' column if you're unsure.&amp;lt;br/&amp;gt;&lt;br /&gt;
If you see ''sdb1'' in the name column, you should use '''/dev/sdb1''' in the above command.&lt;br /&gt;
&lt;br /&gt;
=Mount the hard drive=&lt;br /&gt;
&lt;br /&gt;
A script is provided with Amahi that will look for unmounted partitions in your system, and mount any it finds.&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
hda-diskmount&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
[root@hda ~]$ hda-diskmount&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Ignoring /dev/sda1 - already in /etc/fstab or mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Mounted /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; as '&amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt;' (read-write)&amp;lt;br/&amp;gt;&lt;br /&gt;
	You may want your system to mount it every time you boot.&amp;lt;br/&amp;gt;&lt;br /&gt;
	To do so, add this line VERY CAREFULLY to /etc/fstab and reboot:&amp;lt;br/&amp;gt;&lt;br /&gt;
	&amp;lt;strong style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
All Linux, Windows and Mac partitions on non-removable disks have been mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do '''not''' edit /etc/fstab just yet. What you'll need to add there will depend on how you want to use the extra storage. More about that below.&amp;lt;br/&amp;gt;&lt;br /&gt;
Just note down the information in bold (green, red and blue). We'll use them below.&lt;br /&gt;
&lt;br /&gt;
Note about ext4 in the blue line above: that doesn't necessarily mean your partition is formatted as ext4. It means the ext4 driver will be used to mount your partition. Since that driver is backward compatible, it can be safely used to mount ext2, ext3 and ext4 partitions.&lt;br /&gt;
&lt;br /&gt;
If you get something like ''Disk /dev/dm-0 doesn't contain a valid partition table'' or ''mount: unknown file system type 'lvm2pv''' its because you have LVM's that 'fdisk' can not recognize (or something similar). It's nothing to worry about if you get that when executing the hda-diskmount script.&lt;br /&gt;
&lt;br /&gt;
==Test your hard drive==&lt;br /&gt;
Optionally, you can test your new drive for bad blocks.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that this step can take a ''long'' time to complete! You'll probably want to start it in the evening, to have it completed in the morning.&lt;br /&gt;
&lt;br /&gt;
To do so, [[Open Terminal as root|in a Terminal, as root]], type the following command. Replace &amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; with the (green) value you received from hda-diskmount.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
e2fsck -cn /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
You'll receive a warning that says &amp;quot;WARNING!!!  Running e2fsck on a mounted filesystem may cause SEVERE filesystem damage. Do you really want to continue (y/n)?&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
Answer ''yes''. The -cn option we're using can safely be used on mounted filesystems.&lt;br /&gt;
&lt;br /&gt;
=Use the hard drive=&lt;br /&gt;
&lt;br /&gt;
You have a choice here on how to use your new hard drive storage space. We'll offer some examples.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for all shares==&lt;br /&gt;
&lt;br /&gt;
If you want all your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move all you previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders.&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount.&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/* &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
You'll get a warning about &amp;quot;cannot move `/var/hda/files/drives' to a subdirectory of itself&amp;quot;; that is fine, ignore that.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to unmount your new hard drive, and remount it as /var/hda/files&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you (the blue one), and change the second value (the path).&amp;lt;br/&amp;gt;&lt;br /&gt;
Replace the second value with '''/var/hda/files'''.&lt;br /&gt;
&lt;br /&gt;
hda-diskmount gave me:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt; ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So I should add this instead:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files&amp;lt;/strong&amp;gt; ext4 defaults 1 2&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Make sure you do '''not''' change anything else from the blue line you received from hda-diskmount.&amp;lt;br/&amp;gt;&lt;br /&gt;
It might not be the same thing as the above example; you need to use the values you've received.&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. All your shares in /var/hda/files are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for only some shares==&lt;br /&gt;
&lt;br /&gt;
If you want only some of your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move your previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders (that you want on the new drive).&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount. Replace '''something''' with the name of the share you want to have on your new drive (the share should already exists).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/&amp;lt;strong&amp;gt;something&amp;lt;/strong&amp;gt; &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Repeat with every share you want on your new drive.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to make the mount permanent&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/drives/sdb1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. Your share(s) are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive in your Greyhole storage pool==&lt;br /&gt;
&lt;br /&gt;
If you want to add your new hard drive to your Greyhole storage pool, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll need to make the mount permanent. [[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Finally, you'll need to configure Greyhole to select your new partition.&lt;br /&gt;
&lt;br /&gt;
In the [http://hda/setup?sub=disk_pooling&amp;amp;tab=share Shares &amp;amp;gt; Storage Pool page] of your Amahi dashboard, you'll see a list of mounted partitions, with checkboxes next to each, allowing you to include those partitions in your storage pool.&lt;br /&gt;
&lt;br /&gt;
You should now have a new row in there, referring to /var/hda/files/drives/sdb1.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select it (click the checkbox).&lt;br /&gt;
&lt;br /&gt;
That's it. Your new hard drive just increased your Greyhole storage pool capacity.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18037</id>
		<title>Adding a second hard drive to your HDA</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18037"/>
		<updated>2010-08-29T19:14:47Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;More hard drives can be added in your Amahi HDA for additional storage space.&lt;br /&gt;
&lt;br /&gt;
We'll detail how to add such hard drives, and how to put them to good use.&lt;br /&gt;
&lt;br /&gt;
=Important Notes=&lt;br /&gt;
&lt;br /&gt;
* This is an how-to on how to add additional drives to your HDA.&lt;br /&gt;
* Amahi cannot be held responsible for any data breakage or destruction arising from the use or misuse of this script. We provide it as a service in good will. You accept this automatically if you use the script.&lt;br /&gt;
&lt;br /&gt;
=Make sure your drive is detected by Fedora=&lt;br /&gt;
&lt;br /&gt;
Open a Terminal, and type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Look for the line that match the hard drive you added.&lt;br /&gt;
&lt;br /&gt;
IDE and SATA hard drives will start with '''ata-''' and USB hard drives will start with '''usb-'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Look for your hard drive model and serial number.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST31000528AS_6VP08W65&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_3QD0LJN8&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_5QD27A57&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-WDC_WD10EADS-00L5B1_WD-WCAU4C700358&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST310003_33AS_9E1CA6FFFFFF-0:0&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST375064_0A_2009031309E2-0:0&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Install prerequisites=&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following (two) commands:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left&amp;quot;&amp;gt;&lt;br /&gt;
yum -y install pmount fuse fuse-libs ntfs-3g gparted util-linux-ng&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Partition and format the hard drive=&lt;br /&gt;
&lt;br /&gt;
This step is optional, and should only be executed if you want to delete the content of your new hard drive, or if the hard drive has not yet been formatted.&lt;br /&gt;
&lt;br /&gt;
You should (unless you have a good reason not to) use GParted to partition and format your hard drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
Not having X installed would qualify as a good reason! In such cases, either use SSH X11 Forwarding (Google that if you'd like to use this), or [[Adding_a_second_hard_drive_to_your_HDA#Using_cfdisk|use cfdisk]] from a [[Open Terminal as root|Terminal, as root]].&lt;br /&gt;
&lt;br /&gt;
You'll probably want to create a single partition, and format it as ''ext3''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that Windows can't read ext3 partitions, so if you want dual-boot Windows on your Amahi PC, or if you intend to connect this hard drive to a Windows computer later, you should format as NTFS instead, and you should do that on Windows before you connect the drive in your HDA.&amp;lt;br/&amp;gt;&lt;br /&gt;
Remember that using NTFS partitions on Linux will be slower that using ext3 partitions, so you should only use NTFS if you really need it.&amp;lt;br/&amp;gt;&lt;br /&gt;
How much slower: compare the blue bars (NTFS-3G) with the red bars (ext3) on [http://www.tuxera.com/products/tuxera-ntfs-commercial/performance/ this graph].&lt;br /&gt;
&lt;br /&gt;
To know what device (/dev/sdX) you need to partition and format, use the following command, in a [[Terminal, as root|Open Terminal as root]]:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -l /dev/disk/by-id/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Find the row corresponding to your hard drive, and look at the end of the line to identify the correct device to use.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ &amp;lt;strong&amp;gt;ls -l /dev/disk/by-id/&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
total 0&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V -&amp;gt; ../../sda&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root 10 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V-part1 -&amp;gt; ../../sda1&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-ST31000528AS_6VP08W65 -&amp;gt; ../../&amp;lt;strong&amp;gt;sdb&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted (or use on the cfdisk command). sda in my primary hard drive, and sdb my second hard drive.&lt;br /&gt;
&lt;br /&gt;
==Using GParted==&lt;br /&gt;
From the HDA desktop (or using VNC), [[Open Terminal as root]] and type '''gparted''' to launch the GParted application.&lt;br /&gt;
&lt;br /&gt;
Select the device (/dev/sdX) that you found above.&amp;lt;br/&amp;gt;&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted.&lt;br /&gt;
&lt;br /&gt;
There are many easy to follow guides online on how to use GParted. You should Google for one, to find one that seems clear to you.&amp;lt;br/&amp;gt;&lt;br /&gt;
[http://www.mepisguides.com/Mepis-6/Install/gparted/gparted-set-partition.html Here's one] that looks simple. Just use ext3 instead of fat32 in you follow that tutorial.&lt;br /&gt;
&lt;br /&gt;
==Using cfdisk==&lt;br /&gt;
From a [[Terminal, as root|Open Terminal as root]], type '''cfdisk /dev/sdX''' to launch the cfdisk application.&lt;br /&gt;
&lt;br /&gt;
Make sure to replace /dev/sdX with the actual device (eg. /dev/sdb) that you found above.&lt;br /&gt;
&lt;br /&gt;
If your hard drive contains existing partitions, select them one by one at the top (using up/down arrow keys), then select the '''[ Delete ]''' action (using the left/right arrow keys), then hit ENTER.&lt;br /&gt;
&lt;br /&gt;
You should now only have Free Space listed at the top.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ New ]''' action, and accept the default (Primary, and size).&lt;br /&gt;
&lt;br /&gt;
You should now have a single partition listed at the top, of type Linux.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ Write ]''' action, then '''[ Quit ]'''.&lt;br /&gt;
&lt;br /&gt;
Now that you partitioned your drive, you need to format your newly created partition.&amp;lt;br/&amp;gt;&lt;br /&gt;
To format as EXT3, use this command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mkfs.ext3 -j /dev/sdX1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Replace ext3 with ext4 in the above command to format your partition as EXT4 instead of EXT3.&lt;br /&gt;
&lt;br /&gt;
'''/dev/sdX1''' in the above command refers to the partition your created in cfdisk.&amp;lt;br/&amp;gt;&lt;br /&gt;
Go back in cfdisk, and check the ''Name'' column if you're unsure.&amp;lt;br/&amp;gt;&lt;br /&gt;
If you see ''sdb1'' in the name column, you should use '''/dev/sdb1''' in the above command.&lt;br /&gt;
&lt;br /&gt;
=Mount the hard drive=&lt;br /&gt;
&lt;br /&gt;
A script is provided with Amahi that will look for unmounted partitions in your system, and mount any it finds.&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
hda-diskmount&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
[root@hda ~]$ hda-diskmount&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Ignoring /dev/sda1 - already in /etc/fstab or mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Mounted /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; as '&amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt;' (read-write)&amp;lt;br/&amp;gt;&lt;br /&gt;
	You may want your system to mount it every time you boot.&amp;lt;br/&amp;gt;&lt;br /&gt;
	To do so, add this line VERY CAREFULLY to /etc/fstab and reboot:&amp;lt;br/&amp;gt;&lt;br /&gt;
	&amp;lt;strong style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
All Linux, Windows and Mac partitions on non-removable disks have been mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do '''not''' edit /etc/fstab just yet. What you'll need to add there will depend on how you want to use the extra storage. More about that below.&amp;lt;br/&amp;gt;&lt;br /&gt;
Just note down the information in bold (green, red and blue). We'll use them below.&lt;br /&gt;
&lt;br /&gt;
If you get something like ''Disk /dev/dm-0 doesn't contain a valid partition table'' or ''mount: unknown file system type 'lvm2pv''' its because you have LVM's that 'fdisk' can not recognize (or something similar). It's nothing to worry about if you get that when executing the hda-diskmount script.&lt;br /&gt;
&lt;br /&gt;
==Test your hard drive==&lt;br /&gt;
Optionally, you can test your new drive for bad blocks.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that this step can take a ''long'' time to complete! You'll probably want to start it in the evening, to have it completed in the morning.&lt;br /&gt;
&lt;br /&gt;
To do so, [[Open Terminal as root|in a Terminal, as root]], type the following command. Replace &amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; with the (green) value you received from hda-diskmount.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
e2fsck -cn /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
You'll receive a warning that says &amp;quot;WARNING!!!  Running e2fsck on a mounted filesystem may cause SEVERE filesystem damage. Do you really want to continue (y/n)?&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
Answer ''yes''. The -cn option we're using can safely be used on mounted filesystems.&lt;br /&gt;
&lt;br /&gt;
=Use the hard drive=&lt;br /&gt;
&lt;br /&gt;
You have a choice here on how to use your new hard drive storage space. We'll offer some examples.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for all shares==&lt;br /&gt;
&lt;br /&gt;
If you want all your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move all you previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders.&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount.&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/* &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
You'll get a warning about &amp;quot;cannot move `/var/hda/files/drives' to a subdirectory of itself&amp;quot;; that is fine, ignore that.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to unmount your new hard drive, and remount it as /var/hda/files&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you (the blue one), and change the second value (the path).&amp;lt;br/&amp;gt;&lt;br /&gt;
Replace the second value with '''/var/hda/files'''.&lt;br /&gt;
&lt;br /&gt;
hda-diskmount gave me:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt; ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So I should add this instead:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files&amp;lt;/strong&amp;gt; ext4 defaults 1 2&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Make sure you do '''not''' change anything else from the blue line you received from hda-diskmount.&amp;lt;br/&amp;gt;&lt;br /&gt;
It might not be the same thing as the above example; you need to use the values you've received.&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. All your shares in /var/hda/files are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for only some shares==&lt;br /&gt;
&lt;br /&gt;
If you want only some of your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move your previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders (that you want on the new drive).&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount. Replace '''something''' with the name of the share you want to have on your new drive (the share should already exists).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/&amp;lt;strong&amp;gt;something&amp;lt;/strong&amp;gt; &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Repeat with every share you want on your new drive.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to make the mount permanent&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/drives/sdb1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. Your share(s) are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive in your Greyhole storage pool==&lt;br /&gt;
&lt;br /&gt;
If you want to add your new hard drive to your Greyhole storage pool, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll need to make the mount permanent. [[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Finally, you'll need to configure Greyhole to select your new partition.&lt;br /&gt;
&lt;br /&gt;
In the [http://hda/setup?sub=disk_pooling&amp;amp;tab=share Shares &amp;amp;gt; Storage Pool page] of your Amahi dashboard, you'll see a list of mounted partitions, with checkboxes next to each, allowing you to include those partitions in your storage pool.&lt;br /&gt;
&lt;br /&gt;
You should now have a new row in there, referring to /var/hda/files/drives/sdb1.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select it (click the checkbox).&lt;br /&gt;
&lt;br /&gt;
That's it. Your new hard drive just increased your Greyhole storage pool capacity.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18031</id>
		<title>Adding a second hard drive to your HDA</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Adding_a_second_hard_drive_to_your_HDA&amp;diff=18031"/>
		<updated>2010-08-29T19:12:00Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;More hard drives can be added in your Amahi HDA for additional storage space.&lt;br /&gt;
&lt;br /&gt;
We'll detail how to add such hard drives, and how to put them to good use.&lt;br /&gt;
&lt;br /&gt;
=Important Notes=&lt;br /&gt;
&lt;br /&gt;
* This is an how-to on how to add additional drives to your HDA.&lt;br /&gt;
* Amahi cannot be held responsible for any data breakage or destruction arising from the use or misuse of this script. We provide it as a service in good will. You accept this automatically if you use the script.&lt;br /&gt;
&lt;br /&gt;
=Make sure your drive is detected by Fedora=&lt;br /&gt;
&lt;br /&gt;
Open a Terminal, and type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Look for the line that match the hard drive you added.&lt;br /&gt;
&lt;br /&gt;
IDE and SATA hard drives will start with '''ata-''' and USB hard drives will start with '''usb-'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Look for your hard drive model and serial number.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ ls -1 /dev/disk/by-id/ | egrep -v &amp;quot;part|scsi&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST31000528AS_6VP08W65&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_3QD0LJN8&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-ST3750640A_5QD27A57&amp;lt;br/&amp;gt;&lt;br /&gt;
ata-WDC_WD10EADS-00L5B1_WD-WCAU4C700358&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST310003_33AS_9E1CA6FFFFFF-0:0&amp;lt;br/&amp;gt;&lt;br /&gt;
usb-ST375064_0A_2009031309E2-0:0&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Install prerequisites=&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following (two) commands:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left&amp;quot;&amp;gt;&lt;br /&gt;
yum -y install pmount fuse fuse-libs ntfs-3g gparted util-linux-ng&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=Partition and format the hard drive=&lt;br /&gt;
&lt;br /&gt;
This step is optional, and should only be executed if you want to delete the content of your new hard drive, or if the hard drive has not yet been formatted.&lt;br /&gt;
&lt;br /&gt;
You should (unless you have a good reason not to) use GParted to partition and format your hard drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
Not having X installed would qualify as a good reason! In such cases, either use SSH X11 Forwarding (Google that if you'd like to use this), or [[Adding_a_second_hard_drive_to_your_HDA#Using_cfdisk|use cfdisk]] from a [[Open Terminal as root|Terminal, as root]].&lt;br /&gt;
&lt;br /&gt;
You'll probably want to create a single partition, and format it as ''ext3''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that Windows can't read ext3 partitions, so if you want dual-boot Windows on your Amahi PC, or if you intend to connect this hard drive to a Windows computer later, you should format as NTFS instead, and you should do that on Windows before you connect the drive in your HDA.&amp;lt;br/&amp;gt;&lt;br /&gt;
Remember that using NTFS partitions on Linux will be slower that using ext3 partitions, so you should only use NTFS if you really need it.&amp;lt;br/&amp;gt;&lt;br /&gt;
How much slower: compare the blue bars (NTFS-3G) with the red bars (ext3) on [http://www.tuxera.com/products/tuxera-ntfs-commercial/performance/ this graph].&amp;lt;br/&amp;gt;&lt;br /&gt;
'''Be sure to read the [[Adding_a_second_hard_drive_to_your_HDA#NTFS_partitions|last section about NTFS]] on this page if you use a NTFS partition!'''&lt;br /&gt;
&lt;br /&gt;
To know what device (/dev/sdX) you need to partition and format, use the following command, in a [[Terminal, as root|Open Terminal as root]]:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
ls -l /dev/disk/by-id/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Find the row corresponding to your hard drive, and look at the end of the line to identify the correct device to use.&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
[gb@hda ~]$ &amp;lt;strong&amp;gt;ls -l /dev/disk/by-id/&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
total 0&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V -&amp;gt; ../../sda&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root 10 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V-part1 -&amp;gt; ../../sda1&amp;lt;br/&amp;gt;&lt;br /&gt;
lrwxrwxrwx 1 root root  9 2010-02-18 03:24 ata-ST31000528AS_6VP08W65 -&amp;gt; ../../&amp;lt;strong&amp;gt;sdb&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted (or use on the cfdisk command). sda in my primary hard drive, and sdb my second hard drive.&lt;br /&gt;
&lt;br /&gt;
==Using GParted==&lt;br /&gt;
From the HDA desktop (or using VNC), [[Open Terminal as root]] and type '''gparted''' to launch the GParted application.&lt;br /&gt;
&lt;br /&gt;
Select the device (/dev/sdX) that you found above.&amp;lt;br/&amp;gt;&lt;br /&gt;
In the above example, /dev/sdb would be what I would select in GParted.&lt;br /&gt;
&lt;br /&gt;
There are many easy to follow guides online on how to use GParted. You should Google for one, to find one that seems clear to you.&amp;lt;br/&amp;gt;&lt;br /&gt;
[http://www.mepisguides.com/Mepis-6/Install/gparted/gparted-set-partition.html Here's one] that looks simple. Just use ext3 instead of fat32 in you follow that tutorial.&lt;br /&gt;
&lt;br /&gt;
==Using cfdisk==&lt;br /&gt;
From a [[Terminal, as root|Open Terminal as root]], type '''cfdisk /dev/sdX''' to launch the cfdisk application.&lt;br /&gt;
&lt;br /&gt;
Make sure to replace /dev/sdX with the actual device (eg. /dev/sdb) that you found above.&lt;br /&gt;
&lt;br /&gt;
If your hard drive contains existing partitions, select them one by one at the top (using up/down arrow keys), then select the '''[ Delete ]''' action (using the left/right arrow keys), then hit ENTER.&lt;br /&gt;
&lt;br /&gt;
You should now only have Free Space listed at the top.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ New ]''' action, and accept the default (Primary, and size).&lt;br /&gt;
&lt;br /&gt;
You should now have a single partition listed at the top, of type Linux.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select the '''[ Write ]''' action, then '''[ Quit ]'''.&lt;br /&gt;
&lt;br /&gt;
Now that you partitioned your drive, you need to format your newly created partition.&amp;lt;br/&amp;gt;&lt;br /&gt;
To format as EXT3, use this command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mkfs.ext3 -j /dev/sdX1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Replace ext3 with ext4 in the above command to format your partition as EXT4 instead of EXT3.&lt;br /&gt;
&lt;br /&gt;
'''/dev/sdX1''' in the above command refers to the partition your created in cfdisk.&amp;lt;br/&amp;gt;&lt;br /&gt;
Go back in cfdisk, and check the ''Name'' column if you're unsure.&amp;lt;br/&amp;gt;&lt;br /&gt;
If you see ''sdb1'' in the name column, you should use '''/dev/sdb1''' in the above command.&lt;br /&gt;
&lt;br /&gt;
=Mount the hard drive=&lt;br /&gt;
&lt;br /&gt;
A script is provided with Amahi that will look for unmounted partitions in your system, and mount any it finds.&lt;br /&gt;
&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
hda-diskmount&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Example:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
[root@hda ~]$ hda-diskmount&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Ignoring /dev/sda1 - already in /etc/fstab or mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
Mounted /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; as '&amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt;' (read-write)&amp;lt;br/&amp;gt;&lt;br /&gt;
	You may want your system to mount it every time you boot.&amp;lt;br/&amp;gt;&lt;br /&gt;
	To do so, add this line VERY CAREFULLY to /etc/fstab and reboot:&amp;lt;br/&amp;gt;&lt;br /&gt;
	&amp;lt;strong style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/strong&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;nowiki&amp;gt;****************************************************************&amp;lt;/nowiki&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
All Linux, Windows and Mac partitions on non-removable disks have been mounted&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do '''not''' edit /etc/fstab just yet. What you'll need to add there will depend on how you want to use the extra storage. More about that below.&amp;lt;br/&amp;gt;&lt;br /&gt;
Just note down the information in bold (green, red and blue). We'll use them below.&lt;br /&gt;
&lt;br /&gt;
If you get something like ''Disk /dev/dm-0 doesn't contain a valid partition table'' or ''mount: unknown file system type 'lvm2pv''' its because you have LVM's that 'fdisk' can not recognize (or something similar). It's nothing to worry about if you get that when executing the hda-diskmount script.&lt;br /&gt;
&lt;br /&gt;
==Test your hard drive==&lt;br /&gt;
Optionally, you can test your new drive for bad blocks.&amp;lt;br/&amp;gt;&lt;br /&gt;
Note that this step can take a ''long'' time to complete! You'll probably want to start it in the evening, to have it completed in the morning.&lt;br /&gt;
&lt;br /&gt;
To do so, [[Open Terminal as root|in a Terminal, as root]], type the following command. Replace &amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt; with the (green) value you received from hda-diskmount.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
e2fsck -cn /dev/&amp;lt;strong style=&amp;quot;color:green&amp;quot;&amp;gt;sdb1&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
You'll receive a warning that says &amp;quot;WARNING!!!  Running e2fsck on a mounted filesystem may cause SEVERE filesystem damage. Do you really want to continue (y/n)?&amp;quot;&amp;lt;br/&amp;gt;&lt;br /&gt;
Answer ''yes''. The -cn option we're using can safely be used on mounted filesystems.&lt;br /&gt;
&lt;br /&gt;
=Use the hard drive=&lt;br /&gt;
&lt;br /&gt;
You have a choice here on how to use your new hard drive storage space. We'll offer some examples.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for all shares==&lt;br /&gt;
&lt;br /&gt;
If you want all your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move all you previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders.&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount.&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/* &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
You'll get a warning about &amp;quot;cannot move `/var/hda/files/drives' to a subdirectory of itself&amp;quot;; that is fine, ignore that.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to unmount your new hard drive, and remount it as /var/hda/files&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you (the blue one), and change the second value (the path).&amp;lt;br/&amp;gt;&lt;br /&gt;
Replace the second value with '''/var/hda/files'''.&lt;br /&gt;
&lt;br /&gt;
hda-diskmount gave me:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color:blue&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files/drives/sdb1&amp;lt;/strong&amp;gt; ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So I should add this instead:&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
UUID=9d972abc-1639-44df-a60e-668618d40236 &amp;lt;strong&amp;gt;/var/hda/files&amp;lt;/strong&amp;gt; ext4 defaults 1 2&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Make sure you do '''not''' change anything else from the blue line you received from hda-diskmount.&amp;lt;br/&amp;gt;&lt;br /&gt;
It might not be the same thing as the above example; you need to use the values you've received.&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. All your shares in /var/hda/files are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive for only some shares==&lt;br /&gt;
&lt;br /&gt;
If you want only some of your shares to be on your new hard drive, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll want to move your previous shares data, if any, into your new drive.&amp;lt;br/&amp;gt;&lt;br /&gt;
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders (that you want on the new drive).&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount. Replace '''something''' with the name of the share you want to have on your new drive (the share should already exists).&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mv /var/hda/files/&amp;lt;strong&amp;gt;something&amp;lt;/strong&amp;gt; &amp;lt;strong style=&amp;quot;color:red&amp;quot;&amp;gt;/var/hda/files/drives/sdb1/&amp;lt;/strong&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Repeat with every share you want on your new drive.&lt;br /&gt;
&lt;br /&gt;
Next, you'll need to make the mount permanent&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&amp;lt;br/&amp;gt;&lt;br /&gt;
ls /var/hda/files/drives/sdb1&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That last command should show you the content of you new hard drive.&lt;br /&gt;
&lt;br /&gt;
That's it. Your share(s) are now on your new hard drive.&lt;br /&gt;
&lt;br /&gt;
==Use the hard drive in your Greyhole storage pool==&lt;br /&gt;
&lt;br /&gt;
If you want to add your new hard drive to your Greyhole storage pool, here's how to do that.&lt;br /&gt;
&lt;br /&gt;
First, you'll need to make the mount permanent. [[Open Terminal as root|In a Terminal, as root]], type the following command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
umount /var/hda/files/drives/sdb1&amp;lt;br/&amp;gt;&lt;br /&gt;
nano /etc/fstab&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So, following previous examples, I should add this:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2&amp;lt;/span&amp;gt;&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;&amp;quot;&amp;gt;&lt;br /&gt;
mount -a&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Finally, you'll need to configure Greyhole to select your new partition.&lt;br /&gt;
&lt;br /&gt;
In the [http://hda/setup?sub=disk_pooling&amp;amp;tab=share Shares &amp;amp;gt; Storage Pool page] of your Amahi dashboard, you'll see a list of mounted partitions, with checkboxes next to each, allowing you to include those partitions in your storage pool.&lt;br /&gt;
&lt;br /&gt;
You should now have a new row in there, referring to /var/hda/files/drives/sdb1.&amp;lt;br/&amp;gt;&lt;br /&gt;
Select it (click the checkbox).&lt;br /&gt;
&lt;br /&gt;
That's it. Your new hard drive just increased your Greyhole storage pool capacity.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Shares_troubleshooting&amp;diff=17785</id>
		<title>Shares troubleshooting</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Shares_troubleshooting&amp;diff=17785"/>
		<updated>2010-08-24T17:27:31Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Access Problems ==&lt;br /&gt;
&lt;br /&gt;
Access issues are caused by one or two things, in order: Windows (SMB/Samba) access (domain works, username works), and Linux permissions access&lt;br /&gt;
&lt;br /&gt;
So, to diagnose things, make sure you can login first from your client operating system, and then if that works, make sure you can access the files you are interested in from Linux.&lt;br /&gt;
&lt;br /&gt;
* First make sure that '''your workgroup or samba domain match between your HDA and your clients'''. For your HDA's workgroup/domain, go to Setup -&amp;gt; Settings and turn on advanced settings, after that, go to Shares -&amp;gt; Settings and check the workgroup name. If the DNS domain is home.com, the workgroup will be just home.&lt;br /&gt;
* If only one user can access or write in your shares, and your shares are in a subdirectory of /media, you'll need to unmount your drive from /media, and re-mount it using the instructions found here: [[Adding_a_second_hard_drive_to_your_HDA|How to add additional hard drives in your HDA]].&lt;br /&gt;
* In at least Windows 7, we have observed that the operating system tries to use a &amp;quot;Domain&amp;quot; of the name of the computer, which is wrong! Try typing this in the Username field:&lt;br /&gt;
       YOURWORKGROUP\username&lt;br /&gt;
So, if your username is jdoe and the workgroup is HOME, try HOME\jdoe&lt;br /&gt;
* Some windows clients for some reason may require the whole DNS path, so if your internal domain is, say, home.com, try:&lt;br /&gt;
            \\hda.home.com&lt;br /&gt;
* Make sure the user has permissions to at least read the share (of course) in the Shares area of your HDA&lt;br /&gt;
* Check the Credential manager under Control Panel: Control Panel -&amp;gt; Al Control Panel Items -&amp;gt; Credential Manager: See this [http://forums.amahi.org/viewtopic.php?f=4&amp;amp;t=964&amp;amp;start=11 thread in the forums].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Permission Problems ==&lt;br /&gt;
&lt;br /&gt;
If you cannot write to the shares, there are two things to check.&lt;br /&gt;
&lt;br /&gt;
* Permissions at the SAMBA level&lt;br /&gt;
* Permissions at the Linux level&lt;br /&gt;
&lt;br /&gt;
At the SAMBA level, check Setup -&amp;gt; Shares. Make sure the user has access to the share you are looking at.&lt;br /&gt;
&lt;br /&gt;
At the Linux level, you have to ssh into your HDA or login at the console and try to write a file in to the folder for the share (typically in /var/hda/files/FOO, if you did not change the default path).&lt;br /&gt;
&lt;br /&gt;
== Further Debugging ==&lt;br /&gt;
&lt;br /&gt;
For actual debugging, follow the details of the [[Shares Debug]] page.&lt;br /&gt;
&lt;br /&gt;
== Other ==&lt;br /&gt;
&lt;br /&gt;
NOTE: we used to have a bug in [[Amahi 5.0]] where users that use ANY capital letters were not created properly. Please stick to users with all lowercase letters. This was fixed in [[Amahi 5.1]].&lt;br /&gt;
&lt;br /&gt;
(This appears to be a problem in shadow-utils in Fedora. For status, see Amahi bug [http://bugs.amahi.org/issues/show/395 395] and Fedora bug [https://bugzilla.redhat.com/show_bug.cgi?id=550732 550732].)&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=17713</id>
		<title>Greyhole</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Greyhole&amp;diff=17713"/>
		<updated>2010-08-23T11:35:11Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Category:apps]]&lt;br /&gt;
== What is Greyhole ==&lt;br /&gt;
&lt;br /&gt;
A new feature in Amahi is [[Storage pooling]] using [http://greyhole.pommepause.com/ Greyhole].&lt;br /&gt;
&lt;br /&gt;
This feature is installed by default, but requires a few simple steps to begin utilizing the features.&lt;br /&gt;
&lt;br /&gt;
You can add additional drives to your hda and prepare them for use in Greyhole by following [[Adding a second hard drive to your HDA|this tutorial]].&lt;br /&gt;
&lt;br /&gt;
To add a drive to your Greyhole storage pool. First open your dashboard and navigate to the Shares tab. Then click on the Storage Pool sub-category. You will see a page similar to the one below.&lt;br /&gt;
&lt;br /&gt;
== Important Warnings ==&lt;br /&gt;
&amp;lt;div style=&amp;quot;color:darkred&amp;quot;&amp;gt;You should '''never''' 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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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/'').&lt;br /&gt;
&lt;br /&gt;
Also, touching anything inside the '''gh''' directories that Greyhole creates at the root of your partitions is a recipe for disaster.&lt;br /&gt;
&lt;br /&gt;
We [[Greyhole not on root | strongly discourage you from using the root partition in a drive pool]].&lt;br /&gt;
&amp;lt;/div&amp;gt;&amp;lt;br/&amp;gt;&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== First things first ==&lt;br /&gt;
&lt;br /&gt;
You need to go in the Settings tab, and enable '''Advanced Settings'''.&amp;lt;br/&amp;gt;&lt;br /&gt;
Without Advanced Settings enabled, you won't see the following page and options.&lt;br /&gt;
&lt;br /&gt;
== For Storage Pool (Partitions) ==&lt;br /&gt;
&lt;br /&gt;
[[File:Storage_Pool_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Select the drives you want available for your storage pool.&lt;br /&gt;
&lt;br /&gt;
== Greyhole options ==&lt;br /&gt;
&lt;br /&gt;
The next step is to select the share you want to replicate across the pool.&lt;br /&gt;
&lt;br /&gt;
From the Shares tab, select the Shares sub-catagory. We chose the Pictures share for this tutorial.&lt;br /&gt;
&lt;br /&gt;
[[File:Greyhole_Options_1.png|600px|thumb|left]]&lt;br /&gt;
&lt;br /&gt;
Check the option for &amp;quot;Uses pool&amp;quot; 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.&lt;br /&gt;
&lt;br /&gt;
Note: Greyhole is not a backup solution. If a file is removed, all copies are removed.&lt;br /&gt;
&lt;br /&gt;
== Greyhole advanced options ==&lt;br /&gt;
&lt;br /&gt;
You can further configure Greyhole by manually editing the following file:&amp;lt;br/&amp;gt;&lt;br /&gt;
'''/var/hda/platform/html/config/greyhole.yml'''&lt;br /&gt;
&lt;br /&gt;
To see what options are available, and what they do, refer to the [http://greyhole.googlecode.com/svn/trunk/greyhole.example.conf sample greyhole.conf] provided with Greyhole.&lt;br /&gt;
&lt;br /&gt;
greyhole.yml is in in YAML format. Most of it should be easy enough to modify. The only exception would be the sticky_files (and optional sticky_into) options.&amp;lt;br/&amp;gt;&lt;br /&gt;
Here's an example of how those should appear:&lt;br /&gt;
&lt;br /&gt;
To specify the following to Greyhole in greyhole.conf:&lt;br /&gt;
&lt;br /&gt;
 sticky_files = Music/&lt;br /&gt;
 sticky_files = Videos/Movies/&lt;br /&gt;
     stick_into = /mnt/hdd1/gh&lt;br /&gt;
     stick_into = /mnt/hdd5/gh&lt;br /&gt;
 sticky_files = Backups/CrashPlan/&lt;br /&gt;
     stick_into = /mnt/hdd0/gh&lt;br /&gt;
&lt;br /&gt;
one should specify this in the greyhole.yml file, where '''precise indentation matters''':&lt;br /&gt;
&lt;br /&gt;
 sticky_files: &lt;br /&gt;
 - - Music/&lt;br /&gt;
 - - Videos/Movies/&lt;br /&gt;
   - - /mnt/hdd1/gh&lt;br /&gt;
     - /mnt/hdd5/gh&lt;br /&gt;
 - - Backups/CrashPlan/&lt;br /&gt;
   - - /mnt/hdd0/gh&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Copying you data into Greyhole shares the first time ==&lt;br /&gt;
&lt;br /&gt;
When you start using Greyhole, you might want to copy or move all your exiting files into your new shares that use the storage pool.&lt;br /&gt;
&lt;br /&gt;
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.&amp;lt;br/&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Once 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.&lt;br /&gt;
This can be time consuming, but it is the safest way to use Greyhole.&lt;br /&gt;
&lt;br /&gt;
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 nightly check move the files from there into the pool.&lt;br /&gt;
&lt;br /&gt;
Here's a more detailed walkthrough for this method:&lt;br /&gt;
&lt;br /&gt;
# Setup the Greyhole Storage Pool in the Amahi dashboard, Shares &amp;gt; Storage Pool page.&lt;br /&gt;
# Go in the Shares &amp;gt; 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.&lt;br /&gt;
# 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''&lt;br /&gt;
# Enable the ''Uses pool'' option for each of your shares, and select the number of extra copies you'd like, if any.&lt;br /&gt;
# 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&lt;br /&gt;
# Monitor /var/log/greyhole.log to see when the ''fsck'' operation is done.&lt;br /&gt;
# Once ''fsck'' is done, your data has now been moved into the Greyhole storage pool (in the drives you selected in Shares &amp;gt; 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).&lt;br /&gt;
# Move all those directories / symlinks from there into the correct folders in /var/hda/files/share_name&lt;br /&gt;
# 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).&lt;br /&gt;
# 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''&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== /media ==&lt;br /&gt;
Including any drive mounted as /media/Something in your storage pool is usually a bad idea.&amp;lt;br/&amp;gt;&lt;br /&gt;
Those mounts are created by the ''gnome-automounter'', which requires you to be logged in into X (Gnome) to become available.&amp;lt;br/&amp;gt;&lt;br /&gt;
This will create issues with Greyhole, which expects drives to always be available, and will take action when some of them are missing.&lt;br /&gt;
&lt;br /&gt;
Follow [[Adding a second hard drive to your HDA|this guide]] to permanently mount your drives, before you include them in your storage pool.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=File:Colorus-Amahi-Theme.png&amp;diff=17017</id>
		<title>File:Colorus-Amahi-Theme.png</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=File:Colorus-Amahi-Theme.png&amp;diff=17017"/>
		<updated>2010-08-12T00:12:17Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=User_talk:Gboudreau&amp;diff=16471</id>
		<title>User talk:Gboudreau</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=User_talk:Gboudreau&amp;diff=16471"/>
		<updated>2010-08-04T21:38:32Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Vote for one (or two, or three):&lt;br /&gt;
&lt;br /&gt;
Which of those should become an Amahi theme ?&lt;br /&gt;
&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/1/1633/?KeepThis=true&amp;amp; 1633] -- 1 vote&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/1/1117/?KeepThis=true&amp;amp; 1117] -- 2 votes&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/1/1182/?KeepThis=true&amp;amp; 1182]&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/1/1249/?KeepThis=true&amp;amp; 1249] -- 4 votes DONE: http://www.amahi.org/apps/colorus-theme&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/1/1537/?KeepThis=true&amp;amp; 1537] -- 3 votes&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/0/859/?KeepThis=true&amp;amp; 859]&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/0/904/?KeepThis=true&amp;amp; 904] -- 2 votes&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/0/962/?KeepThis=true&amp;amp; 962] -- 2 votes&lt;br /&gt;
* [http://www.opendesigns.org/od/wp-content/designs/0/771/?KeepThis=true&amp;amp; 771]&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=File:Colorus-Theme-sshot.png&amp;diff=16459</id>
		<title>File:Colorus-Theme-sshot.png</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=File:Colorus-Theme-sshot.png&amp;diff=16459"/>
		<updated>2010-08-04T19:55:00Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: uploaded a new version of &amp;quot;File:Colorus-Theme-sshot.png&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=File:Colorus-theme-thumb.png&amp;diff=16453</id>
		<title>File:Colorus-theme-thumb.png</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=File:Colorus-theme-thumb.png&amp;diff=16453"/>
		<updated>2010-08-04T19:54:48Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=File:Colorus-Theme-sshot.png&amp;diff=16447</id>
		<title>File:Colorus-Theme-sshot.png</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=File:Colorus-Theme-sshot.png&amp;diff=16447"/>
		<updated>2010-08-04T19:49:37Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Amahi_Plug_Edition&amp;diff=16441</id>
		<title>Amahi Plug Edition</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Amahi_Plug_Edition&amp;diff=16441"/>
		<updated>2010-08-04T19:16:25Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;How to run Amahi on your Plug Computer!&lt;br /&gt;
&lt;br /&gt;
= Supported devices =&lt;br /&gt;
&lt;br /&gt;
* [http://en.wikipedia.org/wiki/SheevaPlug SheevaPlug]&lt;br /&gt;
* [http://www.globalscaletechnologies.com/t-guruplugdetails.aspx GuruPlug]&lt;br /&gt;
* Jailbroken [http://www.pogoplug.com/ Pogoplug]&lt;br /&gt;
* Jailbroken [http://www.seagate.com/www/en-us/products/network_storage/freeagent_dockstar/ DockStar]&lt;br /&gt;
* Any other device based on the [http://plugcomputer.org Marvell Plug Computer]&lt;br /&gt;
&lt;br /&gt;
= Requirements =&lt;br /&gt;
&lt;br /&gt;
You'll need:&lt;br /&gt;
* A storage device, of 2GB or more, that your plug computer can boot from.&lt;br /&gt;
* The latest Amahi ''rootfs'' from http://dl.amahi.org/marvell/ - look for the latest file named '''amahi-marvell-*.tar.bz2'''&lt;br /&gt;
* The script to copy the above ''rootfs'' into your storage device: http://dl.amahi.org/marvell/create-clean-f12-disk.sh&lt;br /&gt;
&lt;br /&gt;
= Known issues =&lt;br /&gt;
&lt;br /&gt;
For a list of working / not working apps for plug computers, see [[SP Apps|this page]]. Also, please check (and file) any issues in the [http://bugs.amahi.org/projects/show/plug Amahi bug tracker project for the Plug port]&lt;br /&gt;
&lt;br /&gt;
= Quick Overview =&lt;br /&gt;
&lt;br /&gt;
There are three major steps in getting things going&lt;br /&gt;
&lt;br /&gt;
'''Step 1:''' Download and extract the [http://dl.amahi.org/marvell/ Amahi ''rootfs'' image] into an empty USB hard drive, USB flash drive, or SD card (depending on what your device supports), formatted as ext3.&lt;br /&gt;
&lt;br /&gt;
'''Step 2:''' Boot your device using the drive or card you created in step 1.&lt;br /&gt;
&lt;br /&gt;
'''Step 3:''' Install Amahi, by loading http://plug_ip:2000 and entering the install code you got when you [https://www.amahi.org/user created your Amahi profile].&lt;br /&gt;
&lt;br /&gt;
= Detailed Installation Instructions =&lt;br /&gt;
&lt;br /&gt;
== Step 1: Prepare your boot device ==&lt;br /&gt;
&lt;br /&gt;
Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine (you can use your plug computer!)&amp;lt;br/&amp;gt;&lt;br /&gt;
If needed, partition your device to create a partition you'll use to boot. No need to format it.&amp;lt;br/&amp;gt;&lt;br /&gt;
If a swap partition is desired (highly recommended for the PogoPlug &amp;amp; DockStar), create a second partition on your storage device, between 512MB and 2GB (depending on how big your storage device is), and format it as ''Linux Swap''.&lt;br /&gt;
&lt;br /&gt;
Example partitioning depending on your boot device type &amp;amp; size:&lt;br /&gt;
{| cellpadding=&amp;quot;7&amp;quot;&lt;br /&gt;
! 2GB Flash Drive&amp;lt;br/&amp;gt;or SD Card&lt;br /&gt;
! 8GB Flash Drive&amp;lt;br/&amp;gt;or SD Card&lt;br /&gt;
! 16GB Flash Drive&amp;lt;br/&amp;gt;or SD Card&lt;br /&gt;
! USB Hard Drive&amp;lt;br/&amp;gt;(40+ GB)&lt;br /&gt;
|-&lt;br /&gt;
|2GB, unformatted&lt;br /&gt;
|512MB, Linux Swap&amp;lt;br/&amp;gt;7.5GB, unformatted&lt;br /&gt;
|1GB, Linux Swap&amp;lt;br/&amp;gt;15GB, unformatted&lt;br /&gt;
|2GB, Linux Swap&amp;lt;br/&amp;gt;The rest, unformatted&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Download the Amahi ''rootfs'' file and ''create-clean-f12-disk.sh'' script into your Linux machine. Don't store them on the storage device you want to use on your plug computer.&amp;lt;br/&amp;gt;&lt;br /&gt;
Edit the ''create-clean-f12-disk.sh'' script:&lt;br /&gt;
* Change the first line, the one that says '''partition=&amp;quot;...&amp;quot;''' to point to the partition you want to use to boot your plug computer.&amp;lt;br/&amp;gt;If you're not sure, '''ls -l /dev/disk/by-id/''' and see if you can find it there.&lt;br /&gt;
* Change the second line, if needed. It should contain the name of the Amahi ''rootfs'' file you downloaded. Example: '''rootfs=&amp;quot;amahi-marvell-0.8.tar.bz2&amp;quot;'''&lt;br /&gt;
* Comment (add a # character at the beginning of) the two following lines, the ones that say '''echo &amp;quot;Please edit this script...''' and '''exit 0'''.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot; style=&amp;quot;font-weight: bold&amp;quot;&amp;gt;Big Warning! Putting the wrong partition in this script will completely erase that partition! Be careful what partition you target!&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Run the ''create-clean-f12-disk.sh'' script: '''bash create-clean-f12-disk.sh'''&lt;br /&gt;
 &lt;br /&gt;
== Step 2: Boot your plug ==&lt;br /&gt;
&lt;br /&gt;
Boot the plug computer with your newly created drive/card attached.  Give it a few minutes to boot, and it will be ready for the Amahi installation.&lt;br /&gt;
&lt;br /&gt;
If you need help getting your plug computer to boot from USB or SD, instead of the on-board Flash memory, see our [[Marvell Plug Computer Booting]] page.&lt;br /&gt;
&lt;br /&gt;
== Step 3: Install Amahi ==&lt;br /&gt;
&lt;br /&gt;
Note that for this step to work correctly, your plug computer needs to have access to Internet. Maybe you can just SSH into it, and ping www.amahi.org to make sure it works.&lt;br /&gt;
&lt;br /&gt;
Find the plug computer IP address (check your DHCP server), and launch the Amahi installer by visiting http://plug_computer_ip:2000&lt;br /&gt;
&lt;br /&gt;
(Use nmap or ping -b to find new devices on your LAN, if you can't find your plug computer IP address on your DHCP server.)&lt;br /&gt;
&lt;br /&gt;
It will ask for an install code. That code can be obtained by creating an Amahi profile here: https://www.amahi.org/user (you'll need to create an account first, if you don't already have one).&lt;br /&gt;
&lt;br /&gt;
== Enjoy ==&lt;br /&gt;
&lt;br /&gt;
Access your HDA by logging in at http://plug_computer_ip&amp;lt;br/&amp;gt;&lt;br /&gt;
Username: admin&amp;lt;br/&amp;gt;&lt;br /&gt;
Password: amahi&lt;br /&gt;
&lt;br /&gt;
The root password is: amahi&amp;lt;br/&amp;gt;&lt;br /&gt;
(Change it!)&lt;br /&gt;
&lt;br /&gt;
If all seems to work, you can now disable your old DHCP server, and let your plug computer act as your new DHCP server.&amp;lt;br/&amp;gt;&lt;br /&gt;
You'll need to [[RenewIP|renew the IP address]] of your client computers, once your old DHCP server is disabled.&amp;lt;br/&amp;gt;&lt;br /&gt;
You'll then be able to access the Amahi dashboard at http://hda, and your installed apps using http://app_name&lt;br /&gt;
&lt;br /&gt;
If you created a swap partition while partitioning your storage device, you might need to tell Amahi to use that partition for swap space. You'll need to change '''/dev/sda2''' for the real path to your swap partition. SSH into your Amahi server, and execute the following:&lt;br /&gt;
 mkswap /dev/sda2&lt;br /&gt;
 swapon -a&lt;br /&gt;
&lt;br /&gt;
Note: On the SheevaPlug, the onboard NAND flash is called /dev/mtdblock2. You might want to use it as a swap partition, as it would be faster than your SD card or USB drive.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=User_talk:Gboudreau&amp;diff=16369</id>
		<title>User talk:Gboudreau</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=User_talk:Gboudreau&amp;diff=16369"/>
		<updated>2010-08-03T20:09:05Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: Created page with 'Vote for one (or two, or three):  Which of those should become an Amahi theme ?  http://www.opendesigns.org/od/wp-content/designs/1/1633/?KeepThis=true&amp;amp;  http://www.opendesigns.o…'&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Vote for one (or two, or three):&lt;br /&gt;
&lt;br /&gt;
Which of those should become an Amahi theme ?&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/1/1633/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/1/1117/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/1/1182/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/1/1249/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/1/1537/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/0/859/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/0/904/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/0/962/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
http://www.opendesigns.org/od/wp-content/designs/0/771/?KeepThis=true&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Current votes:&lt;br /&gt;
* 1249 = 1 vote&lt;br /&gt;
* 904 = 1 vote&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Plug_warboard&amp;diff=16345</id>
		<title>Plug warboard</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Plug_warboard&amp;diff=16345"/>
		<updated>2010-08-03T17:47:41Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;For installation notes, etc. see [[SP notes]].&lt;br /&gt;
&lt;br /&gt;
When you note a problem, please indicate what version you're running (0.2, 0.3, ...)&lt;br /&gt;
&lt;br /&gt;
= Warboard =&lt;br /&gt;
&lt;br /&gt;
* VPN works. the date needs to be set to something recent:&lt;br /&gt;
         date --set 'Thu May 27 16:44:57 EDT 2010'&lt;br /&gt;
         hwclock --systohc --utc&lt;br /&gt;
* tar and unzip need to be in the image:&lt;br /&gt;
         yum -y install tar unzip&lt;br /&gt;
* Greyhole *is* working&lt;br /&gt;
* crontab does not appear to be working&lt;br /&gt;
* had to add with noatime in / to prevent flash burnout&lt;br /&gt;
* should control monit - it keeps on pounding the flash with messages in /var/log/monit&lt;br /&gt;
* would like to add swap to flash based drives&lt;br /&gt;
* mt-daapd and amahi-transmission are dying&lt;br /&gt;
* ntpd is not installed??&lt;br /&gt;
  [root@fedora-arm ~]# date&lt;br /&gt;
  Sun Apr 30 06:57:12 EDT 2000&lt;br /&gt;
&lt;br /&gt;
= OpenVPN =&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
      # service openvpn start&lt;br /&gt;
      Starting openvpn: FATAL: Module ip_tables not found.&lt;br /&gt;
      iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)&lt;br /&gt;
      Perhaps iptables or your kernel needs to be upgraded.&lt;br /&gt;
      FATAL: Module ip_tables not found.&lt;br /&gt;
      iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)&lt;br /&gt;
      Perhaps iptables or your kernel needs to be upgraded.&lt;br /&gt;
      FATAL: Module ip_tables not found.&lt;br /&gt;
      iptables v1.4.5: can't initialize iptables table `nat': iptables who? (do you need to insmod?)&lt;br /&gt;
      Perhaps iptables or your kernel needs to be upgraded.&lt;br /&gt;
                                                           [FAILED]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Fixed =&lt;br /&gt;
&lt;br /&gt;
* local DNS server is not working for external hostnames (caused by dnssec enabled in named.conf). Workaround&lt;br /&gt;
          echo -e 'DNSSEC=&amp;quot;off&amp;quot;\nDLV=&amp;quot;off&amp;quot;' &amp;gt; /etc/sysconfig/dnssec&lt;br /&gt;
          service named restart&lt;br /&gt;
&lt;br /&gt;
= Commands not found =&lt;br /&gt;
* which: command not found&lt;br /&gt;
* man: command not found&lt;br /&gt;
* scp: command not found&lt;br /&gt;
* ssh: command not found&lt;br /&gt;
* make: command not found&lt;br /&gt;
&lt;br /&gt;
To install those:&lt;br /&gt;
 yum -y install which man openssh-clients make&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Amahi_Plug_Edition&amp;diff=16339</id>
		<title>Amahi Plug Edition</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Amahi_Plug_Edition&amp;diff=16339"/>
		<updated>2010-08-03T17:40:04Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Supported devices =&lt;br /&gt;
&lt;br /&gt;
* SheevaPlug&lt;br /&gt;
* GuruPlug&lt;br /&gt;
* Pogoplug&lt;br /&gt;
* DockStar&lt;br /&gt;
* Any other Plug Computer based on the Marvell Plug Computer&lt;br /&gt;
&lt;br /&gt;
= Requirements =&lt;br /&gt;
&lt;br /&gt;
You'll need:&lt;br /&gt;
* A storage device, of 2GB or more, that your plug computer can boot from.&lt;br /&gt;
* The latest Amahi ''rootfs'' from http://dl.amahi.org/marvell/ - look for the latest file named '''amahi-marvell-*.tar.bz2'''&lt;br /&gt;
* The script to copy the above ''rootfs'' into your storage device: http://dl.amahi.org/marvell/create-clean-f12-disk.sh&lt;br /&gt;
&lt;br /&gt;
= Known issues =&lt;br /&gt;
&lt;br /&gt;
For a list of working / not working apps for plug computers, see [[SP Apps|this page]].&lt;br /&gt;
&lt;br /&gt;
= Quick Install =&lt;br /&gt;
&lt;br /&gt;
Step 1: Download and extract the [http://dl.amahi.org/marvell/ Amahi ''rootfs'' image] into an empty USB hard drive, USB flash drive, or SD card (depending on what your device supports), formatted as ext3.&lt;br /&gt;
&lt;br /&gt;
Step 2: Boot your device using the drive or card you created in step 1.&lt;br /&gt;
&lt;br /&gt;
Step 3: Install Amahi, by loading http://plug_ip:2000 and entering the install code you got when you [https://www.amahi.org/user created your Amahi profile].&lt;br /&gt;
&lt;br /&gt;
= Detailed Installation Instructions =&lt;br /&gt;
&lt;br /&gt;
== Step 1: Prepare your boot device ==&lt;br /&gt;
&lt;br /&gt;
Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine (you can use your plug computer!)&amp;lt;br/&amp;gt;&lt;br /&gt;
If needed, partition your device to create a partition you'll use to boot. No need to format it.&amp;lt;br/&amp;gt;&lt;br /&gt;
If a swap partition is desired (highly recommended for the PogoPlug &amp;amp; DockStar), create a second partition on your storage device, between 512MB and 2GB (depending on how big your storage device is), and format it as ''Linux Swap''.&lt;br /&gt;
&lt;br /&gt;
Example partitioning depending on your boot device type &amp;amp; size:&lt;br /&gt;
{| cellpadding=&amp;quot;7&amp;quot;&lt;br /&gt;
! 2GB Flash Drive&amp;lt;br/&amp;gt;or SD Card&lt;br /&gt;
! 8GB Flash Drive&amp;lt;br/&amp;gt;or SD Card&lt;br /&gt;
! 16GB Flash Drive&amp;lt;br/&amp;gt;or SD Card&lt;br /&gt;
! USB Hard Drive&amp;lt;br/&amp;gt;(40+ GB)&lt;br /&gt;
|-&lt;br /&gt;
|2GB, unformatted&lt;br /&gt;
|512MB, Linux Swap&amp;lt;br/&amp;gt;7.5GB, unformatted&lt;br /&gt;
|1GB, Linux Swap&amp;lt;br/&amp;gt;15GB, unformatted&lt;br /&gt;
|2GB, Linux Swap&amp;lt;br/&amp;gt;The rest, unformatted&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Download the Amahi ''rootfs'' file and ''create-clean-f12-disk.sh'' script into your Linux machine. Don't store them on the storage device you want to use on your plug computer.&amp;lt;br/&amp;gt;&lt;br /&gt;
Edit the ''create-clean-f12-disk.sh'' script:&lt;br /&gt;
* Change the first line, the one that says '''partition=&amp;quot;...&amp;quot;''' to point to the partition you want to use to boot your plug computer.&amp;lt;br/&amp;gt;If you're not sure, '''ls -l /dev/disk/by-id/''' and see if you can find it there.&lt;br /&gt;
* Change the second line, if needed. It should contain the name of the Amahi ''rootfs'' file you downloaded. Example: '''rootfs=&amp;quot;amahi-marvell-0.8.tar.bz2&amp;quot;'''&lt;br /&gt;
* Comment (add a # character at the beginning of) the two following lines, the ones that say '''echo &amp;quot;Please edit this script...''' and '''exit 0'''.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot; style=&amp;quot;font-weight: bold&amp;quot;&amp;gt;Big Warning! Putting the wrong partition in this script will completely erase that partition! Be careful what partition you target!&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Run the ''create-clean-f12-disk.sh'' script: '''bash create-clean-f12-disk.sh'''&lt;br /&gt;
 &lt;br /&gt;
== Step 2: Boot your plug ==&lt;br /&gt;
&lt;br /&gt;
Boot the plug computer with your newly created drive/card attached.  Give it a few minutes to boot, and it will be ready for the Amahi installation.&lt;br /&gt;
&lt;br /&gt;
If you need help getting your plug computer to boot from USB or SD, instead of the on-board Flash memory, see our [[Marvell Plug Computer Booting]] page.&lt;br /&gt;
&lt;br /&gt;
== Step 3: Install Amahi ==&lt;br /&gt;
&lt;br /&gt;
Note that for this step to work correctly, your plug computer needs to have access to Internet. Maybe you can just SSH into it, and ping www.amahi.org to make sure it works.&lt;br /&gt;
&lt;br /&gt;
Find the plug computer IP address (check your DHCP server), and launch the Amahi installer by visiting http://plug_computer_ip:2000&lt;br /&gt;
&lt;br /&gt;
(Use nmap or ping -b to find new devices on your LAN, if you can't find your plug computer IP address on your DHCP server.)&lt;br /&gt;
&lt;br /&gt;
It will ask for an install code. That code can be obtained by creating an Amahi profile here: https://www.amahi.org/user (you'll need to create an account first, if you don't already have one).&lt;br /&gt;
&lt;br /&gt;
== Enjoy ==&lt;br /&gt;
&lt;br /&gt;
Access your HDA by logging in at http://plug_computer_ip&amp;lt;br/&amp;gt;&lt;br /&gt;
Username: admin&amp;lt;br/&amp;gt;&lt;br /&gt;
Password: amahi&lt;br /&gt;
&lt;br /&gt;
The root password is: amahi&amp;lt;br/&amp;gt;&lt;br /&gt;
(Change it!)&lt;br /&gt;
&lt;br /&gt;
If all seems to work, you can now disable your old DHCP server, and let your plug computer act as your new DHCP server.&amp;lt;br/&amp;gt;&lt;br /&gt;
You'll need to [[RenewIP|renew the IP address]] of your client computers, once your old DHCP server is disabled.&amp;lt;br/&amp;gt;&lt;br /&gt;
You'll then be able to access the Amahi dashboard at http://hda, and your installed apps using http://app_name&lt;br /&gt;
&lt;br /&gt;
If you created a swap partition while partitioning your storage device, you'll need to tell Amahi to use that partition for swap space. You'll need to change '''/dev/sda2''' for the real path to your swap partition. SSH into your Amahi server, and execute the following:&lt;br /&gt;
 mkswap /dev/sda2&lt;br /&gt;
 echo &amp;quot;/dev/sda2          swap                    swap    defaults        0 0&amp;quot; &amp;gt;&amp;gt; /etc/fstab&lt;br /&gt;
 swapon -a&lt;br /&gt;
&lt;br /&gt;
Note: On the SheevaPlug, the onboard NAND flash is called /dev/mtdblock2. You might want to use it as a swap partition, as it would be faster than your SD card or USB drive.&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Plug_notes&amp;diff=16333</id>
		<title>Plug notes</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Plug_notes&amp;diff=16333"/>
		<updated>2010-08-03T17:32:57Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Warboard and Apps =&lt;br /&gt;
&lt;br /&gt;
For known issues, check the [[SP warboard | warboard]]&lt;br /&gt;
&lt;br /&gt;
For app status check the [[SP Apps | apps page]]&lt;br /&gt;
&lt;br /&gt;
= Applications =&lt;br /&gt;
&lt;br /&gt;
For known issues check the [[SP Apps | Apps]]&lt;br /&gt;
&lt;br /&gt;
= Getting the plug booting Fedora 12 =&lt;br /&gt;
&lt;br /&gt;
Here are the steps to make the plug boot from USB&lt;br /&gt;
* General [http://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB directions]&lt;br /&gt;
* Connect the ethernet cable to your network (Mouton says: is this necessary now? Can't we just wait until the Amahi Install section below to connect the plug to the LAN?)&lt;br /&gt;
* Connect the JTAG module to the SheevaPlug (be careful; connecting it the wrong way will fry it! See the warning sticker on the plug, and the photo on the box for proper connection), and connect the USB side to your computer (can be Windows, Linux or Mac).&lt;br /&gt;
* On Windows: install a driver (disc that came with plug), and [http://plugcomputer.org/plugwiki/index.php/SerialTerminal/Windows/PuTTY use PuTTY (serial)].&lt;br /&gt;
* On Linux, execute the following command, and use [http://sourceforge.net/projects/gtkterm/ gtkterm]: use 2 stop bits &amp;amp; 115200 bps speed when creating the profile; keep the defaults for the rest. Instead of gtkterm, you can also use the simpler screen: ''yum -y install screen; screen /dev/ttyUSB1 115200''&lt;br /&gt;
 cat &amp;gt; /etc/udev/rules.d/85-sheevaplug.rules &amp;lt;&amp;lt;'EOF'&lt;br /&gt;
 # if no driver has claimed the interface yet, load ftdi_sio&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, SUBSYSTEM==&amp;quot;usb&amp;quot;, ENV{DEVTYPE}==&amp;quot;usb_interface&amp;quot;, \&lt;br /&gt;
         ATTRS{idVendor}==&amp;quot;1c0c&amp;quot;, ATTRS{idProduct}==&amp;quot;0102&amp;quot;, \&lt;br /&gt;
         DRIVER==&amp;quot;&amp;quot;, \&lt;br /&gt;
         RUN+=&amp;quot;/sbin/modprobe -b ftdi_sio&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 # add the sheevaplug VID and PID to the list of devices supported by ftdi_sio&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, SUBSYSTEM==&amp;quot;drivers&amp;quot;, \&lt;br /&gt;
         ENV{DEVPATH}==&amp;quot;/bus/usb-serial/drivers/ftdi_sio&amp;quot;, \&lt;br /&gt;
         ATTR{new_id}=&amp;quot;1c0c 0102&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 # optionally create a convenience symlink for the console device&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, KERNEL==&amp;quot;ttyUSB*&amp;quot;, \&lt;br /&gt;
         ATTRS{interface}==&amp;quot;SheevaPlug JTAGKey FT2232D B&amp;quot;, \&lt;br /&gt;
         ATTRS{bInterfaceNumber}==&amp;quot;01&amp;quot;, \&lt;br /&gt;
         SYMLINK+=&amp;quot;sheevaplug&amp;quot;&lt;br /&gt;
 EOF&lt;br /&gt;
* Reset the device from the JTAG module (Mouton says: how? I tried to push the button, but that doesn't seem to reset the device... Do you mean login using the terminal emulator, and issue a reboot command..?)&lt;br /&gt;
* At the terminal, press enter a couple of seconds after boot to prevent it from booting using the onboard flash (Ubuntu). You should end up with a ''Marvell&amp;gt;&amp;gt;'' prompt.&lt;br /&gt;
* There are some commands you need to run to make it permanently boot from the USB port ('''NOTE:''' this step is only necessary once):&lt;br /&gt;
&lt;br /&gt;
          &amp;lt;small&amp;gt;&lt;br /&gt;
          setenv mainlineLinux yes&lt;br /&gt;
          setenv arcNumber 2097&lt;br /&gt;
          setenv bootargs_root 'root=/dev/sda1 rootdelay=15'&lt;br /&gt;
          setenv bootcmd_usb 'usb start; ext2load usb 0:1  0x6400000 /boot/uImage'&lt;br /&gt;
          setenv bootcmd 'setenv bootargs $(console) $(bootargs_root); run bootcmd_usb; bootm 0x6400000'&lt;br /&gt;
          saveenv&lt;br /&gt;
          reset&lt;br /&gt;
          &amp;lt;/small&amp;gt;&lt;br /&gt;
* In order to install the rootfs onto a flash or disk, mount the flash drive on a linux system and execute the [http://dl.amahi.org/marvell/create-clean-f12-disk.sh create-clean-f12-disk.sh] script. You'll need to have the [http://dl.amahi.org/marvell/amahi-marvell-0.5.tar.bz2 amahi-marvell-0.5.tar.bz2] file in the current directory. It may take a while, but this must be done before booting up the plug and installing Amahi.&lt;br /&gt;
&lt;br /&gt;
'''NOTE:''' This script is very dangerous (it can destroy the machine it is run on if not used properly). You will need to change the partition destination.&lt;br /&gt;
&lt;br /&gt;
* Insert USB Flash Drive into the plug.&lt;br /&gt;
* Once this is complete, the JTAG module can be disconnected.  There will be no need for serial connection any longer.  Once the USB Flash Drive is connected and the plug booted, you will be able to connect via SSH (default root password is &amp;quot;amahi&amp;quot;).&lt;br /&gt;
&lt;br /&gt;
= Connecting to a Plug on a Mac =&lt;br /&gt;
&lt;br /&gt;
On Mac OS X, Install the [http://www.ftdichip.com/Drivers/VCP/MacOSX/FTDIUSBSerialDriver_v2_2_14.dmg FTDI driver], download [http://dl.dropbox.com/u/3022105/Amahi/sheeva/Info.plist.patch Info.plist.patch] to your desktop, then run the following commands to connect to the SheevaPlug console:&lt;br /&gt;
&lt;br /&gt;
  sudo patch -p0 &amp;lt; ~/Desktop/Info.plist.patch&lt;br /&gt;
  sudo kextunload /System/Library/Extensions/FTDIUSBSerialDriver.kext&lt;br /&gt;
  sudo kextload /System/Library/Extensions/FTDIUSBSerialDriver.kext&lt;br /&gt;
  screen /dev/tty.usbserial-[TAB]B 115200&lt;br /&gt;
&lt;br /&gt;
For [TAB], hit the TAB key; the value there will be unique to each SheevaPlug computer, so TAB will allow you to auto-fill the correct value. Once connected, if you want to close your terminal session, hit Ctrl-A followed by Ctrl-K (or Shift-K on Linux). You'll be asked if you're sure you want to kill this window; just say yes!&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Amahi Install =&lt;br /&gt;
&lt;br /&gt;
After booting from it,&lt;br /&gt;
&lt;br /&gt;
* Configure a profile for the system in http://www.amahi.org. Pay attention to the IP of the HDA you configure. Let's call it PLUG_FIXED_IP.&lt;br /&gt;
* Ensure you have inserted the USB Flash Drive and boot the system&lt;br /&gt;
* Until we optimize things, it will take 4 or 5 minutes to boot the first time.&lt;br /&gt;
* The first time it boots, it will try to use DHCP. In my case, I configured a static IP so that when it boots with DHCP I know what IP it has. This may be different than the static you configured above.&lt;br /&gt;
Note that the sticker on the SP device with the MAC address on it is sometimes wrong. i.e. the MAC address your device will use will be different from the address on this sticker. Use nmap or ping -b to find new devices on your LAN, if you can't find it on your DHCP server.&lt;br /&gt;
* Access the installer via http://IP_OR_NAME_OF_THE_PLUG_IN_DHCP:2000/&lt;br /&gt;
* Wait patiently if it does not respond. This does require internet connectivity&lt;br /&gt;
* The installer takes about 1 minute to install with that :)&lt;br /&gt;
* Input the install code for that system&lt;br /&gt;
* When asked to, click the big red button to reboot&lt;br /&gt;
* The reboot will take a minute or two&lt;br /&gt;
* Access it with the configured IP:    http://IP_OR_NAME_OF_THE_PLUG/&lt;br /&gt;
* First login: admin/amahi. I will ask you to reset the password the first time&lt;br /&gt;
&lt;br /&gt;
'''NOTE:''' With about 1/8th of the rpms on a typical x86 install, you will experience a lot of failures with apps (VPN does not work, apps will be missing deps, etc. etc.).&lt;br /&gt;
&lt;br /&gt;
= Using the onboard NAND flash as a swap drive =&lt;br /&gt;
&lt;br /&gt;
  cfdisk /dev/mtdblock2&lt;br /&gt;
  # Create a &amp;quot;Linux swap / Solaris&amp;quot; partition that takes all the space: &lt;br /&gt;
  # 1. remove any existing partitions, if any&lt;br /&gt;
  # 2. create a new primary partition&lt;br /&gt;
  # 3. select Type option, enter &amp;quot;82&amp;quot;&lt;br /&gt;
  # 4. select Write option&lt;br /&gt;
  # 5. select Quit option&lt;br /&gt;
  mkswap /dev/mtdblock2&lt;br /&gt;
  echo &amp;quot;/dev/mtdblock2          swap                    swap    defaults        0 0&amp;quot; &amp;gt;&amp;gt; /etc/fstab&lt;br /&gt;
  swapon -a&lt;br /&gt;
&lt;br /&gt;
= Reporting issues =&lt;br /&gt;
&lt;br /&gt;
These are mostly what matter for debugging:&lt;br /&gt;
* &amp;lt;code&amp;gt;&amp;lt;small&amp;gt;/root/hda-install.log&amp;lt;/small&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;&amp;lt;small&amp;gt;egrep -v 'POST|GET|progress' /tmp/amahi-ruby-install.log&amp;lt;/small&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* See [[SP_warboard]] for documented issues.&lt;br /&gt;
&lt;br /&gt;
= Misc Notes =&lt;br /&gt;
&lt;br /&gt;
* restarting rpm db in chrooted environment:&lt;br /&gt;
          rm /var/lib/rpm/__db*&lt;br /&gt;
          rpm --rebuilddb -vv&lt;br /&gt;
&lt;br /&gt;
= How to use two HDA on the same network =&lt;br /&gt;
[[How to use two HDA on the same network]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--* May need to add the following line to /etc/resolv.conf if you have DNS issues:&lt;br /&gt;
 nameserver 8.8.8.8--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--  OLD NOTES&lt;br /&gt;
* 2 stop bits to get the bootloader to recognize keyboard and stop autobooting&lt;br /&gt;
* speed: 115200 /dev/ttyUSB1&lt;br /&gt;
* root/fedoraarm default password&lt;br /&gt;
* rpms installed for development: rsync, git, vim-enhanced, sudo, make, rpm-build, tar, httpd-devel, boot-devel, gcc-c++&lt;br /&gt;
* passenger: need rubygems-1.3.5-4.fc12.noarch.rpm with macro changes&lt;br /&gt;
* rpms installed for amahi: httpd, ruby, samba, &lt;br /&gt;
* build hdactl, hda-platform, install (with --nodeps)&lt;br /&gt;
&lt;br /&gt;
RPMs not available from the mirrors:&lt;br /&gt;
* hda-greyhole&lt;br /&gt;
* cadaver&lt;br /&gt;
* rubygem-gd2 - actually - is this one necessary?&lt;br /&gt;
* ruby-RMagick&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* ssh into the plug&lt;br /&gt;
* yum -y install httpd&lt;br /&gt;
&lt;br /&gt;
* Install the hda-release&lt;br /&gt;
** &amp;lt;small&amp;gt;&amp;lt;code&amp;gt;rpm -Uvh &amp;lt;latest_rpm repo=&amp;quot;amahi-f12&amp;quot; rpm=&amp;quot;hda-release&amp;quot; arch=&amp;quot;noarch&amp;quot; output=&amp;quot;url&amp;quot; /&amp;gt;&amp;lt;/code&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Install hdactl&lt;br /&gt;
** &amp;lt;small&amp;gt;&amp;lt;code&amp;gt;rpm -Uvh --nodeps &amp;lt;latest_rpm repo=&amp;quot;amahi-f12&amp;quot; rpm=&amp;quot;hdactl&amp;quot; arch=&amp;quot;armv5tel&amp;quot; output=&amp;quot;url&amp;quot; /&amp;gt;&amp;lt;/code&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Now install &amp;lt;code&amp;gt;hda-platform&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;lt;small&amp;gt;&amp;lt;code&amp;gt;rpm -Uvh --nodeps &amp;lt;latest_rpm repo=&amp;quot;amahi-f12&amp;quot; rpm=&amp;quot;hda-platform&amp;quot; arch=&amp;quot;noarch&amp;quot; output=&amp;quot;url&amp;quot; /&amp;gt;&amp;lt;/code&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Install dependencies:&lt;br /&gt;
** &amp;lt;small&amp;gt;&amp;lt;code&amp;gt;yum -y install rubygems ruby-libs ruby-mysql&amp;lt;/code&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Start the Amahi installer.&lt;br /&gt;
** &amp;lt;small&amp;gt;&amp;lt;code&amp;gt;service amahi-installer start&amp;lt;/code&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* And last but not least, get the installer going by accessing it with a browser:&lt;br /&gt;
       &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;http://your_ip_address:2000&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* input the install code and install!&lt;br /&gt;
* NOTE: it may be better to &lt;br /&gt;
* report bugs!--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
	<entry>
		<id>https://wiki.amahi.org/index.php?title=Plug_warboard&amp;diff=16327</id>
		<title>Plug warboard</title>
		<link rel="alternate" type="text/html" href="https://wiki.amahi.org/index.php?title=Plug_warboard&amp;diff=16327"/>
		<updated>2010-08-03T17:32:01Z</updated>

		<summary type="html">&lt;p&gt;Gboudreau: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;For installation notes, etc. see [[SP notes]].&lt;br /&gt;
&lt;br /&gt;
When you note a problem, please indicate what version you're running (0.2, 0.3, ...)&lt;br /&gt;
&lt;br /&gt;
= Warboard =&lt;br /&gt;
&lt;br /&gt;
* VPN works. the date needs to be set to something recent:&lt;br /&gt;
         date --set 'Thu May 27 16:44:57 EDT 2010'&lt;br /&gt;
         hwclock --systohc --utc&lt;br /&gt;
* tar and unzip need to be in the image:&lt;br /&gt;
         yum -y install tar unzip&lt;br /&gt;
* Greyhole *is* working&lt;br /&gt;
* crontab does not appear to be working&lt;br /&gt;
* had to add with noatime in / to prevent flash burnout&lt;br /&gt;
* should control monit - it keeps on pounding the flash with messages in /var/log/monit&lt;br /&gt;
* would like to add swap to flash based drives&lt;br /&gt;
* mt-daapd and amahi-transmission are dying&lt;br /&gt;
* ntpd is not installed??&lt;br /&gt;
  [root@fedora-arm ~]# date&lt;br /&gt;
  Sun Apr 30 06:57:12 EDT 2000&lt;br /&gt;
&lt;br /&gt;
= OpenVPN =&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
      # service openvpn start&lt;br /&gt;
      Starting openvpn: FATAL: Module ip_tables not found.&lt;br /&gt;
      iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)&lt;br /&gt;
      Perhaps iptables or your kernel needs to be upgraded.&lt;br /&gt;
      FATAL: Module ip_tables not found.&lt;br /&gt;
      iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)&lt;br /&gt;
      Perhaps iptables or your kernel needs to be upgraded.&lt;br /&gt;
      FATAL: Module ip_tables not found.&lt;br /&gt;
      iptables v1.4.5: can't initialize iptables table `nat': iptables who? (do you need to insmod?)&lt;br /&gt;
      Perhaps iptables or your kernel needs to be upgraded.&lt;br /&gt;
                                                           [FAILED]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Fixed =&lt;br /&gt;
&lt;br /&gt;
* local DNS server is not working for external hostnames (caused by dnssec enabled in named.conf). Workaround&lt;br /&gt;
          echo -e 'DNSSEC=&amp;quot;off&amp;quot;\nDLV=&amp;quot;off&amp;quot;' &amp;gt; /etc/sysconfig/dnssec&lt;br /&gt;
          service named restart&lt;br /&gt;
&lt;br /&gt;
= Commands not found =&lt;br /&gt;
* which: command not found&lt;br /&gt;
* man: command not found&lt;br /&gt;
* scp: command not found&lt;br /&gt;
* make: command not found&lt;br /&gt;
&lt;br /&gt;
To install those:&lt;br /&gt;
 yum -y install which man openssh-clients make&lt;/div&gt;</summary>
		<author><name>Gboudreau</name></author>
		
	</entry>
</feed>