koha.README.Debian

koha packaged for Debian
========================

When you install the koha.deb package, it does not quite work out of the
box. Due to various limitations imposed by sanity and the Debian packaging
policies, it is not yet possible to make it so without excessive work.
The work will happen later. For now, you get a checklist.

To enable Koha on your machine, after installing this package, do the
following:

* Make XML::LibXML::SAX:Parser the default parser for Perl's XML SAX
  implementation.
  - edit /etc/perl/XML/SAX/ParserDetails.ini to
    move XML::LibXML::SAX:Parser section last in the file
  - FIXME: This should become unnecessary: Koha is in the process of
    being patched to specify the parser it needs explicitly, instead
    of assuming it is the default one.
* Enable the suexec module for Apache.
  - sudo a2enmod suexec
* Enable the rewrite module for Apache.
  - sudo a2enmod rewrite
* Restart Apache.
  - sudo service apache2 restart

The latter three steps can be done by running the koha-post-install-setup
script.

You may also need to disable the default Apache virtual host:

    # sudo a2dissite 000-default

Then access the following URL:

    http://localhost:8080/

Alternatively, any other name, IP address, and interface will work, too,
although will probably need to configure /etc/apache2/ports.conf to 
have the following line:

    NameVirtualHost *:8080
    
(You'll need to restart apache2 afterwards: /etc/init.d/apache2 restart.)

This should bring up the Koha intranet administration screen, which will
let you log in. The username is koha, the password is in the
/etc/koha/koha-conf.xml file (search for "pass").