Koha/debian/koha-common.README.Debian
Lars Wirzenius 6fb9a6036d Update README.Debian for koha-common with post-install setup.
Signed-off-by: Galen Charlton <gmcharlt@gmail.com>
2010-05-26 08:28:15 -04:00

57 lines
1.8 KiB
Text

Post-installation configuration
===============================
You will want to consider doing the following after installing this
package:
* Install mysql-server, for a local database.
* Alternatively, set up a connection to a remote MySQL server:
- rm /etc/mysql/koha-common.cnf
- $EDITOR /etc/mysql/koha-common.cnf
[client]
host = some.other.host
user = mysqlusername
password = mysqlpassword
* Enable the rewrite module: a2enmod rewrite
* Listen on port 8080: $EDITOR /etc/apache2/ports.conf
* Alternatively, configure koha-create, using /etc/koha/koha-sites.conf
(see /usr/sbin/koha-create for which variables to set).
* After that, you can create a new Koha instance:
- koha-create --create-db name
Koha filesystem layout on Debian
================================
The Debian packaging of Koha puts files in the following places:
* /etc/koha -- system configuration files
* /etc/cron.hourly/koha-common -- cron job
* /usr/share/koha -- shared files (HTML templates, Perl code, etc)
Each Koha instance has files in the following places:
* /etc/koha/sites/$name -- confguration files
* /etc/apache2/sites-available/$name -- Apache config file
* /var/lib/koha/$name -- Zebra databases
* /var/log/koha/$name -- log files (Apache, Zebra)
* /var/lock/koha/$name -- run-time lock files
* /var/run/koha/$name -- run-time sockets etc
* /var/spool/koha/$name -- database dumps
Koha and MySQL
==============
koha-common's postinst script sets up the /etc/mysql/koha-common.cnf,
and all scripts use that to access the MySQL database. By default, it
is a symlink pointing at debian.cnf, and only works on localhost.
If you wish, you can create a file /etc/mysql/koha-common.cnf instead
of the symlink, and point it at a remote server. There is currently
no tool to help you do that, but it should be fairly straightforward.