vufindtutorialde/03_Installation_VuFind.md

172 lines
7.0 KiB
Markdown
Raw Normal View History

2017-10-01 17:47:05 +02:00
# Installation von VuFind
2017-12-13 23:49:47 +01:00
In den vorigen beiden Kapiteln haben Sie ein Ubuntu-Linux-Betriebssystem (16.04 LTS) in VirtualBox installiert. In diesem Kapitel installieren wir nun VuFind und die dafür benötigten Softwarekomponenten. Dazu gehören:
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
* Webserver (Apache)
* Suchindex (Solr)
* Programmiersprache (PHP)
* Datenbank (MySQL)
2017-10-01 17:47:05 +02:00
## Aktualisierung des Betriebssystems
2017-12-13 23:49:47 +01:00
Vor der Installation sollte das Betriebssystem auf den aktuellsten Stand gebracht werden. Führen Sie dazu folgenden Befehl im Terminal 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
sudo apt-get update && sudo apt-get dist-upgrade
2017-10-01 17:47:05 +02:00
```
2017-12-13 23:49:47 +01:00
Der Installation der Updates müssen Sie mit der Antwort „J“ auf die Frage „Möchten Sie fortfahren? \[J/n\]“ zustimmen.
2017-10-01 17:47:05 +02:00
Anschließend sollte das System neu gestartet werden:
2019-12-03 01:17:37 +01:00
```bash
2017-12-13 23:49:47 +01:00
sudo shutdown -r now
2017-10-01 17:47:05 +02:00
```
## Download des Installationspaketes
Führen Sie im Terminal folgenden Befehl aus:
2019-12-03 01:17:37 +01:00
```bash
2017-12-13 23:49:47 +01:00
wget http://downloads.sourceforge.net/vufind/vufind_4.1.1.deb?use_mirror=osdn -O ~/vufind_4.1.1.deb
2017-10-01 17:47:05 +02:00
```
Die Installationsdatei (ein sogenanntes Paket) wird in Ihr Homeverzeichnis heruntergeladen:
![](media/03/image2.png)
## Installation des Paketes
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
sudo apt install -f ~/vufind_4.1.1.deb
2017-10-01 17:47:05 +02:00
```
2017-12-13 23:49:47 +01:00
Dieser Befehl installiert VuFind und alle für VuFind benötigten Pakete (sogenannte abhängige Pakete). Bei diesen Paketen handelt es sich um die in der Einleitung beschriebenen Softwarekomponenten (Apache, Solr, MySQL, PHP).
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Der Installation müssen Sie mit der Antwort „J“ auf die Frage „Möchten Sie fortfahren? \[J/n\]“ zustimmen.
2017-10-01 17:47:05 +02:00
Für die Installation von MySQL wird die Angabe eines Root-Kennwortes erfragt:
![](media/03/image4.png)
2017-12-13 23:49:47 +01:00
Notieren Sie sich das Kennwort, da es für die spätere Konfiguration von VuFind benötigt wird. Es erscheint ein weiteres Fenster, in welchem Sie die Eingabe des Kennworts wiederholen müssen. Danach wird die Installation fortgesetzt.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Wenn die Installation abgeschlossen ist, starten Sie den Firefox Browser. Rufen Sie die Webseite <http://localhost/vufind> auf. Nach kurzer Zeit erscheint die Startseite von VuFind:
2017-10-01 17:47:05 +02:00
![](media/03/image6.png)
2017-12-13 23:49:47 +01:00
Der Hinweis „Es ist ein Fehler aufgetreten“ erscheint, weil die Suchmaschine Solr noch nicht gestartet wurde.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
## Berechtigungen setzen und Solr starten
2017-10-01 17:47:05 +02:00
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
source /etc/profile
2017-10-01 17:47:05 +02:00
```
2017-12-13 23:49:47 +01:00
Durch diesen Befehl werden die Umgebungsvariablen neu eingelesen, was uns einen Neustart erspart. Die Umgebungsvariablen werden zum Betrieb von VuFind benötigt und enthalten den Pfad zur Java-Instanz, zum Hauptverzeichnis von VuFind sowie zum Verzeichnis mit Ihren lokalen Einstellungen für VuFind.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Geben Sie folgende Befehle ein, um notwendige Berechtigungen für Solr und VuFind zu konfigurieren:
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
sudo chown -R $(id -u):$(id -g) /usr/local/vufind/
sudo chown -R www-data:www-data /usr/local/vufind/local/config
sudo chown -R www-data:www-data /usr/local/vufind/local/cache
2017-10-01 17:47:05 +02:00
```
2017-12-13 23:49:47 +01:00
Der erste Befehl setzt den aktuell angemeldeten Nutzer als Eigentümer des Verzeichnisses `/usr/local/vufind`. Damit der Apache-Webserver auf bestimmte Verzeichnisse zugreifen kann, wird für die Unterordner `local/config` und `local/cache` der Nutzer `www-data` als Eigentümer gesetzt.
Starten Sie dann den Suchindex Solr:
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
```
2017-12-13 23:49:47 +01:00
Wenn Sie die noch im Firefox geöffnete Startseite von VuFind aktualisieren, wird der Fehlerhinweis nicht mehr angezeigt:
2017-10-01 17:47:05 +02:00
![](media/03/image7.png)
2017-12-13 23:49:47 +01:00
## Automatische Konfiguration
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Öffnen Sie jetzt die Seite <http://localhost/vufind/Install/Home>. Angezeigt wird die Autokonfiguration von VuFind:
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
![](media/03/image8.png)
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
### Grundkonfiguration
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Klicken Sie den Schalter „Reparieren“ hinter „Basic Configuration“ an. Dies wird quittiert mit „Your configuration has been successfully updated.“ Wechseln Sie über den Link "Autokonfiguration" wieder zurück auf die vorige Seite.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
### Datenbank
2017-10-01 17:47:05 +02:00
Beim Reparieren von „Database“ erscheint eine Eingabemaske:
![](media/03/image9.png)
Geben Sie in das Feld „New user password“ ein Kennwort ein. Wiederholen Sie dieses Kennwort im Feld „Confirm new user password“. Notieren Sie sich das Kennwort.
Geben Sie im Feld „MySQL Root Password“ das während der VuFind-Installation vergebene Root-Kennwort für MySQL.
Klicken Sie anschließend „Abschicken“ an.
2017-12-13 23:49:47 +01:00
## Anbindung Bibliothekssystem
2017-10-01 17:47:05 +02:00
Beim Reparieren von „ILS“ erscheint ebenfalls eine Eingabemaske:
![](media/03/image10.png)
2017-12-13 23:49:47 +01:00
Wählen Sie „NoILS“ aus der Liste aus. Klicken Sie anschließend „Daten absenden“ an.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
---------
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
**!!!** Alternativ können Sie Ihr Lokalsystem aus der Liste wählen und es konfigurieren. Beachten Sie jedoch, dass dies nicht Bestandteil dieses Tutorials ist.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
---------
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Zurück auf der Konfigurationsseite erhalten wir weiterhin die Fehlermeldung "ILS... Fehlgeschlagen". Die Autokonfiguration hat die Einstellung auf NoILS mit der Option „ils-offline“ gesetzt, die für Wartungsarbeiten gedacht ist. Wir müssen diese noch auf „ils-none“ setzen, um VuFind zu signalisieren, dass tatsächlich kein Lokalsystem angebunden ist. Diese Einstellung ist in der Datei `/usr/local/vufind/local/config/vufind/NoILS.ini` vorzunehmen. Geben Sie dazu im Terminal folgenden Befehl ein:
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
sudo sed -i 's/mode = ils-offline/mode = ils-none/g' /usr/local/vufind/local/config/vufind/NoILS.ini
2017-10-01 17:47:05 +02:00
```
2017-12-13 23:49:47 +01:00
Wenn Sie anschließend die Seite Autokonfiguration neu laden, wird "ILS... OK" angezeigt.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
### Sicherheitseinstellungen
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Klicken Sie abschließend den Schalter „Reparieren“ im Bereich „Security“ an.
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
Unterhalb der Statusmeldungen erscheint nun ein Link zum Abschalten der Autokonfiguration:
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
![](media/03/image11.png)
Klicken Sie „Disable Auto Configuration“ an.
Dies wird mit „Auto configuration has been successfully disabled.“ und der Empfehlung quittiert, die Berechtigungen für das Konfigurationsverzeichnis sicherheitshalber anzupassen. Geben Sie dazu noch den folgenden Befehl ins Terminal ein:
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
sudo chown -R $(id -u):$(id -g) /usr/local/vufind/local/config
2017-10-01 17:47:05 +02:00
```
2017-12-13 23:49:47 +01:00
Dieser Befehl sorgt dafür, dass Ihr Benutzer zum Besitzer des Verzeichnisses `/usr/local/vufind/local/config` wird und dieses nicht mehr durch den Webserver verändert werden kann. Das Verzeichnis enthält die lokale Konfiguration für VuFind (mehr dazu in den folgenden Kapiteln).
## Zwischenstand
Die automatische Konfiguration von VuFind ist damit abgeschlossen und das System einsatzbereit.
Im nächsten Schritt importieren wir Testdaten, denn momentan ist der Suchindex noch komplett leer.
2017-10-01 17:47:05 +02:00
## Sicherungspunkt in VirtualBox setzen
2017-12-13 23:49:47 +01:00
Fahren Sie nun das Betriebssystem herunter und setzen Sie in VirtualBox einen Sicherungspunkt namens „VuFind, bereit für Testimport“.
2017-10-01 17:47:05 +02:00
## Quellen
2017-12-13 23:49:47 +01:00
VuFind Dokumentation: Installation Notes (Stand: 20.11.2017)
<https://vufind.org/wiki/installation:notes>
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
VuFind Dokumentation: Local Settings Directory (Stand 21.12.2015)
<https://vufind.org/wiki/configuration:local_settings_directory>
2017-10-01 17:47:05 +02:00
2017-12-13 23:49:47 +01:00
VuFind on Ubuntu. VuFind Documentation (Stand 20.11.2017)
<https://vufind.org/wiki/installation:ubuntu>