Difference between revisions of "Greyhole UI App Transition Guide"

From Amahi Wiki
Jump to: navigation, search
Line 1: Line 1:
This guide will provide a step by step transition from the manual Greyhole installation to using the [https://www.amahi.org/apps/greyhole-ui Greyhole UI] plugin for Amahi 7.  Going forward, this is the preferred method of installing Greyhole.   
+
This guide will provide a step by step transition from the manual Greyhole installation to using the [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application for Amahi 7.  Going forward, this is the preferred method of installing Greyhole.   
  
 
== Getting Started ==
 
== Getting Started ==
The [https://www.amahi.org/apps/greyhole-ui Greyhole UI] plugin does not support previous manual Greyhole installations, meaning all your current Greyhole settings will be overwritten.  You will have to reconfigure it using the dashboard.
+
The [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application does not support previous manual Greyhole installations, meaning all your current Greyhole settings will be overwritten.  You will have to reconfigure it using the dashboard.
  
 
== Backup Current Settings ==
 
== Backup Current Settings ==
We need to back up or note our current settings prior to installing the plugin.  There are many ways to do this.  Lets keep it simple and copy the ''/etc/greyhole.conf file to a share.
+
We need to back up or note our current settings prior to installing the application.  There are many ways to do this.  Lets keep it simple and copy the ''/etc/greyhole.conf file to a share.
  
 
As [[Open_terminal|root user]]:
 
As [[Open_terminal|root user]]:
 
  cp /etc/greyhole.conf /var/hda/files/docs
 
  cp /etc/greyhole.conf /var/hda/files/docs
  
== Install Plugin ==
+
== Install Application ==
The [https://www.amahi.org/apps/greyhole-ui Greyhole UI] plugin has a convenience fee, therefore you will need to log in to your Amahi control panel and purchase the app.
+
The [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application has a convenience fee, therefore you will need to log in to your Amahi control panel and purchase the app.
  
Once you have done so, it will appear in your ''Available Applications'' list.  If it does not, try refreshing the page.  Select the plugin and install as you would any Amahi application.
+
Once you have done so, it will appear in your ''Available Applications'' list.  If it does not, try refreshing the page.  Select the application and install as you would any Amahi application.
  
 
== Configure Greyhole ==
 
== Configure Greyhole ==
Now that you have the plugin installed, select the Drive Pooling tab.   
+
Now that you have the application installed, select the Drive Pooling tab.   
  
 
* <u>Storage Pool</u>
 
* <u>Storage Pool</u>
Line 38: Line 38:
  
 
== Additional Settings ==
 
== Additional Settings ==
There are limited settings configured using the [https://www.amahi.org/apps/greyhole-ui Greyhole UI] plugin.  If you have additional settings you configured manually in the past, see [[Greyhole#Greyhole_Advanced_Options|Greyhole Advanced Options]] for guidance on adding those to Greyhole.
+
There are limited settings configured using the [https://www.amahi.org/apps/greyhole-ui Greyhole UI] application.  If you have additional settings you configured manually in the past, see [[Greyhole#Greyhole_Advanced_Options|Greyhole Advanced Options]] for guidance on adding those to Greyhole.

Revision as of 01:13, 31 July 2014

This guide will provide a step by step transition from the manual Greyhole installation to using the Greyhole UI application for Amahi 7. Going forward, this is the preferred method of installing Greyhole.

Getting Started

The Greyhole UI application does not support previous manual Greyhole installations, meaning all your current Greyhole settings will be overwritten. You will have to reconfigure it using the dashboard.

Backup Current Settings

We need to back up or note our current settings prior to installing the application. There are many ways to do this. Lets keep it simple and copy the /etc/greyhole.conf file to a share.

As root user:

cp /etc/greyhole.conf /var/hda/files/docs

Install Application

The Greyhole UI application has a convenience fee, therefore you will need to log in to your Amahi control panel and purchase the app.

Once you have done so, it will appear in your Available Applications list. If it does not, try refreshing the page. Select the application and install as you would any Amahi application.

Configure Greyhole

Now that you have the application installed, select the Drive Pooling tab.

  • Storage Pool
The first thing you will want to do is select the appropriate drives for the storage pool.
If you are unsure which drives were used, you can open the greyhole.conf file we saved in our Docs share in any editor and consult your previous configuration.
  • Shares
Select the share that will use the Storage pool. Don't forget to choose number of file copies. Leave as - if none are desired.
Consult the greyhole.conf file if needed to see what shares and number of copies were previously used.
  • Status
You will see the status of the Greyhole Daemon.
If it says 'idle', select Run FSCK

Verification

You can monitor activity as always in the Greyhole log.

tail -f /var/log/greyhole

Recommend you verify that everything is working properly. If not, refer to the Greyhole Troubleshooting area for assistance.

Additional Settings

There are limited settings configured using the Greyhole UI application. If you have additional settings you configured manually in the past, see Greyhole Advanced Options for guidance on adding those to Greyhole.