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