Instalacja agenta Windows z pakietu MSI

Przegląd

Zabbix agent można zainstalować w systemie Windows przy użyciu 32-bitowych lub 64-bitowych pakietów instalatora MSI, dostępnych do pobrania.

Minimalne wymagania systemu operacyjnego dla instalacji MSI to:

  • Dla Zabbix agent: Windows XP (64-bit) lub Windows Server 2003
  • Dla Zabbix agent 2: Windows 10 (32-bit) lub Windows Server 2016

Pakietów 32-bitowych nie można instalować w systemach 64-bitowych.

Pakiety zawierają:

  • obsługę TLS (konfiguracja TLS jest opcjonalna)
  • narzędzia Zabbix get i Zabbix sender (mogą być instalowane razem z Zabbix agent/agent 2 lub osobno)

Pakiety Zabbix agent 2 nie zawierają ładowalnych wtyczek (MongoDB, PostgreSQL, MSSQL), które należy pobrać i zainstalować osobno.

Instalację można przeprowadzić przy użyciu kreatora instalacji lub wiersza poleceń.

Chociaż instalacja przy użyciu pakietów MSI jest w pełni obsługiwana, zaleca się zainstalowanie co najmniej Microsoft .NET Framework 2, aby zapewnić prawidłową obsługę błędów.

Zaleca się użycie domyślnej lokalizacji instalacji oferowanej przez instalator. Użycie niestandardowej lokalizacji bez wymaganych uprawnień może obniżyć bezpieczeństwo instalacji.

Instalacja z kreatora instalacji

Poniższe kroki instalacji dotyczą zarówno Zabbix agent, jak i Zabbix agent 2.

1. Kliknij dwukrotnie pobrany plik MSI, aby rozpocząć instalację:

2. Zaakceptuj Umowę licencyjną użytkownika końcowego:

3. Wybierz komponenty Zabbix (Agent daemon, Zabbix sender, Zabbix get) do zainstalowania:

Zaleca się użycie domyślnej lokalizacji instalacji udostępnionej przez instalator. Użycie niestandardowej lokalizacji bez wymaganych uprawnień może zagrozić bezpieczeństwu instalacji.

4. Skonfiguruj następujące parametry. Ich wartości zostaną zapisane w pliku konfiguracyjnym Zabbix agent:

Parameter Description
Host name Nazwa hosta komputera, na którym jest instalowany Zabbix agent. Ustawia parametr Hostname.
Zabbix server IP/DNS Lista adresów IP rozdzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix albo proxy Zabbix. Ten parametr jest wymagany. Ustawia parametr Server.
Agent listen port Agent będzie nasłuchiwał na tym porcie połączeń z serwera. Ustawia parametr ListenPort.
Server or Proxy for active checks Adres serwera/proxy Zabbix lub konfiguracja klastra, z którego mają być pobierane active checks. Adres serwera/proxy jest adresem IP lub nazwą DNS, z opcjonalnym portem oddzielonym dwukropkiem. Ustawia parametr ServerActive.
Enable PSK Zaznacz pole wyboru, aby włączyć obsługę TLS z użyciem kluczy współdzielonych. Ustawia parametry TLSConnect i TLSAccept na psk.
Add agent location to the PATH Zaznacz pole wyboru, aby dodać lokalizację Zabbix agent do systemowej zmiennej PATH.

Jeśli zostanie wykryty istniejący Zabbix agent, zostaną wyświetlone wartości parametrów z jego pliku konfiguracyjnego. Dodatkowo istniejący plik konfiguracyjny zostanie podczas instalacji zmieniony nazwę, a nowy plik konfiguracyjny zostanie utworzony.

5. Skonfiguruj parametry PSK, jeśli w poprzednim kroku zaznaczono pole Enable PSK. Te parametry również zostaną zapisane w pliku konfiguracyjnym Zabbix agent:

Parameter Description
Pre-shared key identity Identyfikator klucza współdzielonego. Ustawia parametr TLSPSKIdentity.
Pre-shared key value Wartość klucza współdzielonego. Tworzy plik psk.key zawierający klucz i ustawia parametr TLSPSKFile na lokalizację klucza (domyślnie: C:\Program Files\Zabbix Agent\psk.key). Zaleca się ograniczenie dostępu do pliku klucza współdzielonego poprzez dostosowanie ustawień zabezpieczeń pliku tak, aby tylko Zabbix agent (lub użytkownik uruchamiający agenta) mógł go odczytać.

6. Kliknij Install, aby rozpocząć instalację.

Wszystkie wybrane komponenty Zabbix oraz plik konfiguracyjny Zabbix agent zostaną zainstalowane w określonej lokalizacji (domyślnie: C:\Program Files\Zabbix Agent). To samo dotyczy Zabbix agent 2, z tą różnicą, że dodatkowe pliki konfiguracyjne dla jego wbudowanych wtyczek zostaną zainstalowane w podfolderze zabbix_agent2.d\plugins.d.

Dodatkowo zabbix_agentd.exe (lub zabbix_agent2.exe) zostanie skonfigurowany jako usługa systemu Windows z opóźnionym automatycznym uruchamianiem (lub automatycznym uruchamianiem w wersjach systemu Windows wcześniejszych niż Windows Vista/Server 2008).

Jeśli podczas instalacji działa inna wersja Zabbix agent, zostaniesz poproszony o wybranie, czy zamknąć aplikację i spróbować ją ponownie uruchomić, czy pozostawić ją otwartą, w którym to przypadku wymagane będzie ponowne uruchomienie komputera.

7. Kliknij przycisk Finish, aby zakończyć pracę kreatora instalacji.

Instalacja z wiersza poleceń

agent Zabbix można zainstalować z wiersza poleceń, uruchamiając instalator MSI za pomocą msiexec. Na przykład:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1

Ta metoda umożliwia instalacje bez nadzoru oraz niestandardowe konfiguracje z użyciem parametrów.

Obsługiwane parametry

Pakiety instalatora MSI Zabbix agent obsługują następujące parametry zarówno dla Zabbix agent, jak i Zabbix agent 2.

Parametry Zabbix agent/agent2 są ustawiane w pliku konfiguracyjnym podczas instalacji. Kliknij nazwę parametru, aby wyświetlić jego szczegółowy opis i przykłady konfiguracji na stronie Zabbix agent (Windows). Dla Zabbix agent 2 zobacz stronę Zabbix agent 2 (Windows).

Parameter Description
ADDDEFAULT Lista komponentów rozdzielonych przecinkami, które mają zostać zainstalowane w domyślnej konfiguracji. Więcej informacji: właściwość ADDDEFAULT.
Możliwe wartości: AgentProgram, GetProgram, SenderProgram, ALL
Przykład: ADDDEFAULT=AgentProgram,GetProgram
ADDLOCAL Lista komponentów rozdzielonych przecinkami, które mają zostać zainstalowane lokalnie. Więcej informacji: właściwość ADDLOCAL.
Możliwe wartości: AgentProgram, GetProgram, SenderProgram, ALL
Przykład: ADDLOCAL=AgentProgram,SenderProgram
ALLOWDENYKEY Lista parametrów AllowKey lub DenyKey rozdzielonych średnikami, służąca do ograniczania kontroli Zabbix agent. W razie potrzeby użyj ukośnika odwrotnego do poprzedzenia separatora (\;). Ustawia parametry AllowKey i DenyKey w pliku konfiguracyjnym agent.
Przykład: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]"
CONF Pełna ścieżka do pliku konfiguracyjnego szablonu dla Zabbix agent. Podczas instalacji ten plik stanie się plikiem konfiguracyjnym agent. Plik musi zawierać co najmniej parametry Server i LogFile.
Przykład: CONF="C:\full\path\to\example.conf"
DONOTSTART Użyj DONOTSTART=1, aby instalator MSI nie uruchamiał usługi Zabbix agent.
ENABLEPATH Użyj ENABLEPATH=1, aby dodać lokalizację Zabbix agent do systemowej zmiennej PATH.
ENABLEPERSISTENTBUFFER Tylko Zabbix agent 2. Włącza użycie lokalnej trwałej pamięci masowej dla aktywnych pozycji.
HOSTINTERFACE Opcjonalny parametr definiujący interfejs hosta.
HOSTMETADATA Opcjonalny parametr definiujący metadane hosta.
HOSTMETADATAITEM Opcjonalny parametr definiujący pozycję używaną do pobierania metadanych hosta.
HOSTNAME Opcjonalny parametr definiujący nazwę hosta.
HOSTNAMEITEM Opcjonalny parametr definiujący pozycję używaną do pobierania nazwy hosta.
INCLUDE Lista pojedynczych plików lub wszystkich plików w katalogu, rozdzielonych średnikami, które mają zostać dołączone do pliku konfiguracyjnego Zabbix agent.
INSTALLFOLDER Pełna ścieżka do folderu, w którym zostaną zainstalowane komponenty Zabbix oraz plik konfiguracyjny Zabbix agent. W przypadku Zabbix agent 2 dodatkowe pliki konfiguracyjne dla wbudowanych wtyczek zostaną zainstalowane w podfolderze zabbix_agent2.d\plugins.d.
Przykład: INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Lista adresów IP rozdzielonych przecinkami, na których agent ma nasłuchiwać.
LISTENPORT Agent będzie nasłuchiwał na tym porcie połączeń z serwer.
LOGFILE Nazwa pliku dziennika Zabbix agent.
LOGTYPE Typ wyjścia dziennika.
NONMSICONFNAME Pełna ścieżka do niestandardowego pliku konfiguracyjnego dla Zabbix agent. Podczas instalacji wszystkie prawidłowe parametry konfiguracji agent obecne w tym pliku (ograniczone do wymienionych w tej tabeli) zostaną zapisane w nowo utworzonym pliku konfiguracyjnym agent. Plik musi zawierać co najmniej parametr Server.
Przykład: NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Tylko Zabbix agent 2. Plik, w którym Zabbix agent 2 ma przechowywać bazę danych SQLite.
PERSISTENTBUFFERPERIOD Tylko Zabbix agent 2. Okres czasu, przez który dane mają być przechowywane, gdy nie ma połączenia z serwer lub proxy.
SERVER Lista adresów IP rozdzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix albo proxy Zabbix. Ten parametr jest obowiązkowy, z wyjątkiem sytuacji, gdy STARTAGENTS ma wartość 0.
SERVERACTIVE Adres serwer Zabbix/proxy lub konfiguracja klastra, z którego mają być pobierane aktywne kontrole.
SKIP Użyj SKIP=fw, aby instalator MSI nie dodawał reguły wyjątku Zapory systemu Windows dla Zabbix agent.
SOURCEIP Adres IP źródłowy dla połączeń wychodzących do serwer Zabbix lub proxy Zabbix, albo do nawiązywania połączeń podczas wykonywania niektórych pozycji (web.page.get, net.tcp.port itp.).
STARTAGENTS Liczba wstępnie uruchomionych instancji zabbix_agentd, które przetwarzają pasywne kontrole.
Jeśli ustawione na 0, pasywne kontrole są wyłączone, a agent nie będzie nasłuchiwał na żadnym porcie TCP.
STARTUPTYPE Typ uruchamiania usługi Zabbix agent. Możliwe wartości:
automatic - uruchamiaj usługę automatycznie podczas startu systemu Windows;
delayed - (domyślnie) opóźnij uruchomienie usługi po zakończeniu startu usług uruchamianych automatycznie (dostępne w Windows Vista/Server 2008 i nowszych wersjach);
manual - uruchamiaj usługę ręcznie (przez użytkownika lub aplikację);
disabled - wyłącz usługę, aby nie mogła zostać uruchomiona przez użytkownika lub aplikację.
Przykład: STARTUPTYPE=disabled
STATUSPORT Tylko Zabbix agent 2. Jeśli ustawione, agent będzie nasłuchiwał na tym porcie na żądania stanu HTTP (http://localhost:<port>/status).
TIMEOUT Określa, jak długo należy czekać (w sekundach) na nawiązanie połączenia i wymianę danych z proxy lub serwer Zabbix.
TLSACCEPT Przychodzące połączenia, które mają być akceptowane (używane dla pasywnych kontroli). Jeśli ustawione na psk, to TLSCONNECT również zostanie ustawione na psk (o ile nie określono inaczej).
TLSCAFILE Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu CA do weryfikacji certyfikatu peera.
TLSCERTFILE Pełna ścieżka do pliku zawierającego certyfikat agent lub łańcuch certyfikatów.
TLSCONNECT Sposób, w jaki agent ma łączyć się z serwer Zabbix lub proxy (używane dla aktywnych kontroli). Jeśli ustawione na psk, to TLSACCEPT również zostanie ustawione na psk (o ile nie określono inaczej).
TLSCRLFILE Pełna ścieżka do pliku zawierającego certyfikaty unieważnione.
TLSKEYFILE Pełna ścieżka do pliku zawierającego prywatny klucz Zabbix agent.
TLSPSKFILE Pełna ścieżka do pliku zawierającego klucz współdzielony Zabbix agent. Jeśli ustawione są zarówno TLSPSKFILE, jak i TLSPSKVALUE, wartość TLSPSKVALUE zostanie zapisana do pliku określonego w TLSPSKFILE. Zaleca się ograniczenie dostępu do pliku klucza współdzielonego poprzez dostosowanie ustawień zabezpieczeń pliku tak, aby tylko Zabbix agent (lub użytkownik uruchamiający agent) mógł go odczytać.
TLSPSKIDENTITY Ciąg identyfikatora klucza współdzielonego.
TLSPSKVALUE Wartość ciągu klucza współdzielonego. Jeśli ustawione są zarówno TLSPSKFILE, jak i TLSPSKVALUE, wartość TLSPSKVALUE zostanie zapisana do pliku określonego w TLSPSKFILE.
Przykład: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER Dozwolony wystawca certyfikatu serwer (proxy).
TLSSERVERCERTSUBJECT Dozwolony podmiot certyfikatu serwer (proxy).
UNSAFEUSERPARAMETERS Zezwala na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika.
Przykłady

Poniższy przykład instaluje agent Zabbix z niestandardową konfiguracją. Włącza również obsługę TLS z użyciem kluczy współdzielonych.

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+^
 SERVER=192.0.2.1^
 INSTALLFOLDER="C:\Program Files\Zabbix Agent"^
 HOSTNAME=LAPTOP-IKP7S51S^
 TLSACCEPT=psk^
 TLSCONNECT=psk^
 TLSPSKIDENTITY="PSK 001"^
 TLSPSKFILE="C:\Program Files\Zabbix Agent\psk.key"^
 TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952^
 ENABLEPATH=1^
 ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]"

Następny przykład instaluje nowszą wersję agenta Zabbix i używa pliku konfiguracyjnego szablonu (CONF="C:\agent-template.conf"). Podczas instalacji ten plik stanie się plikiem konfiguracyjnym agenta. Aby odziedziczyć parametry ze starego pliku konfiguracyjnego, użyj symboli zastępczych parametrów (np. [AllowDenyKey]).

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"

# przykład agent-template.conf:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]

Alternatywnie możesz użyć niestandardowego pliku konfiguracyjnego (NONMSICONFNAME="C:\agent-custom.conf"). Podczas instalacji wszystkie prawidłowe parametry konfiguracji agenta obecne w tym pliku (ograniczone do tych wymienionych w tabeli powyżej) zostaną zapisane w nowo utworzonym pliku konfiguracyjnym agenta. Aby zachować istniejącą konfigurację agenta, zdefiniuj parametry, które mają zostać zachowane.

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"

# przykład agent-custom.conf:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

Ładowalne wtyczki Zabbix agent 2

Ładowalne wtyczki Zabbix agent 2 można instalować w systemie Windows za pomocą 64-bitowych pakietów instalatora MSI, dostępnych do pobrania.

Minimalne wymagania systemowe dla instalacji MSI to Windows 10 (64-bit) lub Windows Server 2016.

Przed zainstalowaniem wtyczki sprawdź jej plik README. Może on zawierać szczegółowe wymagania oraz instrukcje instalacji.

Podobnie jak w przypadku Zabbix agent/agent2, ładowalne wtyczki można instalować za pomocą kreatora instalacji lub z wiersza poleceń.

Instalacja za pomocą kreatora konfiguracji

1. Kliknij dwukrotnie pobrany plik MSI, aby rozpocząć instalację.

2. Zaakceptuj umowę licencyjną użytkownika końcowego.

3. Wybierz ładowalne wtyczki Zabbix agent 2 do zainstalowania.

Zaleca się użycie domyślnej lokalizacji instalacji udostępnionej przez instalator. Użycie niestandardowej lokalizacji bez wymaganych uprawnień może zagrozić bezpieczeństwu instalacji.

4. Kliknij Install, aby rozpocząć instalację.

Wszystkie wybrane ładowalne wtyczki Zabbix agent 2 zostaną zainstalowane w określonej lokalizacji (domyślnie: C:\Program Files\Zabbix Agent 2), a ich pliki konfiguracyjne zostaną zainstalowane w podfolderze zabbix_agent2.d.

5. Kliknij przycisk Finish, aby zamknąć kreatora konfiguracji.

Instalacja z wiersza poleceń

Ładowalne pluginy Zabbix agent 2 można zainstalować z wiersza poleceń, uruchamiając instalator MSI za pomocą msiexec. Na przykład:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-8.0.0-windows-amd64.msi" /qn+

Pakiety instalatora MSI dla ładowalnych pluginów Zabbix agent 2 obsługują następujące parametry.

Parameter Description
ADDDEFAULT Lista komponentów rozdzielonych przecinkami, które mają zostać zainstalowane w swojej domyślnej konfiguracji. Więcej informacji można znaleźć w właściwości ADDDEFAULT.
Możliwe wartości: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Przykład: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Lista komponentów rozdzielonych przecinkami, które mają zostać zainstalowane lokalnie. Więcej informacji można znaleźć w właściwości ADDLOCAL.
Możliwe wartości: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Przykład: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Pełna ścieżka do folderu, w którym zostaną zainstalowane komponenty Zabbix, a ich pliki konfiguracyjne zostaną zainstalowane w podfolderze zabbix_agent2.d.
Przykład: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"