Lokalna instalacja Agenta macOS przy użyciu terminala
Instalacja lokalna agenta monitorowania Syteca On-Premises na systemach operacyjnych Apple macOS
Ten typ instalacji pozwala zainstalować Agenta monitorowania macOS lokalnie, z poziomu wiersza poleceń.
Aby zainstalować Agenta macOS na komputerze docelowym z systemem macOS, wykonaj następujące kroki:
-
Skopiuj pobrany pakiet instalacyjny, np. SytecaMacOSClientuniversal.tar.gz (lub wersję spersonalizowaną z plikiem
settings.ini) do dowolnego folderu w systemie macOS.
Uwaga: W przypadku użycia ukrytego Agenta macOS (zamiast standardowego), pakiet instalacyjny nosi nazwę macos_hidden_agent_universal.tar.gz.
-
Uruchom aplikację Terminal.
-
Przejdź do folderu z pakietem instalacyjnym, wpisując polecenie:
cd <ścieżka_do_folderu>
-
Rozpakuj pakiet instalacyjny, wpisując:
tar xvfz <nazwa_pakietu_instalacyjnego>
-
Otwórz folder EkranClient.
-
Wpisz poniższe polecenie, aby uruchomić instalację Agenta Syteca, podając nazwę hosta lub adres IP komputera, na którym zainstalowany jest Application Server, oraz port do połączenia (domyślnie 9447). W trybie Multi-Tenant podaj także klucz tenantowy:
sudo ./install.sh -h <adres_IP_lub_nazwa_hosta> [-p <port>] [-t <tenant>]
Uwaga: Można podać wiele adresów IP / nazw hostów oddzielonych średnikami — wówczas całą listę należy ująć w cudzysłowie, np.:"<adres1>;<adres2>;<adres3>"
UWAGA: Dla wdrożeń SaaS jako argument -h należy podać adres hosta lub IP load balancera na serwerze proxy Syteca.
UWAGA: W trybie Multi-Tenant klucz tenantowy można skopiować ze strony „Najemcy” w Konsoli Zarządzania. Jeśli nie podano klucza, Agent zostanie przypisany do wbudowanego najemcy domyślnego.
ALTERNATYWA: Jeśli w folderze EkranClient znajduje się plik settings.ini, uruchom skrypt install.sh bez żadnych parametrów.
-
Po zakończeniu instalacji należy przyznać uprawnienia dla aplikacji Syteca Session Client, aby Agent działał prawidłowo:
-
Dostępność (Accessibility)
-
Nagrywanie ekranu (Screen Recording)
-
Jak sprawdzić i nadać uprawnienia:
-
macOS 12 (Monterey): Otwórz Preferencje systemowe → Bezpieczeństwo i prywatność → zakładka Prywatność.
-
macOS 13 (Ventura) i nowsze: Otwórz Ustawienia systemowe → Prywatność i bezpieczeństwo → sekcje Dostępność oraz Nagrywanie ekranu i dźwięku systemowego.
UWAGA: W przypadku użycia ukrytego Agenta, aplikacja Syteca Session Client występuje pod nazwą System Analysis.
-
Po zakończeniu instalacji, Agent macOS pojawi się w liście Agentów monitorowania na stronie Sesje Agentów w Konsoli Zarządzania.
-
Po instalacji wymagane jest również nadanie uprawnień agentowi w systemie. Jak sprawdzić i nadać uprawnienia:
-
macOS 12 (Monterey): Otwórz Preferencje systemowe → Bezpieczeństwo i prywatność → zakładka Prywatność.
-
macOS 13 (Ventura) i nowsze: Otwórz Ustawienia systemowe → Prywatność i bezpieczeństwo → sekcje Dostępność oraz Nagrywanie ekranu i dźwięku systemowego.
-
Po zakończeniu instalacji, Agent macOS pojawi się w liście Agentów monitorowania na stronie Nagrane sesje w Konsoli Zarządzania.
- Upewnij się, że żaden agent macOS nie ma żółtej ikony statusu :

- Jeśli którykolwiek z agentów macOS jest wyświetlany z żółtą ikoną statusu obok niego po lewej stronie na karcie Zarządzanie agentami, oznacza to, że ci agenci nie mają wymaganych uprawnień macOS, takich jak Dostępność i Nagrywanie ekranu (jak wskazuje podpowiedź "Brakujące uprawnienia systemowe. Offline/Online" po najechaniu kursorem na ikonę). Problemy te można rozwiązać, ręcznie zezwalając na brakujące uprawnienia macOS dla tych agentów macOS (zobacz sekcję Instalowanie agentów macOS lokalnie za pomocą wiersza poleceń).
- W przypadku systemu macOS 13 (Ventura) lub nowszego, agenci wyświetlani z żółtą ikoną statusu obok nich, może to również oznaczać, że ci agenci nie mają wymaganego uprawnienia Zezwalaj w tle macOS (jak wskazuje wskazówka "Usługi w tle Syteca wyłączone. Offline/Online" po najechaniu kursorem na ikonę). Problem ten można rozwiązać, wybierając przełącznik agenta Syteca w Preferencjach systemowych > Ogólne > Rzeczy i rozszerzenia otwierane podczas logowania.
-