blob: bdbdfffbc50da9e2287625c468acb4a80191bf12 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
Introduction
============
mod_glusterfs is a module written for lighttpd to speed up the access of files present on glusterfs. mod_glusterfs uses libglusterfsclient library provided for glusterfs and hence can be used without fuse (File System in User Space).
Usage
=====
To use mod_glusterfs with lighttpd-1.5, copy mod_glusterfs.c and mod_glusterfs.h into src/ of lighttpd-1.5 source tree, and apply the Makefile.am.diff to src/Makefile.am. Re-run ./autogen.sh on the top level of the lighttpd-1.5 build tree and recompile.
# cp mod_glusterfs.[ch] /home/glusterfs/lighttpd-1.5/src/
# cp Makefile.am.diff /home/glusterfs/lighttpd-1.5/
# cd /home/glusterfs/lighttpd-1.5
# patch -p1 < Makefile.am.diff
# ./autogen.sh
# ./configure
# make
# make install
Configuration
=============
* mod_glusterfs should be listed at the begining of the list server.modules in lighttpd.conf.
Below is a snippet from lighttpd.conf concerning to mod_glusterfs.
$HTTP["url"] =~ "^/glusterfs" {
glusterfs.prefix = "/glusterfs"
glusterfs.logfile = "/var/log/glusterfs-logfile"
glusterfs.document-root = "/home/glusterfs/document-root"
glusterfs.volume-specfile = "/etc/glusterfs/glusterfs.vol"
glusterfs.loglevel = "error"
glusterfs.cache-timeout = 300
glusterfs.xattr-interface-size-limit = "65536"
}
* $HTTP["url"] =~ "^/glusterfs"
A perl style regular expression used to match against the url. If regular expression matches the url, the url is handled by mod_glusterfs. Note that the pattern given here should match glusterfs.prefix.
* glusterfs.prefix (COMPULSORY)
A string to be present at the starting of the file path in the url so that the file would be handled by glusterfs.
Eg., A GET request on the url http://www.example.com/glusterfs-prefix/some-dir/example-file will result in fetching of the file "/some-dir/example-file" from glusterfs mount if glusterfs.prefix is set to "/glusterfs-prefix".
* glusterfs.volume-specfile (COMPULSORY)
Path to the the glusterfs volume specification file.
* glusterfs.logfile (COMPULSORY)
Path to the glusterfs logfile.
* glusterfs.loglevel (OPTIONAL, default = warning)
Allowed values are critical, error, warning, debug, none in the decreasing order of severity of error conditions.
* glusterfs.cache-timeout (OPTIONAL, default = 0)
Timeout values for glusterfs stat and lookup cache.
* glusterfs.document-root (COMPULSORY)
An absolute path, relative to which all the files are fetched from glusterfs.
* glusterfs.xattr-interface-size-limit (OPTIONAL, default = 0)
Files with sizes upto and including this value are fetched through the extended attribute interface of glusterfs rather than the usual open-read-close set of operations. For files of small sizes, it is recommended to use extended attribute interface.
|
