Minimalne wymagania

Minimalne wymagania niezbędne do prawidłowego działania Comarch POS oraz Comarch POS Agent (na osobnych maszynach):

  • System Operacyjny Microsoft Windows 8.1/10
  • Procesor Intel Core i3/i5/i7 4th Gen, AMD Ryzen 5 lub podobnej klasy (Wynik w CPU benchmark min. 3000 pkt – w celi zapewnienia akceptowalnej reakcji)
  • 6 GB pamięci RAM (lub więcej)
  • Microsoft .NET Framework 4.7.2
  • Microsoft SQL Server 2014 w wersji Express lub wyższy
  • Collation Latin1_General_CI_AS

W przypadku instalacji, gdzie Comarch POS oraz Comarch POS Agent będą na jednej maszynie, należy zapewnić (w stosunku do powyższych wymagań):

  • Lepszy procesor, min. Intel Core i5
  • 8 GB pamięci RAM lub więcej

Uwaga
Należy uwzględnić

  • minimalne wymagania systemu Microsoft Windows
  • minimalne wymagania systemu Microsoft SQL Server

w zależności od obciążenia stanowiska innym oprogramowaniem lub ilością wykonywanych operacji.

Podczas instalacji aplikacji Comarch POS, Comarch ERP Auto Update weryfikuje wersję zainstalowanego komponentu Microsoft .NET Framework. W przypadku braku lub niższej wersji tego komponentu, zostanie on zainstalowany w wymaganej wersji.




Instalacja Comarch ERP Auto Update

Przed rozpoczęciem instalacji i konfiguracji systemu Comarch POS niezbędna jest poprawna instalacja i konfiguracja programu Comarch ERP Auto Update.

W tym celu, należy:

  1. Pobrać plik instalatora UpdateAgent_Setup_[nr_wersji]_PL.EXE.
  2. Uruchomić instalator.
  3. Zaakceptować warunki korzystania z gwarancji.
  4. Wskazać folder instalacyjny Auto Update.
  5. Uruchomić aplikację.

Uwaga
Aplikacja Comarch ERP Auto Update wymaga zainstalowanego .NET Framework w wersji 4.7.2.

Uwaga
Plik UpdateAgent_Setup_[nr_wersji]_PL.EXE dostępny jest na serwerze ftp1.support.comarch.pl w katalogu Pub w folderze Comarch ERP Auto Update oraz na Indywidualnych Stronach Partnerów (Comarch POS –> Aktualne Wersje).

Uwaga
Przy pobieraniu należy wybrać odpowiednią wersję instalatora dla agenta:

  • Nadrzędnego – Jeden w całej instalacji, łączy się do serwerów Comarch i odpowiada za pobieranie oraz dystrybucję oprogramowania do agentów podrzędnych
  • Podrzędnego – Wiele w całej instalacji, łączy się do agenta nadrzędnego

Uwaga
Unikalne Id Klienta może być wykorzystane tylko w jednym agencie nadrzędnym.

Uruchomienie instalatora Auto Update spowoduje pojawienie się okna informującego o konieczności instalacji dodatkowych komponentów niezbędnych do poprawnej pracy auto Update.

W kolejnym kroku pojawi się okno do konfiguracji narzędzia.

Okno konfiguracji Comarch ERP Auto Update
Okno konfiguracji Comarch ERP Auto Update

  • Kod agenta – jest to Id klienta
  • Folder pobierania – domyślny katalog do którego pobierane są aktualizacje, poprawki oraz dodatki
  • Adres agenta nadrzędnego – dla nadrzędnych jest to update.comarch.com, dla podrzędnych adres maszyny z zainstalowanym agentem głównym
  • Port agenta nadrzędnego – dla nadrzędnych jest to właściwy port serwera Comarch – 9466, dla agentów podrzędnych domyślnie 11365
  • Folder kopii zapasowych – domyślny katalog tworzenia kopii zapasowych
  • Folder instalacji wersji – domyślny katalog instalacyjny aplikacji

Uwaga

Dane Id klienta może być użyte tylko do rejestracji jednego agenta głównego na serwerze Comarch. Próba rejestracji innych instalacji agenta na to samo Id będzie skutkowała błędem połączenia.

Uwaga

W wersji instalatora dla agenta podrzędnego w polu Kod agenta należy wprowadzić właściwy kod zdefiniowany w strukturze agentów.




Instalacja i konfiguracja Comarch POS

Instalacja aplikacji Comarch POS odbywa się za pomocą narzędzia Comarch ERP Auto Update.

Po uruchomieniu Comarch ERP Auto Update należy wykonać następujące czynności:

    1. Na zakładce Konfiguracja dodać produkt Comarch Retail.

Rysunek 1 Dodanie produktu Comarch Retail

2. Dla produktu Comarch Retail dodać komponent Comarch POS.

Rysunek 2 Dodanie komponentu Comarch POS
Rysunek 2 Dodanie komponentu Comarch POS

3. Skonfigurować komponent Comarch POS.Okno konfiguracji otwierane jest poprzez zaznaczenie komponentu oraz wybranie z głównego menu przycisku [Konfiguracja]. W oknie należy wprowadzić dane dotyczące połączenia bazy danych stanowiska POS.

Rysunek 3 Konfiguracja komponentu Comarch POS
Rysunek 3 Konfiguracja komponentu Comarch POS

      • Nazwa serwera – nazwa serwera wraz z instancją, na którym zostanie utworzona baza danych
      • Nazwa bazy danych – domyślnie podpowiada się POSDB_[kod_profilu]
      • Dane do logowaniaLogin, Hasło

Przycisk [Test połączenia] umożliwia sprawdzenie nawiązania połączenia ze wskazanym serwerem.

Uwaga
Z jednej bazy lokalnej może korzystać tylko jedno stanowisko POS.

Poniżej sekcji konfiguracji bazy POS znajdują się dodatkowe parametry konfiguracyjne:

  • Konfiguracja dezinstalacji – zaznaczony parametr spowoduje usunięcie bazy danych przy dezinstalacji POS
  • Automatycznie zamykaj procesy podczas aktualizacji – zaznaczenie parametru Zamykaj dla wybranego procesu decyduje o jego zamknięciu podczas instalacji poprawek i dodatków. Parametr Uruchamiaj usługi decyduje o opcjonalnym ponownym uruchomieniu po ukończeniu instalacji. Zaznaczenie parametru Według ustawień dodatków spowoduje pobranie konfiguracji dotyczącej danego procesu z konfiguracji dodatków. Dotyczy to również wykonywania instalacji na agentach podrzędnych w ramach akcji zdalnych.

Rysunek 4 Dodatkowa konfiguracja komponentu Comarch POS
Rysunek 4 Dodatkowa konfiguracja komponentu Comarch POS

4. Zapisać zmiany oraz zamknąć okno konfiguracji produktów przez wybranie odpowiednio przycisku [Zapisz], a następnie [Zamknij].

Rysunek 5 Przyciski [Zapisz] oraz [Zamknij] w oknie Konfiguracja
Rysunek 5 Przyciski [Zapisz] oraz [Zamknij] w oknie Konfiguracja
5. W głównym oknie aplikacji należy wybrać jedną z dostępnych opcji:

    • [Pobierz] – spowoduje, że produkt zostanie zapisany w katalogu podanym w konfiguracji, domyślna ścieżka to C:\Comarch ERP Auto Update\Downloads\. Po zakończeniu pobierania dostępny staje się przycisk [Instaluj].
    • [Pobierz i instaluj] – produkt jest automatycznie instalowany po zakończeniu pobierania.

Po pomyślnym zainstalowaniu aplikacji, w oknie głównym instalatora pojawi się odpowiedni komunikat, a na pulpicie Windows oraz w menu Start pojawią się skróty do aplikacji Comarch POS.

Rysunek 6 Produkt Comarch Retail wraz z komponentem Comarch POS
Rysunek 6 Produkt Comarch Retail wraz z komponentem Comarch POS




Instalacja komponentu BI Point

Na stanowisku POS można korzystać z aplikacji BI Point po zainstalowaniu odpowiedniego komponentu za pomocą Comarch ERP Auto Update.

Po uruchomieniu aplikacji Comarch ERP Auto Update należy wykonać następujące czynności:

    1. Na zakładce Konfiguracja należy wskazać produkt Comarch Retail
    2. Dla produktu Comarch Retail dodać komponent Comarch Retail BI Point

Rysunek 1 Dodanie komponentu Comarch POS BI Point

  1. Zapisać zmiany oraz zamknąć okno konfiguracji produktów przez wybranie odpowiednio przycisku [Zapisz], a następnie [Zamknij].
  2. W głównym oknie aplikacji należy wybrać jedną z dostępnych opcji:
    • [Pobierz] – spowoduje, że produkt zostanie zapisany w katalogu podanym w konfiguracji, domyślna ścieżka to C:\Comarch ERP Auto Update\Downloads\. Po zakończeniu pobierania dostępny będzie przycisk [Instaluj].
    • [Pobierz i instaluj] – produkt jest automatycznie instalowany po zakończeniu pobierania.

Rysunek 7 Produkt Comarch Retail wraz z komponentem Comarch POS BI Point

Domyślny adres prezentowany na stanowisku POS dla BI Point to: http://bipoint.comarch.pl/. Adres można zmienić w tabeli stanowiska POS Configuration.Settings, w wierszu o nazwie BIPointUrl.

Szczegółowe omówienie instalacji produktów znajduje się w sekcji Comarch ERP Altum Auto Update.




Aktualizacja Comarch ERP Auto Update do wersji 2020.0 lub wyższej

1. Aby móc w pełni korzystać ze wszystkich możliwości sieci agentów należy zaraz po podniesieniu agenta nadrzędnego zaktualizować agentów podrzędnych. Jest to wymagane, ponieważ nie ma możliwości wykonywania akcji zdalnych pomiędzy wersjami 2019.0 i 2020.0.

Wskazówka

Żeby proces aktualizacji AU przebiegł poprawnie należy upewnić się, że wszystkie wymagane porty są poprawne:

Na agencie nadrzędnym:

  1. Połączenia przychodzące:
    • 5672
    • 8009
    • 11365
  2. Połączenia wychodzące:
    • 11366 – domyślnie jest to 11366, ale mogą być wymagane także inne w zależności od tego, jaki port jest skonfigurowany na podrzędnym do łączenia z agentem nadrzędnym,
    • 8466 – port do łączenia z update.comarch.com dla AU 2019.0,
    • 9466 – port do łączenia z update.comarch.com dla AU 2020.0

Na agencie podrzędnym:

  1. Połączenia przychodzące:
    • 11366 – domyślnie jest to 11366, ale mogą być wymagane także inne w zależności od tego, jaki port jest skonfigurowany na podrzędnym do łączenia z agentem nadrzędnym
  2. Połączenia wychodzące:
    • 5672
    • 8009
    • 11365

2. W celu dokonania procesu aktualizacji należy uruchomić lub zrestartować UI agenta nadrzędnego (w zależności od tego, czy był on aktualnie uruchomiony w momencie udostepnienia paczki z nową wersją Comarch ERP Auto Update)

3. W zależności od tego, czy parametr na oknie konfiguracji AU „Aktualizuj automatycznie przy starcie programu” jest zaznaczony proces aktualizacji rozpocznie się sam lub będzie wymagane potwierdzenie go przez użytkownika

4. Następnie powinno pojawić się okno z progressbarem:

5. W czasie aktualizacji agent nadrzędny automatycznie przełączy się do serwera update.comarch.com z portu 8466 na port 9466. Po ukończeniu aktualizacji najlepiej sprawdzić czy usługa RabbitMQ jest uruchomiona. Można także w oknie przeglądarki wejść na adres http://localhost:15672 i zalogować się jako admin (Login: admin, Hasło: admin). Jeżeli nie będzie z tym żadnych problemów oznacza to, że usługa rabbita została poprawnie skonfigurowana.

6. Wszyscy agenci podrzędni będą widnieć na liście, jako „Offline”, aż do momentu podniesienia ich do wersji 2020.0. Kropka zmieni się na „Online” gdy uzyskają oni połączenie do kolejki rabbita. Agentów podrzędnych można podnieść albo wszystkich na raz przy pomocy przycisku „Aktualizuj wszystkich” albo po jednym, po rozwinięciu danego agenta i wybraniu „Aktualizuj agenta” . Wtedy rozpocznie się jego proces aktualizacji.

7. W czasie aktualizacji podrzędnego, jeżeli wymagane porty są otwarte w kolumnie „Status” będą wyświetlane kroki jego aktualizacji.

8. Po zakończeniu aktualizacji agent podrzędny stanie się “Online” a w kolumnie “Wersja” pojawi się informacja o zainstalowanych na nim komponentach. Zielony „check” w kolumnie „Nazwa” oznacza, że dany agent podrzędny znajduje się w aktualnej wersji.

Po aktualizacji AutoUpdate do wersji 2020.0 będzie on domyślnie używał komunikacji WCFowej.

Aby móc korzystać z komponentu Comarch mPOS należy korzystać z RESTa.

Do zmiany formy komunikacji agent nadrzędny <-> agenci podrzędni na RESTa należy na oknie konfiguracji w sekcji “Konfiguracja komunikacji” zaznaczyć “Używaj komunikacji RESTowej”. Po zapisaniu konfiguracji nastąpi restart UI I usługi AU i forma komunikacji pomiędzy agent nadrzędnym i podrzędnymi ulegnie zmianie. Zmiana formy komunikacji zalecana jest dopiero po podniesieniu sieci agentów podrzędnych, ponieważ komunikacja AU 2019.0 <-> AU 2020.0 może odbyć się tylko przy pomocy WCFa.

10. Wymagana konfiguracja portów dla AU 2020.0, jeżeli zarówno agent nadrzędny, jak i agenci podrzędni zostali podniesieni do nowej wersji:

Na agencie nadrzędnym:

  1. Połączenia przychodzące:
    • 5672
    • 8009
    • 11365
  2. Połączenia wychodzące:
    • 9466

Na lokalnym agencie nadrzędnym:

  1. Połączenia przychodzące:
    • 8009
  2. Połączenia wychodzące:
    • 5672
    • 8009
    • 11365

Na agencie podrzędnym:

  1. Połączenia wychodzące:
    • 5672
    • 8009
    • 11365

Uwaga
Aplikacja Comarch ERP Auto Update wymaga zainstalowanego .NET Framework w wersji 4.7.2.

Przykład

Rozwiązywanie problemów związanych z rabbitem

W przypadku wystąpienia problemów z rabbitem, można je rozwiązać w następujący sposób:

  1. uruchomić “cmd.exe” z uprawnieniami administratora, a następnie wykonać następujące instrukcje
  2. cd C:\Program Files\RabbitMQ Server\rabbitmq_server-3.7.5\sbin
  3. rabbitmq-service.bat remove
  4. rabbitmq-service.bat install
  5. rabbitmq-service.bat start
  6. rabbitmq-plugins enable rabbitmq_management
  7. rabbitmqctl stop (należy chwile zaczekać na wykonanie tej komendy, czasem jest wymagany ręczne zatrzymanie usługi RabbitMQ)
  8. rabbitmq-server -detached
  9. rabbitmqctl start_app (należy chwile zaczekać na wykonanie tej komendy, czasem jest wymagany ręczne uruchomienie usługi RabbitMQ)
  10. rabbitmqctl add_user admin admin
  11. rabbitmqctl set_user_tags admin administrator
  12. rabbitmqctl set_permissions -p / admin “.*” “.*” “.*”

W czasie wykonywania powyższych komend może wystąpić problem z autentykacją i plikiem erlang cookie. Aby go rozwiązać należy przekopiować: C:\Windows\System32\config\systemprofile\.erlang.cookie

do

C:\Users\UserName\.erlang.cookie