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 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 przez dostosowanie ustawień zabezpieczeń pliku tak, aby mógł go odczytać tylko Zabbix agent (lub użytkownik uruchamiający agenta). |
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 będzie wymagało ponownego uruchomienia systemu.
7. Kliknij przycisk Finish, aby zakończyć 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.4.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 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). W przypadku 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, 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 ograniczenia sprawdzeń Zabbix agent. W razie potrzeby użyj ukośnika odwrotnego do poprzedzenia 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 instalatora MSI od Zabbix 7.4.6. |
| 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 instalatora MSI od Zabbix 7.4.6. |
| INCLUDE | Lista pojedynczych plików lub wszystkich plików w katalogu, rozdzielona ś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 na połączenia 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 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 ma przechowywać bazę danych SQLite. |
| PERSISTENTBUFFERPERIOD | Tylko Zabbix agent 2. Okres, przez który dane mają 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órego mają być pobierane aktywne sprawdzenia. |
| 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 instalatora MSI od Zabbix 7.4.6. |
| STARTAGENTS | Liczba wstępnie uruchomionych instancji zabbix_agentd, które przetwarzają pasywne sprawdzenia. Jeśli ustawione na 0, pasywne sprawdzenia są wyłączone, a agent nie będzie nasłuchiwał na żadnym porcie TCP. Obsługiwane w pakietach instalatora MSI od Zabbix 7.4.6. |
| 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 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 sprawdzeń). 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 urzędów CA najwyższego poziomu do weryfikacji certyfikatu partnera. |
| 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 Zabbix lub proxy (używane dla aktywnych sprawdzeń). 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 z kluczem współdzielonym poprzez odpowiednie ustawienie zabezpieczeń pliku, tak aby tylko Zabbix agent (lub użytkownik uruchamiający agenta) mógł go odczytać. |
| 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 instalatora MSI od Zabbix 7.4.6. |
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.4.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.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"
# agent-template.conf example:
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 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-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"
# agent-custom.conf example:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2BŁadowalne wtyczki Zabbix agent 2
Ładowalne wtyczki Zabbix agent 2 loadable plugins 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.
Podobnie jak w przypadku Zabbix agent/agent2, ładowalne wtyczki można instalować za pomocą Kreatora instalacji lub wiersza poleceń.
Przed zainstalowaniem wtyczki sprawdź jej 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ń
Ładowalne wtyczki 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.4.0-windows-amd64.msi" /qn+Pakiety instalatora MSI dla ładowalnych wtyczek 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, NvidiagpuPlugin, 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, NvidiagpuPlugin, 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" |