Skip to content

Commit 8e4ba36

Browse files
committed
Added some steps and notes in INSTALL file, to help users manually install Greyhole
1 parent a1c8bd1 commit 8e4ba36

File tree

2 files changed

+12
-3
lines changed

2 files changed

+12
-3
lines changed

INSTALL

+8-3
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,15 @@ If you know what you're doing, you should have no problem installing on any othe
1212
1. Install the required applications: PHP 7+ (cli) with MySQL & mbstring extensions, MySQL server, Samba, rsync, GCC (etc.):
1313

1414
Fedora: yum -y install mysql-server php php-mysql php-mbstring php-intl samba samba-common php-pear rsync lsof
15-
Ubuntu: apt-get -y install mysql-server php-cli php-mysql php-mysqlnd php-mbstring php-intl samba samba-common samba-common-bin php-pear rsync lsof sysstat
15+
Ubuntu: apt-get -y install mysql-server php-cli php-mysql php-mysqlnd php-mbstring php-intl samba samba-common samba-common-bin samba-vfs-modules php-pear rsync lsof sysstat
16+
17+
Note: you might need to install mariadb-server, if mysql-server is not available. Those two are equivalent.
18+
Note 2: samba-vfs-modules might not be needed, but if it is available in your repo, it is required.
1619

1720
2. Install Greyhole (as root):
1821

19-
Get the latest Source Install TGZ from https://github.com/gboudreau/Greyhole/releases
22+
Download the latest "greyhole-[VERSION].tar.gz" file from https://github.com/gboudreau/Greyhole/releases
23+
(Don't use the "Source Code" files.)
2024

2125
tar zxf greyhole-*.tar.gz && rm -f greyhole-*.tar.gz
2226
cd greyhole-*
@@ -42,6 +46,7 @@ If you know what you're doing, you should have no problem installing on any othe
4246
install -m 0755 -D -p scripts-examples/greyhole_notify_error.sh /usr/share/greyhole/scripts-examples
4347
install -m 0755 -D -p scripts-examples/greyhole_send_fsck_report.sh /usr/share/greyhole/scripts-examples
4448
install -m 0644 -D -p USAGE /usr/share/greyhole
49+
install -m 0755 -D -p build_vfs.sh /usr/share/greyhole
4550
install -m 0644 -D -p docs/greyhole.1.gz /usr/share/man/man1/
4651
install -m 0644 -D -p docs/greyhole-dfree.1.gz /usr/share/man/man1/
4752
install -m 0644 -D -p docs/greyhole.conf.5.gz /usr/share/man/man5/
@@ -76,7 +81,7 @@ If you know what you're doing, you should have no problem installing on any othe
7681
Debian: service samba restart
7782

7883
3. For Samba 4.12 and later: The greyhole.so files packaged with Greyhole won't work on your system.
79-
You'll need to compile your own VFS module. You'll just need to compile vfs_greyhole.c, and install it.
84+
You'll need to compile your own VFS module.
8085

8186
Fedora: sudo yum -y install patch gcc python-devel gnutls-devel make rpcgen
8287
Ubuntu/Debian: sudo apt -y install build-essential python3-dev libgnutls28-dev pkg-config

greyhole.cron.d

+4
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
11
# cifs client workaround
22
# Ref: http://blog.dhampir.no/content/cifs-vfs-no-response-for-cmd-n-mid
33
@reboot root /sbin/modprobe cifs enable_oplocks=n; if [ -x /proc/fs/cifs/OplockEnabled ]; then echo 0 > /proc/fs/cifs/OplockEnabled; fi
4+
5+
# On-boot initialization: create mem spool folder, mark all dangling tasks as completed, etc.
46
@reboot root /usr/bin/greyhole --create-mem-spool >/dev/null
57
@reboot root /usr/bin/greyhole --boot-init
8+
9+
# Process the Samba spool as soon as possible (daemon might be busy)
610
* * * * * root /usr/bin/greyhole --process-spool --keepalive >/dev/null

0 commit comments

Comments
 (0)