jBib Dokumentation

Übersicht
Über jBib

Installation
  Interbase
  PostgreSQL

Rote Fäden
  Gruppenleihe
  Personenleihe
  Rückgabe
  Suchen
  Jahresmigration
  Einstellungen
  FAQ

Installation

Anleitungen zur Installation mit einer speziellen Datenbank:

• Installtion mit Interbase
• Installtion mit PostgreSQL

Für alle anderen hier eine Installationsanleitung, die weitgehend datenbankunabhängig sein sollte.
Die Installation sieh zwar kompliziert aus, sollte aber nach dieser Anleitung glatt gehen. Irgendwelche Hinweise usw. bitte mailen! (Siehe http://www.jbib.de/kontakt.html)

Installation der Datenbank

1. Da jBib auf mehreren Rechner gleichzeitig auf dem selben Datenbestand arbeiten kann, ist ein zentraler Rechner nötig, diesen Datenbestand verwaltet (Server). Auf dem Server kann natürlich gleichzeitig auch die Oberfläche von jBib benutzt werden. Es ist also eine spezielle Software nötig, eine sogenannte Datenbank. Um das Rad nicht immer neu zu erfinden, setzt jBib auf bewährte Projekte auf (vorzugsweise PostgreSQL, andere SQL Datenbanken sind aber auch möglich).
   
2. Eine detaillierte Anleitung zur Installation finden Sie im Allgemeinen bei der Datenbank. Wenn Sie beispielsweise SuSE-Linux benutzen und PostgreSQL installieren möchten, müssen Sie nur die postgresql Paketet hinzufügen - starten - fertig!

Installation der jBib Dateien

1. Als nächstes entpacken Sie jBib in ein Verzeichnis Ihrer Wahl. Im Verzeichnis bin befinden sich Skripte/Batchdateien zum Starten von jBib.
2. Probieren Sie doch einfach mal jbib.sh bzw. jbib.bat aus. Sie werden dann eine Fehlermeldung bekommen, in der jBib sich darüber beschwert, dass die Datenbank nicht verfügbar sei. Das ist auch ganz richtig so, denn es ist zwar eine Datenbanksoftware installiert, von der weiss jBib aber nichts und eine leere Datenbank ist auch noch nicht eingerichtet. Das machen Sie im nächsten Schritt:

Einrichten der Datenbank

1. Im Verzeichnis bin befindet sich weiterhin eine Datei namens createdb.sql. Wie Sie erraten können, legt diese eine neue Datenbank für jBib an.
   • Öffnen Sie die Administrationskonsole Ihrer Datenbank (DB2: "Befehlszentrale", Oracle: "sqlplus", PostgreSQL: "psql", Interbase: "IBConsole" ...)
   • Starten Sie das Skript createdb.sql (in Oracle bspw. mit "start creatdb.sql", wenn es sich im aktuellen Verzeichnis befindet). Ggf. können Sie es einfach per Copy/Paste einfügen und ausführen.
   • Evtl. müssen Sie darauf achten, dass die Transaktion beendet wird (commit), damit die Änderungen auch aktiv werden.
   • Beenden Sie die Administrationskonsole wieder.
2. Starten Sie jBib und quittieren Sie die Fehlermeldungen mit OK (es ist eben noch keine Datenbank konfiguriert).
3. Wechseln Sie in den Optionsdialog (Datei - Optionen), Reiter Datenbank (gleich der erste). Hier tragen Sie in der 3. Zeile statt des Wortes "localhost" den Server ein, der die jBib Datenbank hält (wenn das der lokale Rechner ist, lassen Sie "localhost" bitte stehen). Hinter dem Schrägstrich, tragen Sie den Datenbanknamen ein (also "bib", "karl" oder "otto"). Bei Arbeitsstationsname können Sie sich noch einen schönen Namen ausdenken, der auf allen Rechnern, auf denen Sie jBib verwenden anders sein sollte.
4. • Tragen Sie im Optionendiaog bei Treiber den Klassennamen des JDBC Treibers für Ihre Datenbank ein.
   • Die Datenbank URL müssen Sie wahrscheinlich auch noch anpassen (in Interbase Windows bspw. jdbc:interbase://localhost/d:/database/bib_db, wenn Interbase auf dem localen Rechner installiert ist und die Dateien in D:\INTERBASE\BIB_DB liegen). Schlagen Sie bitte auch in der Dokumentation Ihrer Datenbank nach, das macht leider jede anders.
5. Verlassen Sie den Dialog dann mit OK.
6. Sorgen Sie in der Datei jbib.bat bzw. jbib.sh dafür, dass sich der JDBC Treiber Ihrer Datenbank im Klassenpfad befindet. Falls nötig können Sie die Datei einfach editieren. (In Unix ist das Trennzeichen ":", in Windows ";".)

Testen

Starten Sie jBib neu. Jetzt müssten Sie eigentlich in der Lage sein, mit dem Menü-Befehl "Eintragen - Person" eine neue Person anzulegen.