The development of this repo has been terminated by Koha-Suomi on May 2024.

If you are interested about importing and exporting between Koha library systems then check our plugin page https://github.com/KohaSuomi/koha-plugin-broadcast-biblios

Koha Suomi Services

Koha Suomi services for different interfaces

Getting Started

Clone this repo to your server and set up configuration file koha_suomi_services.conf to the root.

Prerequisites

Install these CPAN packages to your environment. There is also a script in scripts/Install.sh for automating this.

Try::Tiny@0.30
Modern::Perl@1.20181021
Digest::SHA@5.96
Mojolicious@7.59
Mojolicious::Plugin::OpenAPI@1.17
DBIx::Class@0.082840
DBIx::Class::Migration
Exception::Class@1.44
File::Slurp@9999.19
JSON::Patch@0.04

Config file

Add config file to root directory. Copy koha_suomi_services.conf.example to koha_suomi_services.conf and change values to match your system.

Apache proxy pass

Add proxy pass to Apache to access the service. Change port to match your Mojolicious port.

ProxyPass /service http://localhost:3000 keepalive=On
ProxyPassReverse /service http://localhost:3000

Create databases

You can use same database user as Koha uses, remember to grant permissions.

mysql -u root -p
CREATE DATABASE <databasename>
GRANT ALL ON <databasename>.* TO 'kohaadmin'@'localhost' IDENTIFIED BY '{koha user password}';
FLUSH PRIVILEGES;
QUIT

Running the service

Start:

script/koha_suomi_services_daemon.sh start

Stop:

script/koha_suomi_services_daemon.sh stop

Restart:

script/koha_suomi_services_daemon.sh restart