Administration der eXist-Datenbank
Aus OpenEstate-Wiki
Inhaltsverzeichnis |
Sinn und Zweck
Die Entwickler der eXist-Datenbank stellen zusätzlich zur Datenbank auch ein Hilfsprogramm zur Administration zur Verfügung. Das Programm ermöglicht einen direkten Zugriff auf die Datenbank des ImmoTools, ohne das ImmoTool selbst zu starten. Das Programm ist z.B. vergleichbar mit phpMyAdmin aus der MySQL-Welt.
Ein Wort der Warnung
Bitte verwenden Sie das Administrationsprogramm mit Bedacht, da ein fehlerhafter Eingriff nicht mehr wiederhergestellt werden kann. Im Zweifelsfalle ist es ratsam, eine Sicherungskopie des Projektes anzufertigen, bevor Sie das Administrationsprogramm in Betrieb nehmen.
Programm in Betrieb nehmen
Download
Das Administrationsprogramm ist Bestandteil der eXist-Distribution. Jedoch ist die Installation der eXist-Pakete nicht ganz unkompliziert. Aus diesem Grund haben wir die nötigen Dateien extrahiert und stellen diese als eigenständiges ZIP-Archiv zum Download bereit. Das Programmpaket kann kostenlos - gemäß den Bedingungen der LGPL - verwendet werden. Mit dem Download und durch Verwendung der Software akzeptieren Sie diese Bedingungen.
- Administrationsprogramm für eXist 1.2.6 herunterladen
(verwendbar für Projekte aus ImmoTool 0.9.x)
Programmstart
Entpacken Sie die heruntergeladene ZIP-Datei auf Ihrem Rechner. Im erzeugten Version finden Sie einen Ordner bin, wo die verschiedenen Startskripte hinterlegt sind.
- Windows-Anwender können das Programm durch Doppelklick auf die client.exe oder die client.bat starten.
- Linux- & Mac-Anwender können das Programm mit Hilfe des Skriptes client.sh von der Konsole aus starten.
- Alternativ startet folgender Java-Befehl die Anwendung von der Konsole:
java -jar start.jar client
 ZIP-Archiv entpacken |
 ZIP-Archiv wurde entpackt |
 Doppelklick auf client.exe |
Verbindung zur Datenbank herstellen
Nachdem das Administrationsprogramm gestartet wurde, muss dem Programm das zu verwendende ImmoTool-Projekt mitgeteilt werden.
- Wählen als Type die Option Embedded, da es sich um eine Verbindung zu einer lokalen Datenbank handelt.
- Klicken Sie anschließend auf Select um eine Datenbank von der Festplatte auszuwählen.
- Wählen Sie im folgenden Fenster das Verzeichnis des ImmoTool-Projektes aus. In dem Verzeichnis befindet sich eine Datei db-conf.xml, welche zum Öffnen ausgewählt werden muss.
- Klicken Sie abschließend auf OK um das Administrationsprogramm mit der gewählten Datenbank zu starten.
 Verbindung zur lokalen Datenbank |
 db-conf.xml im Projektverzeichnis wählen |
 Verbindung zur Datenbank herstellen |
Anwendungsbeispiele
Im Folgenden werden Anwendungsfälle vorgestellt, in denen das Administrationsprogramm verwendet werden kann.
Datenbank sichern und in ein neues Projekt integrieren
Sollte es zu Problemen beim Öffnen einer Datenbank mit dem ImmoTool kommen und keine Datensicherung vorliegen, kann eine Sicherung aus dem Administrationsprogramm Ihnen das 'Leben retten'. Selbstredend sind regelmäßige Datensicherungen eines Projektes aber immer die bessere Wahl. Der hier beschriebene Weg ist als eine Art 'Notlösung' zu verstehen.
- Nachdem mit dem Administrationsprogramm eine Verbindung zur Datenbank aufgebaut wurde, kann eine Sicherung durchgeführt werden durch Klick auf Tools » Backup.
- Wählen Sie im folgenden Fenster als zu exportierende Collection die Option /db/ImmoTool aus. Desweiteren können Sie einen Ort auf der Festplatte angeben, wo die gesicherte Datenbank als ZIP-Datei abgelegt werden soll.
- Starten Sie das ImmoTool nachdem die Sicherung durchgeführt wurde und erzeugen Sie ein neues Projekt.
- Nachdem das neue und leere Projekt geöffnet wurde, kann die zuvor gesicherte ZIP-Datei in das Projekt importiert werden.
 Sicherung der Datenbank (1) |
 Sicherung der Datenbank (2) |
 Neues Projekt im ImmoTool erzeugen |
 Import der gesicherten Datenbank (1) |
 Import der gesicherten Datenbank (2) |
