Nachtrag Kapitel 11

11_0_projektpraesentationen-und-abschlussdiskussion.md

@@ -0,0 +1,14 @@
+# 11 Projektpräsentationen und Abschlussdiskussion
+
+Ziel: Projektpräsentationen zu alternativen Vorgehensweisen (andere Daten, andere Werkzeuge) in und Reflexion zur Frage "Was fehlt noch für einen Produktivbetrieb?"
+
+Inhalte:
+
+1. [Projektpräsentationen](11_1_projektpraesentationen.md)
+2. [Was haben wir im Seminar erreicht?](11_2_was-haben-wir-im-seminar-erreicht.md)
+3. [Was fehlt noch für einen Produktivbetrieb?](11_3_was-fehlt-noch-fuer-einen-produktivbetrieb.md)
+4. [Optimierung der virtuellen Maschine](11_4_optimierung-der-virtuellen-maschine.md)
+
+Beiträge der Studierenden in den Lerntagebüchern:
+
+* ...

11_1_projektpraesentationen.md

@@ -0,0 +1,34 @@
+# 11.1 Projektpräsentationen
+
+Neben den Referaten und den Lerntagebüchern gab es für die Studierenden auch die Möglichkeit in Projekten weiter mit der Technik zu experimentieren und ihre Erkenntnisse in der abschließenden Sitzung zu präsentieren. Folgende Projektaufgaben wurden vergeben:
+
+1. VuFind als Beispiel für eine integrierte Lösung (Datenprozessierung und Katalog)
+2. Zusätzliche Daten mit OpenRefine bearbeiten und in den Katalog spielen
+3. Anpassungen an der Katalogoberfläche mit TYPO3/TYPO3-find (Design & funktional)
+
+## Präsentation zu VuFind
+
+Maria von Loh und Ines Rettmer haben sich mit der Komplettlösung [VuFind](https://vufind.org/vufind/) beschäftigt, die an vielen Bibliotheken in Deutschland im Einsatz ist und seit 10 Jahren als Open-Source-Projekt stetig weiterentwickelt wird.
+
+Erkenntnisse:
+
+* Eine native Installation von VuFind unter Windows ist schwierig. Eine Testinstallation unter Windows fällt leicher mit VirtualBox, also der Installation von VuFind mit Linux in einer virtuellen Maschine (vgl. Kapitel 3.1).
+* Der erste Start dauert etwa 15 Minuten und dann empfangen einen zunächst viele rote Balken mit Fehlermeldungen. Die Installationsanleitung gibt an dieser Stelle vor, den "Reparieren-Knopf" zu drücken und dann funktioniert in der Regel auch alles. Also nicht von den Fehlermeldungen abschrecken lassen.
+* VuFind mag Daten am liebsten im Format MARC21 in der Kodierung UTF-8. Testdaten können bei der Deutschen Nationalbibliothek heruntergeladen werden: http://datendienst.dnb.de/cgi-bin/mabit.pl?userID=testdat&pass=testdat&cmd=login
+* Die Konfiguration erfolgt oft direkt in Konfigurationsdateien und nicht in der grafischen Administrationsoberfläche. Die Konfigurationsmöglichkeiten sind aber gut dokumentiert und es finden sich auch viele Erklärungen innerhalb der Konfigurationsdateien.
+
+Literaturempfehlung der ReferentInnen: Tutorial "Inbetriebnahme einer lokal installierten Demoversion von VuFind" von Stefan Niesner bei b.i.t.online: http://www.b-i-t-online.de/heft/VuFind/2016-02-tutorial.php
+
+## Präsentation zu Forschungsdaten
+
+Leif Klemstein und Jonas Engeland haben Metadaten aus dem Forschungsdaten-Repository [Zenodo](https://zenodo.org) über eine OAI-Schnittstelle heruntergeladen, diese mit OpenRefine bearbeitet und in den Suchindex geladen. Es ist ein Beispiel dafür, wie zusätzliche Open-Access-Dokumente im Bibliothekskatalog nachgewiesen werden können. Für den Download der Metadaten über die OAI-Schnittstelle von Zenodo wurde das Werkzeug [Catmandu](http://librecat.org/) eingesetzt.
+
+Die Referenten haben ausführliche [Präsentationsfolien](https://felixlohmeier.gitbooks.io/seminar-wir-bauen-uns-einen-bibliothekskatalog/content/slides/11_1_engeland_klemstein_forschungsdaten.pdf) zu ihrem Vorgehen erstellt, mit denen die Schritte detailliert nachvollzogen werden können.
+
+## Präsentation zu Anpassungsmöglichkeiten von TYPO3-find
+
+Theresa Sophia Joest und Elisa Server haben die Möglichkeiten zur Konfiguration und Gestaltung von TYPO3-find ausgetestet. Dabei hat sich herausgestellt, dass einige der in der Dokumentation angebotenen Anpassungsmöglichkeiten nicht in Verbindung mit unserer Installation über Docker-Container funktionieren. Die Beispielinstallationen der SUB Göttingen (wie z.B. die Klosterdatenbank Germania Sacra, vgl. Kapitel 10.2) demonstrieren, dass mit TYPO3-find sehr viele Funktionen umsetzbar sind, aber viele Konfigurationsmöglichkeiten sind nicht vollständig dokumentiert. TYPO3-find ist schlank und gut programmiert, aber hat im Vergleich zu VuFind keine große Anwendercommunity und bietet somit auch weniger erprobte Anleitungen. Für die Detailarbeit sind also vertiefte TYPO3-Kenntnisse erforderlich.
+
+Im Projekt haben die ReferentInnen gestalterische Anpassungen präsentiert, wie beispielsweise die Veränderung des Webseitentitels, die Veränderung des Farbschemas und ein neues Layout für die Detailansicht. Sie haben zudem weitere Facetten angelegt. Umfangreichere inhaltliche Änderungen wie die Facettenfunktionen Histogramm oder Autovervollständigung haben in unserer Installation nicht funktioniert. Als Ursache werden Inkompatibilitäten zwischen dem Javascript-Frameworks unserer TYPO3-Installation (Introduction Package) und den Javascript-Funktionen von TYPO3-find vermutet.
+
+Ein nachträglicher Test mit einer frischen Installation hat diese Erkenntnisse bestätigt. Eine Rückfrage an die Entwickler von TYPO3-find ist gestellt, aber noch offen (vgl. [Ticket in GitHub](https://github.com/subugoe/typo3-find/issues/121)).

11_2_was-haben-wir-im-seminar-erreicht.md

@@ -0,0 +1,8 @@
+# 11.2 Was haben wir im Seminar erreicht?
+
+* Sie haben grundlegende Funktionsweisen von Webservern und Virtualisierungstechnologien (VirtualBox, Docker) kennengelernt und erschrecken nicht vor der Kommandozeile von Linux.
+* Sie haben OpenRefine zur Transformation von bibliothekarischen Metadaten benutzt und Unterschiede zwischen verschiedenen Metadatenstandards (MARC21, PICA, Dublin Core, usw.) gesehen.
+* Sie haben Katalogdaten in den Suchmaschinenindex Solr geladen.
+* Sie haben TYPO3-find als Beispiel für eine Katalogsoftware installiert und konfiguriert.
+
+Über die praktische Auseinandersetzung mit der Technik haben Sie sich einen Blick hinter die Kulissen von Discovery-Systemen verschafft. Auf Ihrem persönlichen Webserver läuft jetzt der Suchmaschinenindex Solr und das Content-Management-System TYPO3 mit der Erweiterung TYPO3-find. Für die Zusammenarbeit mit IT-KollegInnen an einem Discovery-Projekt in einer Bibliothek sind Sie jetzt gerüstet, da Sie viele der IT-Prozesse aus eigener Erfahrung besser einschätzen können.

11_3_was-fehlt-noch-fuer-einen-produktivbetrieb.md

@@ -0,0 +1,15 @@
+# 11.3 Was fehlt noch für einen Produktivbetrieb?
+
+Für den Betrieb eines Discovery-Systems fehlen noch zahlreiche Funktionen. In der Abschlussdiskussion haben wir ohne Anspruch auf Vollständigkeit folgende Punkte gesammelt:
+
+* Anbindung Benutzerkonto/Ausleihe
+* Exemplarinformationen dynamisch anzeigen
+* Schema erweitern
+* Standard-Crosswalks verwenden oder MARC-Daten genau analysieren
+* Datenquellen erweitern und einzeln betrachten (Online-Ressourcen!, vgl. beispielsweise [Datenquellen des Katalogs der SLUB Dresden](http://www.slub-dresden.de/recherche/slub-katalog-beta/))
+* Design
+* Automatisierung (tägliche Aktualisierungen der Daten)
+* Zusatzfunktionen wie Merkliste und Export in Literaturverwaltungsprogramme
+* Apps für Mobilgeräte
+
+Darüber hinaus haben wir im Seminar nur eine Testinstallation der benötigten Softwarekomponenten vorgenommen. Für einen öffentlichen Dauerbetrieb würde ein/e Systemadministrator/in noch einige Vorkehrungen zur IT-Sicherheit und zur Wartung der Systeme treffen (müssen).

11_4_optimierung-der-virtuellen-maschine.md

@@ -0,0 +1,169 @@
+# 11.4 Optimierung der virtuellen Maschine
+
+Sie sind jetzt im Bonuslevel angekommen!
+
+Wenn Sie die virtuelle Maschine noch weiter verwenden möchten, dann empfiehlt es sich noch ein paar Anpassungen an der Installation vorzunehmen.
+
+Ziel: Beim Start der virtuellen Maschine automatisch Docker-Container ausführen. Willkommensbildschirm und Loginmessage anpassen.
+
+## Automatischer Start der Docker-Container
+
+### solr.service
+
+```sudo nano /etc/systemd/system/solr.service```
+
+Im Editor folgenden Text eingeben und Datei speichern:
+
+```
+[Unit]
+Description=Solr fuer Katalog
+Requires=docker.service
+After=docker.service
+
+[Service]
+ExecStart=/usr/bin/docker start -a my_solr
+ExecStop=/usr/bin/docker stop my_solr
+
+[Install]
+WantedBy=default.target
+```
+
+### typo3-db.service
+
+```sudo nano /etc/systemd/system/typo3-db.service```
+
+Im Editor folgenden Text eingeben und Datei speichern:
+
+```
+[Unit]
+Description=Maria-DB für Katalog
+Requires=docker.service
+After=docker.service
+
+[Service]
+ExecStart=/usr/bin/docker start -a typo3-db
+ExecStop=/usr/bin/docker stop typo3-db
+
+[Install]
+WantedBy=default.target
+```
+
+### katalog.service
+
+```sudo nano /etc/systemd/system/katalog.service```
+
+Im Editor folgenden Text eingeben und Datei speichern:
+
+```
+[Unit]
+Description=TYPO3 für Katalog
+Requires=docker.service solr.service typo3-db.service
+After=docker.service solr.service typo3-db.service
+
+[Service]
+ExecStart=/usr/bin/docker start -a typo3-web
+ExecStop=/usr/bin/docker stop typo3-web
+ExecStopPost=/usr/bin/docker stop -t 5 typo3-db
+ExecStopPost=/usr/bin/docker stop -t 5 my_solr
+
+[Install]
+WantedBy=default.target
+```
+
+### openrefine.service
+
+```sudo nano /etc/systemd/system/openrefine.service```
+
+Im Editor folgenden Text eingeben und Datei speichern:
+
+```
+[Unit]
+Description=OpenRefine
+Requires=docker.service
+After=docker.service
+
+[Service]
+ExecStart=/usr/bin/docker run --name=refine-server -p 8888:3333 -v /home/stud/refine:/data felixlohmeier/openrefine:dev -i 0.0.0.0 -m 1G -d /data"
+ExecStop=/usr/bin/docker stop -t 50 refine-server
+ExecStopPost=/usr/bin/docker rm -f refine-server
+
+[Install]
+WantedBy=default.target
+```
+
+### Services aktivieren
+
+
+```
+sudo systemctl daemon-reload
+sudo systemctl enable solr.service
+sudo systemctl enable typo3-db.service
+sudo systemctl enable katalog.service
+sudo systemctl enable openrefine.service
+```
+
+## Anpassung Willkommensbildschirm von Turnkey
+
+### confconsole.conf
+
+```sudo nano /etc/confconsole/confconsole.conf```
+
+Im Editor das Zeichen ```#``` vor ```default_nic``` in Zeile 2 entfernen und Datei speichern.
+
+### services.txt
+
+```sudo nano /etc/confconsole/services.txt```
+
+Im Editor folgenden Text ergänzen und Datei speichern:
+
+```
+Katalog:    http://$ipaddr
+TYPO3:      http://$ipaddr/typo3
+Solr:       http://$ipaddr:8983
+OpenRefine: http://$ipaddr:8888
+```
+
+## Anpassung Willkommensnachricht beim Login
+
+```sudo nano /etc/update-motd.d/90-footer```
+
+Im Editor folgenden Text eingeben und Datei speichern:
+
+```
+#!/bin/sh
+echo "*** Status der Docker-Container ***"
+docker ps -a
+echo ""
+echo "*** Befehl für stop/start des Katalogs (docker typo3-web, typo3-db und my_solr) ***"
+echo "sudo systemctl stop katalog"
+echo "sudo systemctl start katalog"
+echo ""
+echo "*** Befehl für stop/start von OpenRefine (docker refine-server) ***"
+echo "sudo systemctl stop openrefine"
+echo "sudo systemctl start openrefine"
+echo ""
+phymem=$(free -m|awk '/^Mem:/{print $2}')
+if [ $phymem -lt 2000 ]; then
+echo "Achtung: Für die Arbeit mit OpenRefine werden 2000MB Arbeitsspeicher benötigt. Es stehen aber nur ${phymem}MB zur Verfügung. Bitte weisen Sie der virtuellen Maschine mehr Arbeitsspeicher zu, wenn Sie OpenRefine verwenden wollen."
+echo ""
+fi
+```
+
+Anschließend folgenden Befehl ausführen:
+
+```sudo chmod +x /etc/update-motd.d/90-footer```
+
+## Achtung: Arbeitsspeicher und OpenRefine
+
+Wenn Sie der virtuellen Maschine mehr als 2GB Arbeitsspeicher zuweisen können, dann können Sie den Speicher für OpenRefine erhöhen.
+
+Beispiel für 4GB Arbeitsspeicher der VM:
+
+* ```sudo nano /etc/systemd/system/openrefine.service```
+* Im Editor in der Zeile ```ExecStart=``` das ```-m 1G``` durch ```-m 3G``` ersetzen
+
+## Neustart
+
+Die Änderungen werden bei einem Neustart der virtuellen Maschine wirksam
+
+```sudo shutdown -r now```