Bug 7435: corrects Fund selectbox in addneworder
[koha.git] / 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").