Koha/debian/koha-common.README.Debian
Robin Sheat 18a1c3db11 Bug 5139 - packages now do email and other cron jobs
By default the packages now set up the cron jobs to handle things like
overdues and email etc. By default, email is off, 'koha-email-enable'
and 'koha-email-disable' can manage this.

Signed-off-by: Chris Cormack <chrisc@catalyst.net.nz>
Signed-off-by: Galen Charlton <gmcharlt@gmail.com>
2010-10-06 08:12:14 -04:00

59 lines
1.9 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
* /etc/cron.daily/koha-common -- cron job
* /etc/cron.d/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.