Instalacja Comarch WMS Zarządzanie – nowa wersja interfejsu (Linux)

W celu zainstalowania nowej wersji Zarządzania Comarch WMS na systemie Linux wymagane jest wcześniejsze pobranie komponentu “Zarzadzanie” za pomocą aplikacji Comarch AutoUpdate na Windowsie.
Po pomyślnie zakończonym pobieraniu komponentu w plikach instalacyjnych aplikacji Comarch AutoUpdate (C:\Comarch Auto Update\Downloads) pojawi się folder o nazwie “WMS”, w którym widoczne będą pobrane wersje aplikacji Comarch WMS.

1. Wypakować pliki aplikacji

W folderze docelowym należy wypakować plik ./Management/setup.zip z paczki

  • WMS (C:\Comarch Auto Update\Downloads\WMS\wersja_aplikacji_WMS\Management) w ścieżce z odpowiednią wersją aplikacji widoczny będzie plik Setup.zip
  • QuickFixa (C:\Comarch Auto Update\Downloads\QuickFixes#Nazwa_Profilu_W_AutoUpdate\Numer_QFa)
    Ścieżka przykładowa:
    (C:\Comarch Auto Update\Downloads\QuickFixes#2026\QF2026000.20260911.02\Management)
    Folder “QuickFixes#Nazwa_Profilu_w_Comarch_AutoUpdate” widoczny będzie w plikach instalacyjnych aplikacji Comarch AutoUpdate po pobraniu poprawki. W ścieżce znajduję się plik “Numer_QFa.zip”, w którym znajduje się folder Management

2. Uzupełnić pliki konfiguracyjne

2.1. W pliku

.\config\appsettings.json

  • w sekcji ConnectionStrings\ApiDatabase uzupełnić parametry do połączenia z bazą danych
    • Data Source – adres serwera baz danych
    • Database – nazwa bazy danych
    • User id – nazwa użytkownika
    • Password – hasło użytkownika
Uwaga
W plikach konfiguracyjnych należy podawać pełne nazwy serwerów np. sqlServer.domena.pl a nie sqlServer.
Wskazówka
Nazwę i hasło użytkownika należy podać otwartym tekstem, po pierwszym uruchomieniu aplikacji zostaną one zaciemnione
  • w sekcji License uzupełnić parametry do połączenia z serwerem licencji
    • serwer – adres serwera licencji
    • Number – numer klucza
    • EncryptionPassword – hasło do szyfrowania połączenia z serwerem licencji
  • uzupełnić parametr ErpType – jako wartość należy podać "XL"
  • w sekcji Jwt uzupełnić parametry dotyczące wydawania tokenów JWT
    • Key – należy kryptograficznie wygenerować co najmniej 32-elementowy losowy ciąg znaków, zalecane jest wygenerowanie co najmniej 64 bajtów
    • Issuer – nazwa służąca do identyfikacji aplikacji wydającej token JWT, wartość pola należy uzupełnić wg. wzoru “Comarch WMS Management Moja Firma”

Przykład polecenia, które kryptograficznie generuje 64 bajty zapisanych w formacie base64:

openssl rand -base64 64

Polecenie należy wykonać w konsoli na systemie Linux (bash). W przypadku błędu Command ‘openssl’ not found, program openssl należy zainstalować za pomocą polecenia:

sudo apt update && sudo apt install openssl

2.2. W pliku .env uzupełnić parametry

  • PROFILE – nazwa profilu – parametr umożliwia instalację wielu instancji aplikacji Comarch WMS Nowe Zarządzanie na jednej maszynie (analogicznie do profili AutoUpdate)
  • PORT – port na jakim ma działać aplikacja
  • LOGS_DIRECTORY – katalog logów. UWAGA: należy podać ścieżkę w formacie linuxowym np. /home/user/wms/logs

3. Zainstalować Docker

Należy uruchomić terminal, przejść do folderu, w którym wypakowano paczkę z aplikacją i wykonać polecenie:

./setup/install_docker

4. Zaimportować obraz do Dockera

Należy uruchomić terminal, przejść do folderu, w którym wypakowano paczkę z aplikacją i wykonać polecenie:

docker load --input wms-management-app.tar

5. Utworzyć i uruchomić kontenery dockerowe z aplikacją

Należy uruchomić terminal, przejść do folderu, w którym wypakowano paczkę z aplikacją i wykonać polecenie:

docker compose -f production.yml up --detach

Po wykonaniu powyższych punktów aplikacja powinna być dostępna pod adresem localhost na porcie podanym w pliku .env

Czy ten artykuł był pomocny?

Wyślij opinie