debian/koha.README.Debian

   1 koha packaged for Debian
   2 ========================
   3
   4 When you install the koha.deb package, it does not quite work out of the
   5 box. Due to various limitations imposed by sanity and the Debian packaging
   6 policies, it is not yet possible to make it so without excessive work.
   7 The work will happen later. For now, you get a checklist.
   8
   9 To enable Koha on your machine, after installing this package, do the
  10 following:
  11
  12 * Make XML::LibXML::SAX:Parser the default parser for Perl's XML SAX
  13   implementation.
  14   - edit /etc/perl/XML/SAX/ParserDetails.ini to
  15     move XML::LibXML::SAX:Parser section last in the file
  16   - FIXME: This should become unnecessary: Koha is in the process of
  17     being patched to specify the parser it needs explicitly, instead
  18     of assuming it is the default one.
  19 * Enable the suexec module for Apache.
  20   - sudo a2enmod suexec
  21 * Enable the rewrite module for Apache.
  22   - sudo a2enmod rewrite
  23 * Restart Apache.
  24   - sudo service apache2 restart
  25
  26 The latter three steps can be done by running the koha-post-install-setup
  27 script.
  28
  29 You may also need to disable the default Apache virtual host:
  30
  31     # sudo a2dissite 000-default
  32
  33 Then access the following URL:
  34
  35     http://localhost:8080/
  36
  37 Alternatively, any other name, IP address, and interface will work, too,
  38 although will probably need to configure /etc/apache2/ports.conf to
  39 have the following line:
  40
  41     NameVirtualHost *:8080
  42
  43 (You'll need to restart apache2 afterwards: /etc/init.d/apache2 restart.)
  44
  45 This should bring up the Koha intranet administration screen, which will
  46 let you log in. The username is koha, the password is in the
  47 /etc/koha/koha-conf.xml file (search for "pass").