Difference between revisions of "Koha/Post-Installation"

From Libopedia
Jump to navigation Jump to search
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
==Step 1 - Enable system backup and monitor==
+
==Step 1 - Setup email delivery==
−
*With the packages installation, the '''koha-run-backups''' command is available. See below for help.
 
−
<pre>
 
−
/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'.
 
−
</pre>
 
−
*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
 
−
 
 
−
#Add the above to "root" user crontab. Remove all instances of "__KOHA_USER__" since we are already the "root" user.
 
−
#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 '''advance_notices.pl''' task, the database credentials do not work.
 
−
#Remove the '''cleanup_database.pl''' task, the database credentials do not work.
 
−
#Remove the '''process_message_queue.pl''' task, this is covered with the '''koha-email-enable''' command used during installation.
 
−
#Remove the '''rebuild_zebra.pl''' task and replace with the '''koha-rebuild-zebra''' command by adding the following, to index the "library" instance:
 
−
<pre>
 
−
# ZEBRA INDEX UPDATES per instance
 
−
*/10 * * * * /usr/sbin/koha-rebuild-zebra library
 
−
</pre>
 
−
 
 
−
==Step 3 - Setup system email delivery==
 
 
*Install mail delivery agent
 
*Install mail delivery agent
 
  sudo apt-get install postfix
 
  sudo apt-get install postfix
Line 70: Line 25:
 
===Tips===
 
===Tips===
 
*https://github.com/colinsc/koha/blob/master/misc/maintenance/borrowers-force-messaging-defaults
 
*https://github.com/colinsc/koha/blob/master/misc/maintenance/borrowers-force-messaging-defaults
 +
 +
==Step 2 - Setup custom website style==
 +
*Select the "ccsr" theme using the '''opacthemes''' parameter in the admin interface.
 +
*Setup the '''opacsmallimage''' in the admin interface.
 +
*See the highlighted red boxes in the screenshot below for customisable areas of the OPAC web interface.
 +
 +
[[File:Koha.png]]
 +
 +
*The following folder contains the CCS files to style the OPAC client depending on which theme you selected.
 +
/usr/share/koha/opac/htdocs/opac-tmpl
 +
*The following folder contains the CCS files to style the admin interface.
 +
/usr/share/koha/intranet/htdocs/intranet-tmpl
 +
===Help===
 +
*http://wiki.lib.sun.ac.za/images/5/56/OPAC-Customization.pdf
 +
*http://libill.hartford.edu/koha/development/index.asp
 +
*http://manual.koha-community.org/3.4/en/impopac.html
 +
*http://wiki.koha-community.org/wiki/Customising_Notices_and_Slips
 +
*http://wiki.koha-community.org/wiki/Receipt_Printing_Fonts
 +
----
 +
* http://learnlayout.com
 +
* http://www.csstutorial.net
 +
* http://www.echoecho.com/css.htm
 +
* http://htmldog.com
 +
* http://htmlhelp.com/reference/css
 +
* http://www.fontsquirrel.com
 +
* http://validator.w3.org
 +
* http://jigsaw.w3.org/css-validator
 +
 +
==Step 3 - Enable LDAP user ID and authentication==
 +
To do.
 +
===Help===
 +
*http://perldoc.koha-community.org/C4/Auth_with_ldap.html
 +
*http://kohablog.wordpress.com/category/koha/ldap
 +
*http://bywatersolutions.com/2012/07/09/koha-ldap
 +
*http://www.slideshare.net/ohiocore/koha-integration-ldap
 +
 +
==Step 4 - Enable Plugins==
 +
See: http://kohageek.blogspot.com/2013/09/how-to-setup-plugin-system-in-koha.html
 +
 +
Below is a brief procedure on how to add a "plugins" preference to Koha. Remember, with the packages installation method, these paths must be modified to point to your instance of Koha.
 +
 +
*To enable Koha plugins, the system preference '''UseKohaPlugins''' must be enabled.
 +
*Create the directory '''/var/lib/koha/plugins'''
 +
*Add the following lines to your '''koha-conf.xml''' file
 +
<pre>
 +
      <pluginsdir>/var/lib/koha/plugins</pluginsdir>
 +
      <enable_plugins>1</enable_plugins>"
 +
</pre>
 +
*Add the following line to your '''koha-httpd.conf''' file
 +
Alias /plugin/ "/var/lib/koha/plugins/"
 +
*Restart your webserver
 +
*Access the plugins system from the "More" pulldown
 +
*Upload the example plugin file provided here.
  
 
  '''[[Koha|Return to Koha wiki page]]'''
 
  '''[[Koha|Return to Koha wiki page]]'''

Latest revision as of 13:48, 30 September 2013

Step 1 - 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

Step 2 - Setup custom website style

  • Select the "ccsr" theme using the opacthemes parameter in the admin interface.
  • Setup the opacsmallimage in the admin interface.
  • See the highlighted red boxes in the screenshot below for customisable areas of the OPAC web interface.

Koha.png

  • The following folder contains the CCS files to style the OPAC client depending on which theme you selected.
/usr/share/koha/opac/htdocs/opac-tmpl
  • The following folder contains the CCS files to style the admin interface.
/usr/share/koha/intranet/htdocs/intranet-tmpl

Help

Step 3 - Enable LDAP user ID and authentication

To do.

Help

Step 4 - Enable Plugins

See: http://kohageek.blogspot.com/2013/09/how-to-setup-plugin-system-in-koha.html

Below is a brief procedure on how to add a "plugins" preference to Koha. Remember, with the packages installation method, these paths must be modified to point to your instance of Koha.

  • To enable Koha plugins, the system preference UseKohaPlugins must be enabled.
  • Create the directory /var/lib/koha/plugins
  • Add the following lines to your koha-conf.xml file
      <pluginsdir>/var/lib/koha/plugins</pluginsdir>
      <enable_plugins>1</enable_plugins>"
  • Add the following line to your koha-httpd.conf file
Alias /plugin/ "/var/lib/koha/plugins/"
  • Restart your webserver
  • Access the plugins system from the "More" pulldown
  • Upload the example plugin file provided here.
Return to Koha wiki page
Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=Koha/Post-Installation&oldid=21366"