So kann es z.B. durch einen Stromausfall, Festplatten- und Speicherfehlern oder Kopieren der Datenbank während des laufenden Betriebs zu Problemen kommen (Details siehe hier). Diese machen sich allerdings nicht unbedingt sofort durch einen Programmfehler bemerkbar, da die Probleme innerhalb der Datenbank zunächst nur als Fehler markiert werden, so dass eine weitere Nutzung möglich ist.

Sie sollten deshalb regelmäßig prüfen, ob Ihre Datenbank fehlerfrei ist.

Dieser Beitrag zeigt Ihnen, wie Sie eine Prüfung durchführen können und zeigt Ihnen erste Maßnahmen im Falle eines Fehlers auf.

Um zu ermitteln, ob in Ihrer Datenbank Fehler enthalten sind, rufen Sie den Menüpunkt “Extras > Datenbankdiagnose” auf. Es wird dabei das Firebird-Tool “gfix” gestartet, das einen exklusiven Zugriff auf Ihre Datenbank benötigt.

Nach Abschluss der Diagnose werden die gefundenen Fehler im Protokoll aufgeführt. Wenn keine Fehler gefunden wurden, erhalten Sie nur die Rückmeldung, dass die Prüfung abgeschlossen wurde, siehe folgendes Bild:

Falls Fehler ausgewiesen werden (z. B. “Number of record level errors”, “Number of index page errors” oder “Number of database page errors”>= 1), lassen sich diese nicht einfach durch die Datenbankprüfung beheben, sondern nur durch eine Datenbanksicherung mit anschließender Rücksicherung.

Legen Sie dazu zunächst eine Datensicherung im FBK-Format an (Menü “Extras > Datensicherung erstellen”), die Sie anschließend sofort wieder zurücksichern (“Extras > Datensicherung zurückholen”), am Besten in einen neuen Mandanten, so dass Sie noch auf die alte Datenbank zugreifen können.

Durch diesen Vorgang wird Ihre Datenbank neu aufgebaut und die enthaltenen Fehler werden korrigiert, was Sie durch einen erneuten Aufruf der Datenbankdiagnose überprüfen können.

Bitte beachten Sie, dass eine Korrektur fehlerhafter Datenbanken nicht in allen Fällen möglich ist, insbesondere bei der Rückmeldung “database file appears corrupt”. Deshalb ist es empfehlenswert nicht nur die letzte Datensicherung aufzubewahren, sondern auch ältere, auf die dann notfalls zurück gegriffen werden kann.

Um ganz sicher zu gehen, sollten Sie zur Kontrolle die erstellten Datensicherungen stichprobenweise in einen neuen Mandanten zurücksichern.

Weitere Details finden Sie in der Dokumentation:

• Sicherung:  www.Amicron.org/onlinehilfe/amicron-faktura-10/index.html?datensicherung.htm
• Diagnose:  www.Amicron.org/onlinehilfe/amicron-faktura-10/datenbankdiagnose.htm

Die Dokumentation zu gfix finden Sie hier:  http://firebirdsql.org/manual/gfix-dbverify.html

Beim Öffnen der Datenbank ist ein Fehler aufgetreten:
TDBXError.unsupported on-disk structure for file C:\Dokumente und Einstellungen\All Users\Dokumente\Amicron-Data\Data.fdb

Ursache:
Die aufgeführte Datenbank wurde mit einer neueren Version von Firebird erstellt, installiert ist jedoch nur eine veralterte Version, die keinen Zugriff auf neuere Firebird-Datenbanken unterstützt.

Lösung:
Deinstallieren Sie die alte Firebird-Version und installieren diejenige Firebird-Version, die zur Datenbank-Version passt. Falls sich die Datenbank auf einem Server befindet, müssen Sie diese Installation auf dem Server durchführen. Die Installationsdateien für Firebird können Sie auf http://firebirdsql.org herunterladen.
Achtung: Setzen Sie neuere Versionen von Firebird nur dann ein, wenn die verwendete Amicron-Faktura bzw. Amicron-Mailoffice-Version für diese Firebird-Version freigegeben wurde!

Beispiel:
In der Fehlermeldung wird “found 11.1, support 11.0″ angegeben.

In diesem Fall ist die Datenbank mit Firebird 2.1 erstellt worden, installiert ist jedoch nur Firebird 2.0. Sie müssen Firebird 2.1 installieren.

Wenn in der Fehlermeldung “found 32779.10″ angegeben wird, ist noch Firebird 1.5 installiert.

Lösung:
Ursache ist hier nicht die fehlende dbxint30.dll (wie man bei der Meldung zunächst vermutet)  sondern eine Firebird-Client-Version (=GDS32.DLL), die nicht zum Firebird-Server passt.
Kopieren  Sie deshalb aus dem BIN-Ordner von Firebird (z.B. C:\Programme\firebird\Firebird\bin) die Datei FBCLIENT.DLL in den Programmordner von Amicron-Faktura und benennen die Datei in GDS32.DLL um (die bereits vorhandene GDS32.DLL können Sie umbenennen in GDS32-alt.DLL).

Anschließend sollten Sie die Anwendung ohne Fehler starten können.

- Fehler “Expected Backup-Version 1, 2, or 3. Found 7″
- Fehler während der Rücksicherung: “Ende der Datei (EOF) erreicht.”
- Fehler beim Start der Rücksicherung: expected backup description record

Expected Backup-Version 1, 2, or 3. Found 7

Die gbak Meldung “Expected Backup-Version 1, 2, or 3. Found 7″ tritt auf, wenn die fbk-Sicherungsdatei mit Firebird 2.0 erstellt wurde und dann versucht wird, diese mit Firebird 1.5 zurückzusichern, siehe http://tracker.firebirdsql.org/browse/CORE-1131

Lösung:
Installieren Sie Firebird 2.0, bevor Sie die Datensicherungsdatei wiederherstellen.

FireBird 2.0 kann hier heruntergeladen werden:
http://sourceforge.net/projects/firebird/files/firebird-win32/2.0.6-Release/Firebird-2.0.6.13266_0_win32.exe/download

Expected backup version 1, 2, 3, 4, 5, 6, or 7.  Found 8

Diese Meldung tritt auf, wenn die fbk-Sicherungsdatei mit Firebird 2.1 erstellt wurde und dann versucht wird, diese mit Firebird 2.05 zurückzusichern.

Lösung:
Installieren Sie Firebird 2.1, bevor Sie die Datensicherungsdatei wiederherstellen.

Fehler während der Rücksicherung: “Ende der Datei (EOF) erreicht.”

Die Rücksicherung bricht nach einiger Zeit mit folgender Fehlermeldung ab:

gbak: ERROR: I/O error for file “C:\DATENBANKEN\DATA.FDB”
gbak: ERROR:     Error while trying to read from file
gbak: ERROR:     Ende der Datei (EOF) erreicht.
gbak: ERROR: gds_$send failed
gbak: Exiting before completion due to errors
Datenwiederherstellung fehlgeschlagen! (Code 1)

Ursache:
Beim Wiederherstellen der Datenbank DATA.FDB war nicht genug Festplattenspeicher frei.
Falls die Zeile “gbak: ERROR: gds_$send failed” nicht erscheint, wird die Ursache vermutlich an der Datenbankgröße liegen. Wenn Sie das Laufwerk mit FAT32 formatiert haben, beträgt die maximale Dateigröße 4 GB, siehe http://de.wikipedia.org/wiki/FAT32#FAT32. Wenn Sie versuchen, eine Datei wiederherzustellen, die größer ist als 4 GB, bricht die Rücksicherung ab, sobald die 4 GB-Grenze erreicht wurde.

Sollte keine der obigen Ursachen zutreffen, versuchen Sie zunächst ein neues Backup zu erstellen und aktivieren dabei die Option -limbo (“Ignore Transactions in Limbo”).

Versuchen Sie dann, die erstellte Datensicherung wiederherzustellen.

Fehler beim Start der Rücksicherung: expected backup description record

Die Rücksicherung startet nicht und bricht sofort mit folgendem Fehler ab:

gbak: ERROR: expected backup description record

Ursache:
Bei der Datei, die zurückgesichert werden soll, handelt es sich nicht um eine gültige Backupdatei (*.fbk)

Eine manuelle Einrichtung der Datenbank ist z.B. in folgenden Situationen notwendig:

1. Bei der Installation wurde (versehentlich) eine neue Datenbank installiert, es soll jedoch auf die vorhandenen Daten zugegriffen werden.
2. Eine ehemals als Einzelplatz genutzte Installation soll in eine netzwerkfähige Installation umgewandelt werden.
3. Eine AMICRON-MAILOFFICE-Version mit lokaler (Test-)Datenbank soll zukünftig auf die AMICRON-FAKTURA-Datenbank des Netzwerkservers zugreifen.

In den obigen Fällen müssen Sie zunächst herausfinden, wo sich die Datenbank befindet, auf die Sie zukünftig zugreifen möchten.

Der “Lagerort” der Datenbank läßt sich am einfachsten ermitteln, indem Sie eine Version von AMICRON-FAKTURA oder AMICRON-MAILOFFICE aufrufen, die auf die korrekte Datenbank zugreift und dort über das Menü Einstellungen > Systeminformationen die folgenden Angaben notieren:

Kartei Programminformationen:

• Pfad der Data.ini

Kartei Verbindungsinformationen:

• Mandant
• DB-Server
• DB-Name

Prüfen Sie aber vorher, ob das Programm tatsächlich auf Ihre aktuellen Daten zugreift!

Anschließend rufen Sie über den Windows-Explorer den Ordner auf, in dem sich diejenige AMICRON-MAILOFFICE bzw. AMICRON-FAKTURA-Version befindet, die auf die falsche Datenbank zugreift. Öffnen Sie nun mit einem Texteditor (z.B. Notepad) die Datei FAKTURA.INI bzw. MAILOFFICE.INI und tragen bei der Angabe “PfadzurServerDB” den Pfad der Data.ini ein, den Sie oben notiert haben. Falls in der INI-Datei noch keine Zeile mit “PfadzurServerDB=” enthalten ist, tragen Sie diese bitte in eine neue Zeile ein. Bei “Mandant=” geben Sie den oben ermittelten Mandantennamen ein.

Durch die Korrektur des Eintrags “PfadzurServerDB” greift das installierte Programm nun beim nächsten Start automatisch auf die korrekte DATA.INI zu. In der Datei DATA.INI befindet sich der Lagerort Ihrer Datenbank. Falls Sie mehrere Mandanten angelegt haben, wird für dort für jeden Mandant ein Mandanten- und Datenbankname gespeichert.

Installieren Sie nun auf dem neuen Rechner Amicron-Faktura bzw. Amicron-Mailoffice (sofern noch nicht erfolgt). Über das Menü “Extras > Datensicherung > zurückholen” können Sie die erstellte Datensicherungsdatei zurückholen.

Danach können Sie auf dem neuen PC mit den Daten weiterarbeiten.

Falls Sie die integrierte Dokumentenverwaltung nutzen, müssen Sie die Dokumente ggfs. manuell auf den neuen PC umziehen, da diese nicht in der Datenbank bzw. der Datenbanksicherung enthalten sind.

Welche Firebird-Version wird unterstützt?

Setzen Sie stets nur diejenige Firebird-Version ein, die von unseren Programmen offiziell unterstützt werden, da es ansonsten zu unerwarteten Fehlern kommen kann:

Amicron-Faktura 8.x und Amicron-Mailoffice 3.0:  Firebird 1.5.x und 2.0.x
Amicron-Faktura 9.0 und Amicron-Mailoffice 3.5:  2.0.x und 2.1.x (ausgeliefert wird 2.0.x)
Amicron-Faktura 10.0 und Amicron-Mailoffice 4.0:  2.0.x, 2.1.x und 2.5 (ausgeliefert wird 2.0.x)
Amicron-Faktura 11.0: 2.0.x, 2.1.x und 2.5 (ausgeliefert wird 2.5)

Wir möchten Ihnen hier kurz beschreiben, wie Sie die neue Version 2.1 oder 2.5  installieren können.

Die wichtigste Vorbereitung: das Backup!

Ihre Datenbankdatei (*.fdb) kann ohne Konvertierung mit Firebird 2.1 und 2.5 verwendet werden, da neuere Firebird-Versionen Datenbankdateien älterer Formate verwenden können. Das ist jedoch nur möglich, solange Sie nicht das Dateiformat auf die neue Firebird-Version umstellen. Sie können also ohne weiteren Aufwand wie gewohnt mit Amicron-Faktura bzw. Amicron-Mailoffice weiterarbeiten.

Falls Sie auf eine höhere Firebird-Version aktualisieren, also z.B. von 2.0 auf 2.1 oder von 2.1 auf 2.5 können Sie jedoch nur dann in den Genuss der besseren Performance der neuen Firebird-Version gelangen, wenn Sie auf das neue Dateiformat aktualisieren. Wie macht man das? Indem einfach mit der bisher eingesetzten alten Firebird-Version ein Backup der Datenbankdatei erstellt wird (*.fbk), das dann nach Installation der neuen Firebird-Version über Firebird zurückgesichert wird. Sie können dazu die in den Amicron-Programmen integrierten Funktionen verwenden (Menü “Extras > Datensicherung > erstellen bzw. zurückholen”). Falls Sie mehrere Mandanten verwenden, muss die Sicherung für jeden Mandanten durchgeführt werden!

ACHTUNG: Nach der Umstellung auf das Dateiformat von Firebird 2.1 bzw. 2.5  ist es nicht mehr möglich, die Datenbankdatei mit älteren Firebird-Versionen zu öffnen! Bei einem Versuch erhalten Sie dann den Fehler “unsupported on-disk-structure“.
Auch die erstellte Backupdatei (*.fbk) kann i.d.R. nicht mehr mit einer älteren Firebird-Version zurückgesichert werden.

Der nächste Schritt: Die Datenbankprüfung

Nach der Sicherung sollten Sie prüfen, ob die Datenbank fehlerfrei ist. Führen Sie deshalb eine Datenbankprüfung durch. Falls dabei Fehler ausgewiesen werden, werden diese meist durch die Rücksicherung behoben, da die Datenbank dabei vollständig neu aufgebaut wird. Führen Sie nach der Rücksicherung erneut eine Datenbankprüfung durch, um sicherzustellen, dass alle Fehler behoben wurden.

Wo muss das Update installiert werden?

Wenn Sie Amicron-Faktura bzw. Amicron-Mailoffice im Netzwerk einsetzen, müssen Sie die alte Firebird-Version nur auf dem Server deinstallieren und neu installieren, sofern Sie auf dem Server die Datenbankprüfung, Sicherung und Wiederherstellung vornehmen. Falls Sie die Sicherung jedoch auf der Arbeitsstation durchführen möchten oder dort zurücksichern wollen, muss Firebird auch auf der Arbeitsstation installiert sein (gleiche Version wie auf dem Server!).

Was ist bereits installiert?

Um zu prüfen, welche Firebird-Version bei Ihnen installiert ist, rufen Sie in Amicron-Faktura oder Amicron-Mailoffice den Menüpunkt “Einstellungen > Systeminformationen” auf. Sie finden dann auf der Kartei “Verbindung DB-Server” die Angabe “Serverversion”. Wenn dort bereits die Version 2.5 aufgeführt wird, ist kein Update notwendig.

Was muss installiert werden? Wo kann man Firebird herunterladen?

Firebird können Sie über die vollständige Installationsdatei von Amicron-Faktura oder Amicron-Mailoffice installieren. Selbst wenn Sie eine Vollversion installiert haben, reicht für das Firebird-Update die Prüfversion. Sie können diese im Downloadbereich von Amicron herunterladen.

Auf der Homepage des Firebird-Projekts finden Sie ebenfalls entsprechenden Installationsdateien:

Rufen Sie über diesen Link die Downloadseite zu Firebird 2.0.6 auf oder klicken Sie hier, um die Windows-Version von Firebird 2.0.6 direkt herunterzuladen.

Rufen Sie über diesen Link die Downloadseite zu Firebird 2.1.4 auf oder klicken Sie hier, um die Windows-Version von Firebird 2.1.4 direkt herunterzuladen.

Rufen Sie über diesen Link die Downloadseite zu Firebird 2.5.1 auf oder klicken Sie hier, um die Windows-Version von Firebird 2.5.1 direkt herunterzuladen.

Deinstallation der alten Firebird-Version:

Falls bereits eine alte Version von Firebird installiert ist, muß diese nach Erstellen der Datensicherung (*.fbk) erst deinstalliert werden, da sich sonst keine neue Version installieren läßt. Eine detailierte Anleitung zur Deinstallation finden Sie im folgenden Beitrag:
http://Amicron.org/blog/2009/02/02/wie-kann-der-firebird-datenbankserver-deinstalliert-werden

Nach der Deinstallation von Firebird sollten Sie den PC neu starten.

Installation der Original-Firebird-Installation

Starten Sie die Installationsdatei. Bei der Auswahl Classic- oder Superserver sind beide Varianten möglich, im Zweifelsfall wählen Sie jedoch die Classic-Variante. Führen Sie die Installation bis zum Ende aus, wählen bzw. bestätigen Sie dabei die vorgeschlagenen Einstellungen.

Installation der neuen Firebird-Version über die Amicron-Installation:

Rufen Sie anschließend die Installation von Amicron-Faktura oder Amicron-Mailoffice auf.

Gehen Sie dort wie folgt vor:

1. Im Willkommensfenster klicken Sie auf “Weiter”.

2. Wenn auf der nächsten Seite “Programm ist bereits vorhanden” erscheint, müssen Sie die Option “Neu installieren” wählen.

3. Klicken Sie auf “Weiter” bis Sie zur Seite “Komponenten wählen” kommen. Dort entfernen Sie bei allen Komponenten das Häkchen, außer bei folgenden Einträgen:
- Datenbanktreiber (Client)
- Datenbanktreiber (SQL-Server)

4. Führen Sie nun die Installation bis zum Ende aus.

Nach der Installation können Sie Amicron-Faktura bzw. Amicron-Mailoffice wie gewohnt starten. Im Menü Systeminformationen (siehe oben) können Sie prüfen, ob die neue Firebird-Version erfolgreich installiert wurde.

Wichtig: Update der Firebird-Client-Datei GDS32.DLL

Sollte auf den Arbeitsstationen beim Start von Amicron-Faktura eine Fehlermeldung auftreten, kopieren Sie bitte vom Server die erneuerte Datei GDS32.DLL (=Firebird-Client) auf die Arbeitsstation in den Programmordner von Amicron-Faktura bzw. Amicron-Mailoffice.

Wo gibt es weitere Infos zur Installation von Firebird?

Auf der Homepage FirdbirdSQL.org finden Sie folgende Dokumentationen:

• Schnellanleitung zur Installation
• Ausführliche Installationsanleitung für Windows, Linux und MacOSX (englisch)

Bevor Sie den Firebird-Datenbankserver von Ihrem PC entfernen, sollten Sie alle Programme beenden. Falls Sie Amicron-Mailoffice einsetzen, achten Sie bitte darauf, dass auch der Telereporter und Reminder beendet wird. In einem Netzwerk sollten Sie sicherheitshalber alle Arbeitsstationen runterfahren und den Server vor der Deinstallation neu starten, um Probleme und Datenbankfehler durch noch geöffnete Verbindungen auszuschließen.

Um den installierten Firebird-Server zu deinstallieren, muss zuerst der Dienst “Firebird Server” und “Firebird Guardian” angehalten werden.

Gehen Sie dazu wie folgt vor:

1. Rufen Sie unter Windows “Start > Einstellungen > Systemsteuerung > Verwaltung > Dienste” auf. Sie erhalten eine Liste aller installierten Dienste. Suchen Sie in der Spalte “Name” nach dem Dienst “Firebird Server”.

2. Stoppen Sie den angewählten Dienst über den Menüpunkt “Aktion > Beenden” (Windows XP) bzw. “Vorgang > Beenden” (Windows 2000).

3. Stoppen Sie zusätzlich den Dienst “Firebird Guardian Service” ebenfalls über den Menüpunkt “Beenden”.

Anschließend rufen Sie über “Start > Einstellungen > Systemsteuerung > Software” den Eintrag “Firebird SQL-Datenbankserver” auf und deinstallieren diesen, indem Sie auf den “Entfernen”-Schalter klicken.

Sollte die Deinstallation nicht automatisch möglich sein, können Sie auch manuell deinstallieren.

Gehen Sie dazu wie folgt vor:
1. Beenden Sie die Dienste, wie oben beschrieben

2. Löschen Sie den Ordner, in den Firebird installiert wurde inkl. Unterordner (Standard: C:\Programme\Firebird)

3. Löschen Sie in der Registry von Windows unter
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services die folgenden Einträge:
- FirebirdServer
- FirebirdGuardian

4. Bei Firebird 1.5 löschen Sie in der Registry von Windows unter
HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project den folgenden Eintrag:
- Firebird Server

Bei Firebird 1.0 muss folgender Eintrag gelöscht werden:
HKEY_LOCAL_MACHINE\SOFTWARE\Borland\InterBase

Starten Sie anschließend den PC neu.