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.
4. Skonfiguruj następujące parametry. Ich wartości zostaną ustawione w pliku konfiguracyjnym Zabbix agent:
| Parameter | Description |
|---|---|
| Host name | Nazwa hosta maszyny, na której instalowany jest Zabbix agent. Ustawia parametr Hostname. |
| Zabbix server IP/DNS | Lista adresów IP oddzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix albo proxy Zabbix. Ten parametr jest obowiązkowy. 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 to adres IP lub nazwa DNS oraz opcjonalny port oddzielony dwukropkiem. Ustawia parametr ServerActive. |
| Enable PSK | Zaznacz pole wyboru, aby włączyć obsługę TLS przy użyciu 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 przemianowany, a następnie zostanie utworzony nowy plik konfiguracyjny.
5. Skonfiguruj parametry PSK, jeśli w poprzednim kroku zaznaczono pole wyboru Enable PSK. Te parametry również zostaną ustawione w pliku konfiguracyjnym Zabbix agent:
| Parameter | Description |
|---|---|
| Pre-shared key identity | Ciąg identyfikatora klucza współdzielonego. Ustawia parametr TLSPSKIdentity. |
| Pre-shared key value | Wartość ciągu 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 przez dostosowanie ustawień zabezpieczeń pliku tak, aby tylko Zabbix agent (lub użytkownik uruchamiający agent) 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 tym wyjątkiem, że dodatkowe pliki konfiguracyjne dla jego wbudowanych wtyczek zostaną zainstalowane w podfolderze zabbix_agent2.d\plugins.d.
Dodatkowo plik zabbix_agentd.exe (lub zabbix_agent2.exe) zostanie skonfigurowany jako usługa Windows z opóźnionym automatycznym uruchamianiem (lub automatycznym uruchamianiem w wersjach Windows wcześniejszych niż Windows Vista/Server 2008).
Jeśli podczas instalacji działa inna wersja Zabbix agent, pojawi się monit z wyborem: zamknąć aplikację i spróbować uruchomić ją ponownie albo pozostawić ją otwartą, co będzie wymagało ponownego uruchomienia systemu.
7. Kliknij przycisk Finish, aby zamknąć kreatora konfiguracji.
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.0Ta metoda umożliwia instalacje nienadzorowane oraz niestandardową konfigurację przy użyciu 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 oraz przykłady konfiguracji na stronie Zabbix agent (Windows). W przypadku Zabbix agent 2 zobacz stronę Zabbix agent 2 (Windows).
| Parameter | Description |
|---|---|
| ADDDEFAULT | Lista komponentów rozdzielonych przecinkami do zainstalowania w ich domyślnej konfiguracji. Więcej informacji znajduje się w właściwości ADDDEFAULT. Możliwe wartości: AgentProgram, GetProgram, SenderProgram, ALLPrzykład: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Lista komponentów rozdzielonych przecinkami do zainstalowania lokalnie. Więcej informacji znajduje się w właściwości ADDLOCAL. Możliwe wartości: AgentProgram, GetProgram, SenderProgram, ALLPrzykład: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Lista parametrów AllowKey lub DenyKey rozdzielonych średnikami służących do ograniczania kontroli Zabbix agent. W razie potrzeby użyj ukośnika odwrotnego, aby poprzedzić separator znakiem ucieczki (\;). 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 szablon pliku konfiguracyjnego dla Zabbix agent. 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 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 pozycja używaną do pobierania metadanych hosta. |
| HOSTNAME | Opcjonalny parametr definiujący nazwę hosta. |
| HOSTNAMEITEM | Opcjonalny parametr definiujący pozycja 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 powinien 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 wszelkie prawidłowe parametry konfiguracji agenta obecne w tym pliku (ograniczone do tych 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 | Tylko Zabbix agent 2. Plik, w którym Zabbix agent 2 powinien przechowywać bazę danych SQLite. |
| PERSISTENTBUFFERPERIOD | Tylko Zabbix agent 2. Okres, przez który dane powinny 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 jest ustawione na 0. |
| SERVERACTIVE | Adres Zabbix serwer/proxy lub konfiguracja klastra, z którego mają być pobierane aktywne kontrole. |
| SKIP | Użyj SKIP=fw, aby uniemożliwić instalatorowi MSI dodanie reguły wyjątku Zapory systemu Windows dla Zabbix agent. |
| SOURCEIP | Źródłowy adres IP dla połączeń wychodzących do Zabbix serwer lub Zabbix proxy albo do nawiązywania połączeń podczas wykonywania niektórych pozycji (web.page.get, net.tcp.port itd.). |
| STARTAGENTS | Liczba wstępnie utworzonych instancji zabbix_agentd przetwarzających kontrole pasywne. Jeśli ustawione na 0, kontrole pasywne 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 - uruchom usługę automatycznie podczas startu systemu Windows; delayed - (domyślnie) opóźnij uruchomienie usługi do momentu zakończenia uruchamiania usług startowanych automatycznie (dostępne w systemach Windows Vista/Server 2008 i nowszych); manual - uruchom 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 żądań statusu HTTP (http://localhost:<port>/status). |
| TIMEOUT | Określa, jak długo czekać (w sekundach) na ustanowienie połączenia i wymianę danych z Zabbix proxy lub serwer. |
| TLSACCEPT | Przychodzące połączenia do zaakceptowania (używane dla kontroli pasywnych). Jeśli ustawione na psk, wówczas TLSCONNECT również zostanie ustawione na psk (o ile nie określono inaczej). |
| TLSCAFILE | Pełna ścieżka do pliku zawierającego certyfikaty głównych urzędów certyfikacji (CA) do weryfikacji certyfikatu strony zdalnej. |
| 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 Zabbix serwer lub proxy (używane dla kontroli aktywnych). Jeśli ustawione na psk, wówczas TLSACCEPT również zostanie ustawione 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 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 z kluczem współdzielonym przez dostosowanie ustawień zabezpieczeń pliku tak, aby tylko Zabbix agent (lub użytkownik uruchamiający agenta) mógł go odczytać. |
| TLSPSKIDENTITY | Ciąg tożsamości 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 przy użyciu 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.0^
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ę agent Zabbix i używa pliku konfiguracyjnego szablonu (CONF="C:\agent-template.conf").
Podczas instalacji plik ten stanie się plikiem konfiguracyjnym agent.
Aby dziedziczyć 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 konfiguracyjne agent obecne w tym pliku (ograniczone do tych wymienionych w powyższej tabeli) zostaną zapisane w nowo utworzonym pliku konfiguracyjnym agent.
Aby zachować istniejącą konfigurację agent, 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 pluginy Zabbix agent 2
Ładowalne pluginy Zabbix agent 2 można zainstalować w systemie Windows przy użyciu 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 pluginu sprawdź jego plik README. Może on zawierać szczegółowe wymagania oraz instrukcje instalacji.
Podobnie jak w przypadku Zabbix agent/agent2, ładowalne pluginy 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, PostgresqlPluginPrzykł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, PostgresqlPluginPrzykł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" |