ZMIANY WPROWADZONE W COMARCH AUTO UPDATE

Comarch Auto Update

Zmiana logo i nazwy

W najnowszej wersji zmieniona została nazwa narzędzia do zarządzania produktami Comarch w środowisku produkcyjnym na Comarch Auto Update, dodatkowo zmiany zostały również wprowadzone w:

• szacie graficznej
• nazwie skrótów i przycisków
• oknach z komunikatami typu pop-up

Po uruchomieniu Comarch Auto Update zostanie wyświetlony komunikat informujący o zakończeniu wspierania komunikacji za pomocą WCF, w kolejnych wersjach. Zmiana ta związana jest ze zwiększeniem poziomów bezpieczeństwa za pomocą komunikacji szyfrowanych.

Komunikacja po SSL

W konfiguracji Comarch Auto Update została wprowadzona możliwość użycia bezpiecznego połączenia SSL w sieci agentów podrzędnych. Na zakładce Konfiguracja w sekcji Konfiguracja komunikacji dla agentów podrzędnych dodana została trzecia opcja: Używaj bezpiecznego połączenia SSL.

W sekcji tej dodana została również informacja o ilości agentów podrzędnych korzystających z komunikacji WCF i REST.

Uwaga

W kolejnych wersjach narzędzia Comarch Auto Update komunikacja za pomocą WCF nie będzie już wspierana.

Zmiany na agencie nadrzędnym

Na zakładce Konfiguracja na agencie nadrzędnym dodano:

• pole Port do połączenia szyfrowanego (SSL) – w zależności od regionu klienta należy łączyć się po porcie:
  • 10466 (PL i EN)
  • 10460 (FR)
  • 10539 (DE)

Uwaga

Odpowiedni port należy odblokować również na poziomie routera.

• sekcja Konfiguracja połączenia SSL dla agentów podrzędnych

W sekcji dodane zostały przyciski i parametry:

• [Wygeneruj certyfikaty] – generuje certyfikat i automatycznie następuje rozesłanie na agentów podrzędnych. Przycisk jest aktywny, jeżeli w sieci agentów wszyscy podpięci podrzędni mają zainstalowaną wersję umożliwiającą przejście na SSL.
• [Wyślij informację] – ponawia próbę przesłania certyfikatu na agentów podrzędnych
• [Używaj połączenia SSL] – wybranie przycisku wiąże się z rozpoczęciem komunikacji za pomocą SSL
• Port SSL – domyślny port komunikacji to 12365
• Port SSL dla lokalnych nadrzędnych – domyślny port to 12365
• Wprowadź wszystkie nazwy maszyny, na której znajduje się agent nadrzędny w sieci agentów, które są (lub będą) używane w sieci. Oddzielaj wartość średnikiem (;) – należy określić nazwy maszyny z agentem nadrzędnym
• Wprowadź wszystkie adresy IP maszyny, na której znajduje się agent nadrzędny w sieci agentów, które są (lub będą) używane w sieci. Oddzielaj wartość średnikiem (;) – należy określić adresy IP maszyny z agentem nadrzędnym
• Podrzędni z pobranymi certyfikatami – wskazuje stosunek ilości agentów podrzędnych z pobranym certyfikatem do ilości agentów podrzędnych zdefiniowanych
• Podrzędni przełączeni na komunikację SSL – wskazuje stosunek ilości agentów podrzędnych połączonych za pomocą komunikacji SSL do ilości agentów podrzędnych zdefiniowanych
• [Wyeksportuj certyfikaty] – eksport certyfikatów dla Comarch mPOS, w celu ręcznego umieszczenia w systemie Android

Zmiany na agencie podrzędnym

Na zakładce Konfiguracja na agencie podrzędnym dodano:

• pole Port do połączenia szyfrowanego (SSL) – przy przełączaniu na komunikację SSL port roześle się automatycznie, ale jeżeli zostanie dodany nowy podrzędny do sieci to należy w konfiguracji ustawić port ręcznie

• sekcja Konfiguracja połączenia SSL dla agentów podrzędnych

W sekcji dodane zostały przyciski i parametry:

• Usługa AutoUpdate wykorzystuje połączenie szyfrowane SSL
• UI AutoUpdate wykorzystuje połączenie szyfrowane SSL
• AutoUpdate wykorzystuje połączenie szyfrowane SSL
• Agent nadrzędny wykorzystuje połączenie szyfrowane SSL
• [Używaj połączenia SSL] – umożliwia przełączanie komunikacji agenta podrzędnego z REST na SSL, po wybraniu przycisku pojawi się okno na którym można wskazać plik zip z certyfikatem

Aktywacja połączenia SSL

Aby aktywować połączenie za pomocą SSL należy wykonać poniższe kroki:

1. Określić porty SSL dla komunikacji podrzędny – nadrzędny oraz podrzędny – lokalny nadrzędny, dla obu domyślnie jest to port: 12365.
2. Określić nazwy maszyn z agentem nadrzędnym oraz ich adres IP.
3. Wygenerować certyfikat za pomocą przycisku: [Wygeneruj certyfikaty].

Certyfikat jest generowany oraz rozsyłany na agentów podrzędnych, gdzie następuje jego instalacja. Całość operacji odbywa się automatycznie. Przycisk [Wyślij informację] ponawia próbę przesłania certyfikatu na agentów podrzędnych.

4. Wybrać przycisk [Używaj połączenia SSL].

Od momentu wybrania przycisku [Używaj połączenia SSL] komunikacja odbywa się za pomocą SSL.

5. Dla urządzeń mobilnych z aplikacją Comarch mPOS dostępna jest opcja Wyeksportuj certyfikaty.

Certyfikat .cer należy zainstalować na urządzeniu mobilnym (Android → Ustawienia → Zabezpieczenia → Zainstaluj certyfikaty). Ścieżka może się różnić w zależności od wersji systemu Android. Certyfikat .pfx należy wgrać do folderu mPOS. W mPOS w menu Start > Ustawienia > Auto Update wprowadzamy:

• nazwę certyfikatu (bez rozszerzenia .pfx)
• hasło certyfikatu
• włączamy obsługę SSL

Uwaga

W przypadku aplikacji Comarch mPOS komunikacja z użyciem SSL wymaga podania adresu agenta nadrzędnego w postaci nazwy domenowej (adres IP nie jest wspierany).

Uwaga

Aplikacja Comarch mPOS musi być w wersji umożliwiającej obsługę SSL. Jest to aktualna wersja aplikacji 2023.5 i wersja 2023.2 z najnowszymi poprawkami.

Informacje na temat wgranych dodatków na liście struktury agentów

W celu usprawnienia pracy i zarządzania siecią agentów dodano możliwość zdalnego sprawdzenia z poziomu agenta nadrzędnego jakie dokładne wersje dodatków i poprawek zainstalowane są na konkretnych stanowiskach podrzędnych. Na liście dostępnej po wybraniu przycisku [Struktura agentów] prezentowani są wszyscy agenci podrzędni dostępni w ramach aktywnego profilu. Dla każdego agenta w linii pozycji dodany został nowy przycisk: [Pokaż szczegóły].

  Po wybraniu przycisku [Pokaż szczegóły] prezentowane jest okno ze szczegółami wybranego podrzędnego:

• Adres usługi – w przypadku poprawnego połączenia pomiędzy nadrzędnym a podrzędnym, prezentowany jest adres usługi
• Wersja agenta – wersja Comarch Auto Update aktualnie zainstalowana na agencie podrzędnym. Ikona żółtego trójkąta z wykrzyknikiem oznacza brak informacji o wersji agenta podrzędnego.
• Informacja o wolnym miejscu – w przypadku braku połączenia prezentowana jest informacja: Brak informacji o wolnym miejscu

Poniżej informacji o wolnym miejscu przeniesione zostały standardowe przyciski, dostępne wcześniej pod przyciskiem strzałki obok nazwy wybranego agenta podrzędnego. W dolnej części okna dostępna jest tabela zawierająca informację o nazwie i wersji zainstalowanych:

• Produktów
• Dodatkach
• Poprawkach

Obsługa poprawek dla produktu Comarch WMS

Wprowadzona została funkcjonalność lokalnej oraz zdalnej instalacji QF dla produktu Comarch WMS. Poprawki są to paczki z bibliotekami oraz skryptami zawierające zmiany poprawiające funkcjonowanie danego komponentu w określonej wersji.

Uwaga

Poprawki nie pojawiają się w aplikacji automatycznie, a są udostępniane na życzenie klienta lub partnera po uprzednim kontakcie z asystą Comarch.

W przypadku produktu Comarch WMS funkcjonalność poprawek obsługowana jest przez komponenty:

• Magazynier
• Zarządzanie
• Uczenie Maszynowe

1    Dodatkowe komponenty

1.1     Comarch Device Manager Service

Dla produktu Comarch Retail wprowadzony został nowy komponent – Comarch Device Manager Service. Komponent działa jako usługa, która pośredniczy i umożliwia wykonanie wydruku z aplikacji Comarch mPOS.

Uwaga

Po dodaniu komponentu nie ma potrzeby jego konfiguracji, należy wybrać przycisk [Zapisz], a następnie przystąpić do instalacji. W tym celu należy przejść do widoku głównego aplikacji Comarch Auto Update, gdzie pojawi się możliwość pobrania i instalacji komponentu.

1.2     Comarch Discount Engine Service

Uwaga

Funkcjonalność jest zintegrowana wyłącznie z systemem Comarch ERP Enterprise

Do produktu Comarch Retail dodane zostały nowe komponenty związane z obsługą rabatów:

• Discount Engine Service – Discount Service
• Discount Engine – Synchronization Service

  Comarch Discount Engine Service (DES) umożliwia aplikacjom zewnętrznym korzystanie z rabatów w taki sam sposób jak w aplikacji Comarch POS. Może być on wykorzystywany do obliczania cen i rabatów dla sklepów internetowych. Dla nowych komponentów z poziomu Comarch Auto Update możliwa jest:

• Instalacja
• Aktualizacja
• Deinstalacja
• Cofnięcie w przypadku błędu
• Instalacja poprawek
• Wstępna konfiguracja w interfejsie użytkownika Comarch Auto Update

Uwaga

Nowe komponenty dostępne są tylko dla profilu głównego.

Uwaga

W związku ze zmianami w szyfrowaniu przed migracją do wersji Windows 11 należy wykonać poniższe kroki:

1. Wykonać aktualizację systemu Auto Update do najnowszej wersji.
2. Zainstalować najnowszą poprawkę do odpowiedniej wersji systemu Comarch POS w której dodano dll szyfrującą (w celu uzyskania poprawki należy wysłać zgłoszenie w Systemie Obsługi Zgłoszeń).

Po wykonaniu powyższych zmian należy zweryfikować czy połączenie z bazą SQL dla POS oraz POS Agent jest prawidłowe w konfiguracji komponentów Comarch POS i Comarch POS Agent w Comarch Auto Update.

  W związku z wymaganiami rynku, w najnowszej wersji systemu usługa RabbitMQ została zaktualizowana do wersji 3.13.7. Od wersji 2025.0 dostępna jest tylko komunikacja REST i SSL, dlatego zablokowana została możliwość aktualizacji środowiska wykorzystującego komunikację WCF. Należy zadbać o otwarcie portów dla komunikacji po SSL

• PL/EN - port 10466
• DE - port 10539
• FR - port 10460

Ograniczono również wyświetlanie stan wykonywanych akcji dla wersji AU, komponentów, QFów i Addonsów – zamiast poszczególnych kroków instalacji/aktualizacji/dezinstalacji wyświetlany jest jeden krok zbiorczy.  

 

1       Komunikacja SSL dla agentów podrzędnych

W związku z wprowadzonymi zmianami dotyczącymi komunikacji SSL, dodany został nowy widok w głównym oknie Comarch Auto Update, w sekcji Konfiguracja programu -  Konfiguracja SSL.

Po wybraniu przycisku [Konfiguracja SSL] dostepny jes nowy widok, który został podzielony na dwie sekcje. Po lewej stronie znajduje się panel do testowania zmiany połączenia na SSL. Po prawej stronie znajduje się sekcja dotycząca konfiguracji połączenia SSL dla agentów podrzędnych.  

  W celu przełączenia komunikacji na SSL w pierwszej kolejności należy wygenerować certyfikaty dla agenta nadrzędnego przy pomocy przycisku [Wygeneruj certyfikaty]. W tym momencie zostaną wygenerowane certyfikaty SSL dla agentów podrzędnych i lokalnych nadrzędnych.

Uwaga

Najważniejszym elementem jest prawidłowe wypełnienie pół konfiguracji. Po wygenerowaniu certyfikatów nie będzie można już zmienić tych wartości, ponieważ zostaną one zawarte w certyfikatach.

W konfiguracji konieczne jest uzupełnienie poniższych pól:

• Port SSL – port po którym agency podrzędni będą łączyć się do agenta nadrzędnego. Domyślnie ma on wartość 12365.
• Port SSL dla lokalnych nadrzędnych – port po którym agenci podrzędni, którzy mają zdefiniowane lokalizacje będą łączyć się do lokalnych agentów nadrzędnych. Domyślnie ma on wartość 12365. Jeżeli w sieci nie posiadamy lokalizacji zalecane jest pozostawienie domyślnej wartości.
• Wszystkie nazwy maszyny, na której znajduje się agent nadrzędny – należy uzupełnić oddzielone średnikiem nazwy maszyny z zainstalowanym agentem nadrzędnym.
• Wszystkie adresy IP maszyny, na której znajduje się agent nadrzędny – należy uzupełnić oddzielone średnikiem adresy IP maszyny z zainstalowanym agentem nadrzędnym.

Certyfikaty generowane są do domyślnej ścieżki:  ‘C:\ProgramData\Agent0Data\Certificates’. Po wygenerowaniu certyfikatów przycisk [Test przełączania na SSL] zostaje aktywowany i wówczas możliwa jest  konfiguracja czasu dla testu przełączania na SSL agentów podrzędnych.

Uwaga

Po upływie czasu ustawionego jako timeout, wykonywanie testu zostaje przerwane, nawet gdy test sam w sobie nie zdąży się zakończyć, dlatego należy dostosować czas do wielkości środowiska. Domyślna wartość to 60 min - nie jest zalecane bez konkretnej potrzeby zmienianie wartości domyślnej.

Na liście, która znajduje się po prawej stronie, w sekcji Status, widoczni są wszyscy agenci podrzędni.

  Wiadomość o teście zostaje wysłana do agentów podrzędnych spełniających poniższe warunki:

• w wersji co najmniej 2025.0
• nie będących agentami podrzędnymi typu mPOS

Uwaga

Po zakończeniu testu system wyświetla komunikat podsumowujący ilość agentów podrzędnych które zostały: przepięte poprawnie, z błędami, nie wzięły udziału, są w wersji niewspierającej SSL i typu mPOS

Gdy agenci podrzędni mają już pobrane certyfikaty należy skorzystać z przycisku [Używaj połączenia SSL], wówczas rozpocznie się proces przepinania sieci na komunikację SSL. W celu bezpieczniejszego korzystania z działania komunikacji SSL dla agentów podrzędnych warto uruchomić komunikację Rabbit SSL. Przycisk [Używaj połączenia SSL dla RabbitMQ] będzie dostępny gdy środowisko będzie przepięte na komunikację SSL. Wówczas po jego wybraniu RabbitMQ zostanie przepięty na komunikację po SSL i będzie korzystał z portu 5671. Port należy dodać do reguł przychodzących dla agenta nadrzędnego i wychodzących dla agentów podrzędnych. W widoku Konfiguracji SSL dodana została sekcja Akcje zaawansowane, w której użytkownik ma możliwość wymuszenia przepięcia sieci agentów na komunikację SSL, poprzez skorzystanie z przycisku [Wymuś przepięcie na SSL]. Dostępny jest również przycisk [Pokaż podrzędnych bez SSL] – jego wybranie powoduje wyświetlenie list podrzędnych, z podziałem na:

• Podrzędnych nieprzepiętych na SSL
• Podrzędnych niepodłączonych do Rabbit SSL

2       Dodatkowe zmiany dla agentów podrzędnych

2.1      Eksport listy

Dodano możliwość eksportu listy agentów podrzędnych do Excela. W tym celu należy skorzystać z przycisku [Eksportuj do Excela]

2.2     Zdalny restart usługi dla agentów podrzędnych

Dodano możliwość zbiorowego zdalnego restartu usługi dla agentów podrzędnych przy pomocy przycisku [Zrestartuj wszystkich], dostępnego z poziomu agenta nadrzędnego na widoku agentów podrzędnych. W sytuacji gdy skorzystamy z przycisku bez wskazania konkretnych agentów podrzędnych, informacja o restarcie zostanie wysłana do wszystkich podrzędnych. Jeśli lista agentów podrzędnych zostanie zawężona poprzez konkretne wskazanie z listy, żądanie restartu zostanie wysłane tylko do wybranych.

 

2.3     Nowy widok filtrów

Wprowadzono nowy widok filtrów w oknie agentów podrzędnych. Przycisk [Pokaż widok filtrów] został dodany w sekcji Zarządzanie siecią agentów. Wszelkie filtry można ze sobą łączyć.  

2.4     Ustalenie liczby agentów podrzędnych wykonujących jednocześnie akcję zdalną (np. pobieranie, instalacja)

W oknie konfiguracji agenta nadrzędnego została dodana sekcja Konfiguracja akcji zdalnych. Parametr Maksymalna liczba podrzędnych wykonująca jednocześnie akcję zdalną ma domyślną wartość 200. W nowej wersji dodano również parametr określający Czas oczekiwania na odpowiedź od podrzędnego (minuty), z wartością domyślną ustawioną na 15 min.

 

2.5     Akcje zdalne dla QFów i Addonsów

Przycisk [Zamknij i wyczyść] został ukryty na widoku akcji zdalnych dla QFów i Addonsów, w celu wyeliminowania sytuacji wyczyszczenia aktualnego stanu wywołanej akcji zdalnej i umożliwienia jej ponownego aktywowania bez konieczności otrzymania informacji zwrotnej o danej akcji ze strony agenta podrzędnego.

2.6     Skrót aplikacji Auto Update

Wraz z nową wersją skrót do aplikacji Comarch Auto Update dla agentów podrzędnych  został ukryty. W sytuacji gdy użytkownik chce jednak mieć dostęp do skrótu to jest to możliwe z poziomu agenta nadrzędnego, poprzez zaznaczenie parametru Twórz skrót na pulpicie dla agentów podrzędnych w głównych oknie Konfiguracji.

   

W najnowszej wersji Comarch Auto Update wprowadzono kilka istotnych zmian i usprawnień, które wpływają zarówno na proces instalacji, jak i zarządzanie komponentami systemu.  

1       Instalacja .NET Framework 4.8

Podczas instalacji lub aktualizacji Auto Update do wersji 2025.1, automatycznie instalowany będzie również komponent .NET Framework 4.8. Ze względu na wymagania tego komponentu, konieczny będzie restart maszyny po zakończeniu instalacji, aby Auto Update mógł działać poprawnie. Warto uwzględnić ten fakt podczas planowania wdrożeń i automatyzacji instalacji.  

 

2      Nowy komponent: WMS Zarządzanie

W ramach intensywnych prac nad rozwojem nowego interfejsu WMS Zarządzanie oraz wdrażanych zmian technologicznych, w tym wykorzystania technologii Docker, wprowadzone zostały istotne modyfikacje w obszarze instalacji i konfiguracji tego komponentu w Comarch Auto Update. W systemie Comarch Auto Update pojawił się nowy komponent dedykowany dla produktu Comarch WMS. Jednocześnie, nazwa dotychczasowego komponentu została zmieniona na Zarządzanie (old version)    

Uwaga

Działanie to ma na celu docelowe uproszczenie struktury komponentów w Auto Update – w momencie zakończenia wsparcia dla starego interfejsu WMS Zarządzanie, dostępny będzie wyłącznie nowy interfejs pod standardową nazwą.

 

  W trosce o zwiększenie bezpieczeństwa danych, w konfiguracji komponentu została dodana funkcjonalność szyfrowania połączenia z bazą danych SQL. Zapewnia to bezpieczną komunikację pomiędzy aplikacją, a bazą danych.  

 

3      Instalacja w trybie cichym (silent mode)

W celu wsparcia automatyzacji instalacji naszych produktów, możliwa jest teraz instalacja agenta Auto Update w trybie cichym (silent/quiet mode). Jest to szczególnie przydatne przy masowym wdrażaniu systemu na wielu urządzeniach. Analogicznie jak inne komponenty, takie jak .NET czy SQL Express, agent może być instalowany bez interwencji użytkownika, z poziomu wiersza poleceń. Dzięki temu proces instalacji może być w pełni zautomatyzowany, co ułatwia pracę administratorów oraz zespołów wdrożeniowych.  

4      Usprawnienie dotyczące pobierania komponentów instalacyjnych

Aby usprawnić proces instalacji, w najnowszej wersji dołączyliśmy wymagane składniki Microsoft (np. sqlclrtypes, smo, vcredist) bezpośrednio do naszego oprogramowania. Eliminuje to potrzebę ich dodatkowej instalacji, dzięki czemu uruchomienie aplikacji jest teraz szybsze i bardziej intuicyjne.  

5      Zmiany w akcjach zdalnych oraz instalacji poprawek i dodatków

 

5.1     Ustawienie timeoutu wykonania skryptów SQL dla agentów podrzędnych

Dodano możliwość konfiguracji parametru Timeout wykonania skryptów SQL (s) bezpośrednio z poziomu widoku konfiguracji agenta nadrzędnego. Parametr określa czas (w sekundach), po którym wykonywanie skryptów SQL zostanie przerwane, co zapobiega potencjalnemu "zawieszeniu się" procesu przy długotrwałym lub nieskończonym wykonywaniu skryptów.

Uwaga

Wartość ta dotyczy agentów podrzędnych, natomiast konfiguracja jest dostępna tylko z poziomu agenta nadrzędnego.

 

5.2     Konfigurowalna liczba ponowień instalacji poprawek i dodatków

Wprowadzono nowy parametr umożliwiający ustawienie liczby ponowień instalacji poprawek i dodatków w przypadku błędu.

Dotychczas mechanizm wykonywał automatycznie 3 próby ponowienia. W nowej wersji użytkownik ma możliwość samodzielnego określenia liczby prób, co pozwala lepiej dostosować działanie systemu do indywidualnych potrzeb środowiska.