Difference between revisions of "Greyhole UI App Transition Guide"
(Created page with "The automated option is designed for new Amahi 7 installations and the preferred method of install. It does not support previous manual Greyhole installations, meaning all yo...") |
|||
| 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. | |
| − | You can | + | == Getting Started == |
| + | The Greyhole UI does not support previous manual Greyhole installations, meaning all your current Greyhole settings will be overwritten. | ||
| + | == 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. | ||
| + | |||
| + | As [[Open_terminal|root user]]: | ||
| + | cp /etc/greyhole.conf /var/hda/files/docs | ||
| + | |||
| + | == Install Plugin == | ||
| + | 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. | ||
| + | |||
| + | 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. | ||
| + | |||
| + | == Configure Greyhole == | ||
| + | Now that you have the plugin installed, select the Drive Pooling tab. | ||
| + | |||
| + | * <u>Storage Pool</u> | ||
| + | :The first thing you will want to do is select the appropriate drives for the storage pool. | ||
| + | :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. | ||
| + | |||
| + | * <u>Shares</u> | ||
| + | :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. | ||
| + | |||
| + | * <u>Status</u> | ||
| + | :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|Greyhole Troubleshooting]] area for assistance. | ||
| + | |||
| + | == 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. | ||
Revision as of 00:38, 31 July 2014
This guide will provide a step by step transition from the manual Greyhole installation to using the Greyhole UI plugin for Amahi 7. Going forward, this is the preferred method of installing Greyhole.
Contents
Getting Started
The Greyhole UI does not support previous manual Greyhole installations, meaning all your current Greyhole settings will be overwritten.
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.
As root user:
cp /etc/greyhole.conf /var/hda/files/docs
Install Plugin
The Greyhole UI plugin 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.
Configure Greyhole
Now that you have the plugin 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 plugin. If you have additional settings you configured manually in the past, see Greyhole Advanced Options for guidance on adding those to Greyhole.
