Koha/Post-Installation

Step 1 - Enable system backup and monitor

• With the packages installation, the koha-run-backups command is available. See below for help.

/usr/sbin/koha-run-backups - performs backups of the koha installations on the system

This allows automation of backing up the koha data and configuration to the
filesystem. It will keep the past so many backups, discarding older ones.

Options:
    --output:   the directory that the resulting files will be placed into.
                (default: /var/spool/koha)
    --days:     the number of days to keep backups around for
                (default: 2)

Note: backups produced using this tool can be restored using `koha-restore'.

• Setup the root crontab by adding the following: (Check database credentials in "/etc/koha/koha-conf.xml" first).

@daily /usr/sbin/koha-run-backups

Help

• http://wiki.lib.sun.ac.za/index.php/SUNScholar/Disaster_Recovery/Backups/Client_Setup
• http://wiki.lib.sun.ac.za/index.php/SUNScholar/Disaster_Recovery/Backups/Server_Setup
• http://wiki.lib.sun.ac.za/index.php/SUNScholar/Disaster_Recovery/System_Monitor

Also see: https://github.com/Koha-Community/Koha/blob/master/misc/cronjobs/backup.sh

Step 2 - Setup automated tasks using the cron daemon

See: https://github.com/Koha-Community/Koha/blob/master/misc/cronjobs/crontab.example and http://manual.koha-community.org/3.12/en/cronjobsch.html

1. Add the above to "root" user crontab. Remove all instances of "__KOHA_USER__" since we are already the "root" user.
2. Check /etc/koha/koha-conf.xml for correct database credentials.
3. Add "--run-as-root" to the rebuild_zebra.pl task

Step 3 - Setup email delivery

• Install mail delivery agent

sudo apt-get install postfix

When asked for type of configuration, select Internet with smarthost. The smarthost is your campus email server, for example at Stellenbosch University that server is: mail.sun.ac.za

• Deliver koha user email to designated recipients

sudo nano /etc/aliases

See example below. Replace the example email addresses with your email addresses.

# Added by installer for initial user
root:	me@my.edu
koha:   me@my.edu, you@my.edu

After saving the file, run the following command.

sudo newaliases

Enable command line email utils

sudo apt-get install mailx

Send a test email to yourself, by typing and pressing enter.

mail -s "Test from KOHA server" root, me@my.edu

Type in some content for the email, then press CTL+d to deliver the email.

You can check the log at /var/log/mail.log for more info of delivery.

Help

• https://help.ubuntu.com/community/Postfix

Tips

• https://github.com/colinsc/koha/blob/master/misc/maintenance/borrowers-force-messaging-defaults

Return to Koha wiki page