Difference between revisions of "Koha/Post-Installation"

From Libopedia
Jump to navigation Jump to search
Line 33: Line 33:
  
 
#Add the above to "root" user crontab. Remove all instances of "__KOHA_USER__" since we are already the "root" user.
 
#Add the above to "root" user crontab. Remove all instances of "__KOHA_USER__" since we are already the "root" user.
 +
#Check '''/etc/koha/koha.conf''' for correct database credentials.
 
#Remove the '''overdue_notices.pl''' task, the database credentials do not work.
 
#Remove the '''overdue_notices.pl''' task, the database credentials do not work.
 
#Remove the '''fines.pl''' task, the database credentials do not work.
 
#Remove the '''fines.pl''' task, the database credentials do not work.

Revision as of 11:47, 3 September 2013

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

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. Check /etc/koha/koha.conf for correct database credentials.
  3. Remove the overdue_notices.pl task, the database credentials do not work.
  4. Remove the fines.pl task, the database credentials do not work.
  5. Remove the advance_notices.pl task, the database credentials do not work.
  6. Remove the cleanup_database.pl task, the database credentials do not work.
  7. Remove the process_message_queue.pl task, this is covered with the koha-email-enable command used during installation.
  8. 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
@hourly /usr/sbin/koha-rebuild-zebra -a -b -v library

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

Tips

Return to Koha wiki page
Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=Koha/Post-Installation&oldid=20886"