beic-koha

An Ansible recipe for Koha installation on Fedora.

© Fondazione BEIC e Federico Leva, 2016

GNU General Public License v3.0

Requisites used

• Fedora server.
• dnf install ansible libselinux-python python2-dnf.
• Run dnf install langpacks-it, and if your locale is not set in locale also localedef -i it_IT -f UTF-8 it_IT. (Adapt for your language.)
• Note that CPAN may fail if system is not updated.

The recipe has tested on Fedora 25 but not fully on CentOS 7, which requires EPEL for ansible and dnf and Zebra RPMs: CentOS Plus, RPM Fusion and RepoForge lack packages too (notably Yaz).

Steps

• Check that the configuration suits you.
• Edit inventory.ini to add your server IP or hostname.
• From the machine which can ssh into the server, run: ansible-playbook koha.yml -u root -i inventory.ini
  • for local installation: ansible-playbook koha.yml -u root -i inventory.ini --connection local
• Complete the online install.

Migrations

If you're migrating from another Koha installation, you probably want to check the data migration section of the Koha manual implementation checklist, or some information on the koha migration process. In particular, after the installer you may want to visit:

• tools/stage-marc-import.pl and tools/manage-marc-import.pl to import your catalog;
• admin/biblio_framework.pl to import your MARC bibliographic frameworks.

More information

http://wiki.koha-community.org/wiki/Koha_3.22_on_Fedora_23

This use of GitHub is not an endorsement

This project is currently hosted by GitHub for legacy reasons. GitHub is not recommended as it's a service running on proprietary software and does not respect copyleft.

I'm happy to move this one-person project to a freedom-respecting forge if you need to interact with it and you find yourself executing proprietary software (i.e. anything beyond git commands on your local machine).

Free software needs free tools: support the campaign Give up GitHub from the Software Freedom Conservancy.

(This section is released under CC-0.)