Instrukcja Comarch ERP Menadżer Kluczy
Wprowadzenie
Aplikacja Comarch ERP Menadżer Kluczy jest niezbędnym elementem pozwalającym na aktywację i pobieranie zakupionych modułów produktów Comarch ERP. Może on współpracować zarówno z fizycznymi kluczami HASP, jak i z kluczami aktywowanymi w COMARCH (kluczami wirtualnymi). 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 kluczami aktywowanymi 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, Windows Server 2022
- Dostęp do adresów ml.comarch.pl i erp.comarch.pl na portach TCP 80, TCP 443
Współpraca z aplikacjami
Menadżer Kluczy w wersji 2025.0.1 obsługuje następujące aplikacje:- Comarch ERP Altum oraz Comarch ERP Retail od wersji 2015
- Comarch ERP Optima w wersji 17.10 przy czym:
- funkcjonalność wielu kluczy z modułami dla Optima wspierana jest od wersji 2013.3.1
- klucze wirtualne wspierane są od wersji 2013.0.1
- Comarch ERP XL
- Funkcjonalność wielu kluczy jest wspierana od wersji 2013.3.1
- Comarch ERP Mobile od wersji 2015
- Comarch WMS od wersji 2015
- Comarch ERP HRM – wszystkie wersje
- Comarch e-Sklep od wersji 6.5
- Comarch ERP Optima Pulpit Menadżera od wersji 5.5, przy czym:
- funkcjonalność wielu kluczy z modułami dla Pulpitu Menadżera wspierana jest od wersji 5.5.2
- Comarch DMS – wszystkie wersje
Instalacja

Po wyborze języka pojawia się kreator instalacji, w którym można podać katalog, gdzie zostanie umieszczona aplikacja. Przy wyborze katalogu zaleca się pozostawienie wartości domyślnych.

Kolejnym parametrem podawanym w instalatorze Menadżera Kluczy, jest instancja SQL. Musi to być lokalna instancja dla komputera, na którym instalowany jest Menadżer Kluczy. Użytkownik, który będzie logował się do SQL niezależnie od tego czy to będzie Logowanie domenowe, czy serwerowe musi posiadać uprawnienia administracyjne na tym serwerze SQL. W przypadku, gdy wybrany login nie posiada wymaganych uprawnień wyświetlony zostanie odpowiedni komunikat:


- 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
- Dodanie w menu start lub ekranie startowym (Windows 8 i 8.1) grupy Comarch ERP Menadżer Kluczy zawierającej ikonę do uruchomienia monitora Menadżera Kluczy.


Instalacja z linii komend
Istnieje możliwość instalacji Menadżera Kluczy z linii komend. W tym celu należy uruchomić plik instalacyjny z następującymi parametrami: ComarchML.exe /s /bin /cfg "Nazwa_instancji_serwera_SQL" 5150 0 1800 /sql " Nazwa_instancji_serwera_SQL " "Użytkownik" "Hasło_użytkownika" Gdzie: /s – „cicha” instalacja 5150 – port serwera http MK 1800 – czas bezczynności „Nazwa_instancji_serwera_SQL” – instancja serwera SQL, na którym zostaną zainstalowane procedury Menadżera Kluczy "Użytkownik" – użytkownik SQL z uprawnieniami administratora np. sa. "Hasło_użytkownika" – hasło SQL dla podanego użytkownika Jeżeli pola „Użytkownik” i „Hasło_użytkownika” pozostaną puste, to instalator autoryzuje się na serwerze SQL za pomocą użytkownika domenowego.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. Monitor uruchamiany jest przy logowaniu do systemu użytkownika, który zainstalował Menadżer Kluczy.
- 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.
Zakładka Dostępne moduły
Zakładka przedstawia listę dostępnych modułów pochodzących z podłączonego klucza HASP, 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. Okno składa się z kolumn:- Numer – numeryczne oznaczenie modułu licencyjnego
- Moduł – nazwa modułu
- Ilość początkowa – ilość dostępnych modułów na kluczu
- Ilość aktualna – pozostająca ilość wolnych modułów na kluczu
- Opcje – czy moduł zawiera dodatkowe opcje (np. możliwość wymiany danych EDI)
- Data ważności – data ważności danego modułu.

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.

Moduły w modelu abonamentowym
Część modułów sprzedawanych jest w modelu abonamentowym, co oznacza, że po upłynięciu daty ważności takiego modułu, aplikacje nie mogą już z niego korzystać. W takim przypadku na zakładce Dostępne moduły oznaczany jest kolorem czerwonym i ilość początkowa resetowana jest do zera. Dodatkowo wyświetlana jest ikona trójkąta z wykrzyknikiem.
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ł. Jeżeli użytkownik na tym samym komputerze uruchomi wielokrotnie program Comarch ERP Optima, to na zakładce Pobrane moduły będzie wyświetlone każde to uruchomienie, przy czym każdy unikalny moduł zostanie pobrany z serwera tylko jeden raz. W przypadku połączeń terminalowych takie działanie występuje w ramach jednego połączenia. Optima uruchomiona w kolejnym połączeniu do tego samego serwera (ale z innej sesji) spowoduje pobranie osobnego zestawu modułów. Pobrane moduły, które nie zostaną odświeżone przez aplikację, przez czas określony za pomocą parametru „Czas do zwolnienia nieaktywnego modułu” (domyślnie 1800 s), są usuwane z listy pobranych i aktualizowana jest ilość dostępnych modułów. Więcej informacji na temat pobierania modułów przez Comarch ERP Optima można znaleźć w biuletynie technicznym OPT007-SerwisHASP.pdf dostępnym na Indywidualnych Stronach Partnerów.

Moduły nazwane
Moduły nazwane są modułami, które są przypisywane do konkretnego urządzenia lub użytkownika. Raz pobrane nie są zwalniane po wylogowaniu z aplikacji. Również restart usługi nie powoduje zwolnienia modułu nazwanego, który został przypisany do identyfikatora przesłanego przez urządzenie lub użytkownika. Reset takiego modułu można wykonać poprzez telefoniczny kontakt z Asystą Comarch.Zakładka Konfiguracja
Lista kluczy
Na zakładce Konfiguracja podana jest nazwa serwera SQL, na którym zainstalowany jest serwis Menadżera Kluczy oraz lista wszystkich kluczy podłączonych do Menadżera Kluczy. Wśród nich może być klucz HASP lub klucze wirtualne. Klucz standardowy przeznaczony dla Klientów na zakładce Konfiguracja ma kolor oliwkowy, natomiast klucz partnerski wyświetlany jest w kolorze fioletowym. W pierwszej kolumnie Dane identyfikacyjne firmy znajduje się numer NIP firmy, która jest właścicielem klucza lub jej akronim.


Funkcje dostępne na zakładce Konfiguracja









Przenoszenie klucza na inny komputer
W przypadku klucza HASP, wystarczy zainstalować Comarch ERP Menadżer Kluczy na nowym komputerze i do tego komputera podłączyć klucz HASP. Przeniesie klucza wirtualnego z jednego komputera na drugi wymaga usunięcia go z pierwotnej instalacji i dopiero później aktywacji na nowym komputerze po zainstalowaniu Comarch ERP Menadżer Kluczy. Bez usunięcia klucza wirtualnego z pierwotnego komputera nie będzie możliwa jego aktywacja w nowym środowisku. W przypadku braku dostępu do komputera, gdzie był aktywowany klucz wirtualny, bądź gdy nie ma on połączenia z Internetem prosimy o kontakt z Asystą Comarch w celu resetu ustawień przenoszonego klucza wirtualnego.Praca z kluczami HASP
Po podłączeniu klucza HASP do komputera należy odczekać kilkanaście do kilkudziesięciu sekund w celu zainstalowania klucza w systemie. Następnie w celu aktywacji klucza w Menadżerze Kluczy wymagany jest restart usługi Menadżera Kluczy.
Praca z wieloma kluczami
Od wersji 2013.3.1 Comarch ERP Optima i Comarch ERP XL oraz od wersji 2015.0.1 Comarch ERP Altum wprowadzono możliwość pracy z wieloma kluczami zawierającymi moduły tej samej aplikacji. Może to być klucz HASP oraz klucze wirtualne lub same klucze wirtualne. Każdy klucz tworzy osobną pulę modułów, ilości modułów nie sumują się pomiędzy kluczami. Poszczególne pule są identyfikowane poprzez numer danego klucza, dlatego w Comarch ERP Optima oraz w Detalu należy dodatkowo wskazać numer klucza.
W przypadku Pulpitu Menadżera, serwer SQL na którym zainstalowany został Menadżer Kluczy oraz numer klucza podawany jest w pliku appSettings.config, który znajduje się w katalogu programu, domyślnie C:\inetpub\wwwroot\pulpitm\.

- Menadżer Kluczy obsługuje tylko jeden klucz HASP podłączony do komputera.
- Jeżeli w Menadżerze Kluczy aktywowane są dwa klucze, przy czym tylko jeden z nich zawiera moduły dla Comarch ERP Optima, a drugi moduły dla Pulpitu Menadżera lub Comarch ERP e-Sklep oraz oba klucze zostały wygenerowane dla tego samego kontrahenta to w Comarch ERP Optima oraz Detalu, w polu serwer klucza nie trzeba wskazywać numeru klucza, wystarczy podać samą nazwę serwera SQL lub zostawić puste pole jeżeli Menadżer Kluczy został zainstalowany na tym samym serwerze SQL co bazy danych. Tak samo jest w przypadku Pulpitu Menadżera, w którym również nie trzeba podawać numeru klucza.

Weryfikacja NIP
Od 1 lipca 2015 dla nowych Klientów Comarch ERP Optima, a od 1 września 2015 roku dla dotychczasowych Klientów Comarch ERP Optima zostanie uruchomiona funkcja weryfikacji NIP. Oznacza to przejście na klucze Firmowe i klucze Wielofirmowe. Poniżej lista wszystkich typów kluczy.
Praca na klastrze SQL
Wprowadzenie
Konfiguracja Menadżera Kluczy na klastrze SQL pozwala na zwiększenie dostępności tej usługi. Przełączenie klastra na nowy węzeł powoduje udostępnienie modułów w Menadżerze Kluczy na nowym, aktywnym węźle. Użytkownicy aplikacji ERP pobierającej moduły po przelogowaniu mogą normalnie pracować bez dodatkowych zmian i konfiguracji. Funkcjonalność przekazywania modułów pomiędzy węzłami klastra dostępna jest tylko dla kluczy wirtualnych, klucze HASP nie są obsługiwane w ten sposób. Przed przystąpieniem do wykonywania instrukcji należy przygotować klaster windows oraz uruchomić na nim klastrowaną usługę SQL.Instrukcja konfiguracji Menadżera Kluczy w środowisku klastra SQL
Instalacja klastrowa Menadżera kluczy dotyczy mechanizmu Microsoft SQL Server Failover Cluster. Mechanizm SQL Server Availability groups nie jest wspierany. Poniższe kroki należy wykonać na każdym węźle klastra: 1. Zainstalować Menadżer Kluczy 2. Konfiguracja po stronie Menadżera Kluczy z poziomu zakładki Zaawansowane- Zaznaczyć parametr Instalacja klastrowa
- Podać nazwę klastra SQL
- Nazwę klastra SQL można sprawdzić w narzędziu zarządzania klasterem (Failover Cluster Manager)


- Założyć domenowe konto, na którym będzie działać usługa Menadżera Kluczy. Proponowana nazwa konta to domena\ComarchMKUser
- Dodać konto domena\ComarchMKUser do grupy administratorzy na komputerach, które są węzłami klastra
- Ustawić konto domena\ComarchMKUser jako konto, na którym działa usługa Menadżera Kluczy. W tym celu należy uruchomić przystawkę services.msc

- Na zakładce Ogólne zmienić typ uruchomienia usługi z „Automatyczny” na „Automatycznie (opóźnione uruchomienie)”
- Nadanie uprawnień po stronie serwera SQL. Zalogować się do klastrowanej usługi SQL i wykonać poniższy skrypt:

Zasada działania
W klastrze pracy awaryjnej Windows mamy węzły, którymi są serwery tworzące klaster. Tylko jeden z węzłów w danym momencie jest aktywny, pozostałe są nieaktywne. Do usługi klastrowanej, jaką jest np. SQL Server łączymy się poprzez jej nazwę. Pod tą nazwą dostępny jest aktywny w danym momencie węzeł klastra. Moduły w Menadżerze Kluczy znajdują się na aktywnym węźle, na pozostałych węzłach wyświetlana jest informacja o nieaktywności węzła i nie ma modułów do pobrania.

Zmiany
Zmiany w wersji 2025.0.1.2024
- Zmieniono nazwę modułu Optima Biuro Rachunkowe na Optima Biuro Rachunkowe / Operacje Wielofirmowe
- Usunięto obsługę kluczy plikowych – softhasp
- Wprowadzono możliwość szyfrowania bezpośredniej komunikacji z Comarch ERP Menadżer Kluczy
Zmiany w wersji 2024.2.1.1147
- Wprowadzono poprawki stabilizacyjne .
Zmiany w wersji 2024.2.1.1144
- Poprawiono aktualizację kluczy HASP z chmury
- Poprawiono przy instalacji logowanie do serwera SQL z hasłem zawierającym znaki specjalne
- Dotyczy kluczy HASP. Dodano Płace i Kadry Plus Współpraca z Comarch ERP Enterprise, XL Artificial intelligence – Optymalizacja zatowarowania, XL KSeF z opcją XL KSeF – no limit, Optima KSeF z opcją Optima KSeF – no limit
- Dotyczy kluczy HASP. Zmieniono nazwy modułów XL Rejestracja Produkcji na XL MES, Optima Kasa/Bank na Optima Moduł dostępowy (Kasa/Bank), Optima Kasa/Bank Plus na Optima Moduł dostępowy (Kasa/Bank Plus), XL Artificial intelligence na XL Artificial intelligence – Windykacja .
Zmiany w wersji 2022.2.1.1101
- Dodano obsługę nowych opcji Optima KSeF Mikro, Optima KSeF Standard, Optima KSeF Premium i Optima KSeF Enterprise oraz XL KSeF
- Dostosowano programowanie kluczy HASP z chmury do planowanych zmian na serwerach Comarch (aktualizacja serwerów Comarch planowana jest na lipiec 2022).
Zmiany w wersji 2022.2.1.1095
- Dodano obsługę nowej opcji XL Artificial intelligence – Limity kredytowe
- Skrócono czas odpowiedzi Menadżera Kluczy do aplikacji Comarch ERP w przypadku pobierania modułów przez protokół http
Zmiany w wersji 2021.3.1.1075
- Drobne zmiany optymalizacyjne
Zmiany w wersji 2021.3.1.1073
- Zaktualizowano sterownik HASP do wersji 8.15 i dodano aktualizację sterownika przy reinstalacji Menadżera Kluczy
- Dodano obsługę nowych modułów: XL IoT, Optima PPK Start i XL PPK Start
- Poprawiono wyświetlanie ilości modułów z poziomu http
Zmiany w wersji 2020.6.1.1026
- Zaktualizowano sterownik HASP do wersji 8.11 i dodano aktualizację sterownika przy reinstalacji Menadżera Kluczy.
- Zmieniono wymagania dotyczące wersji Microsoft .NET Framework na 4.5
- Umożliwiono podgląd w przeglądarce modułów, które znajdują się na kluczach wirtualnych.
- Zablokowano dodawanie tego samego klucza wirtualnego.
- Poprawiono odświeżanie listy kluczy na zakładce Konfiguracja.
- Zmieniono nazwę modułu XL Obieg dokumentów na XL DMS.
Zmiany w wersji 2019.1.1.996
- Dodano obsługę nowych opcji: Optima PPK Standard Plus i XL PPK Standard Plus.
Zmiany w wersji 2019.1.1.993
- Dodano obsługę nowych modułów: Optima PPK Mikro, Optima PPK Standard , Optima PPK Premium, Optima PPK Enterprise 500, Optima PPK Enterprise 1000, Optima PPK Enterprise No Limit, XL PPK Mikro, XL PPK Standard, XL PPK Premium, XL PPK Enterprise 500, XL PPK Enterprise 1000, XL PPK Enterprise No Limit
Zmiany w wersji 2019.1.1.988
- Dodano obsługę nowych opcji: XL Kontrola jakości, Optima – e-Sprawozdania Plus oraz XL – e-Sprawozdania Plus.
Zmiany w wersji 2019.1.1
- Dodano obsługę nowych opcji: XL – e-Sprawozdania, Optima – Wersja dla Biur Rachunkowych oraz Optima – e-Sprawozdania.
Zmiany w wersji 2018.7.1
- Dodano obsługę nowego modułu XL Business Intelligence – Point – Subskrypcje oraz opcji XL Interfejs obcojęzyczny.
- Zaktualizowano sterowniki do klucza HASP do wersji 7.80.
Zmiany w wersji 2018.2.3
- Dodano obsługę nowych opcji: Faktury – Opcja BR, Handel – Opcja BR oraz Handel Plus – Opcja BR.
Zmiany w wersji 2018.2.2
- Zmieniono numer SMS obsługujący aktywację tymczasową kluczy wirtualnych. Nowy numer to 7148.
Zmiany w wersji 2018.2.1
- Dodano informację o serwerze, na którym zainstalowano serwis Menadżera Kluczy.
- Dodano reset zaawansowanych ustawień konfiguracyjnych.
- Ograniczono ustawienie czasu do zwolnienia nieaktywnego modułu do minimum 70 sekund.
Zmiany w wersji 2018.0.1
- Poprawiono mechanizm instalacji Menadżera Kluczy w trakcie instalacji Optimy z serwerem SQL.