Greyhole UI App Transition Guide
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.
Contents
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
Housekeeping
For those who did the manual install, there were two lines added to the Extra Parameters field for each share that was greyhole enabled.
dfree command = /usr/bin/greyhole-dfree vfs objects = greyhole
Please ensure these are removed before installing the application. They will be automatically added to each share and not reflected in the Extra Parameters field.
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 application.
Once you have done so, it will appear in your Available Applications list. If it does not, try refreshing the page. Select it 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 - (dash) if none are desired.
- Consult the greyhole.conf file if needed to see what shares and number of copies were previously used.
- Status
Verification
You can monitor activity as always in the Greyhole log.
tail -f /var/log/greyhole.log
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.