Posnet Server – Instalacja

Posnet Server oparty jest o multiplatformowy framework Node.js, dzięki czemu może być uruchomiony zarówno pod systemem Windows, MacOS jak i dowolnymi dystrybucjami Unix’a (Linux, Ubuntu, Debian, Raspbian itp.)

WERSJA 5.3

W tej wersji nie dodaliśmy nowych funkcjonalności, a jedynie kilka drobnych poprawek w stosunku do wersji 5.2. Z góry dziękujemy za przesyłanie informacji o problemach z instalacją lub uruchomieniem wersji 5.x i jako krótkoterminowe rozwiązanie, sugerujemy instalację wersji 4.4.

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.5.3.1084.zip	29MB	82fceac95c8dbbf2e584e2f97aafb1c3
Windows	x64	posnetserver.win64.5.3.1084.zip	30MB	820a9aecb73ffd90f5d03ea414954fc8
Unix	x64	posnetserver.x64.5.3.1084.tar.gz	2.1MB	940e5973d1017b75234384370dac4510
Ubuntu 20.04	arm	posnetserver-ubuntu-2004.arm32.5.3.1084.tar.gz	1.9MB	9824de81f9d086fbd76a07307c6d485b
MacOS	arm64	posnetserver.darwin-arm64.5.3.1084.tar.gz	4.1MB	4669442b2221cd133c0998e0666cfcc5

Wersja 5.2

W porównaniu do poprzedniej wersji 5.1, rozszerzone zostały jedynie możliwości wydruków niefiskalnych.

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.5.2.1082.zip	29MB	b5cbe2b5e4f4647602d962f25fdd34ee
Windows	x64	posnetserver.win64.5.2.1082.zip	30MB	3dfa1539d8d77754950ff0176434f788
Unix	x64	posnetserver.x64.5.2.1082.tar.gz	2.1MB	d44a74ac864128e0afdd99e18e897b3a
Ubuntu 20.04	arm	posnetserver-ubuntu-2004.arm32.5.2.1082.tar.gz	1.9MB	c6f25e3622710d632f519914654a5780
MacOS	arm64	posnetserver.darwin-arm64.5.2.1082.tar.gz	4.1MB	f1f368d7b7718439e2ad4f4a1ecfbd52

WERSJA 5.1

Jest to poprawiona, stabilna wersja piątej edycji PosnetServer’a. Poza poprawieniem kilku problemów, które pojawiły się w wersji 5.0-beta, usunęliśmy również kilka starych bibliotek o statusie “deprecated” zamieniając je nowszymi wersjami. Dodaliśmy też kilka nowych feature:

• Moduł umożliwiający autoryzację i autentykację użytkowników,
• Dedykowane metody do obsługi szuflady
• Feature symulujący upgrade licencji (w /licencja/upgrade) służący do przetestowania środowiska produkcyjnego pod kątem automatycznej aktualizacji

W przypadku jakichkolwiek problemów z instalacją lub uruchomieniem wersji 5.1 sugerujemy instalację wersji 4.4 i z góry dziękujmy za przesyłanie uwag.

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.5.1.1081.zip	29MB	70a34e2bc53125221add3394df3681c6
Windows	x64	posnetserver.win64.5.1.1081.zip	30MB	c55d8dbbb7b555ffb4dc962352cd326b
Unix/Linux	x64	posnetserver.x64.5.1.1081.tar.gz	2.1MB	7ea709a7794af071019e25d695a1ab81
Ubuntu 20.04	arm	posnetserver-ubuntu-2004.arm32.5.1.1081.tar.gz	1.9MB	39c19935c134b4086c7b1a88264a653f
MacOS	arm64	posnetserver.darwin-arm64.5.1.1081.tar.gz	4.1MB	e37ad69f53418c4a02210339a4a2c8bb

WERSJA 5.0-beta

Jest to najnowsza wersja, gruntownie przebudowana wersja PosnetServer. W przypadku jakichkolwiek problemów z instalacją lub uruchomieniem, z góry dziękujmy za ich zgłaszanie.

• W tej wersji wprowadzony został symulator drukarki fiskalnej,
• Wspierane są build’y pod MacOS,
• Możliwość sprzedaży w innej walucie niż waluta ewidencyjna,
• Możliwość aktywowania automatycznego przelicznika walut pod paragonem
• Usprawniony system pluginów,
• Nie wspieramy już build’ów pod Unix x32

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.5.0.1068.zip	29MB	b8f4c8a52b406530050f2567837312a2
Windows	x64	posnetserver.win64.5.0.1068.zip	30MB	9474956a31c6cfe21257968e8bf40a69
Unix	x64	posnetserver.x64.5.0.1068.tar.gz	2.1MB	18be5b3504c0713c774be9762b043acc
Ubuntu 20.04	arm	posnetserver-ubuntu-2004.arm32.5.0.1068.tar.gz	1.9MB	97437871f2ef1b4aca5f047dc31c800d
MacOS	arm64	posnetserver.darwin-arm64.5.0.1068.tar.gz	4.1MB	f7693034e4e883e2cf82ef22398a9611

WERSJA 4.4

• nowa metoda /deviceid zwracająca unikalny numer drukarki i wersje firmware
• Poprawiono format response zwracany przez funkcję /raporty/events/dobowy w przypadku gdy parametr “mergeSection=true”

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.4.4.1052.zip	28MB	5c32e6ad4f15584fa7fe1d3eb82b29d4
Windows	x64	posnetserver.win64.4.4.1052.zip	29MB	3ca37b565e86b9832f1874bd7208e1c9
Unix	x32	posnetserver.x32.4.4.1052.tar.gz	2MB	a1a083a5794ab10fc2569c928cdb19d4
Unix	x64	posnetserver.x64.4.4.1052.tar.gz	2MB	f0b93cf22ab5459ee03ba3a6adf7d9c1
Ubuntu 18.04	arm	posnetserver-ubuntu-1804.arm32.4.4.1052.tar.gz	1.7MB	290ac355b4ec94aa4f97c97b7fdb2702

WERSJA 4.3

Największą zmianą tej wersji jest możliwość skanowania pamięci fiskalnej, więcej informacji o nowym feature znajduje się na naszym blogu: https://blog.bigdotsoftware.pl/posnet-server-odczyt-pamieci-fiskalnej/

• pobieranie zdarzeń drukarki (daty raportów dobowych, awarii zasilania, zmiany daty/czasu itp)
• pobieranie historii fiskalnych dokumentów w zadanym przedziale czasowym z dokładnością co do szczegółów każdej pozycji
• export tych danych do zewnętrznego pliku w formacie JSON

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.4.3.1045.zip	28MB	40ac18c7eea43f9429f78d5a186a89bf
Windows	x64	posnetserver.win64.4.3.1045.zip	29MB	7db27cfd6cb662fcac40558dc2c66aee
Unix	x32	posnetserver.x32.4.3.1045.tar.gz	2MB	7879aebda18bf08fed71745825b8f6d8
Unix	x64	posnetserver.x64.4.3.1045.tar.gz	2MB	3e7de0763c72f25859069057e37d62f9
Ubuntu 18.04	arm	posnetserver-ubuntu-1804.arm32.4.3.1045.tar.gz	1.5MB	5f23a055a86c230b00653990538a2150

WERSJA 4.2

• Nowy atrybut dla restpoint /command breakOnFirstError=true/false
• Obsluga retry logic w restpoint /command, analogicznie jak w pozostalych restpointach (Sekcja “retry” w pliku konfiguracyjnym)

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.4.2.1015.zip	23MB	c1d6957ba6bd2bdf143e4582736e5293
Windows	x64	posnetserver.win64.4.2.1015.zip	23MB	9ee9dc2a81f097e9e0e77be60de2a2fa
Unix	x32	posnetserver.x32.4.2.1015.tar.gz	1MB	fd38942ccd5b3c893c3f3b876eee2a3c
Unix	x64	posnetserver.x64.4.2.1015.tar.gz	1MB	aa461bedac1babd2bb6a3416ae193f2a
Ubuntu 18.04	arm	posnetserver-ubuntu-1804.arm32.4.2.1015.tar.gz	0.7MB	665277b67d72e756af986c0ce4cb18e4

WERSJA 4.1

Pierwszy kompletny release wersji 4.x.

• Pełne wsparcie dla eParagon i eFaktury. Jeśli chcesz zrezygnować z papierowej wersji paragonów i faktur, to dzięki rozwiązaniom w wersji 4.1 przejście na eParagon i eFakturę jest banalnie proste – więcej,
• Dodatkowy typ rabatu: basic,
• Kody kreskowe pod pozycjami oraz PKWiU na fakturach i eFakturach,
• Dodatkowy opis pod pozycją oraz możliwość zmiany jednostki na paragonach/eParagonach i fakturach/eFakturach,
• Możliwość przesłania innej grafiki w nagłówku lub stopce niż tej która jest domyślnie zaprogramowana w drukarce,
• Dodatkowe RESTpointy do testowania i konfiguracji eParagon/eFaktura,
• Poprawki techniczne i nowsze wersje bibliotek poprawiające wydajność i stabilność serwisu,
• Koniec wsparcia dla dedykowanych wersji pod Raspbian. Wersja oznaczona “ubuntu” działa na każdej dystrybucji na urządzeniach RaspberryPi

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.4.1.982.zip	23MB	cf36638b506ca33c41b02590965ec4f6
Windows	x64	posnetserver.win64.4.1.982.zip	23MB	90ec729d6c731c5a9b9c3ddfd1281679
Unix	x32	posnetserver.x32.4.1.982.tar.gz	1MB	52f53cf949ba8307660e13c80de19797
Unix	x64	posnetserver.x64.4.1.982.tar.gz	1MB	ff3266bb2807999f72d5bc81e1bd97aa
Ubuntu 18.04	arm	posnetserver-ubuntu-1804.arm32.4.1.982.tar.gz	0.7MB	2725f690b94877c77879941730aa0b00

WERSJA 4.0 – RC1

Z dumą prezentujemy pierwszy RC wersji 4.0. Kod serwisu został znacząco poprawiony, został zmieniony i rozszerzony interfejs API (w miarę możliwości staraliśmy się aby był kompatybilny wstecz) ale jedną z ciekawszych zmian są pluginy oraz esparcie dla eParogon. Poniżej znajduje się bardziej dokładna lista zmian:

• Wsparcie dla eParagon
• Pluginy pozwalające na integracje z RabbitMQ (AMQP), Azure Service Bus czy lokalnego DLQ
• Heartbeat’y wysyłane do drukarki mogą sprawdzać czas lub status mechanizmu drukarki
• Poprawiono rotację i severity logów. Od teraz ogromne pliki logów, szczególnie w trybie fulldebug nie powinne już stanowić problemu. dodatkowo severity bardziej odpowiada sytuacji , stad monitoring aplikacji jest bardziej intuicyjny
• Lokalne DLQ. Wszystkie paragony których nie udało się wydrukować zapisywane są w lokalnym katalogu i w dowolnym momencie można ręcznie ponowić ich wydruk
• Lepsza obsługa błędów i czytelniejsze komunikaty o błędach
• Walidacja konfiguracji. Jeśli zostanie wprowadzony błędny parametr, serwis nie uruchomi się informując o tym która część jest błędna
• Refactoring kodu oraz upgrade do najnowszych wersji bibliotek
• Zaprzestaliśmy wspierania dedykowanych buildów na RaspberryPI, o teraz wersja oznaczona symbolem “ubuntu” będzie mogła być używana naprzemiennie. Buildy będą dostępne w pierwszej wersji nie oznaczonej RC
• Dodaliśmy nowy RESTpoint /devicestatus aby szybciej określać czy jest problem z drukarką a jeśli tak to jaki i czy błąd wymaga wezwania serwisu lub czy jedynie akcji kasjera jak np naciśnięcia klawisza czy wymiany papieru (odpowiednio wcześniej można określić czy papier się kończy)

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.4.0.956-rc.zip	23MB	2b8054246f7fea862bafb4461e858631
Windows	x64	posnetserver.win64.4.0.956-rc.zip	23MB	0249b7ba4fa1ee9ca132626cb1ca4277
Unix	x32	posnetserver.x32.4.0.956-rc.tar.gz	1MB	b609547a2e7d7af6a6d7a243cb817b2b
Unix	x64	posnetserver.x64.4.0.956-rc.tar.gz	1MB	6c623ff7b54f0504c3a3c053c3e4dab5
Raspberry Pi OS (Raspbian)	deprecated	n/a	deprecated
Ubuntu 18.04 i nowsze	ARM/ARM64	0MB	wkrótce

WERSJA 3.13

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.3.13.883.zip	23MB	baca3d41a41437e24fc5f8f8d69fe869
Windows	x64	posnetserver.win64.3.13.883.zip	23MB	73074981125be8add80433f56899377f
Unix	x32	posnetserver.x32.3.13.883.tar.gz	1MB	d234e78fefd005f644bc72500d677277
Unix	x64	posnetserver.x64.3.13.883.tar.gz	1MB	d3aab79c8338ee4e372fecb52f437788
Raspberry Pi OS (Raspbian)	arm	posnetserver-raspbian.arm32.3.13.883.tar.gz	0.7MB	d4a912bed84b1cf3278d9af4ef2c7e72
Ubuntu 18.04	arm	posnetserver-ubuntu-1804.arm32.3.13.883.tar.gz	0.7MB	7eb42617344b24ebd138b288ca97b4b1

Wersja 3.13 zawiera pełne wsparcie dla narzutów i rabatów. W katalogu /docs paczki dystrybucyjnej znajdują się przykłady użycia 5 typów rabatów/narzutów: bill, line, vat, promo i subtotal. Dodatkowo poprawiono walidacje schemy. W przypadku problemów z kompatybilnością wsteczną prosimy o informację, a jako workaround należy wykonać downgrade do wersji 3.12.

WERSJA 3.12

System	Platforma	Download	Rozmiar	MD5
Windows	x32	posnetserver.win32.3.12.797.zip	23MB	b3d136cb3ceceba4a0ea22c58426d6c1
Windows	x64	posnetserver.win64.3.12.797.zip	23MB	956e3382e6da1dd366ecf691e79816c0
Unix	x32	posnetserver.x32.3.12.797.tar.gz	1MB	d20e6feb43c50f8f38b20918a91462f8
Unix	x64	posnetserver.x64.3.12.797.tar.gz	1MB	3f67fc9ab6a672a9281d726bfdfbd347
Raspberry Pi OS (Raspbian)	arm	posnetserver-raspbian.arm32.3.12.797.tar.gz	0.7MB	6d32f1ab6a1625f0883a7098a63a1ebe
Ubuntu 18.04	arm	posnetserver-ubuntu-1804.arm32.3.12.797.tar.gz	0.7MB	59c66aad32257e484dc0580a71bbd851

Wersja 3.12 zawiera wsparcie dla wydruków kodów kreskowych czy niestandardowych formatek. Dodatkowo od wersji 3.12 można włączyć “pingowanie” urządzenia, jak również ustawić niestandardową logikę ponawiania prób w przypadku błędów komunikacji.

Poprzednie wersje

automatyczna Instalacja Windows

Dla systemów Windows dostępna jest paczka zip do samodzielnej instalacji. Ręczna instalacja pozwala na pełną kontrolę procesu instalacji oraz aktualizacji naszego oprogramowania.

Ręczna instalacja windows

Poniższe punkty opisują krok po kroku jak zainstalować i uruchomić PosnetServer bez używania instalatora.

1. Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64 (lista znajduje się wyżej)
2. Rozpakuj paczkę do katalogu C:\PosnetServer
3. Zainstaluj Microsoft Redistributable Libraries znajdujące się w katalogu c:\PosnetServer\vcredist\
4. Pobierz i zainstaluj framework Node.js (strona)
5. Sprawdź czy node.js został poprawnie zainstalowany

1. Przejdź do katalogu C:\PosnetServer i zainstaluj pakiety (node_modules) wpisując polecenie “npm install”

Uruchom serwer poleceniem serverstart.cmd

ręczna instalacja Unix (Debian) oraz Raspberry Pi OS (RASPBIAN)

1. Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64/arm (lista znajduje się na górze)
2. Rozpakuj paczkę do katalogu /opt/posnetserver

Pobierz i zainstaluj framework Node.js. W zależności od dystrybucji sposób instalacji może być różny. Przykładowo dla dystrybucji Debian, bardzo pomocny opis znajduje się tutaj. Minimalna, wspierana wersja Node.js to 9.x. Sprawdź czy node.js został poprawnie zainstalowany:

Przejdź do katalogu /opt/posnetserver i zainstaluj pakiety (node_modules) wpisując polecenie “npm install”

Uruchom serwer poleceniem ./serverstart.sh

Raspberry Pi OS (RASPBIAN)

Od wersji 3.0 wprowadziliśmy wsparcie dla architektury ARM. Wersja 3.0-alpha jest aktualnie testowana na Rasbian bazującym na Debian buster.

Od wersji 3.0 jesteśmy w stanie wspierać również inne architektury jak również inne systemy operacyjne. Zachęcamy do kontaktu.

Typowe problemy i ich rozwiązywanie

Jeśli PosnetServer wyłącza się zaraz po uruchomieniu

Sprawdź czy pobrana wersja odpowiada Twojemu systemowi operacyjnemu (arm,x32,x64). Dla architektury arm publikujemy 2 paczki: osobną dla Raspbian i osobną dla Ubuntu. Wspieramy Ubuntu od wersji 18.04 oraz Debiana od wersji buster. Poniżej kompletne zestawienie wersji:

Może być to również problem starej wersji node.js (node -v). Minimalna wersja node.js to 8.x (zalecana 10.x) – w przykładzie powyżej na serwerze była zainstalowana wersja 4.2.6

Drugą przyczyną takiego zachowania może być brak zainstalowanych modułów (moduły przechowywane są w katalogu node_modules). Aby zainstalować moduły, należy wydać polecenie npm install

cd /opt/posnetserver
npm install

Jeśli posnetserver dalej wyłącza się zaraz po uruchomieniu, ale dochodzi do miejsca widocznego poniżej (Loading napi….):

Wówczas problemem może być brak odpowiednich bibliotek systemowych. Aby to zweryfikować należy przejść do katalogu /opt/posnetserver/build/Release i wykonać polecenie:

Wynik może różnić się od dystrybucji oraz wersji Posnet Server, ważne aby wszystkie zależności były rozwiązane. Poniższy przykład pokazuje brak biblioteki libnode.so:

JEŚLI NIE DZIAŁA SYMULATOR DRUKARKI FISKALNEJ

Zazwyczaj problemy z używaniem symulatora drukarki fiskalnej pojawiają się dla wdrożeń pod Windows, gdyż Windows domyślnie nie posiada kompilatora i bibliotek niezbędnych dla polecenia “npm install”. Należy pamiętać, że symulator jest komponentem opcjonalnym i błędy podczas uruchomiania informujące że symulator nie może zostać załadowany nie wpływają na stabilność PosnetServera, jedynie funkcje symulacji nie będą dostępne.

1. Na początku należy zainstalować Pythona w wersji 3, szczegóły tego procesu można znaleźć tutaj: https://github.com/nodejs/node-gyp#on-windows
2. Jeśli używany Python jest w wersji >= 3.12, należy koniecznie doinstalować pakiet setuptools poleceniem “pip install setuptools“
3. Na końcu należy zainstalować Microsoft Visual Studio, ale wystarczy wybrać jedynie pakiety do kompilacji C++ (MSVC i Windows SDK)
   

• 

• 

Share This