Anleitungen

Installationsanleitung

Index:

• Erscheinungsbemerkungen
• Systemvoraussetzungen
• OpenBiblio 0.7.3(.x)-g Installationsanleitung (Neues System)
• Einrichten des Userlogin
• Update einer früheren Version

Version 0.7.3g wird für neue Installationen und zum updaten von älteren Openbiblio-Versionen empfohlen, da hiermit die Sicherheit verbessert wird. Die wichtigsten änderungen sind im ChangeLog zu finden.

• Versionen vor 0.5.2: sehr wichtig. Das Update funktioniert auch mit den Versionen von openbiblio.de.
• 0.5.2: Die Dringlichkeit hängt ab von Kompatibilität, Bugfixes, Neuen Funktionen und dem Vertrauen in die Benutzer mit der Erlaubnis die Berichte aufzurufen.
• 0.6.0, 0.6.1: Die Dringlichkeit hängt ab von Kompatibilität, Bugfixes und Neuen Funktionen
• 0.7.0, 0.7.1: Viele Bugfixes für Neue Funktionen, besonders in der Ausleihe.
• 0.7.3: Update auf das aktuelle und sicherere Php 7.x möglich

• MARC wird nicht perfekt in der Datenbank abgespeichert (Problem 1, wird gefixed in obiblio-10-wip).
• UTF-8 Multibyte Zeichen: sehr eingeschränkter Support in Berichten und eventuelle Probleme bei der Suche (Problem 19).
• Wenn Sie bis ins Jahr 2038 noch nicht auf 64bit PHP geupdatet haben kann es zu Problemen bei der Berechnung von den Verspätungen, den entsprechenden Verspätungsgebühren und der Berechnung der Reservierungsdauer kommen. (Problem 51).

OpenBiblio Testläufe arbeiteten erfolgreich in den folgenden Konfigurationen:

Betriebssystem:	Ubuntu 14.04 (GNU/Linux)	Microsoft Windows 7	Ubuntu 9.04 (GNU/Linux)	Ubuntu 9.04 (GNU/Linux)
PHP Version:	7.1.13	5.6.0alpha3 VC11 EasyPHP	5.3.1 XAMPP for Linux 173a	4.3.9 XAMPP for Linux 149a
Web Server:	Apache 2.4.7	Apache 2.4.7 VC11	Apache 2.2.14	Apache 2.0.52
MySql Version:	5.5.59	5.6.15 (niedrigere Versionen von 5.6 zählen die Ergebnisse nicht korrekt)	5.1.41	4.0.21

• PHP version 4.2.0 oder höher und ein Webserver, der dies unterstützt.
• MySQL version 4.0.12 oder höher
• Ein relativ moderner Webbrowser. Der Internet Explorer vor der Version 6.0 könnte Probleme mit den pdf-Dateien haben, die Openbiblio generiert. Benutzer von Netscape 4.x und zeitiger könnten Design-Probleme bekommen.

Prozedur

1. Um ihr System für OpenBiblio zu nutzen müssen Sie einen WebServer, PHP und MySQL installiert haben. Wenn Sie dieses nicht schon haben wird empfohlen für diese Installation XAMPP zu nutzen, dieses bietet Ihnen mit einer Installation alle benötigten Programme (außer Openbiblio selber natürlich). XAMPP gibt es für Windows, Linux, MacOS X und Solaris. Die Windows-Version läuft leider nicht mit Windows ME, da dieses Probleme mit Apache2 (aufgrund von TCP/IP-Fehlern von ME) macht. Wenn Sie ME nutzen oder ein nicht hier erwähntes System, nutzen Sie bitte die manuelle Installation (ab Punkt 4), ansonsten fahren sie mit 2. fort (ich danke Christopher Dagleish für den Hinweis auf XAMPP :-))
2. Laden Sie die für ihr System benötigte Version von XAMPP herunter, dabei reicht theoretisch die Lite-Version, aber die volle Version wird trotzdem empfohlen (diese bietet auch regelmäßige Updates...). Installieren Sie anschließend das heruntergeladene XAMPP (die Installation wird auf der Seite der entsprechenden XAMPP-Version auf deutsch genau beschrieben und daher hier nicht weiter erklärt, aber lesen Sie bitte am besten alles dort durch :-)). Starten sie nun XAMPP, nach der dort beschriebenen Methode und schon haben Sie Apache, PHP und MySQL laufen. Fahren Sie nun mit der Einrichtung von OpenBiblio unter Punkt 7. fort!
3. Die folgenden Punkte 4-6 müssen Sie nur durchführen, falls Sie XAMPP nicht installiert haben bzw. nicht konnten (oder es aus welchen Gründen auch immer nicht lief):
4. Installieren Sie einen Webserver wie Apache, der kompatibel mit PHP ist. Wenn sie Apache benutzen, machen Sie sich damit bekannt, wie man den Server startet und anhält. Unter Windows 95/98/ME gibt es im Installationsverzeichnis eine Apache.exe, die sie einfach starten müssen. Eine Verknüpfung mit dieser Datei können sie einfach in ihr Autostartverzeichnis hinzufügen. Mit Windows NT/2000/XP kann man Apache als Service installieren, der auch dann läuft, wenn man ausgeloggt ist. Wenn Sie Linux benutzen sollte Apache normalerweise bei ihrer Linuxdistribution schon dabei sein und sich mit Linux automatisch starten. Achtung: Unter Windows ME gibt es häufig Berichte über Probleme mit Apache 2.0.x (ich selber habe es mit installierten Netzwerkkarten nicht zum laufen gebracht, die TCP/IP-Treiber von ME sind wohl fehlerhaft), nehmen Sie bei Problemen unter ME bitte Apache 1.3.33
5. Fügen Sie PHP zu ihrem Webserver als CGI oder als Module hinzu. Wenn Sie Apache 2.x benutzen, ist es stark empfohlen PHP als Modul statt als CGI zu installieren. Schauen sie auch Beispiel 3-9. PHP and Apache 2.0 as Module (derzeit leider nur in englisch) im PHP Handbuch an, um mehr über die Installation von PHP zu erfahren..

   OpenBiblio benutzt Sessiondaten. Deshalb müssen Sie aufpassen, daß in PHP sessions angestellt sind. Passen Sie auf, daß sie ein Verzeichnis für Sessiondaten auf ihrem Server erstellen und den session.save_path in der php.ini-Datei festlegen. Die Standard php.ini setzt den session.save_path nach "/tmp". Deshalb müssen sie ein Verzeichnis c:/tmp (in Windows) erstellen. Trotz dessen sollten sie ein beschreibenderes Verzeichnis benutzen, erstellen sie ein sessiondata-Verzeichnis im PHP-Verzeichnis und ändern sie ihre php.ini-Datei entsprechend

   Beispiel php.ini Anweisung:

   session.save_path = d:\PHP\sessiondata

   Schauen Sie auch in die Sektion Session Funktionen im PHP Handbuch für mehr Details über PHP-Sessions.

6. Installieren Sie die MySQL Datenbank von http://www.mysql.com/. Machen Sie sich mit dem starten und stoppen des Servers vertraut. Sehen Sie sich auch Starten von MySQL unter Windows 95 oder Windows 98 für mehr Informationen an (nur in englisch).
   
   Wenn Sie Windows NT/2000/XP nutzen, stellen sie MySQL als Service ein, so daß es automatisch mit dem Rechner gestartet wird. Schauen Sie sich auch Starten von MySQL unter Windows NT, Windows 2000 oder Windows XP für mehr Informationen über MySQL als Service an.
   
   Wenn Sie Linux benutzen, sollte MySQL ebenfalls schon dabei sein und mit Linux zusammen starten.
7. Die folgenden Punkte beschreiben das Einrichten von OpenBiblio und müssen von allen ausgeführt werden, die OpenBiblio das erste Mal installieren (egal ob sie XAMPP nutzen oder Apache, PHP, MySQL anders installiert haben):
8. Machen Sie sich vertraut mit dem einloggen unter MySQL aus dem DOS Promt heraus (oder vom Linuxprompt). Am besten nutzen Sie folgende Befehlsequenz.

   C:\>c:\mysql\bin\mysql -uroot mysql
   Enter password: *********
   Welcome to the MySQL monitor.  Commands end with ; or \g.
   Your MySQL connection id is 8 to server version: 3.23.26-beta
   
   Type 'help;' or '\h' for help. Type '\c' to clear the buffer
   
   mysql> show databases;
   +--------------+
   | Database     |
   +--------------+
   | mysql        |
   +--------------+
   6 rows in set (0.00 sec)
   
   mysql> exit
   Bye
   
   C:\>
   

9. Erstellen Sie die OpenBiblio Datenbank. Um dies zu tun, loggen Sie sich in MySQL mit dem AdminAccount ein (wie oben beschrieben) und führen sie folgendes SQL Kommando aus.

   mysql> create database OpenBiblio /*!40100 default character set latin1 */;
   

   Neu: Der bedingte Kommentar /* ... */ wird in MySQL 4.1.0 oder höher ausgeführt und spezifiziert latin1 als Standard-Datenbank Zeichensatz für die Datenbank, die erstellt wird.

   
   

   Sie könnten eventuell Probleme bekommen, wenn der Datenbank Zeichensatz nicht auf latin1 gestellt wird.

   Datenbank Zeichensatz	Registerkarte Admin: Bibliothekseinstellunegn, Feld HTML Zeichensatz	Kommentar
   latin1 (empfohlen)	iso-8859-1 (Initialwert, von der Installation gesetzt)	Keine Probleme.
   utf8	UTF-8	Probleme bei Multibyte Zeichen Suche? PDF Layouts

   Auf neueren Systemen muss unter Umständen die ISO8859-1-Locale erst generiert werden. Hierzu auf dem Linuxprompt den Befehl locale-gen de_DE ausführen.

   
   

   Neu: Wenn der OpenBiblio HTML Zeichensatz auf UTF-8 gestellt ist, können PDF Layouts einige Multibyte Zeichen korrekt anzeigen, indem diese in Single Byte konvertiert werden.

   
   Um zu überprüfen, ob die Datenbank wirklich angelegt wurde führen Sie folgendes Kommando aus.

   mysql> show databases;
   +--------------+
   | Database     |
   +--------------+
   | mysql        |
   | OpenBiblio   |
   +--------------+
   

10. Erstellen Sie den OpenBiblio Datenbank-Benutzer. Um dies zu tun loggen sie sich in MySQL mit dem adminAccount ein und führen Sie folgendes Kommando aus, wobei Sie obiblio_user und obiblio_password mit einem Usernamen und einem Passwort ihrer Wahl ersetzen.

    mysql> ->

    grant all privileges on OpenBiblio.* to obiblio_user@localhost identified by 'obiblio_password';

11. Prüfen Sie ihre Datenbank und den Benutzer, indem Sie sich als Benutzer einloggen.

    C:\mysql\bin\mysql -uobiblio_user -pobiblio_password OpenBiblio
    

12. Kopieren Sie das openbiblio-Verzeichnis und seinen gesamten Inhalt in das htdocs-Verzeichnis oder einen Unterordner ihres htdocs-Verzeichnis ihres Webservers.
13. Bearbeiten sie die Datei database_constants.php (befindet sich im Hauptverzeichnis von openbiblio) mit einem Texteditor ihrer Wahl. Ändern sie den Username und das Passwort auf den neu erstellten MySQL-Benutzer und dessen Passwort (den sie im vorigen Schritt erstellt haben).
14. Erstellen sie die OpenBiblio Tabellen. Um dies zu machen führen Sie das Install-Skript aus, welches Sie mit http://localhost/openbiblio/install/index.php aufrufen können, wobei ich davon ausgehe, daß sie das openbiblio-Verzeichnis in das htdocs-Verzeichnis ihres Webservers kopiert haben.
15. Für die Sicherheit: Entfernen Sie das Verzeichnis openbiblio/install komplett um unbefugten Zugriff auf die install- oder update-Tools zu verhindern.
16. Für die Sicherheit: Prüfen Sie, daß die display_errors Einstellung in der php.ini ist 'Off' um zu verhindern, daß ungeprüfte Informationen angezeigt werden.
17. Für die Sicherheit: Wechseln Sie in das openbiblio-Verzeichnis, ändern Sie sie Gruppe der Datei database_constants.php auf die Apache-Gruppe (meist www-data) und ändern Sie die Rechte auf 440. (chgrp www-data database_constants.php; chmod 440 database_constants.php)
18. Greifen Sie auf ihre neue Bibliothekssoftware unter http://localhost/openbiblio/index.html zu, wobei ich davon ausgehe, daß sie das openbiblio-Verzeichnis in das htdocs-Verzeichnis ihres Webservers kopiert haben. Geben Sie zum einloggen "admin" als Username und als Passwort ein, sobald sie sich einloggen müssen. Sie können das Admin-Passwort ändern in der "Admin"-Registerkarte unter Mitarbeiter, wo Sie auch neue Mitarbeiter hinzufügen können.

1. In Openbiblio unter http://localhost/openbiblio/index.html einloggen und dort in den Admin-Bereich wechseln.
2. Hier in den Bereich Mitgliederfelder wechseln und dort ein neues spezifisches Feld hinzufügen.
3. Das neue Feld muss unbedingt als Kennzeichen "secret" benannt werden. In der Beschreibung können Sie die Bezeichnung selber wählen, ich selber verwende hier "Geheimes Wort". Das Ganze anschließend übermitteln.
4. Ab jetzt ist unter http://localhost/openbiblio/opac/index.html das Benutzerlogin freigeschaltet.
5. In den Benutzerinfos eines Mitglieds kann man ab nun das Geheime Wort hinterlegen. Sobald dies hinterlegt ist kann sich dieses Mitglied unter http://localhost/openbiblio/opac/loginform.php unter Angabe der Benutzernummer und des Geheimwort einloggen und seine Medien verlängern bzw. Vorbestellungen vornehmen. Wenn ein Mitglied kein Geheimwort hinterlegt hat erscheint hier die Info, daß er ein Geheimes Wort hinterlegen lassen muss.

1. Benennen Sie ihr altes openbiblio-Verzeichnis um, so daß der Inhalt nicht verloren geht. Wir nennen hier das alte Verzeichnis openbiblio-old.
2. Kopieren Sie das neue openbiblio-Verzeichnis und seinen Inhalt in ein Verzeichnis, das benannt werden sollte, wie das alte vorher hieß.
3. Kopieren Sie die Datei database_constants.php aus dem openbiblio-old Verzeichnis in das neue openbiblio-Verzeichnis, indem Sie die Datei database_constants.php darin ersetzen.
4. Erstellen sie unbedingt ein Backup ihrer Datenbank. Lesen Sie dazu die MySQL Dokumentation für eine Anleitung. (mysqldump benutzen)
5. Updaten Sie die OpenBiblio-Datenbank-Tabellen, indem Sie das Konversions-Tool nutzen, welches sie unter http://localhost/openbiblio/install/index.php finden, wobei ich davon ausgehe, daß sie das openbiblio-Verzeichnis in das htdocs-Verzeichnis ihres Webservers kopiert haben. Wenn es auf einem entfernten Server installiert ist, ist auch der erste Teil der Adresse unterschiedlich. Wenn die Tabellen schon OK sind dann sagt das Tool: nein
6. Für die Sicherheit: Entfernen Sie das Verzeichnis openbiblio/install komplett um unbefugten Zugriff auf die install- oder update-Tools zu verhindern. Falls vorhanden entfernen Sie auch das openbiblio/tests-Verzeichnis
7. Für die Sicherheit: Prüfen Sie, daß die display_errors Einstellung in der php.ini ist 'Off' um zu verhindern, daß ungeprüfte Informationen angezeigt werden.
8. Für die Sicherheit: Wechseln Sie in das openbiblio-Verzeichnis, ändern Sie sie Gruppe der Datei database_constants.php auf die Apache-Gruppe (meist www-data) und ändern Sie die Rechte auf 440. (chgrp www-data database_constants.php; chmod 440 database_constants.php)