Systemy Streamsoft Pro i Streamsoft Prestiż od wersji 10.0.358 pracują w oparciu o serwer bazy danych Firebird 3.0. Z uwagi na stały rozwój systemu i konieczność zapewnienia wydajności pracy od wersji 18.1.376 i 19.0.378 zostały dostosowane do działania na serwerze bazy danych Firebird 5.0. Skutkuje to znacznym zwiększeniem efektywności oraz stabilności pracy w systemie.

W związku z powyższym zalecamy zmianę wersji serwera bazodanowego Firebird 3.0 na wersję Firebird 5.0. Jednocześnie informujemy, że od czerwca 2026 planowane jest zakończenie wsparcia dla Firebird 3.0. W poniższym materiale znajduje się instrukcja instalacji oraz migracji danych.

I.Kopia zapasowa baz danych przed wykonaniem migracji

Przed przystąpieniem do instalacji silnika bazodanowego Firebird 5.0 należy upewnić się, że aktualna wersja programu i bazy danych to 18.1.376 lub wyższa. Następnie należy zarchiwizować wszystkie bazy danych:

Archiwizację należy wykonać w Module Administratora lub za pomocą komendy CMD używając polecenia gbak.

  • W przypadku chęci przeniesienia użytkowników bazodanowych należy zarchiwizować również bazę security3.fdb, znajdującą się w folderze instalacyjnym silnika Firebird 3.0. Przeniesieni użytkownicy będą korzystać z typu autoryzacji jaki był zdefiniowany przy tworzeniu użytkownika.
  • W przypadku posiadania wersji systemu niższej niż 18.1.376, w pierwszej kolejności należy wykonać aktualizację do tej wersji lub wyższej. Umożliwi to zaktualizowanie systemu do najnowszych kompilacji. Link do plików aktualizacyjnych znajduje się tutaj:

https://podreczniki.streamsoft.pl/AKTUALIZ_377.zip 

Operację taką można wykonać za pomocą poniższych poleceń. Należy pamiętać, że polecenia te zawierają domyślne hasło SYSDBA – masterkey. Jeżeli hasło było zmieniane to w poleceniu należy użyć aktualnie używanego hasła.

"C:\Program Files\Firebird\Firebird_3_0\gbak.exe" -b -se localhost:service_mgr -user SYSDBA -password masterkey "C:\Program Files\Firebird\Firebird_3_0\security3.fdb" "C:\Program Files\Firebird\Firebird_3_0\security3.gbk"
/opt/firebird/bin/gbak -b -se localhost:service_mgr -user SYSDBA -password masterkey /opt/firebird/security3.fdb /opt/firebird/security3.gbk

II.Przygotowanie baz danych do migracji

Następnym krokiem będzie uruchomienie migracji z funkcji UDF do UDR (Internal functions). Po zalogowaniu do Modułu Administratora w zakładce Administracja → Serwer → Migracja z funkcji UDF do UDR (Internal functions) znajduje się proces migracji do nowszego standardu funkcji bazodanowych.

Uruchamiamy proces migracji na bazie systemowej oraz na bazie firmowej:

Bazy danych po migracji nie będą nadawać się do pracy w systemie ERP Streamsoft Prestiż na silniku bazodanowym Firebird w wersji 3.0. Kluczowe jest wykonanie kopii baz danych przed tą operacją.

Zalecamy rozpoczęcie migracji od baz danych firmy, a bazę systemową przeprowadzić jako ostatnią.

Po udanej operacji zostanie wyświetlony komunikat:

Następnym krokiem będzie wykonanie archiwizacji wszystkich baz danych w Module Administratora.

III. Aplikacje zewnętrzne

W przypadku posiadania aplikacji zewnętrznych zintegrowanych z systemem Prestiż, takich jak m.in.:

konieczne jest ich dostosowanie do wersji wspierających Firebird 5.0.

Obecnie trwają prace nad aktualizacją aplikacji ABI do współpracy z FB 5.0 - instrukcja w tym zakresie będzie dostępna po publikacji wersji.

Rozwiązania dedykowane powinny zostać zweryfikowane i indywidualnie przystosowane do działania z nowym silnikiem. W szczególności należy zwrócić uwagę na zapytania z użyciem CURRENT_TIME i CURRENT_TIMESTAMP. Szczegóły zostały opisane w punkcie II.

IV. Instalacja w systemie WINDOWS

  1. Ze strony https://firebirdsql.org/en/server-packages/ należy pobrać plik instalacyjny z rozszerzeniem .exe odpowiedni dla środowiska WINDOWS.

2. W celu instalacji należy:

2.1. Uruchomić plik instalacyjny i wybrać język:

2.2. Zaakceptować umowę licencyjną:

2.3. W oknie zdefiniować ścieżkę z instalacją (można zostawić domyślną):

2.4. Zaznaczyć wszystkie dodatkowe opcje:

2.5. Silnik bazodanowy należy zainstalować jako SuperServer.

W przypadku kiedy ilość jednocześnie pracujących użytkowników będzie mniejsza niż 10 osób lub jest to instalacja wielofirmowa (ma być obsługiwanych wiele baz danych), zalecamy instalację silnika bazodanowego jako Classic server.

2.6. Wpisać hasło użytkownika administracyjnego SYSDBA:

2.7. Po poprawnej instalacji powinien wyświetlić się komunikat o zakończeniu instalacji. W oknie komunikatu należy odznaczyć opcję After installation – What Next i zakończyć operację poprzez przycisk Finish.

V.Instalacja w systemie LINUX

Minimalne wymagania do prawidłowego działania silnika Firebird 5.0 w środowisku operacyjnym LINUX:

  • CentOS Stream 9
  • Ubuntu LTS 24.04 lub Debian Linux 12

Należy pamiętać, że najbardziej wydajne i bezpieczne działanie silnika Firebird odbywa się na najnowszej wybranej dystrybucji systemu operacyjnego.

  1. Ze strony https://firebirdsql.org/en/server-packages/ do lokalizacji /opt należy pobrać plik z rozszerzeniem tar.gz odpowiedni dla środowiska LINUX

2. Plik należy umieścić w lokalizacji /opt na serwerze:

cd /opt
wget https://github.com/FirebirdSQL/firebird/releases/download/v5.0.1/Firebird-5.0.1.1469-0-linux-x64.tar.gz

3. W następnym kroku należy zainstalować biblioteki konieczne do działania silnika Firebird:

sudo apt -y install libtommath1

4. Archiwum należy rozpakować w lokalizacji /opt/firebird:

tar -zxvf Firebird-5.0.1.1469-0-linux-x64.tar.gz

5. Następnie należy uruchomić instalator i wprowadzić hasło użytkownika SYSDBA. Dla zwiększenia bezpieczeństwa zalecane jest użycie silnego hasła. Przy uruchomieniu skryptu instalacyjnego z parametrem -silent hasło SYSDBA zostanie wygenerowane i zapisane w pliku /opt/SYSDBA.password.

cd /opt/Firebird-5.0.1.1469-0-linux-x64
./install.sh -silent

6. Po wykonaniu powyższych czynności Firebird powinien poprawnie działać. Weryfikację działania można wykonać za pomocą poleceń:

systemctl status firebird

● firebird.service - Firebird Database Server
Loaded: loaded (/lib/systemd/system/firebird.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2024-12-19 14:06:50 CET; 42s ago
Docs: https://firebirdsql.org/en/firebird-rdbms/
Process: 10607 ExecStart=/opt/firebird/bin/fbguard -daemon -forever (code=exited, status=0/SUCCESS)
Main PID: 10608 (fbguard)
asks: 5 (limit: 9253)
Memory: 14.5M
CPU: 39ms
CGroup: /system.slice/firebird.service
├─10608 /opt/firebird/bin/fbguard -daemon -forever
└─10609 /opt/firebird/bin/firebird
Dec 19 14:06:50 vm-srv-kurs-03 systemd[1]: Starting firebird.service - Firebird Database Server...
Dec 19 14:06:50 vm-srv-kurs-03 systemd[1]: Started firebird.service - Firebird Database Server.

VI.Pliki konfiguracyjne Firebird 5.0

W kolejnym kroku należy wygenerować zawartość pliku konfiguracyjnego firebird.conf oraz databases.conf dla architektury SuperServer lub ClassicServer ze strony: https://cc.ib-aid.com/. W celu uzyskania dostępu do narzędzia należy utworzyć bezpłatne konto. Należy uzupełnić parametry zgodnie z parametrami serwera bazodanowego.

W wygenerowanym pliku firebird.conf należy dodać parametry:

ReadConsistency=0

DataTypeCompatibility = 3.0

W przypadku kiedy ilość jednocześnie pracujących użytkowników będzie mniejsza niż 10 osób lub jest to instalacja wielofirmowa (instalacja zawiera wiele baz danych), zalecamy instalację silnika bazodanowego jako Classic server.

Można wygenerować pliki konfiguracyjne z poziomu wyżej podanego kalkulatora lub zmienić tryb serwera poprzez uruchomienie skryptu /opt/firebird/bin/changeServerMode.sh oraz podać na jaki tryb chcemy przejść:

/opt/firebird/bin/changeServerMode.sh
Firebird server may run in 2 different modes - super and classic.
Super server provides better performance, classic - better availability.
Which option would you like to choose: (super|classic) [super] classic
Stopping currently running engine...
Starting firebird in classic server mode...
Done.

Po udanej zmianie z trybu SuperServer na ClassicServer można sprawdzić status działającej usługi za pomocą komendy:

systemctl status firebird
● firebird.service - Firebird Database Server
Loaded: loaded (/lib/systemd/system/firebird.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2024-12-19 14:25:42 CET; 4s ago
Docs: https://firebirdsql.org/en/firebird-rdbms/
Process: 10607 ExecStart=/opt/firebird/bin/fbguard -daemon -forever (code=exited, status=0/SUCCESS)
Main PID: 10608 (fbguard)
asks: 5 (limit: 9253)
Memory: 1.1M
CPU: 13ms
CGroup: /system.slice/firebird.service
├─10608 /opt/firebird/bin/fbguard -daemon -forever
└─10609 /opt/firebird/bin/firebird
Dec 19 14:06:50 vm-srv-kurs-03 systemd[1]: Starting firebird.service - Firebird Database Server...
Dec 19 14:06:50 vm-srv-kurs-03 systemd[1]: Started firebird.service - Firebird Database Server.

Pliki konfiguracyjne należy umieścić w folderze instalacyjnym silnika Firebird - /opt/firebird (dla Linux) | C:\program files\firebird\Firebird 5.0 (dla Windows).

Po wgraniu zoptymalizowanych plików konfiguracyjnych, zalecamy ustawić parametr Page Buffers na wartość 0 w nagłówku wszystkich baz danych systemu Streamsoft Prestiż. Wówczas silnik bazodanowy będzie wykorzystywał wartość parametru z głównego, zoptymalizowanego pliku konfiguracyjnego. Taką czynność można wykonać komendą:

/opt/firebird/bin/gfix -buffers 0 BAZA.gdb

Po wgraniu zoptymalizowanego pliku konfiguracyjnego zostanie utworzony użytkownik SYSDBA z typem autoryzacji „Legacy Authentication”. Należy zmienić jego hasło łącząc się do przykładowej bazy danych (w poniższym przykładzie podane zostało hasło domyślne: masterkey. Podczas dokonywania zmiany należy wpisać hasło, jakie zostało podane w procesie instalacji.

/opt/firebd/bin/isql -user SYSDBA -password masterkey localhost:/opt/firebird/examples/empbuild/employee.fdb

Po udanym zalogowaniu należy wpisać zapytanie: 

ALTER USER SYSDBA SET PASSWORD 'nowe_haslo' USING PLUGIN Legacy_UserManager;

Następnie zaakceptować zmiany i wyjść z narzędzia isql:

COMMIT;
EXIT;

VII. Konfiguracja połączenia do bazy danych w programie Streamsoft Pro, Streamsoft Prestiż (nieobowiązkowe)

Podczas aktualizacji silnika Firebird z wersji 3.0 do 5.0, przy dużej liczbie użytkowników bazodanowych jest możliwość przeniesienia danych wszystkich użytkowników bazodanowych. W celu przeniesienia można wykonać odtworzenie bazy danych security3.fdb do bazy security5.fdb. Jeśli została wykonana już kopia przed aktualizacją, to można przejść do procesu odtworzenia:

"C:\Program Files\Firebird\Firebird_5_0\gbak.exe" -c -se localhost:service_mgr -user SYSDBA -password masterkey "C:\Program Files\Firebird\Firebird_3_0\security3.gbk" "C:\Program Files\Firebird\Firebird_5_0\security5.fdb"
/opt/firebird/bin/gbak -c -se localhost:service_mgr -user SYSDBA -password masterkey /opt/firebird/security3.gbk /opt/firebird/security5.fdb

Konieczne jest upewnienie się, że użytkownik firebird ma uprawnienia do odtworzonego pliku bazy danych security5.fdb:

chown firebird:firebird /opt/firebird/security5.fdb

VIII. Utworzenie użytkownika SYSSTR i bazy systemowej

Po zainstalowaniu silnika Firebird 5.0 konieczne jest utworzenie użytkownika SYSSTR.

  1. W celu należy uruchomić program exe znajdujący się w katalogu instalacyjnym programu.

2. Po uruchomieniu wyświetli się ekran powitalny:

3. W oknie Przygotowanie do uruchomienia systemu za pomocą przycisku Dalej należy przejść do etapu III. Ustalenie poziomu zabezpieczeń, który umożliwia ewentualną zmianę hasła do bazy danych

4. Po ustawieniu poziomu zabezpieczeń i wyborze przycisku Dalej zostanie utworzony użytkownik SYSSTR

5. Po utworzeniu bazy systemowej wyświetlony zostanie komunikat:

6. Po poprawnym utworzeniu bazy systemowej należy zamknąć program przyciskiem Anuluj.

IX.Dearchiwizacja baz danych

Dearchiwizację bazy danych należy przeprowadzić w Module Administratora logując się jako użytkownik Admin, bez podawania hasła:

  1. W menu Administracja należy wybrać opcję Dearchiwizacja:

W wywołanym oknie należy określić, która baza danych na zostać odtworzona oraz wskazać lokalizację pliku archiwum *.gbk. W pierwszej kolejności należy odtworzyć bazę systemową.

Pliki archiwum baz danych powinny znajdować się na serwerze bazy danych. W polu Katalog należy podać ścieżkę lokalną dla serwera bazodanowego.

2. Po zakończeniu odtwarzania bazy systemowej, należy ponownie uruchomić Moduł Administratora i powtórzyć powyższe czynności dearchiwizując wszystkie bazy firmowe, a następnie wszystkie bazy dodatkowych dokumentów.

Wykonanie dearchiwizacji wszystkich baz danych kończy operację migracji na silnik bazodanowy Firebird 5.0 i pozwala na rozpoczęcie pracy w programie.



wersja 1.0 z dn. 21.07.2025