1 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 obowiązkowy. Ustawia parametr Server. |
| Agent listen port | Agent będzie nasłuchiwał na tym porcie na połączenia 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 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 | Ciąg identyfikujący klucz współdzielony. 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 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, zostanie wyświetlony monit o wybranie jednej z opcji: zamknięcie aplikacji i ponowną próbę jej uruchomienia albo pozostawienie jej otwartej, co spowoduje konieczność ponownego uruchomienia systemu.
7. Kliknij przycisk Finish, aby zamknąć kreator 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-7.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1Ta metoda umożliwia instalacje bez nadzoru oraz niestandardowe konfiguracje z użyciem parametrów.
Obsługiwane parametry
Pakiety instalacyjne 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 z domyślną konfiguracją. Więcej informacji: właściwość ADDDEFAULT. Możliwe wartości: AgentProgram, GetProgram, SenderProgram, ALLPrzykł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, ALLPrzykł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 escape'owania separatora (\;). 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 pliku konfiguracyjnego szablonu dla Zabbix agent. Podczas instalacji ten plik 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.Obsługiwane w pakietach instalacyjnych MSI od Zabbix 7.0.22. |
| 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. Obsługiwane w pakietach instalacyjnych MSI od Zabbix 7.0.22. |
| 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 serwera. |
| 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 agenta obecne w tym pliku (ograniczone do 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 serwerem 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 serwera/proxy Zabbix lub konfiguracja klastra, z których mają być pobierane aktywne kontrole. |
| SKIP | Użyj SKIP=fw, aby uniemożliwić instalatorowi MSI dodanie reguły wyjątku w Zaporze systemu Windows dla Zabbix agent. |
| SOURCEIP | Adres IP źródłowy dla połączeń wychodzących do serwera Zabbix lub proxy Zabbix albo do nawiązywania połączeń podczas wykonywania niektórych pozycji (web.page.get, net.tcp.port itp.). Obsługiwane w pakietach instalacyjnych MSI od Zabbix 7.0.22. |
| 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. Obsługiwane w pakietach instalacyjnych MSI od Zabbix 7.0.22. |
| 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 Zabbix lub serwerem. |
| 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łównych urzędów CA do weryfikacji certyfikatu peer. |
| TLSCERTFILE | Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów. |
| TLSCONNECT | Sposób, w jaki agent ma łączyć się z serwerem 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 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 klucza współdzielonego poprzez odpowiednie ustawienia zabezpieczeń pliku, tak aby mógł go odczytać tylko Zabbix agent (lub użytkownik uruchamiający agenta). |
| TLSPSKIDENTITY | Łańcuch identyfikatora klucza współdzielonego. |
| TLSPSKVALUE | Wartość 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 serwera (proxy). |
| TLSSERVERCERTSUBJECT | Dozwolony podmiot certyfikatu serwera (proxy). |
| UNSAFEUSERPARAMETERS | Zezwala na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika. Obsługiwane w pakietach instalacyjnych MSI od Zabbix 7.0.22. |
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-7.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-7.0.1-windows-amd64-openssl.msi" /qn+ CONF="C:\agent-template.conf"
# przykład agent-template.conf:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]Alternatywnie można 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-7.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 loadable plugins można zainstalować w systemie Windows przy użyciu 64-bitowych pakietów instalatora MSI, dostępnych do pobrania. Plugin Ember+ jest dołączony do tych pakietów od Zabbix 7.0.10.
Minimalne wymagania systemowe dla instalacji MSI to Windows 10 (64-bit) lub Windows Server 2016.
Podobnie jak w przypadku Zabbix agent/agent2, ładowalne pluginy można instalować za pomocą Kreatora instalacji lub wiersza poleceń.
Przed zainstalowaniem pluginu prosimy sprawdzić jego plik README. Może on zawierać szczegółowe wymagania i instrukcje instalacji.
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ń
Wtyczki ładowane 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-7.0.0-windows-amd64.msi" /qn+Pakiety instalatora MSI dla wtyczek ładowanych Zabbix agent 2 obsługują następujące parametry.
| Parameter | Description |
|---|---|
| ADDDEFAULT | Lista komponentów rozdzielonych przecinkami, które mają zostać zainstalowane w domyślnej konfiguracji. Więcej informacji można znaleźć w ADDDEFAULT property. Possible values: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginExample: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Lista komponentów rozdzielonych przecinkami, które mają zostać zainstalowane lokalnie. Więcej informacji można znaleźć w ADDLOCAL property. Possible values: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginExample: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Pełna ścieżka do folderu, w którym zostaną zainstalowane komponenty Zabbix, a ich pliki konfiguracyjne zostaną umieszczone w podfolderze zabbix_agent2.d.Example: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |