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.0 – zapowiedź
W wersji 4.0 zostanie zmieniony interfejs API oraz zostaną podniesione wersje bibliotek. Zostanie dodane wsparcie dla ARM64 oraz zrezygnujemy z dwóch build’ów dla ARM32 (nie będzie dłużej podziału na ubuntu oraz raspbian)
POBIERZ AKTUALNĄ 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.
POBIERZ POPRZEDNIĄ WERSJĘ 3.10 / 3.11
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.3.11.773.zip | 23MB | 49ddd8f72bff657e275460bf3fb781aa |
| Windows | x64 | posnetserver.win64.3.11.773.zip | 23MB | f388888a4a650f79b5f0fe900a9d49c8 |
| Unix | x32 | posnetserver.x32.3.11.773.tar.gz | 1MB | ee7fa55d81db626fb95485b7eb3ced3c |
| Unix | x64 | posnetserver.x64.3.11.773.tar.gz | 1MB | 80b82d5934b8a090a753d8ad4adb7716 |
| Raspberry Pi OS (Raspbian) | arm | posnetserver-raspbian.arm32.3.11.773.tar.gz | 0.7MB | 689cb6b17f05f8e3630bfb47c5463bbe |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.3.11.773.tar.gz | 0.7MB | 1c8c4c4c9076a5d14849069591b6c000 |
Wersja 3.11 zawiera część funkcjonalności z przygotowywanej aktualnie wersji 4.0. Między innymi API zostało rozszerzone ułatwiając zarządzanie lub drukowanie niestandardowych formatek. Podczas wysyłania requestu do wydruku paragonu lub faktury możliwe jest uzupełnienie nowego pola “userdata” a w odpowiedzi znajdują się znaczniki czasowe rozpoczęcia oraz zakończenia wydruku.
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.3.10.738.zip | 23MB | 341b2460650696040c6e37f0748429d2 |
| Windows | x64 | posnetserver.win64.3.10.738.zip | 23MB | 74732ace6b549822009c13b63200506e |
| Unix | x32 | posnetserver.x32.3.10.738.tar.gz | 1MB | 59754b2c6683f60a9a1fa618f8932e3f |
| Unix | x64 | posnetserver.x64.3.10.738.tar.gz | 1MB | 382ee1a803bc26765022c9cd7b8cb42f |
| Raspberry Pi OS (Raspbian) | arm | posnetserver-raspbian.arm32.3.10.738.tar.gz | 0.7MB | bcf070b85271efdd54493c467b36459a |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.3.10.738.tar.gz | 0.7MB | 36bf36c67a3d28336772c242d5e87080 |
W wersji 3.9 oraz wersji 3.10 podniesione zostały wersje części bibliotek, stąd podczas wykonywania upgrade należy pamiętać o wykonaniu polecenia “npm install“, a w razie jakichkolwiek problemów należy usunąć katalog node_modules i wówczas zainstalować moduły ponownie poleceniem “npm install“. Poprawiony został logger. API jest w pełni kompatybilne z wersją 3.8, stąd nie trzeba aktualizować aplikacji używających PosnetServer. Wersja 3.9 jest w pełni przetestowaną i stabilną wersją, jednak z góry dziękujemy za zgłaszanie jakichkolwiek problemów z wdrożeniem i jako tymczasowy workaround proponujemy używanie wersji 3.8.
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.
- Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64 (lista znajduje się wyżej)
- Rozpakuj paczkę do katalogu C:\PosnetServer
- Zainstaluj Microsoft Redistributable Libraries znajdujące się w katalogu c:\PosnetServer\vcredist\
- Pobierz i zainstaluj framework Node.js (strona)
- Sprawdź czy node.js został poprawnie zainstalowany
- 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)
- Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64/arm (lista znajduje się na górze)
- 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:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
Ubuntu Debian 20.04 focal bullseye/ sid - 11 19.10 eoan buster / sid - 10 19.04 disco buster / sid 18.10 cosmic buster / sid 18.04 bionic buster / sid 17.10 artful stretch / sid - 9 17.04 zesty stretch / sid 16.10 yakkety stretch / sid 16.04 xenial stretch / sid 15.10 wily jessie / sid - 8 15.04 vivid jessie / sid 14.10 utopic jessie / sid 14.04 trusty jessie / sid 13.10 saucy wheezy / sid - 7 13.04 raring wheezy / sid 12.10 quantal wheezy / sid 12.04 precise wheezy / sid 11.10 oneiric wheezy / sid 11.04 natty squeeze / sid - 6 10.10 maverick squeeze / sid 10.04 lucid squeeze / sid |
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:
|
1 |
ldd native.node |
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:
