1 koha packaged for Debian
2 ========================
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.
9 To enable Koha on your machine, after installing this package, do the
12 * Make XML::LibXML::SAX:Parser the default parser for Perl's XML SAX
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.
21 * Enable the rewrite module for Apache.
22 - sudo a2enmod rewrite
24 - sudo service apache2 restart
26 The latter three steps can be done by running the koha-post-install-setup
29 Then access the following URL:
31 http://localhost:8080/
33 Alternatively, any other name, IP address, and interface will work, too,
34 although will probably need to configure /etc/apache2/ports.conf to
35 have the following line:
37 NameVirtualHost *:8080
39 (You'll need to restart apache2 afterwards: /etc/init.d/apache2 restart.)
41 This should bring up the Koha intranet administration screen, which will
42 let you log in. The username is koha, the password is in the
43 /etc/koha/koha-config.xml file (search for "pass").