Posnet Server – Instalacja

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

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

POBIERZ OSTATNIą STABILNĄ WERSJĘ 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.

POBIERZ POPRZEDNIĄ WERSJĘ WERSJĘ 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:

Share This