Koha/debian/koha.README.Debian
Lars Wirzenius 6858a1feda Fix bug 4818: Add note to koha README.Debian to maybe disable default vhost.
Signed-off-by: Galen Charlton <gmcharlt@gmail.com>
2010-06-02 07:14:40 -04:00

47 lines
1.6 KiB
Text

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-config.xml file (search for "pass").