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