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'.

• So we add this command to a root crontab but first we need to create a destination folder for the backups.

sudo mkdir /var/backup

• Create a backup folder for the "library" instance created during installation.

sudo mkdir /var/backup/library

• Setup the root crontab by adding the following:

@daily /usr/sbin/koha-run-backups --output /var/backup --days 2

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

1. Add the above to "root" user crontab. Remove all instances of "__KOHA_USER__" since we are already the "root" user.
2. Remove the process_message_queue.pl task, this is covered with the koha-email-enable command used during installation.
3. Remove the rebuild_zebra.pl task and replace with the koha-rebuild-zebra command by adding the following, to index the "library" instance:

# ZEBRA INDEX UPDATES per instance
*/10 * * * * /usr/sbin/koha-rebuild-zebra library

Step 3 - Setup system 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

Return to Koha wiki page