Koha/Hints

90 lines
3.3 KiB
Text

Example /etc/koha.conf file entries
database=Koha
hostname=localhost
user=Koha
pass=xxxxxx
includes=/usr/local/www/koha/htdocs/includes
Please note the final line (includes=path) - The path entry can be used as an alternative to manually editing the path in Output.pm file (see INSTALL manual).
--------------------------------------------------------------------------------
Example apache httpd.conf entries:
Koha makes extensive use of Server Side Includes (SSI):
http://httpd.apache.org/docs/mod/mod_include.html
If your page headers and footers do not show, then you may need to re-configure your web server.
Here is an example of entries suitable for Apache httpd.conf:
<VirtualHost 111.222.333.1>
ServerName koha.example.com
ServerPath /var/www/library
DocumentRoot /var/www/library/koha/html
Alias /images/ "/var/www/library/koha/html/images/"
ScriptAlias /cgi-bin/koha/ "/var/www/library/koha/cgi-bin/"
SetEnv PERL5LIB "/var/www/library/modules"
ErrorLog /var/log/httpd/koha-error_log
#
# ======== koha uses Server Side Includes =========
# Normally here, use the same path as "DocRoot" above
<Directory "/var/www/library/koha/html">
#
AllowOverride None
#
# First, you MUST enable +Includes or +IncludesNoExec
#
Options +Includes -FollowSymlinks -Indexes
#
# Second, you must also configure one of following:
#
# 1. server-parsed content (SSI) for files ending in ".html"
#
AddHandler server-parsed .html
#
# ...OR... (not "AND" !!!!)...
#
# 2. Allow SSI if executable bit set using "XBitHack"
# XBitHack on|off|full
#
# XBitHack on - any file that has the user-execute bit
# - set will be treated as a server-parsed html doc.
# - The "full" = "on" but, in addition, will test the
# - group-execute bit. If the group execute bit is set
# - then the Last-modified date of the returned file
# - is sent. If group-execute bit is not set, then no
# - last-modified date is sent.
# - Setting this bit allows clients and proxies to
# - cache the result of the request!
#
# For example, enable XBitHack (on) if you want to
# - include non-executable content in documents like:
# <!--#include virtual="/includes/footer.inc" -->
# <!--#include virtual="/cgi-bin/counter.pl" -->
#
# XBitHack on
#
# Remember - do not use XBitHack if using AddHandler!
</Directory>
</VirtualHost>
<VirtualHost 111.222.333.1>
ServerName opac.example.com
ServerPath /var/www/library
DocumentRoot /var/www/library/opac/html
Alias /images/ "/var/www/library/opac/html/images/"
ScriptAlias /cgi-bin/opac/ "/var/www/library/opac/cgi-bin/"
SetEnv PERL5LIB "/var/www/library/modules"
ErrorLog /var/log/httpd/opac-error_log
#
<Directory "/var/www/library/opac/html">
AllowOverride None
Options +Includes -FollowSymLinks -Indexes
AddHandler server-parsed .html
</Directory>
</VirtualHost>
Read your web server docs for more information about how Server Side Includes work.