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.