Installation of 'Embedded ‡biblios' with your Koha ILS

First...

Install any missing dependencies.

‡biblios requires the following components:

  • Apache2 with proxy_http module
  • Perl
  • Perl Modules:
    • CGI
    • CGI::Carp
    • MARC::Record
    • MARC::File::XML
    • File::Temp
    • File::BaseName
    • JSON
    • Term::Clui
    • Template
    • File::Slurp
  • PazPar2 (available here)
  • Google Gears plugin for Firefox/Internet Explorer (available here)

Next...

Get a copy of biblios here.

Then...

Configure Apache to route certain requests from ‡biblios to PazPar2 and Koha.

‡biblios sends search requests to /pazpar2/search.pz2. You need to enable the Apache proxy_http module. Next, configure your Apache server to proxy requests to the pazpar2 daemon with a directive like this:

ProxyPass /pazpar2/search.pz2 http://localhost:9004/search.pz2

Run the pazpar2 daemon with the following command from the base of the ‡biblios directory (you may need to adjust the path to pazpar2):

pazpar2 -D -l logs/pazpar2.log -f conf/pazpar2/pazpar2.cfg -t conf/pazpar2/biblios-pazpar2.cfg

Next...

Configure ‡biblios via its configuration file. There is a sample configuration file in:

/conf/biblios-dist.conf

The configuration file contains settings for Z39.50 search targets and remote targets to send records to (currently only Koha supported).

The configuration file should be called

conf/biblios.conf

Note that in order to retrieve records directly from Koha, as well as to enable extra functionality for Koha-retrieved records (e.g. disabling Koha-specific tags and validating certain required tags), your Koha installation's Search Target name must match your Koha installation's Send Target name.

Next...

Run the following command to build ‡biblios' index.html file to work within your koha installation and install Biblios files. This will prompt you to provide koha installation parameters and then copy the Biblios source files to appropriate paths in your koha installation.

integration/koha/install.pl

Finally...

You should now be able to access biblios from within your koha staff intranet via the following url:

cgi-bin/koha/cataloguing/biblios.pl

Example: http://public-staff.demo.kohalibrary.com/cgi-bin/koha/biblios.pl

You may wish you add a link to the above Biblios url in your header.inc Koha template file, located at

koha-tmpl/intranet-tmpl//includes/header.inc