Instalacja

MobiSkan WMS jest dostarczany jako instalacja lokalna u klienta: natywny instalator dla Windows i Linux albo, dla klientów z własnym środowiskiem, zestaw obrazów kontenerowych.

Wymagania

Sprzęt i system

Element	Wymaganie
System operacyjny	Windows 10/11 lub 64-bitowa dystrybucja Linux (pakiet .deb)
Architektura	x86-64
Miejsce na dysku	ok. 1 GB na samą aplikację plus miejsce na dane i zdjęcia towarów
Sieć	stały adres w sieci lokalnej, osiągalny dla kolektorów

Instalacja natywna zawiera wszystkie potrzebne komponenty (baza danych, magazyn plików, cache) spakowane razem z aplikacją. Na komputerze klienta nie jest wymagany Docker ani żadne dodatkowe oprogramowanie serwerowe.

Porty

Instalacja natywna używa stałych portów:

Port	Przeznaczenie
3000	serwer aplikacji (panel i API)
3443	połączenie szyfrowane dla kolektorów
5432	baza danych
9000, 9001	magazyn plików (zdjęcia towarów)
6379	cache

Porty nie są dziś konfigurowalne w kreatorze. Jeśli któryś z nich jest zajęty przez inne oprogramowanie, instalacja zatrzymuje się z czytelnym komunikatem wskazującym konflikt - trzeba zwolnić port przed ponowną próbą.

Zapora sieciowa

Aby kolektory mogły łączyć się z serwerem, w zaporze systemowej trzeba dopuścić ruch przychodzący na portach 3000 i 3443 w sieci lokalnej.

Instalator natywny (wariant zalecany)

Windows

Instalacja nie wymaga uprawnień administratora. Kreator prowadzi przez kolejne ekrany:

1. Ekran powitalny.
2. Umowa licencyjna - trzeba ją zaakceptować, aby przejść dalej.
3. Wykrycie istniejącej instalacji (jeśli jest) - można ją odinstalować albo zainstalować ponownie w tym samym miejscu.
4. Wybór katalogów oraz decyzja, czy załadować dane demonstracyjne.
5. Postęp instalacji.
6. Ekran końcowy z przyciskiem otwierającym panel.

Instalator rozdziela dwa katalogi:

• katalog aplikacji (domyślnie C:\MobiSkan WMS) - pliki programu, podmieniane przy ponownej instalacji,
• katalog danych (domyślnie C:\ProgramData\MobiSkan WMS) - baza danych, zdjęcia, licencja, logi.

Katalog danych przetrwa ponowną instalację i deinstalację, o ile deinstalacja nie zostanie wykonana z jawnie zaznaczoną opcją usunięcia danych.

Po instalacji na pulpicie pojawia się skrót MobiSkan WMS. Jego kliknięcie uruchamia serwer, jeśli jeszcze nie działa, i otwiera panel w przeglądarce. Serwer pracuje w tle do wylogowania lub wyłączenia komputera.

Serwer nie startuje sam po restarcie komputera. Na Windows MobiSkan WMS nie jest rejestrowany jako usługa systemowa. Po ponownym uruchomieniu komputera pierwszy użytkownik musi kliknąć skrót, żeby serwer wystartował. To świadomy kompromis, dzięki któremu instalacja nie wymaga uprawnień administratora - taki sam model, jak w innych programach handlowych z wbudowaną bazą danych.

Deinstalacja jest możliwa na dwa sposoby: ponownym uruchomieniem instalatora (przycisk "Odinstaluj") albo z systemowego okna "Aplikacje i funkcje". W obu przypadkach usunięcie danych jest osobną, jawnie potwierdzaną decyzją.

Linux

Instalacja z pakietu .deb wymaga uprawnień administratora (sudo). Kreator zakłada dedykowanego, nieuprzywilejowanego użytkownika systemowego i rejestruje usługę systemd, która startuje automatycznie razem z systemem. Domyślne katalogi to /opt/mobiskan-wms (aplikacja) i /var/lib/mobiskan-wms (dane).

Deinstalacja na Linuksie odbywa się przez ponowne uruchomienie pliku instalatora.

Aktualizacja

Aktualizacja polega na uruchomieniu nowszego instalatora nad istniejącą instalacją. Podmieniane są wyłącznie pliki aplikacji, katalog danych pozostaje nietknięty. Kreator nie sprawdza dziś samodzielnie dostępności nowszej wersji - nowy plik instalatora przekazuje dostawca.

Wariant kontenerowy

Dla klientów z własnym środowiskiem serwerowym dostępny jest wariant oparty o obrazy kontenerowe: serwer aplikacji, panel, baza danych PostgreSQL, magazyn plików zgodny z S3, cache oraz usługa wykonująca kopie zapasowe. Złożenie jest przygotowane jako punkt wyjścia do wdrożenia, a nie jako gotowy instalator - nie zawiera odwrotnego proxy, terminacji TLS ani stosu monitorowania. Te elementy dobiera i konfiguruje zespół utrzymania po stronie klienta.

Wariant kontenerowy jest właściwym wyborem, gdy klient ma już własną politykę backupu, monitorowania i utrzymania serwerów. W pozostałych przypadkach zalecany jest instalator natywny.

Konfiguracja kopii zapasowych w tym wariancie: Kopie zapasowe.

Pierwsze uruchomienie

1. Uruchom serwer (skrót na pulpicie w Windows, usługa startuje sama w Linuksie).
2. Otwórz panel w przeglądarce pod adresem http://localhost:3000/. Z innych komputerów w sieci użyj adresu IP serwera zamiast localhost.
3. Aktywuj licencję produktu. Instalacja bez ważnej licencji nie pozwala nawet na zalogowanie. Na ekranie aktywacji widoczny jest identyfikator instalacji - przekaż go dostawcy, aby otrzymać plik licencji, a następnie wgraj otrzymany plik. Szczegóły: Licencja.
4. Załóż pierwszą firmę albo zaloguj się na konto właściciela instalacji.

Konto właściciela instalacji. Przy pierwszym starcie serwera powstaje automatycznie konto superadministratora (właściciela instalacji). Hasło startowe do tego konta przekazuje dostawca oprogramowania. Zmień je natychmiast po pierwszym zalogowaniu na ekranie konta superadministratora. Do czasu zmiany hasła panel zarządzania wszystkimi firmami na tej instalacji jest chroniony wyłącznie hasłem startowym.

Dalsze kroki opisuje strona Pierwsze kroki.

Znane ograniczenia instalacji natywnej

Obszar	Ograniczenie
Autostart (Windows)	serwer nie uruchamia się samoczynnie po restarcie komputera
Porty	zakodowane na stałe, bez możliwości zmiany w kreatorze
Aktualizacja	brak dedykowanego trybu i automatycznego sprawdzania nowszej wersji
Podpis cyfrowy	pliki instalatora nie są podpisane certyfikatem code-signing, co może wywoływać ostrzeżenia programu antywirusowego
Wykrywanie instalacji (Windows)	ograniczone do tego samego konta systemowego, które wykonało instalację