vufindtutorialde/04_Installation_Testimport.md

88 lines
3.6 KiB
Markdown
Raw Permalink Normal View History

2017-10-01 17:47:05 +02:00
# Durchführung eines Testimports
Um VuFind und seine Funktionen erstmalig in Augenschein zu nehmen, empfiehlt sich die Durchführung eines Testimports. Dabei laden Sie Testdaten in den Suchindex von VuFind und lernen somit bereits, wie Sie einen ersten einfachen Datenimport durchführen. Gut geeignet für einen Testimport sind Testdaten der Deutschen Nationalbibliothek (DNB).
## Download von Testdaten
2017-12-13 23:49:47 +01:00
Öffnen Sie das Verzeichnis Testdaten auf dem Downloadserver data.dnb.de der Deutschen Nationalbibliothek:
<https://data.dnb.de/testdat/>
2017-10-01 17:47:05 +02:00
2019-12-03 01:17:37 +01:00
Laden Sie die Datei `Atest.utf8.mrc` in das Verzeichnis `Downloads` Ihres Homeverzeichnisses herunter (Rechtsklick auf den Dateinamen und "Ziel speichern unter..." wählen).
2017-10-01 17:47:05 +02:00
![](media/04/image1.png)
2017-12-13 23:49:47 +01:00
## Start von Solr
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Starten Sie die Suchmaschine Solr im Terminal (erforderlich nach jedem Neustart):
2017-10-01 17:47:05 +02:00
2019-12-03 01:17:37 +01:00
```bash
2017-12-13 23:49:47 +01:00
/usr/local/vufind/solr.sh start
2017-10-01 17:47:05 +02:00
```
## Anpassung der Einstellungen für den Import
2019-12-03 01:17:37 +01:00
Öffnen Sie die Datei `marc_local.properties` im Verzeichnis `/usr/local/vufind/import/` mit einem Texteditor und editieren Sie die drei Werte `collection`, `institution` und `building` wie folgt:
2017-10-01 17:47:05 +02:00
![](media/04/image3.png)
2017-12-13 23:49:47 +01:00
Achten Sie darauf, dass Sie jeweils das führende `#`-Zeichen entfernen. Speichern Sie die Änderungen.
2017-10-01 17:47:05 +02:00
## Starten des Importes
Starten Sie den Import:
2019-12-03 01:17:37 +01:00
```bash
2017-12-13 23:49:47 +01:00
/usr/local/vufind/import-marc.sh ~/Downloads/Atest.utf8.mrc
2017-10-01 17:47:05 +02:00
```
2017-12-13 23:49:47 +01:00
Während des Importes werden diverse Statusmeldungen ausgegeben. Zum Abschluss meldet der Import unter anderem, wie viele Datensätze er dem Index hinzugefügt hat:
2017-10-01 17:47:05 +02:00
![](media/04/image4.png)
## Suche in VuFind
Öffnen Sie VuFind in Firefox und starten Sie eine leere Suche, indem Sie den Suchschlitz leer lassen und einfach „Suchen“ anklicken.
![](media/04/image5.png)
2017-12-13 23:49:47 +01:00
Sie können unter anderem erkennen, dass alle 2.455 importierten Datensätze mit der leeren Suche gefunden wurden. Außerdem wird die Suchdauer angegeben (hier: 0,48s).
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Die Suchdauer lässt sich verkürzen, indem Sie den Index optimieren. Außerdem werden Suchanfragen automatisch in einen Cache geladen, so dass eine erneute identische Suche schneller erfolgt.
2017-10-01 17:47:05 +02:00
## Index optimieren
2017-12-13 23:49:47 +01:00
Führen Sie im Terminal folgenden Befehl aus:
2017-10-01 17:47:05 +02:00
2019-12-03 01:17:37 +01:00
```bash
2017-12-13 23:49:47 +01:00
php /usr/local/vufind/util/optimize.php
2017-10-01 17:47:05 +02:00
```
Die Optimierung läuft ohne Anzeigen im Terminal ab und ist beendet, wenn wieder ein Cursor im Terminal erscheint.
2017-12-13 23:49:47 +01:00
Durch die Optimierung des Suchindex werden die Suchen in VuFind jetzt geringfügig schneller erfolgen. In der Dokumentation wird empfohlen, nach jeder Indexierung von neuen Daten den Suchindex zu optimieren.
2017-10-01 17:47:05 +02:00
## Sicherungspunkt in VirtualBox setzen
2017-12-13 23:49:47 +01:00
Fahren Sie das Betriebssystem herunter und setzen Sie in VirtualBox einen weiteren Sicherungspunkt namens „mit Testimport“.
2017-10-01 17:47:05 +02:00
## Weitere Informationen zum Datenimport
2019-12-03 01:17:37 +01:00
Beim Datenimport werden die einzelnen Felder eines Datensatzes einem Indexfeld im Solr-Index zugeordnet. Dies kann mit Hilfe von Einstellungsdateien wie der oben verwendeten `marc_local.properties` beeinflusst werden. Die Einstellungen steuern, welche Felder aus den zu importierenden Daten in welches Indexfeld im Solr-Index importiert werden.
2017-10-01 17:47:05 +02:00
Direkt in VuFind importieren können Sie Daten in den Formaten:
2017-12-13 23:49:47 +01:00
* MARC21 (binäres MARC)
* MARCXML
* XML
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Für den Import von Daten in XML-Formaten sind größere Anpassungen erforderlich. Dies betrifft ebenfalls das Harvesting von Daten über OAI-PMH. Innerhalb des Tutorials werden wir uns ausschließlich mit dem Datenimport in den beiden MARC-Formaten beschäftigen.
2017-10-01 17:47:05 +02:00
## Quellen
2017-12-13 23:49:47 +01:00
VuFind Dokumentation: Performance (Stand 11.8.2017)
<https://vufind.org/wiki/administration:performance>
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
VuFind Dokumentation: Indexing (Stand: 21.4.2017)
2019-12-03 01:17:37 +01:00
<https://vufind.org/wiki/indexing>