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 za pomocą kreatora konfiguracji

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), które mają zostać zainstalowane:

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

Jeśli zostanie użyta niestandardowa lokalizacja poza katalogiem Program Files, a folder docelowy już istnieje, instalator nie zmieni jego uprawnień. Podczas nowej instalacji zostanie wyświetlony monit o ręczne ustawienie odpowiednich uprawnień lub kontynuowanie bez ich modyfikowania.

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

Parameter Description
Nazwa hosta Nazwa hosta komputera, na którym jest instalowany Zabbix agent. Ustawia parametr Hostname.
Adres IP/DNS serwera Zabbix Lista rozdzielanych przecinkami adresów IP, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix albo proxy Zabbix. Ten parametr jest obowiązkowy. Ustawia parametr Server.
Port nasłuchiwania agent agent będzie nasłuchiwać na tym porcie połączeń z serwera. Ustawia parametr ListenPort.
Serwer lub proxy dla aktywnych kontroli Adres serwera/proxy Zabbix lub konfiguracja klastra, z którego mają być pobierane aktywne kontrole. Adres serwera/proxy to adres IP lub nazwa DNS oraz opcjonalny port oddzielone dwukropkiem. Ustawia parametr ServerActive.
Włącz PSK Zaznacz pole wyboru, aby włączyć obsługę TLS z użyciem kluczy wstępnie współdzielonych. Ustawia parametry TLSConnect i TLSAccept na psk.
Dodaj lokalizację agent do zmiennej 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. Ponadto podczas instalacji istniejący plik konfiguracyjny zostanie przemianowany, a następnie zostanie utworzony nowy plik konfiguracyjny.

5. Skonfiguruj parametry PSK, jeśli w poprzednim kroku zaznaczono pole wyboru Włącz PSK. Parametry te również zostaną ustawione w pliku konfiguracyjnym Zabbix agent:

Parameter Description
Tożsamość klucza wstępnie współdzielonego Ciąg znaków tożsamości klucza wstępnie współdzielonego. Ustawia parametr TLSPSKIdentity.
Wartość klucza wstępnie współdzielonego Wartość ciągu znaków klucza wstępnie 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 wstępnie współdzielonego przez dostosowanie ustawień zabezpieczeń pliku tak, aby tylko Zabbix agent (lub użytkownik uruchamiający agent) mógł go odczytywać.

6. Kliknij przycisk 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 wyjątkiem dodatkowych plików konfiguracyjnych jego wbudowanych wtyczek, które zostaną zainstalowane w podfolderze zabbix_agent2.d\plugins.d.

Ponadto 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 starszych niż Windows Vista/Server 2008).

Jeśli podczas instalacji działa inna wersja Zabbix agent, zostanie wyświetlony monit o zamknięcie aplikacji i próbę jej ponownego uruchomienia albo pozostawienie jej otwartej; w drugim przypadku wymagane będzie ponowne uruchomienie systemu.

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

Instalacja z wiersza poleceń

Zabbix agent 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.2.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1

Ta metoda umożliwia przeprowadzanie instalacji nienadzorowanych oraz stosowanie niestandardowych konfiguracji za pomocą parametrów.

Obsługiwane parametry

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

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

Parametr Opis
ADDDEFAULT Lista rozdzielanych przecinkami komponentów, które należy zainstalować z konfiguracją domyślną. Więcej informacji można znaleźć w opisie właściwości ADDDEFAULT.
Możliwe wartości: AgentProgram, GetProgram, SenderProgram, ALL
Przykład: ADDDEFAULT=AgentProgram,GetProgram
ADDLOCAL Lista rozdzielanych przecinkami komponentów, które należy zainstalować lokalnie. Więcej informacji można znaleźć w opisie właściwości ADDLOCAL.
Możliwe wartości: AgentProgram, GetProgram, SenderProgram, ALL
Przykład: ADDLOCAL=AgentProgram,SenderProgram
ALLOWDENYKEY Lista rozdzielanych średnikami parametrów AllowKey lub DenyKey służących do ograniczania kontroli agenta Zabbix. W razie potrzeby użyj odwrotnego ukośnika do oznaczenia znaku rozdzielającego jako znaku specjalnego (\;). Ustawia parametry AllowKey i DenyKey w pliku konfiguracyjnym agenta.
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 szablonowego pliku konfiguracyjnego agenta Zabbix. Podczas instalacji plik ten stanie się plikiem konfiguracyjnym agenta. Plik musi zawierać co najmniej parametry Server i LogFile.
Przykład: CONF="C:\full\path\to\example.conf"
DONOTSTART Użyj DONOTSTART=1, aby uniemożliwić instalatorowi MSI uruchomienie usługi agenta Zabbix.
ENABLEPATH Użyj ENABLEPATH=1, aby dodać lokalizację agenta Zabbix do systemowej zmiennej PATH.
ENABLEPERSISTENTBUFFER Dotyczy tylko agenta Zabbix 2. Włącza używanie lokalnego trwałego magazynu 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 rozdzielanych średnikami pojedynczych plików lub wszystkich plików w katalogu, które należy dołączyć do pliku konfiguracyjnego agenta Zabbix.
IGNOREALREADYEXISTSFOLDER W przypadku nowych instalacji użyj IGNOREALREADYEXISTSFOLDER=1, aby zezwolić na instalację w istniejącym folderze docelowym poza katalogiem Program Files. Jeśli ten parametr nie zostanie określony, instalacja zakończy się niepowodzeniem, gdy taki folder docelowy już istnieje.
INSTALLFOLDER Pełna ścieżka do folderu, w którym zostaną zainstalowane komponenty Zabbix i plik konfiguracyjny agenta Zabbix. W przypadku agenta Zabbix 2 dodatkowe pliki konfiguracyjne wbudowanych wtyczek zostaną zainstalowane w podfolderze zabbix_agent2.d\plugins.d.
Przykład: INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Lista rozdzielanych przecinkami adresów IP, na których agent powinien nasłuchiwać.
LISTENPORT Port, na którym agent będzie nasłuchiwać połączeń z serwera.
LOGFILE Nazwa pliku dziennika agenta Zabbix.
LOGTYPE Typ danych wyjściowych dziennika.
NONMSICONFNAME Pełna ścieżka do niestandardowego pliku konfiguracyjnego agenta Zabbix. Podczas instalacji wszystkie prawidłowe parametry konfiguracji agenta znajdujące się w tym pliku (ograniczone do parametrów wymienionych w tej tabeli) zostaną zapisane w nowo utworzonym pliku konfiguracyjnym agenta. Plik musi zawierać co najmniej parametr Server.
Przykład: NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Dotyczy tylko agenta Zabbix 2. Plik, w którym agent Zabbix 2 powinien przechowywać bazę danych SQLite.
PERSISTENTBUFFERPERIOD Dotyczy tylko agenta Zabbix 2. Okres, przez który dane powinny być przechowywane w przypadku braku połączenia z serwerem lub proxy.
SERVER Lista rozdzielanych przecinkami adresów IP, 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 serwera/proxy Zabbix lub konfiguracja klastra, z którego należy pobierać aktywne kontrole.
SKIP Użyj SKIP=fw, aby uniemożliwić instalatorowi MSI dodanie reguły wyjątku Zapory systemu Windows dla agenta Zabbix.
SOURCEIP Źródłowy adres IP dla połączeń wychodzących z serwerem Zabbix lub proxy Zabbix albo do nawiązywania połączeń podczas wykonywania niektórych pozycji (web.page.get, net.tcp.port itd.).
STARTAGENTS Liczba wstępnie rozgałęzionych instancji zabbix_agentd przetwarzających kontrole pasywne.
Jeśli ustawiono wartość 0, kontrole pasywne są wyłączone, a agent nie będzie nasłuchiwać na żadnym porcie TCP.
STARTUPTYPE Typ uruchamiania usługi agenta Zabbix. Możliwe wartości:
automatic - uruchamianie usługi automatycznie podczas uruchamiania systemu Windows;
delayed - (domyślnie) opóźnienie uruchomienia usługi do czasu zakończenia uruchamiania usług uruchamianych automatycznie (dostępne w systemach Windows Vista/Server 2008 i nowszych);
manual - ręczne uruchamianie usługi (przez użytkownika lub aplikację);
disabled - wyłączenie usługi, aby nie mogła zostać uruchomiona przez użytkownika ani aplikację.
Przykład: STARTUPTYPE=disabled
STATUSPORT Dotyczy tylko agenta Zabbix 2. Jeśli ustawiono ten parametr, agent będzie nasłuchiwać na tym porcie żądań stanu HTTP (http://localhost:<port>/status).
TIMEOUT Określa czas oczekiwania (w sekundach) na ustanowienie połączenia i wymianę danych z proxy lub serwerem Zabbix.
TLSACCEPT Połączenia przychodzące, które należy akceptować (używane w przypadku kontroli pasywnych). Jeśli ustawiono wartość psk, TLSCONNECT również zostanie ustawiony na psk (o ile nie określono inaczej).
TLSCAFILE Pełna ścieżka do pliku zawierającego certyfikaty najwyższego poziomu CA do weryfikacji certyfikatu peera.
TLSCERTFILE Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów.
TLSCONNECT Sposób, w jaki agent powinien łączyć się z serwerem lub proxy Zabbix (używany w przypadku kontroli aktywnych). Jeśli ustawiono wartość psk, TLSACCEPT również zostanie ustawiony na psk (o ile nie określono inaczej).
TLSCRLFILE Pełna ścieżka do pliku zawierającego unieważnione certyfikaty.
TLSKEYFILE Pełna ścieżka do pliku zawierającego klucz prywatny agenta Zabbix.
TLSPSKFILE Pełna ścieżka do pliku zawierającego klucz wstępnie współdzielony agenta Zabbix. Jeśli ustawiono zarówno TLSPSKFILE, jak i TLSPSKVALUE, wartość TLSPSKVALUE zostanie zapisana w pliku określonym w TLSPSKFILE. Zaleca się ograniczenie dostępu do pliku klucza wstępnie współdzielonego przez dostosowanie ustawień zabezpieczeń pliku tak, aby tylko agent Zabbix (lub użytkownik uruchamiający agenta) mógł go odczytać.
TLSPSKIDENTITY Ciąg identyfikatora klucza wstępnie współdzielonego.
TLSPSKVALUE Wartość ciągu klucza wstępnie współdzielonego. Jeśli ustawiono zarówno TLSPSKFILE, jak i TLSPSKVALUE, wartość TLSPSKVALUE zostanie zapisana w pliku określonym w TLSPSKFILE.
Przykład: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER Dozwolony wystawca certyfikatu serwera (proxy).
TLSSERVERCERTSUBJECT Dozwolony podmiot certyfikatu serwera (proxy).
UNSAFEUSERPARAMETERS Zezwala na przekazywanie wszystkich znaków w argumentach parametrów definiowanych przez użytkownika.
Przykłady

Poniższy przykład instaluje agenta Zabbix z niestandardową konfiguracją. Włącza również obsługę TLS przy użyciu kluczy wstępnie współdzielonych.

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.2.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[*]"

Kolejny przykład instaluje nowszą wersję agenta Zabbix i używa szablonowego pliku konfiguracyjnego (CONF="C:\agent-template.conf"). Podczas instalacji plik ten 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.2.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 znajdujące się w tym pliku (ograniczone do parametrów wymienionych w powyższej tabeli) 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.2.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"

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

Wtyczki ładowalne Zabbix agent 2

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

Minimalne wymagania systemu operacyjnego dotyczące instalacji MSI to Windows 10 (64-bitowy) lub Windows Server 2016.

Przed zainstalowaniem wtyczki sprawdź jej plik README. Może on zawierać określone wymagania i instrukcje instalacji.

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

Instalacja za pomocą kreatora instalacji

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

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

3. Wybierz ładowalne wtyczki Zabbix agent 2, które mają zostać zainstalowane.

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

4. Kliknij przycisk 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 instalacji.

Instalacja z wiersza poleceń

Wtyczki ładowane przez 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.2.0-windows-amd64.msi" /qn+

Pakiety instalatora MSI wtyczek ładowanych przez Zabbix agent 2 obsługują następujące parametry.

Parametr Opis
ADDDEFAULT Lista rozdzielanych przecinkami komponentów, które należy zainstalować w ich domyślnej konfiguracji. Więcej informacji zawiera sekcja ADDDEFAULT property.
Możliwe wartości: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Przykład: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Lista rozdzielanych przecinkami komponentów, które należy zainstalować lokalnie. Więcej informacji zawiera sekcja ADDLOCAL property.
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"