Płatnik – naprawa problemów z bazą Firebird

Baza danych Płatnika oparta na silniku Firebird (InterBase Embedded) jest sercem całego systemu przechowywania dokumentów ZUS. Uszkodzenie pliku bazy .fdb – wskutek nagłego wyłączenia zasilania, błędu dysku lub nieprawidłowego zamknięcia programu – może uniemożliwić uruchomienie Płatnika lub otwarcie konkretnej firmy. Narzędzia Firebird (gfix, gbak) umożliwiają jednak skuteczną naprawę w wielu przypadkach, a znajomość procedury naprawczej pozwala szybko przywrócić dostęp do danych.

Objawy uszkodzonej bazy Firebird

Uszkodzenie bazy danych Płatnika objawia się zazwyczaj jednym z poniższych komunikatów:

• „Błąd podczas otwierania bazy danych" lub „Database file appears corrupt".
• „I/O error during 'ReadFile' operation for file [ścieżka]" – problem z odczytem pliku.
• „Page size is incorrect" – uszkodzenie struktury stron bazy.
• Program zawiesza się lub zamyka nieoczekiwanie przy próbie otwarcia konkretnej bazy.
• Brak możliwości wyświetlenia listy dokumentów lub konkretnych formularzy.

Przed przystąpieniem do naprawy wykonaj kopię pliku .fdb (nawet uszkodzonego) – pozwoli to wrócić do stanu wyjściowego w razie niepowodzenia naprawy.

Narzędzie gfix – naprawa spójności bazy

Program gfix jest standardowym narzędziem Firebird do weryfikacji i naprawy spójności bazy. Znajduje się w folderze instalacyjnym Płatnika (zazwyczaj C:\Program Files\Płatnik\bin\ lub C:\Program Files (x86)\Platnik\bin\).

Podstawowa procedura naprawy:

1. Zamknij Płatnik i upewnij się, że żaden inny proces nie używa pliku .fdb.
2. Otwórz wiersz poleceń jako administrator.
3. Przejdź do folderu z narzędziami: cd "C:\Program Files\Platnik\bin"
4. Uruchom weryfikację: gfix -validate -full C:\Platnik\baza.fdb
5. Jeśli weryfikacja wykryje błędy, uruchom naprawę: gfix -mend -full C:\Platnik\baza.fdb
6. Po naprawie wykonaj ponowną weryfikację, by upewnić się, że błędy zostały usunięte.

Przełącznik -full nakazuje narzędziu sprawdzenie wszystkich stron bazy, nie tylko nagłówka. Jest to wolniejsze, ale dokładniejsze niż standardowy tryb.

Procedura backup i restore jako metoda naprawy

Sekwencja gbak backup + restore jest najskuteczniejszą metodą naprawy uszkodzonej bazy Firebird, ponieważ podczas przywracania Firebird odbudowuje całą strukturę od podstaw:

1. Wykonaj backup (nawet z uszkodzonej bazy): gbak -b -v C:\Platnik\baza.fdb C:\Platnik\baza_backup.gbk
2. Przywróć bazę z kopii zapasowej do nowego pliku: gbak -c -v C:\Platnik\baza_backup.gbk C:\Platnik\baza_naprawiona.fdb
3. Zmień nazwę oryginalnego pliku na baza_stara.fdb (archiwum awaryjne).
4. Zmień nazwę baza_naprawiona.fdb na oryginalną nazwę pliku.
5. Otwórz naprawioną bazę w Płatniku i sprawdź kompletność danych.

Jeśli gbak nie może wykonać kopii zapasowej ze względu na poważne uszkodzenie, użyj przełącznika -ig (ignore errors): gbak -b -v -ig C:\Platnik\baza.fdb C:\Platnik\baza_backup.gbk. Spowoduje to pominięcie uszkodzonych stron i może odratować większość danych.

Przywrócenie z archiwum Płatnika

Jeśli posiadasz aktualne archiwum .gbk wykonane przez menu Płatnika, przywrócenie jest znacznie prostsze:

1. W menu wybierz Plik → Przywróć z archiwum.
2. Wskaż plik .gbk z kopią zapasową.
3. Potwierdź przywrócenie – program odbuduje bazę .fdb z archiwum.

To najbezpieczniejsza metoda, gdyż nie wymaga operacji w wierszu poleceń. Dlatego tak ważne jest regularne wykonywanie archiwizacji przez menu Płatnika.

Problemy z usługą Firebird Server

Czasem baza jest sprawna, ale nie można jej otworzyć z powodu problemów z usługą Firebird:

• Sprawdź, czy usługa Firebird Guardian lub FirebirdServerDefaultInstance jest uruchomiona (Panel sterowania → Usługi).
• Jeśli usługa nie startuje, sprawdź dziennik zdarzeń Windows – może brakować pliku fbembed.dll lub bibliotek Visual C++ Redistributable.
• Reinstalacja Płatnika zazwyczaj naprawia brakujące komponenty Firebird.

Profilaktyka – jak unikać uszkodzeń bazy

• Zawsze zamykaj Płatnik przez Plik → Zakończ, nigdy przez przyciski systemowe lub Task Manager.
• Używaj zasilacza UPS – nagłe wyłączenia zasilania to główna przyczyna uszkodzeń plików .fdb.
• Regularnie wykonuj archiwizację (Plik → Archiwizuj) – najlepiej po każdej sesji pracy.
• Unikaj przechowywania bazy na dyskach sieciowych – wolne połączenie lub zerwanie sieci może uszkodzić plik.

Nasz serwis oferuje profesjonalną naprawę bazy danych Płatnika, odzyskiwanie danych z uszkodzonych plików .fdb oraz wdrożenie procedur tworzenia kopii zapasowych. Skontaktuj się z nami, jeśli nie możesz otworzyć swojej bazy lub straciłeś dostęp do dokumentów ZUS.