fixing nomenclature on files in misc/, adding a few new utilities
[wip/koha-chris_n.git] / misc / info / Hints
1 Example /etc/koha.conf file entries
2
3 database=Koha
4 hostname=localhost
5 user=Koha
6 pass=xxxxxx
7 includes=/usr/local/www/koha/htdocs/includes
8
9 Please note the final line (includes=path) - The path entry can be
10 used as an alternative to manually editing the path in Output.pm file
11 (see INSTALL manual). 
12
13
14 --------------------------------------------------------------------------------
15 Example apache httpd.conf entries:
16 Koha makes extensive use of Server Side Includes (SSI):
17
18
19 http://httpd.apache.org/docs/mod/mod_include.html 
20
21 If your page headers and footers do not show, then you may need to
22 re-configure your web server. 
23
24 Here is an example of entries suitable for Apache httpd.conf:
25
26
27 <VirtualHost 111.222.333.1>
28    ServerName koha.example.com
29    ServerPath /var/www/library
30    DocumentRoot /var/www/library/koha/html
31    Alias /images/ "/var/www/library/koha/html/images/"
32    ScriptAlias  /cgi-bin/koha/ "/var/www/library/koha/cgi-bin/"
33    SetEnv PERL5LIB "/var/www/library/modules"
34    ErrorLog /var/log/httpd/koha-error_log
35    # 
36    # ======== koha uses Server Side Includes =========
37    # Normally here, use the same path as "DocRoot" above
38    <Directory "/var/www/library/koha/html">
39         #       
40         AllowOverride None
41         #
42         # First, you MUST enable +Includes or +IncludesNoExec
43         #
44         Options +Includes -FollowSymlinks -Indexes
45         #
46         # Second, you must also configure one of following:
47         #
48         # 1. server-parsed content (SSI) for files ending in ".html"
49         #
50         AddHandler server-parsed .html
51         #
52             # ...OR... (not "AND" !!!!)...
53             #
54             # 2. Allow SSI if executable bit set using "XBitHack"
55             # XBitHack on|off|full
56             #
57             # XBitHack on - any file that has the user-execute bit
58             # - set will be treated as a server-parsed html doc. 
59             # - The "full" = "on" but, in addition, will test the
60             # - group-execute bit. If the group execute bit is set
61             # - then the Last-modified date of the returned file
62             # - is sent. If group-execute bit is not set, then no
63             # - last-modified date is sent.
64             # - Setting this bit allows clients and proxies to
65             # - cache the result of the request!
66             #
67             # For example, enable XBitHack (on) if you want to
68             # - include non-executable content in documents like:
69             #   <!--#include virtual="/includes/footer.inc" -->
70             #   <!--#include virtual="/cgi-bin/counter.pl" -->
71             #
72             # XBitHack on
73             #
74             # Remember - do not use XBitHack if using AddHandler!
75     </Directory>    
76 </VirtualHost>
77
78 <VirtualHost 111.222.333.1>
79     ServerName opac.example.com
80     ServerPath /var/www/library
81     DocumentRoot /var/www/library/opac/html
82     Alias /images/ "/var/www/library/opac/html/images/"
83     ScriptAlias  /cgi-bin/opac/ "/var/www/library/opac/cgi-bin/"
84     SetEnv PERL5LIB "/var/www/library/modules"
85     ErrorLog /var/log/httpd/opac-error_log
86     #
87     <Directory "/var/www/library/opac/html">
88             AllowOverride None
89             Options +Includes -FollowSymLinks -Indexes
90             AddHandler server-parsed .html
91     </Directory>
92 </VirtualHost>
93
94
95 Read your web server docs for more information about how Server Side
96 Includes work.
97
98
99