Teil 1: Installation – Wie man Koha installiert und für Schulen einrichtet

By zefanja

Koha, ein [integriertes Bibliothekssystem][1], ist eines der [besten Open Source Projekte][2], das ich kenne. Wir verwenden es in unserer [Schul- und Lehrmittelbibliothek][3]. Weltweit wird es von vielen Schulen, Universitäten und natürlich Bibliotheken verwendet. Es bringt sehr viele Features mit und man kann es sehr flexibel konfigurieren und anpassen. Jedoch hat es einen Nachteil: Wenn man bisher wenig mit dem Bibliothekswesen zu tun hatte, ist der Einstieg recht steil, weniger in Koha, sondern in das [bibliografische Datenformat MARC 21][4]. Deshalb möchte ich in dieser Artikelreihe zeigen, wie man Koha installiert und für Schulen einrichtet.

Dieser Artikel ist ein Teil einer Serie:

  1. [Installation und Einrichtung einer ersten Bibliothek][5]
  2. [Das bibliografische Framework][6]
  3. [Grundeinstellungen][7]
  4. [Buchaufnahme][8]
  5. [Drucken von Etiketten][9]
  6. [Ausleihkonditionen][10]
  7. Verbinden mit einem Z.39.50 / SRU Server
  8. Benachrichtigungen und Erinnerungen
  9. Mahnungen und Gebühren

Installation

Vorbereitungen

Koha ist eine Webanwendung für die wir einen Webserver brauchen.  Das kann ein eigener Rechner sein, eine virtuelle Maschine oder ein Linux-Container. Wir werden in diesem Beispiel ein [LXD-Container][11] mit Ubuntu 20.04 verwenden, es geht aber auch jeder andere Rechner mit Debian oder Ubuntu.

Zuerst fügen wir die Paketquellen und den zugehörigen Schlüssel für Koha hinzu:

$ echo deb http://debian.koha-community.org/koha stable main | sudo tee /etc/apt/sources.list.d/koha.list
$ wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Danach müssen wir die Paketquellen einmal aktualisieren:

$ sudo apt update

Nun können wir Koha und den Datenbankserver installieren:

$ sudo apt install koha-common mariadb-server

Damit unser Datenbankserver sicherer wird, können wir mit folgendem Befehl einige Einstellungen ändern:

$ sudo mysql_secure_installation
```

Bis auf die erste Frage können alle Fragen können mit Ja („Y“) beantwortet werden. Es sollte unbedingt ein Root-Passwort festgelegt werden!

Bevor wir Koha einrichten, müssen wir ein paar grundlegende Einstellungen in der Datei _**/etc/koha/koha-sites.conf**_ vornehmen. Es geht um die Festlegung der Domain unter welcher Koha und der OPAC (die Website für die Benutzer) später erreichbar ist. Sie setzt sich dabei wie folgt zusammen:

  * OPAC: _bibliothek.domain.tld_
  * Koha-Intranet: _bibliothek-intra.domain.tld_

Dazu öffnen wir die Datei und ändern folgende Parameter:

  * DOMAIN – hier tragen wir die Haupt-Domain ein, z.B. „.meine-schule.org“
  * INTRASUFFIX – standardmäßig „-intra“, z.B. bibliothek_-intra_.meine-schule.org


$ sudo nano /etc/koha/koha-sites.conf
```

Danach aktivieren wir noch einige Webserver-Module, damit Koha später erreichbar ist:


$ sudo a2enmod rewrite
$ sudo a2enmod cgi
$ sudo service apache2 restart
```

#### Deutsches Sprachpaket installieren

Das deutsche Sprachpaket können wir so installieren:

```
$ sudo koha-translate --install de-DE
```

Später ist sowohl der Webinstaller als auch Koha in Deutsch verfügbar.

#### Bibliotheksinstanz erstellen

Mit Koha können wir mehrere Bibliotheken erstellen und verwalten. Bisher existiert aber noch keine, deshalb müssen wir erst einmal eine erstellen.

```
$ sudo koha-create --create-db bibliothek
```

Soll Koha später unter _bibliothek.meine-schule.org_ erreichbar sein, müssen wir _bibliothek_ als Bibliotheksnamen verwenden.

Als nächsten aktivieren noch die neue Konfiguration für den Webserver und starten ihn neu:


$ sudo a2enmod deflate
$ sudo a2ensite bibliothek
$ sudo service apache2 restart
```

Damit wir den Webinstaller erreichen können müssen wir die IP und den Domainnamen entweder in unseren DNS-Server eintragen oder lokal in die hosts-Datei. In Ubuntu befindet sie sich unter _**/etc/hosts**__._ Die IP findet man z.B. mit `ifconfig` heraus.

```
$ sudo nano /etc/hosts
...
10.97.127.207 bibliothek.meine-schule.org
10.97.127.207 bibliothek-intra.meine-schule.org
...
```

### Koha einrichten

#### Grundinstallation

Unter http://bibliothek-intra.meine-schule.org erreichen wir den Webinstaller.

Koha Installation 

Der Benutzer ist koha__bibliotheksname_. Das Passwort erhalten wir mit folgendem Befehl (_bibliotheksname_ anpassen!):


$ sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/bibliotheksname/koha-conf.xml;echo
```

Im nächsten Schritt können wir dann die Sprache auswählen:

koha sprache 

In den nächsten Schritten werden Abhängigkeiten geprüft, z.B. ob alle Perl-Module vorhanden sind, die Datenbanktabellen eingerichtet und ein MARC-Format muss ausgewählt werden (MARC21 ist der Standard).

Koha Marc21 

Dann kommt eine längere Seite auf der wir die Datenbank mit verschiedenen Vorlagen und Beispieldaten befüllen können. Hier muss jeder für sich entscheiden, was er alles in der Datenbank haben möchte. Wir wählen zu den bereits markierten Punkte noch folgende hinzu:

  * Bibliographisches Standard-Framework für MARC21
  * „FA“, ein MARC21-Framework (Erfassungsmaske) für Schnellaufnahmen und Fernleihtitel
  * Beispiele für die Auswahllisten der verschiedenen normierten Werte (Verloren, Beschädigt, Sammlung, Standort etc.) …
  * Nützliche Benutzerattribute

Koha Grundeinstellungen 

Damit ist die Grundinstallation abgeschlossen.

#### Bibliothek und erste Einstellungen einrichten

Nun werden wir gefragt, wie unsere Bibliothek heißen soll. Dazu legen wir ein Kürzel fest (kann später nicht geändert werden) und vergeben einen Namen. Wir nennen sie hier im Beispiel _Schulbibliothek_.

Koha Bibliothek anlegen 

Als nächstes erstellen wir einen ersten Benutzertypen. Das Admin-Konto, welches wir gleich anlegen, verwendet diesen Benutzertyp. Wieder müssen wir ein Kürzel bzw. Code für die Kategorie vergeben („_MA_„) , eine Beschreibung und die Dauer der Mitgliedschaft. Letztere legt fest, wann ein Benutzerkonto in dieser Kategorie abläuft.

Koha Benutzertyp 

Nachdem der Benutzertyp angelegt ist, erstellen wir den Administrator. Dieser Benutzer hat „_Superlibraian_„-Rechte. Alle Felder müssen ausgefüllt werden.

Koha Admin 

Nun legen wir einen ersten Medientyp fest. Das können Bücher, CDs, DVDs, Karten usw. sein. Wieder brauchen wir ein Code, der später nicht geändert werden kann, und einen Beschreibung:

Koha Medientyp 

Zuletzt legen wir die Ausleihkonditionen für den eben erstellten Medientyp fest. Die Einstellungen sind sehr flexibel. Man kann die Leihfrist einstellen oder für welche Bibliothek oder Benutzertyp die Regel gelten soll. Wir können die Regeln später noch ändern.

Koha Ausleihkonditionen 

Damit ist die Grundinstallation von Koha und unserer ersten Bibliothek abgeschlossen! Unter http://bibliothek-intra.meine-schule.org können wir uns nun mit unserem Admin-Konto anmelden und haben damit Zugriff auf die Administrationsseite von Koha. Dort nehmen wir alle weiteren Einstellungen vor, verleihen Bücher oder nehmen sie wieder zurück.

### Fazit

Wir haben nun eine funktionieren Koha-Installation und eine erste Bibliothek. Trotzdem sind viele weitere Einstellungen nötig, bevor wir die ersten Medien in Koha aufnehmen können. Dies möchte ich in den kommenden Artikeln dieser Serie aufzeigen.

 [1]: https://de.wikipedia.org/wiki/Koha_(Bibliothekssoftware)
 [2]: https://zefanjas.de/5-grossartige-open-source-programme-die-wir-in-unserer-schule-einsetzen/
 [3]: https://zefanjas.de/umstieg-von-littera-zu-koha-teil-1/
 [4]: https://de.wikipedia.org/wiki/Machine-Readable_Cataloging
 [5]: https://zefanjas.de/wie-man-koha-installiert-und-fuer-schulen-einrichtet-teil-1/
 [6]: https://zefanjas.de/koha-installation-schule-bibliografische-framework/
 [7]: https://zefanjas.de/teil-3-grundeinstellungen-wie-man-koha-installiert-und-fuer-schulen-einrichtet/
 [8]: https://zefanjas.de/teil-4-katalogisierung-wie-man-koha-installiert-und-fuer-schulen-einrichtet/
 [9]: https://zefanjas.de/teil-5-etikettendruck-wie-man-koha-installiert-und-fuer-schulen-einrichtet/
 [10]: https://zefanjas.de/teil-6-ausleihkonditionen-wie-man-koha-installiert-und-fuer-schulen-einrichtet/
 [11]: https://zefanjas.de/5-gruende-warum-wir-lxd-verwenden/