W celu uzgodnienia stanów magazynów należy w menu głównym wybrać kafel [Aktualizacja danych], a następnie [Uzgadnianie stanów magazynowych].

Uwaga

Funkcjonalność dostępna jest tylko dla tych użytkowników, którzy posiadają uprawnienie do uzgadniania stanów w Comarch ERP XL.

Wykonanie procesu spowoduje, że stany magazynowe towarów dostępnych w sklepie zostaną ustalone zgodnie z informacjami uzyskanymi z systemu centralnego. Pozyskane dane mogą nie uwzględniać informacji o dokumentach, które nie zostały jeszcze przesłane ze stanowiska Comarch POS lub Comarch mPOS do systemu centralnego. Aby zminimalizować prawdopodobieństwo istnienia takich dokumentów należy:

• upewnić się, że wszystkie urządzenia w sklepie obsługujące Comarch POS oraz Comarch mPOS zostały włączone i pracują w trybie online
• uruchomić proces uzgadniania po możliwie najdłuższym czasie od wystawienia w sklepie ostatniego dokumentu (np. przed rozpoczęciem dnia pracy)

W celu uruchomienia procesu uzgadniania stanów magazynowych należy wybrać przycisk [Rozpocznij].

W pierwszej kolejności system weryfikuje, czy w kolejce istnieją nieprzetworzone jeszcze dokumenty pochodzące z danego centrum. Jeśli tak, wyświetlony zostanie komunikat: „Znaleziono dokumenty, które nie zostały jeszcze zarejestrowane przez system centralny - uzgodniony stan magazynu może różnić się od faktycznego aktualnego stanu w sklepie. Zaleca się wykonanie operacji później. Czy na pewno chcesz rozpocząć proces?”. Po rozpoczęciu procesu stany magazynowe są ustalane w usłudze POS Agent na podstawie informacji uzyskanych z systemu ERP. Po ukończeniu procesu wyświetlony zostanie komunikat: Uzgodniono stany magazynowe z systemem centralnym. W przypadku wystąpienia błędu lub braku połączenia wyświetlona zostanie informacja o przerwaniu procesu i konieczności powtórnego jego uruchomienia.

Comarch POS Agent

Informacje podstawowe

Usługa (POS Agent) dostarcza aktualne informacje o stanach magazynowych na każdym stanowisku , podczas wystawiania dokumentów. Informacje te prezentowane są z uwzględnieniem poszczególnych magazynów. Wszystkie procesy w magazynie będą mogły zachodzić w trybie offline z centralą, dzięki czemu korzystanie z tej usługi zapewni pełną autonomię sklepu, poprzez zagwarantowanie, że stan magazynowy jest zawsze aktualny. W trybie pracy offline z centralą, do komunikacji z usługą POS Agent wykorzystywany jest broker wiadomości Comarch POS Agent Broker. Komponent ten agreguje kolejkę wiadomości, przekazując aktualizację stanów magazynowych do właściwego POS Agenta w danym sklepie. Usługa POS Agent to miejsce, w którym przechowywane będą wszystkie niezbędne informacje dla stanowiska POS m.in.:

• zaparkowane dokumenty
• statystyka licznika bramek
• stany magazynowe wraz z rezerwacjami

Zasada działania

Usługa POS Agent działa jako samodzielna usługa z własną bazą danych na tym samym komputerze co baza Comarch POS lub osobnym. Przed zatwierdzeniem dokumentów POS Agent weryfikuje poprawność stanów magazynowych na dokumentach:

• handlowych:
  • Paragony (PAR) oraz ich korekty ilościowe i ręczne
  • Faktury sprzedaży (FS) oraz ich korekty ilościowe i ręczne
  • Zamówienia sprzedaży (ZS)
• magazynowych:
  • Przesunięcia międzymagazynowe (MM-/MM+)
  • Przychody oraz rozchody wewnętrzne (PW/RW) oraz ich korekty ilościowe
  • Przyjęcia oraz wydania zewnętrzne (PZ/WZ) oraz ich korekty ręczne

Instalacja i konfiguracja

Instalacja usługi Comarch POS Agent odbywa się przy pomocy narzędzia Comarch Update Agent.

Uwaga

Wymagana jest najnowsza wersja Comarch Update Agent.

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

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

  

• Dla produktu Comarch POS dodać komponent Comarch POS Agent.

• • Skonfigurować komponent Comarch POS Agent. Okno konfiguracji otwierane jest poprzez zaznaczenie komponentu oraz wybranie z menu przycisku [Konfiguracja]. W oknie należy wskazać dane do połączenia z serwerem Microsoft SQL Server Management Studio, na którym zostanie zainstalowana baza POS Agent.

    

    Konfiguracja połączenia z serwerem SQL dla POS Agent
  • Nazwa serwera – nazwa serwera wraz z instancją, na którym zostanie zainstalowana baza danych
  • Nazwa bazy danych – domyślnie podpowiada się POSAgent_[kod_profilu]
  • Dane do logowania – Login, Hasło

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

• Następnie należy zapisać zmiany oraz zamknąć okno konfiguracji komponentu przez wybranie odpowiednio przycisków [Zapisz] i [Zamknij].

Konfiguracja w integracji Comarch ERP XL

Aby skonfigurować usługę POS Agent w Comarch ERP XL należy:

• Z poziomu Administratora oddziałów → zakładka Oddziały → edycja oddziału POS →  zdefiniować kod POS Agenta i magazyny na zakładce POS Agent

Uwaga

Pola Host, Port, GUID zostaną uzupełnione automatycznie, po poprawnym wprowadzeniu danych w POSAgentConfigurator.exe, znajdującego się w folderze instalacyjnym POS Agent.

• W kolejnym kroku należy otworzyć katalog instalacyjny POS Agent i uruchomić aplikację
• Po naciśnięciu przycisku [OK] otwiera się okno konfiguratora:

 

• W aplikacji należy podać:
  • Adres IP usługi POS Agent– adres IP komputera, na którym została zainstalowana usługa POS Agent
  • Port usługi POS Agent – domyślnym portem jest 8098
  • Adres serwera OMS – domyślnym adresem jest http://localhost:8099/DataService/
  • Kod POS Agenta – kod POS Agent wprowadzony w aplikacji Comarch POS Agent
  • GUID – wartość nadawana automatycznie
• Usługę instaluje się za pomocą przycisku [Instaluj]. Poprawność wcześniej wprowadzony danych można zweryfikować za pomocą przycisku [Weryfikuj]. Natomiast przycisk [Rejestruj] służy do rejestracji usługi POS Agent.
• W celu weryfikacji czy proces zakończył się poprawnie, należy przejść na zakładkę POS Agent w Comarch ERP XL i sprawdzić, czy zaktualizowane zostały wpisy w polach: Host, Port i parametr Zarejestrowano.

W aplikacji POS, po instalacji usługi, dostępna jest ikona  której kolor informuje o stanie połączenia z usługami:  

• Zielony – wszystkie usługi są włączone

 

• Żółty – jedna z usług jest wyłączona

• Czerwony – wszystkie usługi są wyłączone

Uwaga

Każde stanowisko POS i mPOS w sklepie powinna nawiązać połączenie ale tylko z POS Agent w przypadku potwierdzenia dowolnego dokumentu magazynowego. Jednak jedynie połączenie z centralą zapewnia, że dokument magazynowy zawiera poprawną – dostępną ilość i będzie prawidłowo przetwarzany.

Dodatkowo pod ikoną  dostępny jest również przycisk [Ustawienia usług], który otwiera okno konfiguracji usług aplikacji Comarch Retail POS, dostępny również z menu głównego pod kaflem Konfiguracja.

Rejestracja usługi POS Agent z poziomu wiersza poleceń

Istnieje możliwość rejestracji usługi Comarch POS Agent z poziomu wiersza poleceń systemu Windows. Dostępne komendy:

• --register
• --install
• --uninstall
• --setaddress --agentIP:127.0.0.1 –port:8098 (ustawienie adresu IP i portu dla usługi POS Agent)
• --seterpaddress –adres:http://example.com (ustawienie adresu serwera OMS)
• --stop
• --start
• --help
• --status
• --waitforstatus

W celu rejestracji usługi Comarch POS Agent z poziomu wiersza poleceń należy: 1.Otworzyć wiersz polecenia jako administrator z lokalizacji: C:\Users\nazwa.użytkownika\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\System Tools

2.Odnaleźć i skopiować ścieżkę gdzie znajduje się aplikacja Konfigurator usługi POS Agent (folder Comarch POS Agent), przykładowa ścieżka: C:\2022_5\Comarch Retail\Comarch Retail POS Agent 3.W wierszu polecenia wpisać: cd C:\2022_5\Comarch Retail\Comarch Retail POS Agent i wybrać przycisk [Enter]

4.Zainstalować usługę POS Agent wpisując: POSAgentConfigurator.exe --install i wybrać przycisk [Enter]

5.Po poprawnej instalacji należy wystartować usługę wpisując: POSAgentConfigurator.exe --start i wybrać przycisk [Enter]

6.W celu rejestracji usługi należy wpisać: POSAgentConfigurator.exe --register i wybrać przycisk [Enter]

7.W celu weryfikacji statusu połączenia usługi należy wpisać: POSAgentConfigurator.exe --status i wybrać przycisk [Enter]

Po sprawdzeniu statusu wyświetlane są informacje o:

• stanie usługi
• adresie usługi Comarch POS Agent
• adresie usługi OMS
• kodzie POS Agenta
• GUID zarejestrowanego POS Agenta

Wymagalność portów

Na poniższym schemacie przedstawiono komunikację komponentów według domyślnych portów. Schemat uwzględnia również kierunek połączenia pomiędzy komponentami.

 

Comarch POS Agent Broker

Uwaga

Komponent POS Agent Broker wymagany jest do komunikacji pomiędzy Comarch ERP Altum/XL a Comarch POS Agent.

Informacje podstawowe

Komponent Comarch POS Agent Broker (POS Agent Broker) wykorzystywana jest do komunikacji z usługą Comarch POS Agent (POS Agent) jako broker wiadomości. Komponent agreguje kolejkę wiadomości, przekazując aktualizację stanów magazynowych do właściwego POS Agenta w danym sklepie, przy braku połączenia z centralą. Aktualizowanie informacji umożliwia przy wystawianiu dokumentów w Comarch ERP Altum:

• weryfikacje aktualnego stanu zasobów na stanowisku POS przed wygenerowaniem dokumentu, który pobiera informacje o stanach z magazynu przypisanego do danego stanowiska POS
• wprowadzenie do kolejki wiadomości np. o zwiększeniu stanów magazynowych, gdy zostanie wystawiony dokument, który zwiększa takie stany magazynowe

Instalacja i konfiguracja

Przed instalacją komponentu POS Agent Broker należy włączyć dodatkowe funkcje systemu Windows – Internetowe usługi informacyjne (IIS).  W tym celu należy przejść do Panelu sterowania → Programy i funkcje → Włącz lub wyłącz funkcje systemu Windows → Internetowe usługi informacyjne (IIS) i włączyć:

• Narzędzia zarządzania siecią Web
• Usługi WWW

Instalacja Comarch POS Agent Broker odbywa się przy pomocy narzędzia Comarch ERP Auto Update. Po uruchomieniu Comarch ERP Auto Update należy wykonać następujące czynności:

• Na zakładce Konfiguracja dodać produkt Comarch Retail

  

• Dla produktu Comarch POS dodać komponent Comarch POS Agent Broker.

  

Uwaga

Po włączeniu dodatkowych funkcji Windows i  instalacji POS Agent Broker, może być wymagane ponowne uruchomienie stacji roboczej.

Konfiguracja z Comarch ERP XL

• Aby skonfigurować Comarch POS Agent Broker w integracji z Comarch ERP XL należy przejść do systemowego okna konfiguracji dostępnego w menu.

• Następnie uzupełnić pola:
  • Konfiguracja POS Agent Broker – adres usługi POS Agent Broker, w systemach rozproszonych należy używać IP maszyny na jakiej zainstalowana jest usługa
  • Port –domyślnym portem jest 80, należy zweryfikować dostępność portu
• W celu weryfikacji poprawności danych należy sprawdzić połączenie za pomocą przycisku [Test połączenia].

 

Adres usługi Comarch POS Agent Broker

W celu sprawdzenia pod jakim adresem została udostępniona usługa Comarch POS Agent Broker należy:

• Otworzyć Menedżer internetowych usług informacyjnych (IIS)
• W widoku Połączenia rozwinąć Witryny -> Default Web Site
• Wskazać pozycję zawierającą w nazwie 'POSAgentBroker'
• W widoku Akcje wybrać Przeglądaj *:80 (http)

• W domyślnej przeglądarce w pasku adresu znajdzie się poprawny link do usługi POS Agent Broker

 

Uwaga

http://localhost/POSAgentBroker jest to domyślny adres w przypadku głównego profilu programu Comarch ERP Auto Update. 

W przypadku gdy weryfikacja połączenia zakończy się niepowodzeniem, należy sprawdzić w przeglądarce poprawność linku: http://localhost/POSAgentBroker/health?Auth=MjhlMWUxMmEtNDc5OS00ZTRkLWIwMWMtNzk2ZDA2MmZmYjlj

Instrukcja instalacji Comarch POS we współpracy z Comarch ERP XL w systemie rozproszonym

Instrukcja prezentuje instalacje Comarch POS we współpracy z Comarch ERP XL w strukturze rozproszonej. Oznacza to, że Comarch ERP XL i Comarch POS nie znajdują się na jednej maszynie, a na przykład do utrzymania połączeń usług wykorzystuje się router.

 

Słownik pojęć

• Comarch Update Agent – narzędzie niezbędne do instalacji produktu Comarch Retail i jego komponentów, przy instalacji tworzony jest profil główny, aplikacja umożliwia tworzenie dodatkowych profili o niezależnej konfiguracji
• Comarch POS Agent – działa jako samodzielna usługa z własną bazą danych, dostarcza aktualne informacje o stanach magazynowych na każdym stanowisku, podczas wystawiania dokumentów
• Comarch POS Agent Broker – zapewnia komunikacje pomiędzy usługą POS Agent a systemem ERP, komponent ten agreguje kolejkę wiadomości, przekazując aktualizację stanów magazynowych do właściwego POS Agenta. Należy pamiętać że komponent POS Agent Broker może być dodany tylko na jednym profilu w programie Comarch Update Agent.

Przykład

Jeżeli w programie Comarch  Update Agent skonfigurowanych jest kilka profili na przykład: Profil I: XL w wersji 2021.0 POS w wersji 2021.0 POS Agent w wersji 2021.0 POS Agent Broker – brak Profil II: XL w wersji 2021.1 POS w wersji 2021.6 POS Agent w wersji 2021.6 POS Agent Broker w wersji 2021.6 W konfiguracji XL w wersji 2021.0, dla Brokera należy podać adres Brokera z Profilu II.

Uwaga

Jeżeli na jednej maszynie zainstalowanych jest kilka wersji Comarch ERP XL i Comarch POS, to należy pamiętać, że system Comarch ERP XL musi posiadać aktualne rejestry odpowiedniej wersji, aby usługa synchronizacji działała poprawnie. Dodatkowo w zmiennych środowiskowych w części PATH musi być podany wpis na pierwszym miejscu odnoszący się do odpowiedniej wersji Comarch ERP XL, na której chcemy pracować. Konieczny jest wtedy restart komputera, aby zmiany zostały poprawnie odczytane oraz puszczenie rejestrów do wybranej wersji Comarch ERP XL.

• Usługa synchronizacji Data service – dzięki usłudze możliwa jest synchronizacja system ERP <-> POS. Nazwę usługi i jej port definiuje się w systemie ERP, brak usługi uniemożliwia pracę z aplikacją Comarch POS.
• Kafka message queue – rozproszona platforma przesyłania strumieniowego typu „open source”, która umożliwia tworzenie aplikacji i protokołów danych przesyłania strumieniowego w czasie rzeczywistym. Kafka pełni funkcję usługi brokera komunikatów. Działa po zainstalowaniu komponentu Comarch POS Agent Broker.
• Zookeeper Service – usługa, działająca po zainstalowaniu komponentu Comarch POS Agent Broker. Służy do utrzymywania wspólnego stanu dla wszystkich instancji Kafki, zarządzania konfiguracją, monitorowania.

1. System ERP i usługa synchronizacji wysyła żądanie do Comarch POS Agent Brokera
2. Żądanie zapisuje się w kolejce zadań
3. Żądanie jest odczytywane
4. Comarch POS Agent Broker wysyła żądanie do POS Agenta
5. Następuje procesowanie w POS Agencie
6. POS Agent wysyła odpowiedź do Brokera
7. Odpowiedź zapisuje się w kolejce odpowiedzi
8. Odpowiedź jest odczytywana przez Broker
9. Comarch POS Agent Broker wysyła odpowiedź do systemu ERP i usługi synchronizacji

Informacje o logach

Szczegółowe informacje o zdarzeniach występujących na stanowisku POS dotyczące samej aplikacji Comarch POS, któregoś komponentu lub usługi, rejestrowane są w plikach txt (logach). Domyślne ścieżki zapisywania logów:

• dla stanowiska POS to: C:\Retail\POS2\mainprofile\Logs

Uwaga

W przypadku innego profilu niż główny w Auto Update, ścieżka do logowania znajduje się w pliku POS2.exe.config w katalogu Comarch POS.

• dla usługi POS Agent: C:\Retail\POS Agent\mainprofile\Logs i C:\Retail\POSAgentConfig\Log
• dla usługi synchronizacji Data Service: C:\Program Files (x86)\Comarch ERP XL\XLDataService\POS_LOG\Comarch.XL.POS.Data.Service
• dla kolejki wiadomości: C:\Kafka\kafka\logs (All + Own)
• dla POS Agent Brokera: C:\Program Files (x86)\Comarch Retail\Comarch POS Agent Broker\Logs
• dla aplikacji Comarch ERP Auto Update: C:\Program Files (x86)\Comarch ERP Auto Update\Logs

Informacje ogólne

Od wersji Comarch ERP XL 2021.0 oraz Comarch POS 2021.0 do współpracy między systemami konieczne jest wykorzystywanie nowych komponentów: Comarch POS Agent oraz Comarch POS Agent Broker.

Komponenty te należy zainstalować za pomocą Comarch Update Agent wraz z instalacją produktu Comarch POS.

Aktualizacja Comarch Update Agent 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:

3.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

Uwaga

Port można zdefiniować w Auto Update podrzędnym na zakładce Konfiguracja -> sekcja połączenia z agentem nadrzędnym.

4.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 Update Agent)

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 Update Agent do wersji 2020.0 będzie on domyślnie używał komunikacji WCFowej.

9.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 agentem 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 Update Agent 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. rabbitmqctl enable_feature_flag all
7. rabbitmq-plugins enable rabbitmq_management
8. rabbitmqctl stop (należy chwilę zaczekać na wykonanie tej komendy, czasem jest wymagane ręczne zatrzymanie usługi RabbitMQ)
9. rabbitmq-server -detached
10. rabbitmqctl start_app (należy chwilę zaczekać na wykonanie tej komendy, czasem jest wymagane ręczne uruchomienie usługi RabbitMQ)
11. rabbitmqctl add_user admin admin
12. rabbitmqctl set_user_tags admin administrator
13. 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

Instalacja i konfiguracja po stronie Comarch ERP XL

Pełna instrukcja konfiguracji stanowiska POS znajduje się pod linkiem:

https://pomoc.comarch.pl/xl/index.php/dokumentacja/xl137-instalacja-i-konfiguracja-pos/ 

1. Na komputerze na którym znajduje się Comarch ERP XL należy zainstalować Auto Update w wersji nadrzędnej nazwa profilu i kod musi być taki sam jak dla agenta podrzędnego. Instrukcja instalacji agenta nadrzędnego znajduje się pod linkiem:

https://pomoc.comarch.pl/pos/xl/documentation/instalacja-comarch-erp-auto-update/

2. Na komputerze na którym będzie znajdował się POS należy zainstalować agenta podrzędnego, nazwa profilu i kod musi być taki sam jak dla agenta nadrzędnego, informacje na temat zrządzania strukturą agentów podrzędnych, znajdują się w dokumentacji:

https://pomoc.comarch.pl/autoupdate/documentation/struktura-agentow-i-agent-podrzedny/

3. Przy definiowaniu stanowiska POS w systemie Comarch ERP XL należy określić typ licencji:

Od rodzaju licencji określonej na poziomie danego stanowiska zależy dostępność funkcji dla poszczególnych modułów aplikacji:

• Back office (funkcjonalność magazynowa)
• Front office (funkcjonalność sprzedażowa)

4. Na zakładce POS Agent w konfiguracji Oddziału Comarch POS należy zdefiniować kod POS Agenta.

Uwaga

Należy pamiętać, że kod POS Agenta ≠ kod Stanowiska POS, jednak nie ma przeciwskazań aby nazwy były takie same.

Komponent POS Agent Broker

Przed instalacją komponentu POS Agent Broker należy włączyć dodatkowe funkcje systemu Windows – Internetowe usługi informacyjne (IIS).  W tym celu należy przejść do Panelu sterowania → Programy i funkcje → Włącz lub wyłącz funkcje systemu Windows → Internetowe usługi informacyjne (IIS) i włączyć:

• Narzędzia zarządzania siecią Web
• Usługi WWW

Uwaga

Po włączeniu dodatkowych funkcji zalecany jest restart maszyny.

1.Na komputerze gdzie zainstalowany jest agent nadrzędny (serwer centralny na którym znajduje się system ERP) należy dodać produkt Comarch Retail i komponent Comarch POS Agent Broker.

2. Po dodaniu komponentu Comarch POS Agent Broker w aplikacji Comarch ERP Auto Update należy zainstalować odpowiednią wersję Brokera. (Tabela 1 Współpraca pomiędzy systemami a komponentami)

Uwaga

Po włączeniu dodatkowych funkcji Windows i instalacji POS Agent Broker, może być wymagane ponowne uruchomienie stacji roboczej.

3. Po instalacji komponentu, należy wprowadzić adres kolejki wiadomości POS Agent Brokera. W tym celu należy przejść do System -> Konfiguracja -> POS w systemie Comarch ERP XL.

W celu sprawdzenia pod jakim adresem została udostępniona usługa Comarch POS Agent Broker należy:

• Otworzyć Menedżer internetowych usług informacyjnych (IIS)
• W widoku Połączenia rozwinąć Witryny -> Default Web Site
• Wskazać pozycję zawierającą w nazwie 'POSAgentBroker'
• W widoku Akcje wybrać Przeglądaj *:80 (http)

Uwaga

Należy pamiętać, że port 80 jest portem domyślnym – przy konfiguracji należy zweryfikować czy port nie jest już w użyciu.

4. Po wybraniu [Przeglądaj] w domyślnej przeglądarce w pasku adresu znajdzie się poprawny link do usługi POS Agent Broker.

Jeżeli POS Agent Broker zainstalowany został na profilu o nazwie: 2021_2 to adres prezentowany w przeglądarce będzie wyglądał następująco: http://localhost/POSAgentBroker_2021_2 jeżeli na profilu głównym link ma postać: http://localhost/POSAgentBroker

Localhost = IP komputera na którym zainstalowano Comarch POS Agent Brokera, przy problemach z połączeniem z Brokerem i POS Agentem, warto zmienić tą nazwę na IP komputera.

Przy problemach z połączeniem i synchronizacją można również w oknie Menedżera internetowych usług IIS dla puli aplikacji POS Agent Broker wybrać Odtwarzanie.

5. W Usługach Windows należy zweryfikować czy uruchomione są usługi:

• Kafka Message Queue
• Zookeeper Service

6. Jeżeli obie usługi są uruchomione, należy w Comarch ERP XL przejść do zakładki System -> Konfiguracja -> POS -> [test połączenia].

W przypadku gdy weryfikacja połączenia zakończy się niepowodzeniem, należy sprawdzić w przeglądarce poprawność linku: http://localhost/POSAgentBroker_2021_2/health?Auth=MjhlMWUxMmEtNDc5OS00ZTRkLWIwMWMtNzk2ZDA2MmZmYjlj w przypadku profilu głównego: http://localhost/POSAgentBroker/health?Auth=MjhlMWUxMmEtNDc5OS00ZTRkLWIwMWMtNzk2ZDA2MmZmYjlj   W pogrubionej części należy wprowadzić adres dostępny z poziomu System -> Konfiguracja -> POS w Comarch ERP XL.

Jeżeli po wykonaniu wszystkich powyższych czynności test połączenia w Comarch ERP XL kończy się niepowodzeniem. Należy w Menedżerze internetowych usług (IIS) wybierając Witryny -> Default Web Side -> prawy przycisk myszy -> Powiązania usunąć powiązanie https port 443, jeżeli pojawia się na liście.

Komponent Comarch POS

Po poprawnej instalacji i konfiguracji komponentu Comarch POS Agent Broker należy dodać komponent Comarch POS dla produktu Comarch Retail.

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.

Następnie na zakładce Więcej -> Struktura agentów należy dodać agenta podrzędnego oraz wybrać jakie komponenty będą instalowane dla danego profilu.

W oknie należy uzupełnić:

• Kod agenta – kod agenta podrzędnego, który należy wprowadzić w Auto Update podczas konfiguracji
• Lokalizację – opcjonalnie
• Tagi – oznaczenia wykorzystywane podczas wyszukiwania agenta podrzędnego na liście
• Profile – wraz ze wskazaniem produktów, które mają być zainstalowane na agencie podrzędnym
• Lokalny nadrzędny – czy dany agent pełni rolę lokalizacji

Po dodaniu agenta podrzędnego będzie on widoczny w strukturze agentów. Z poziomu tego okna istnieje możliwość:

• Dodania nowego agenta podrzędnego
• Dodania nowej lokalizacji
• Wykonanie aktualizacji wszystkich agentów do najnowszej wersji
• Wymuszenie synchronizacji z agentami podrzędnymi
• Wykonanie akcji zdalnej na agencie podrzędnym – pobranie, instalacja, możliwość przywrócenia wersji i dezinstalacji dla wskazanego produktu. Istnieje możliwość zaznaczenia na liście kilku agentów i wykonania dla nich akcji zdalnej.

• Pokazania/ukrycia szczegółów
• Zmiany profilu

Komponent POS Agent

Po poprawnej instalacji i konfiguracji komponentu Comarch POS Agent Broker należy dodać komponent Comarch POS Agent dla produktu Comarch Retail.

Uwaga

Zalecane jest aby POS Agent znajdował się na tej samej maszynie co produkt Comarch POS, dlatego stosowana jest struktura nadrzędny – podrzędny.

Po zainstalowaniu na agencie podrzędnym komponentu Comarch POS Agent należy przejść do katalogu gdzie znajduje się zainstalowany i pobrany POS Agent (domyślna ścieżka C:\Program Files (x86)\Comarch Retail\Comarch Retail POS Agent).

1.W folderze Comarch Retail -> Comarch Retail POS Agent dostępna jest aplikacja exe.

2.Przy pierwszym uruchomieniu pojawi się okno z wyborem języka.

3.Podczas pierwszego uruchomienia, pojawi się błąd dotyczący odinstalowanej usługi.

4.Wyświetlony komunikat należy potwierdzić przyciskiem [OK], w kolejnym kroku wyświetlone zostanie okno konfiguratora:

Uwaga

Należy zweryfikować automatycznie uzupełnione porty i IP.

W aplikacji przed wybraniem przycisku [Instaluj] należy podać:

• Adres IP usługi POS Agent – pole uzupełniane automatycznie adresem IP komputera na którym zainstalowano usługę POS Agent. W przypadku gdy IP jest zmienne, należy ustawić dla usługi POS Agent stałe przekierowanie na IP, zamiast nazwy localhost przy zmiennym IP można wprowadzić 127.0.0.1.

Uwaga

Usługa Comarch POS Agent wymaga stałego IP komputera, na którym jest zainstalowana.

• Port usługi POS Agent – domyślnym portem jest 8098, należy pamiętać, że usługa POS Agent i usługa synchronizacji XL – POS nie może działać na tym samym porcie, wprowadzony może być dowolny wolny port
• Adres serwera OMS – domyślnym adresem jest http://localhost:8099/DataService/, adres ten składa się z:
  • localhost – IP komputera na którym, znajduje się XL i usługa synchronizacji
  • 8099 – domyślny port dla usługi synchronizacji, należy podać port, jaki został wprowadzony dla usługi synchronizacji w Comarch ERP XL na zakładce Oddziały -> Konfiguracja automatu synchronizacji. Na poniższym rysunku uzupełniony jest port: 51426, więc adres przy IP = 10.138.37.7 w aplikacji POS Agent Konfigurator wyglądałby tak: http://10.138.37.7:51426/DataService/

Uwaga

Port dla usługi synchronizacji na przykład 51426 powinien być przekierowany na routerze. Dotyczy to również portu usługi POS Agent – domyślnie 8098.

• Kod POS Agenta – kod POS Agent wprowadzony w systemie ERP w oknie Konfiguracji oddziału -> Comarch POS

• GUID – wartość nadawana automatycznie, po poprawnym zarejestrowaniu usługi

5.Po uzupełnieniu powyższych danych w Konfiguratorze POS Agent należy wybrać przycisk:

• [Instaluj]
• [Odśwież]
• [Uruchom] – powinien pojawić się komunikat dotyczący uruchomienia usługi
• [Sprawdź] (przy wpisanym kodzie POS Agenta) – po wybraniu przycisku pojawi się okno z informacją o stanie połączenia

• [Odśwież]
• [Zarejestruj] – automatycznie uzupełnione zostanie pole GUID w konfiguratorze, a także pola HOST, PORT i GUID w systemie Comarch ERP XL. Dodatkowo pojawi się okno z informacją o poprawnym zarejestrowaniu Agenta.

Uwaga

Usługa POS Agent powinna pracować nieprzerwanie, to oznacza, że maszyna na jakiej działa powinna być cały czas włączona aby zapewnić poprawność pracy na magazynach POS.

6.Po włączeniu usług i wykonaniu prawidłowej konfiguracji, dodatkową i najlepszą weryfikacją poprawności działania usług jest wystawienie w systemie Comarch ERP XL dokumentu magazynowego (rozchód wewnętrzny, wydanie zewnętrzne) z magazynu POSowego – tutaj przy dodawaniu elementu na dokument, jeżeli połączenie będzie niepoprawne otrzymamy o tym komunikat: „Nie można wykonać akcji ze względu na niedostępność usługi POS Agent. Operacje na magazynach POS wymagają połączenia z usługą.” 7.Po wykonaniu wszystkich kroków na stanowisku POS zaleca się włączenie Uzgadniania stanów – funkcjonalność synchronizuje stany magazynowe pomiędzy sklepem a systemem centralnym ERP. Dodatkowe informacje na temat uzgadniania znajdują się pod linkiem:

https://pomoc.comarch.pl/pos/xl/documentation/uzgadnianie-stanow-magazynowych/

Uwaga

Uzgadnianie stanów należy włączać w momencie gdy nikt nie pracuje na stanowiskach POS i wykonywać pojedynczo na każdym stanowisku POS. Po wykonaniu pierwszego uzgadniania, z funkcjonalności należy korzystać doraźnie, gdy zaobserwowane zostaną różnice w stanach.

O czym należy pamiętać:

1. Przede wszystkim należy pamiętać aby porty były dostępne dla dwóch komputerów, w tym celu należy zrobić przekierowanie na routerze danych portów usług synchronizacji.
2. Zalecanym sposobem weryfikacji jest korzystanie z wiersza poleceń (cmd), gdzie za pomocą poleceń:

• netstat -aon
• telnet

można zweryfikować dostępność danych portów.      

Instalacja

Pobieranie oraz instalacja Comarch POS odbywa się za pomocą aplikacji Comarch Update Agent.

Opis aplikacji oraz jej funkcjonalności jest dostępny na dedykowanej stronie: https://pomoc.comarch.pl/autoupdate/

Pobieranie i instalacja Comarch POS została opisana w artykule: https://pomoc.comarch.pl/autoupdate/documentation/dodawanie-i-konfiguracja-produktu-na-przykladzie-comarch-retail/

Comarch ERP Menadżer Kluczy

Aplikacja Comarch ERP Menadżer Kluczy jest niezbędnym narzędziem pozwalającym na pobieranie i aktywację zakupionych modułów produktów Comarch ERP. Może on współpracować zarówno z fizycznymi kluczami HASP, plikami SoftHASP, a także z modułami potrzebnymi dla stacjonarnych aplikacji jak np. Comarch POS. Aplikacja ta zastępuje Serwis klucza HASP oraz Zdalny Serwer Klucza. Jedną z zalet Menadżera Kluczy jest możliwość pracy na maszynach wirtualnych z wykorzystaniem kluczy aktywowanych w Comarch.

Wymagania systemowe

• System operacyjny Windows 11, Windows 10, Windows 8.1, Windows 7, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows Server 2019
• Dostęp do adresów ml.comarch.pl i erp.comarch.pl na portach TCP 80, TCP 443
• Microsoft SQL Server

 

Instalacja i konfiguracja

Uwaga

Instalację aplikacji uruchamiamy na komputerze, gdzie zainstalowany jest Microsoft SQL Server.

Instalację Menadżera Kluczy wykonuje się na serwerze, na którym zainstalowany jest Microsoft SQL Server, na profilu głównym Comarch Update Agent. Po uruchomieniu Comarch Update Agent należy wykonać następujące czynności:

• Na zakładce Konfiguracja dodać produkt Comarch ERP Menadżer Kluczy
• Dla produktu Comarch ERP Menadżer Kluczy dodać komponent Comarch ERP Menadżer Kluczy

• Po dodaniu produktu i komponentu Comarch ERP Menadżer Kluczy należy dokonać jego konfiguracji. Okno konfiguracji otwierane jest poprzez zaznaczenie komponentu oraz wybranie z menu przycisku [Konfiguracja]. Po przejściu do konfiguracji komponentu należy uzupełnić poniższe pola:
  • Lokalną nazwę instancji serwera bazy danych, na której komponent ma zostać zainstalowany wraz z danymi do logowania na konto użytkownika z uprawnieniami administracyjnymi
  • Id klienta, PIN i numer klucza licencyjnego – dostępne w aplikacji iZAM
  • Opcjonalnie adres e-mail dla powiadomień w przypadku utraty połączenia z serwerem Comarch

W ramach instalacji wykonywane są następujące czynności:

• Instalacja sterowników klucza HASP
• Konfiguracja serwera bazy danych
• Dodanie wyjątku do zapory sieciowej w celu umożliwienia pracy sieciowej
• Instalacja usługi Zarządzanie kluczami produktów Comarch ERP (ComarchML)
• Instalacja aplikacji (monitora) Menadżera Kluczy

Po zakończeniu instalacji należy uruchomić Comarch ERP Menadżer Kluczy, w prawym dolnym rogu ekranu powinna pojawić się ikona informująca o stanie gwarancji na program. Zielony kolor ikony kłódki informuje o prawidłowym stanie pozwalającym na pracę z najnowszymi wersjami oprogramowania dla zakupionych programów. Kolor ikony:

• Czerwony – brak informacji o dostępnych modułach, lub zatrzymana usługa Zarządzanie kluczami produktów Comarch ERP, aplikacje mogą jedynie pracować w trybie DEMO
• Żółty – program poza gwarancją, można pracować ale tylko na wersjach, na których data produkcji jest wcześniejsza od daty ważności zakupionych modułów. Zalecamy przedłużenie ważności gwarancji.
• Zielony – program na gwarancji, prawidłowy stan pozwalający na pracę z najnowszymi wersjami oprogramowania dla zakupionych modułów

Monitor Menadżera Kluczy

W skład Menadżera Kluczy wchodzi aplikacja monitora (ComarchMLTray). To ona odpowiada za wyświetlanie ikony kłódki w prawym dolnym rogu ekranu.

Po kliknięciu prawym klawiszem na ikonie kłódki dostępne są następujące opcje:

• Pokaż konfigurację – wyświetla okno aplikacji
• Uruchom usługę – uruchamia usługę Zarządzanie kluczami produktów Comarch ERP
• Restartuj usługę – restartuje usługę Zarządzanie kluczami produktów Comarch ERP
• Zatrzymaj usługę – zatrzymuje usługę Zarządzanie kluczami produktów Comarch ERP
• Zwolnij moduły – wylogowuje poszczególnych użytkowników z usługi i tym samym zwalnia pobrane moduły dla wybranych kluczy
• Aktualizuj moduły w kluczu HASP – aktualizuje moduły w kluczu HASP (programowanie klucza). Aktualizacja może być wykonana na dwa sposoby:
  • Aktualizacja z chmury – po wybraniu tej opcji moduły w kluczu HASP będę zaktualizowane plikiem RUS automatycznie pobranym z serwerów Comarch (opcja wymaga dostępu do Internetu). Aktualizacja z chmury nie jest dostępna dla kluczy partnerskich.
  • Aktualizacja z dysku – po wybraniu tej opcji należy wskazać na dysku plik RUS odpowiedni dla podłączonego klucza HASP w celu wykonania aktualizacji modułów
• Wyłącz monitor Comarch ERP Menadżer Kluczy – wyłącza ikonę kłódki, która pojawi się po ponownym uruchomieniu aplikacji

Ponadto dwukrotne kliknięcie na ikonę zielonej (lub żółtej) kłódki spowoduje uruchomienie okna aplikacji monitora Comarch ERP Menadżer Kluczy, co jest tożsame z wybraniem opcji Pokaż konfigurację. Po kliknięciu na opcję Pokaż konfigurację uruchamiane jest okno aplikacji z trzema zakładkami: Dostępne moduły, Pobrane moduły oraz Konfiguracja.

Jeżeli na komputerze jest włączony mechanizm kontroli konta (UAC) i jeżeli monitor Menadżera Kluczy nie zostanie uruchomiony jako administrator, to przy próbie użycia funkcji wymagających uprawnień administracyjnych takich jak: Uruchom usługę, Restartuj usługę, Zatrzymaj usługę lub przejście do ustawień zaawansowanych pojawi się monit z prośbą o zaakceptowanie ponownego uruchomienia monitora Menadżera Kluczy jako administrator, co umożliwi skorzystanie z wymienionych funkcji.

Zakładka Dostępne moduły

Zakładka przedstawia listę dostępnych modułów pochodzących z podłączonego klucza HASP, plików SoftHASP, bądź z modułów aktywowanych w Comarch (kluczy wirtualnych). Te same informacje dostępne są również na stronie http://localhost:5150/. W nagłówku okna widoczny jest numer wersji Menadżera Kluczy. Kolor wyświetlanych modułów informuje, czy dany moduł jest aktualny, czy jest już po gwarancji. Kolorem zielonym wyświetlane są moduły na gwarancji (data ważności późniejsza lub równa dacie bieżącej), natomiast kolorem żółtym oznaczane są moduły po gwarancji (data ważności wcześniejsza niż data bieżąca). Analogicznie jak to ma miejsce w przypadku koloru ikony kłódki w prawym dolnym rogu ekranu.

Zakładka Pobrane moduły

Zakładka zawiera informacje o modułach pobranych przez aplikacje, które korzystają z Menadżera Kluczy. W kolumnie Zalogowani użytkownicy znajdują się informacje pozwalające zidentyfikować użytkownika, który pobrał dany moduł.

Na zakładce znajdują się przyciski:

• Ikona pioruna – pozwala zaktualizować widok, opcja dostępna również poprzez klawisz [F5]
• Ikona kosza – usuwa wszystkie pobrane moduły dla zaznaczonego użytkownika

Zakładka Konfiguracja

Na zakładce Konfiguracja podana jest lista wszystkich kluczy podłączonych do Menadżera Kluczy. Wśród nich może być klucz HASP, klucze wirtualne lub tzw. SoftHASP w postaci plików Softhasp.sig i Softhasp.dat umieszczonych na dysku komputera (domyślnie C:\). Na zakładce Konfiguracja wyświetlana jest lista dostępnych kluczy wraz z odpowiednim kolorem:

• oliwkowy – standardowy klucz przeznaczony dla Klientów
• fioletowy – klucz partnerski
• jasnoniebieski – klucz firmowy. Klucz ten może działać tylko z bazą, która w danych o firmie ma przypisany ten sam numer NIP, jaki związany jest z tym kluczem (kolumna Dane identyfikacyjne firmy). Klucz firmowy może występować w postaci klucza HASP bądź klucza wirtualnego.
• pomarańczowy – klucz wielofirmowy. W przypadku tego klucza mamy do czynienia z przypisaniem do klucza więcej niż jednego numer NIP. Wszystkie numery NIP dla zaznaczonego klucza wielofirmowego wyświetlane są w dodatkowej tabeli poniżej listy kluczy. Klucz wielofirmowy jest rozszerzeniem klucza firmowego i działa analogicznie jak klucz firmowy, przy czym mamy możliwość połączenia z bazą danych, która zawiera jeden z numerów NIP przypisanych do tego klucza. Klucze wielofirmowe występują wyłącznie w postaci kluczy wirtualnych.
• czerwony – klucz, którego data ograniczenia czasowego została przekroczona

W pierwszej kolumnie Dane identyfikacyjne firmy znajduje się numer NIP firmy, która jest właścicielem klucza lub jej akronim.

Na zakładce dostępne są przyciski:

• [Aktualizuj moduły] – wymusza połączenie z serwerami Comarch, aktualizuje widok. Opcja dostępna również poprzez kombinację klawiszy [Ctrl+F5]
• [Aktualizacja modułów w przypadku braku połączenia internetowego] – pozwala na aktywację modułów w przypadku braku połączenia z siecią
• [Dodaj] – pozwala na dodanie klucza wirtualnego, który wymaga cyklicznego kontaktu z serwerami Comarch (minimum co 24 godziny w przypadku modułów Comarch ERP Optima oraz co 72h dla Comarch ERP XL i Comarch ERP Altum). W celu dodania takiego klucza w oknie Dane klucza wirtualnego należy podać: ID Klienta, Pin, Nr klucza oraz Adres e-mail, jeżeli nie jest jeszcze wpisany w konfiguracji Menadżera Kluczy (Adres e-mail administratora).
• [Usuń] – usuwa klucz wirtualny (nie dotyczy kluczy HASP oraz SoftHasp). Po usunięciu klucza wirtualnego z Menadżera Kluczy, może on zostać aktywowany na innym komputerze.
• [Edytuj] – umożliwia edycję nieaktywnych kluczy
• [Zaawansowane] – uruchamia dodatkowe okno z zaawansowanymi parametrami konfiguracji, możliwe do włączenia w przypadku uruchomienia Menadżera Kluczy z uprawnieniami administratora

 

Aktualizacja Comarch ERP Menadżer kluczy

Aby zaktualizować do najnowszej wersji aplikację Comarch ERP Menadżer Kluczy należy w narzędziu Comarch ERP Auto Update przejść na zakładkę Więcej następnie wybrać przycisk [Pobierz i instaluj] dla Comarch ERP Menadżer Kluczy. W celu aktualizacji do innej wersji należy użyć przycisku [Akcje zaawansowane].

Po wybraniu przycisku [Pobierz i instaluj] zostanie wyświetlony standardowy komunikat, który informuje o konieczności wyłączenia wszystkich powiązanych aplikacji i usług.

Po aktualizacji aplikacji w Comarch ERP Auto Update należy uruchomić Comarch ERP Menadżer Kluczy, przejść na zakładkę Konfiguracja -> wybrać przycisk [Aktualizuj moduły] w celu aktualizacji modułów licencyjnych.

MSDTC – koordynator transakcji rozproszonych

Microsoft Distributed Transaction Coordinator (MSDTC) to usługa systemowa w systemach Windows, która umożliwia zarządzanie transakcjami rozproszonymi w środowiskach wielourządzeniowych lub wieloserwerowych. Jest kluczowym komponentem w aplikacjach, które korzystają z transakcji obejmujących wiele źródeł danych, takich jak bazy danych, kolejki wiadomości czy usługi sieciowe. Na środowiskach rozproszonych należy dokonać dodatkowej konfiguracji:

• na każdej maszynie z której uruchamiane są aplikacje POS
• na serwerze bazy danych

Konfiguracja MSDTC

  W celu poprawnej konfiguracji MSDTC należy:

• Skonfigurować automatyczne uruchomienia usługi: Koordynator transakcji rozproszonych
  • w tym celu należy przejść do usług systemu Windows -> odnaleźć usługę i wybrać prawym przyciskiem myszy [Właściwości]

• Skonfigurować ustawienia MSDTC
  • w tym celu należy przejść do aplikacji Windows: Usług składowe

 

• w aplikacji Usługi składowe należy przejść do właściwości lokalnej usługi DTC. Lokalna usługa DTC dostępna jest pod: Usługi składowe -> Komputery -> Mój komputer -> Koordynator transakcji rozproszonych.

• wybierając następnie prawym przyciskiem myszy [Właściwości] należy przejść na zakładkę Zabezpieczenia. W oknie zabezpieczeń właściwości lokalnej usługi DTC należy aktywować parametr
  • Dostęp do usługi DTC przez sieć wraz z opcjami: Zezwalaj na zdalnych klientów i Zezwalaj na administrację zdalną.
  • Komunikacja Menadżera transakcji wraz z opcjami: Zezwalaj na przychodzące, Zezwalaj na wychodzące oraz Uwierzytelnianie niewymagane.
  • Włącz transakcje XA
  • Włącz transakcje SNA LU 6.2

 

• Odblokować reguły zapory Windows:
  • w tym celu należy przejść do okna Zapory Windows Defender z zabezpieczeniami zaawansowanymi, w którym należy włączyć reguły dotyczące koordynatora transakcji rozproszonych. W regułach przychodzących i wchodzących należy włączyć wszystkie reguły związane z: Koordynatorem transakcji rozproszonych.

• Dodać do zapory wyjątek dla procesu MSDTC:
  • w tym celu należy otworzyć okno z panelu sterowania: Zezwalaj aplikacji na dostęp przez Zaporę systemu Windows -> wybrać [Zmień ustawienia] -> [Zezwalaj na dostęp innej aplikacji] -> [Przeglądaj] -> znaleźć na liście mdstc.exe i zapisać zmiany.

• Dodać do pliku hosts na wszystkich maszynach namiar z IP i nazwą serwera na jakim znajduje się aplikacja POS lub POS Agent. Plik hosts znajduje się w lokalizacji: C:\Windows\System32\drivers\etc