1. Wprowadzenie
2. Trawers-X Linux
3. Trawers-W Windows
4. Minimalne Wymagania Sprzętowe (Architektura procesora)
5. Tematy powiązane
1. Wprowadzenie
Komunikacja z systemem KSeF oparta na certyfikatach wymaga użycia
dodatkowych bibliotek programistycznych oraz podniesienia minimalnych wymagań
na dotychczas używane składniki.
Przygotowane zostały wersje programu Trawers spełniające nowe wymagania
i zawierające obsługę funkcjonalności KSeF.
Wersje te oznaczone są sufiksem '_ds', np. tr5x64_ds.zip, tr5w_ds.zip
Wersje bez obsługi KSeF (z poprzednimi wymaganiami) będą wydawane do końca 05/2026.
Poniżej opisano nowe wymagania oraz sposób aktualizacji.
2. Trawers-X Linux
a) Wymagania
- biblioteka glibc : min. 2.34 (było: 2.17)
- biblioteka xmlsec : min. 1.2.29
- biblioteka openssl : wersja 3.x.x
- biblioteka GTK3 : wersja 3.24
- biblioteka WebKit : libwebkit2gtk-4.0-37
b) Aktualizacja
1. zapewnić, że w systemie będą spełnione powyższe wymagania
2. pobrać ręcznie paczkę tr5x64_ds.zip (tr6x64_ds.zip)
3. w paczce znajduje się:
- plik wykonywalny, np. tr5x64.exe
- nowa biblioteka libharbour.so.3.2.20251021
4. w menu AD > Pomoc > O programie widać nowe informacje, np:
Nr wersji: [5] [6] 5 (ds) <-- jest dopisek (ds)
OpenSSL(exe/system) 3.5.1 / 3.0.2 XmlSec(exe) 1.2.29 (!)
(!) wykrzyknik oznacza, że w systemie jest niezgodna wersja xmlsec, np. 1.2.28
5. Podczas uruchamiania funkcji KSeF program sprawdza zgodność biblioteki xmlsec.
Gdy niezgodna to informuje i nie pozwala kontynuować.
c) wersja graficzna (GUI)
Wersja graficzna (GUI) -X będzie uzupełniana o funkcjonalności KSeF.
Obecnie obsługa KSeF jest tylko w wersji znakowej (TUI).
3. Trawers-W Windows
a) Wymagania
Wymagane jest zainstalowanie nowego środowiska mingw32_ds
To nowe środowisko może współistnieć z dotychczasowym mingw32.
b) Aktualizacja
1. Pobrać i zainstalować środowisko mingw32_ds:
https://ftp.tres.pl/dodatki-windows/trmingw32_ds.exe
Zainstalować do tego samego katalogu, w którym jest obecnie mingw32.
2. pobrać ręcznie paczkę tr5w_ds.zip (tr6w_ds.zip)
3. w paczce znajduje się:
- plik wykonywalny tr5w.exe
- plik konfiguracyjny tr5w.exe.config
Ten plik wskazuje na nowe środowisko mingw32_ds:
<probing privatePath="..\..\mingw32_ds\bin"/>
- nowa biblioteka harbour-32-20251021.dll
Te trzy pliki należy umieścić tam, gdzie są obecne wersje (bez KSeF)
Przykładowo:
c:\trawers
c:\trawers\mingw32 <-- dotychczasowa wersja środowiska
c:\trawers\mingw32_ds <-- nowa wersja (dla KSeF)
c:\trawers\dane
c:\trawers\dane\bin
c:\trawers\dane\bin\tr5w.exe <-- nowe exe z paczki tr5w_ds.zip (z KSeF)
c:\trawers\dane\bin\tr5w.exe.config <-- nowy plik konfiguracyjny wskazujący na ..\..\mingw32_ds\bin
c:\trawers\dane\bin\harbour-32-20251021.dll <-- nowa biblioteka (z KSeF)
4. Ze zmiennej środowiskowej PATH usunąć wpisy wskazujące na mingw32\bin
np. c:\trawers\mingw32
Windows 11 > Menu Start:
wpisać: Zmienne środowiskowe
na liście kliknąć: Edytuj zmienne środowiskowe systemu
W oknie [Właściwości systemu] kliknąć [Zmienne środowiskowe]
Pojawi się okno [Zmienne środowiskowe]
Na listach [Zmienne użytkownika] oraz [Zmienne systemowe]
sprawdzić zmienną PATH i usunąć wpisy wskazujące na mingw32\bin
Zmienną PATH należy także usunąć ze skryptów uruchamiających Trawersa
(jeśli używano).
5. Uruchomić ponownie komputer
(konieczne ze względu na mechanizmy cache'owania systemu Windows)
6. Uruchomić Trawers
W menu AD > Pomoc > O programie widać nowe informacje, np:
Nr wersji: [5] [6] 5 (ds) <-- jest dopisek (ds)
OpenSSL(exe/system) 3.6.0 / 3.6.0 XmlSec(exe) 1.3.8
c) Wersja graficzna (GUI) dla Windows
W nowym środowisku mingw32_ds nie będzie dostępna wersja graficzna (GUI).
Dostępna będzie tylko wersja znakowa (TUI) (z KSeF).
Wersja graficzna (GUI) dostępna będzie jedynie w poprzednim środowisku mingw32.
Nie będzie posiadała funkcjonalności KSeF.
Możliwe będzie równoczesne używanie wersji GUI bez KSeF z wersją TUI z KSeF.
Konfiguracja wtedy może wygladać tak:
c:\trawers
c:\trawers\mingw32 <-- dotychczasowa wersja środowiska (dla tr6w.exe)
c:\trawers\mingw32_ds <-- nowa wersja (dla KSeF)
c:\trawers\dane
c:\trawers\dane\bin
c:\trawers\dane\bin\tr5w.exe <-- nowe exe z paczki tr5w_ds.zip (z KSeF)
c:\trawers\dane\bin\tr5w.exe.config <-- nowy plik z paczki tr5w_ds.zip konfiguracyjny wskazujący na ..\..\mingw32_ds\bin
c:\trawers\dane\bin\harbour-32-20251021.dll <-- nowa biblioteka (dla KSeF) z paczki tr5w_ds.zip
c:\trawers\dane\bin\tr6w_gui.exe <-- exe z paczki tr6w.zip (bez KSeF)
c:\trawers\dane\bin\tr6w_gui.exe.config <-- plik konfiguracyjny wskazujący na ..\..\mingw32\bin
c:\trawers\dane\bin\harbour-32-20211020.dll <-- biblioteka dla tr6w_gui.exe
Nasze oprogramowanie wymaga procesora zgodnego ze standardem x86-64-v2
(wprowadzonym ok. 2009 roku). Starsze procesory nie obsługują
instrukcji niezbędnych do poprawnego działania aplikacji.
Wspierane serie procesorów:
Intel:
* Intel Core i3 / i5 / i7 / i9 - wszystkie generacje od Nehalem (seria 500+) wzwyż.
* Intel Xeon - wszystkie modele od serii 3400 / 5500 / 7500 wzwyż.
* Intel Pentium i Celeron - modele oparte na architekturze Sandy Bridge (2011 r.) lub nowsze (np. serie G).
* Intel Atom - serie oparte na mikroarchitekturze Silvermont (2013 r.) i nowsze.
AMD:
* AMD Ryzen / EPYC / Threadripper - wszystkie generacje.
* AMD FX / Opteron - modele oparte na architekturze Bulldozer (2011 r.) i nowsze.
* AMD Athlon / Sempron - serie oparte na architekturze Jaguar (2013 r.) i nowsze (np. gniazdo AM1).
Procesory NIEKOMPATYBILNE (Przykłady):
Aplikacja nie uruchomi się na starszych jednostkach, m.in.:
* Intel Core 2 Duo / Core 2 Quad (brak SSE4.2).
* AMD Phenom II / Athlon II (brak SSE4.2).
* Stare serie Intel Pentium 4 / Dual Core (sprzed 2010 r.).
Jak sprawdzić kompatybilność na działającym systemie ?
Jeśli użytkownik chce zweryfikować, czy jego obecny serwer spełnia wymagania,
może wykonać poniższe polecenia:
W systemie Linux: Plecenie, aby sprawdzić, czy procesor obsługuje wymagane flagi:
Bash
grep -E 'sse4_2|popcnt' /proc/cpuinfo
Jeśli po wykonaniu komendy tekst podświetli się na czerwono
lub pojawi się lista flag, procesor jest kompatybilny.
systemie WindowsPowerShell):
PowerShell
Get-WmiObject Win32_Processor | Select-Object Name
Należy porównać nazwę procesora z listą powyżej (wszystkie modele
Core i3/i5/i7 są wspierane).
Dlaczego wymagamy x86-64-v2 ?
Wymóg ten pozwala na wykorzystanie nowoczesnych mechanizmów bezpieczeństwa
(np. ochrony stosu) oraz znacząco przyspiesza operacje matematyczne
i przetwarzanie danych, co przekłada się na stabilność i wydajność
dostarczanego rozwiązania.