Installazione dell'agent Windows da MSI
Panoramica
Zabbix agent può essere installato su Windows utilizzando pacchetti di installazione MSI a 32 bit o 64 bit, disponibili per il download.
I requisiti minimi del sistema operativo per l'installazione tramite MSI sono:
- Per Zabbix agent: Windows XP (64 bit) o Windows Server 2003
- Per Zabbix agent 2: Windows 10 (32 bit) o Windows Server 2016
I pacchetti a 32 bit non possono essere installati su sistemi a 64 bit.
I pacchetti includono:
- supporto TLS (la configurazione TLS è facoltativa)
- utilità Zabbix get e Zabbix sender (possono essere installate insieme a Zabbix agent/agent 2 o separatamente)
I pacchetti di Zabbix agent 2 non includono plugin caricabili (MongoDB, PostgreSQL, MSSQL), che devono essere scaricati e installati separatamente.
L'installazione può essere eseguita utilizzando la Procedura guidata di installazione o la riga di comando.
Sebbene l'installazione tramite pacchetti MSI sia pienamente supportata, si consiglia di installare almeno Microsoft .NET Framework 2 per una corretta gestione degli errori.
Si consiglia di utilizzare il percorso di installazione predefinito fornito dal programma di installazione. L'utilizzo di un percorso personalizzato senza le autorizzazioni necessarie può compromettere la sicurezza dell'installazione.
Installazione tramite Setup Wizard
I seguenti passaggi di installazione si applicano sia a Zabbix agent sia a Zabbix agent 2.
1. Fare doppio clic sul file MSI scaricato per avviare l'installazione:
2. Accettare il Contratto di licenza con l'utente finale:
3. Selezionare i componenti di Zabbix (Agent daemon, Zabbix sender, Zabbix get) da installare:
Si consiglia di utilizzare il percorso di installazione predefinito fornito dal programma di installazione. L'utilizzo di un percorso personalizzato senza le autorizzazioni necessarie può compromettere la sicurezza dell'installazione.
4. Configurare i seguenti parametri. I relativi valori verranno impostati nel file di configurazione di Zabbix agent:
| Parameter | Description |
|---|---|
| Host name | Il nome host della macchina su cui viene installato Zabbix agent. Imposta il parametro Hostname. |
| Zabbix server IP/DNS | Un elenco di indirizzi IP separati da virgole, facoltativamente in notazione CIDR, oppure nomi DNS di server Zabbix o proxy Zabbix. Questo parametro è obbligatorio. Imposta il parametro Server. |
| Agent listen port | L'agent resterà in ascolto su questa porta per le connessioni dal server. Imposta il parametro ListenPort. |
| Server or Proxy for active checks | L'indirizzo del server/proxy Zabbix o la configurazione del cluster da cui ottenere gli active checks. L'indirizzo del server/proxy è un indirizzo IP o un nome DNS con una porta facoltativa separata da due punti. Imposta il parametro ServerActive. |
| Enable PSK | Selezionare la casella di controllo per abilitare il supporto TLS utilizzando chiavi precondivise. Imposta i parametri TLSConnect e TLSAccept su psk. |
| Add agent location to the PATH | Selezionare la casella di controllo per aggiungere il percorso di Zabbix agent alla variabile di sistema PATH. |
Se viene rilevato un Zabbix agent esistente, verranno visualizzati i valori dei parametri dal relativo file di configurazione. Inoltre, il file di configurazione esistente verrà rinominato durante l'installazione e ne verrà creato uno nuovo.
5. Configurare i parametri PSK se nel passaggio precedente è stata selezionata la casella di controllo Enable PSK. Anche questi parametri verranno impostati nel file di configurazione di Zabbix agent:
| Parameter | Description |
|---|---|
| Pre-shared key identity | La stringa di identità della chiave precondivisa. Imposta il parametro TLSPSKIdentity. |
| Pre-shared key value | Il valore stringa della chiave precondivisa. Crea il file psk.key contenente la chiave e imposta il parametro TLSPSKFile sul percorso della chiave (predefinito: C:\Program Files\Zabbix Agent\psk.key). Si consiglia di limitare l'accesso al file della chiave precondivisa modificando le impostazioni di sicurezza del file in modo che solo Zabbix agent (o l'utente che esegue l'agent) possa leggerlo. |
6. Fare clic su Install per avviare l'installazione.
Tutti i componenti Zabbix selezionati e il file di configurazione di Zabbix agent verranno installati nel percorso specificato (predefinito: C:\Program Files\Zabbix Agent).
Lo stesso vale per Zabbix agent 2, tranne per il fatto che i file di configurazione aggiuntivi per i suoi plugin integrati verranno installati nella sottocartella zabbix_agent2.d\plugins.d.
Inoltre, zabbix_agentd.exe (o zabbix_agent2.exe) verrà configurato come servizio Windows con avvio automatico ritardato (oppure avvio automatico nelle versioni di Windows precedenti a Windows Vista/Server 2008).
Se durante l'installazione è in esecuzione una versione diversa di Zabbix agent, verrà richiesto di scegliere se chiudere l'applicazione e provare a riavviarla oppure lasciarla aperta, nel qual caso sarà necessario riavviare il sistema.
7. Fare clic sul pulsante Finish per uscire dal Setup Wizard.
Installazione dalla riga di comando
Zabbix agent può essere installato dalla riga di comando eseguendo il programma di installazione MSI con msiexec. Ad esempio:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0Questo metodo consente installazioni non assistite e configurazioni personalizzate tramite parametri.
Parametri supportati
I pacchetti di installazione MSI di Zabbix agent supportano i seguenti parametri sia per Zabbix agent sia per Zabbix agent 2.
I parametri di Zabbix agent/agent2 vengono impostati nel file di configurazione durante l'installazione. Fare clic sul nome di un parametro per visualizzarne la descrizione dettagliata e gli esempi di configurazione nella pagina Zabbix agent (Windows). Per Zabbix agent 2, fare riferimento alla pagina Zabbix agent 2 (Windows).
| Parametro | Descrizione |
|---|---|
| ADDDEFAULT | Un elenco di componenti separati da virgole da installare nella loro configurazione predefinita. Per ulteriori informazioni, vedere proprietà ADDDEFAULT. Valori possibili: AgentProgram, GetProgram, SenderProgram, ALLEsempio: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Un elenco di componenti separati da virgole da installare localmente. Per ulteriori informazioni, vedere proprietà ADDLOCAL. Valori possibili: AgentProgram, GetProgram, SenderProgram, ALLEsempio: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Un elenco di parametri AllowKey o DenyKey separati da punto e virgola per limitare i controlli di Zabbix agent. Se necessario, usare una barra rovesciata per eseguire l'escape del delimitatore (\;). Imposta i parametri AllowKey e DenyKey nel file di configurazione dell'agent.Esempio: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]" |
| CONF | Il percorso completo di un file di configurazione template per Zabbix agent. Durante l'installazione, questo file diventerà il file di configurazione dell'agent. Il file deve contenere almeno i parametri Server e LogFile. Esempio: CONF="C:\full\path\to\example.conf" |
| DONOTSTART | Usare DONOTSTART=1 per impedire al programma di installazione MSI di avviare il servizio Zabbix agent. |
| ENABLEPATH | Usare ENABLEPATH=1 per aggiungere il percorso di Zabbix agent alla variabile PATH di sistema. |
| ENABLEPERSISTENTBUFFER | Solo Zabbix agent 2. Abilita l'uso dell'archiviazione persistente locale per gli item attivi. |
| HOSTINTERFACE | Parametro facoltativo che definisce l'interfaccia host. |
| HOSTMETADATA | Parametro facoltativo che definisce i metadati dell'host. |
| HOSTMETADATAITEM | Parametro facoltativo che definisce un item usato per ottenere i metadati dell'host. |
| HOSTNAME | Parametro facoltativo che definisce il nome host. |
| HOSTNAMEITEM | Parametro facoltativo che definisce un item usato per ottenere il nome host. |
| INCLUDE | Un elenco di singoli file separati da punto e virgola oppure di tutti i file in una directory da includere nel file di configurazione di Zabbix agent. |
| INSTALLFOLDER | Il percorso completo di una cartella in cui verranno installati i componenti Zabbix e il file di configurazione di Zabbix agent. Per Zabbix agent 2, i file di configurazione aggiuntivi per i plugin integrati verranno installati nella sottocartella zabbix_agent2.d\plugins.d.Esempio: INSTALLFOLDER="C:\Program Files\Zabbix Agent" |
| LISTENIP | Un elenco di indirizzi IP separati da virgole sui quali l'agent deve restare in ascolto. |
| LISTENPORT | L'agent resterà in ascolto su questa porta per le connessioni dal server. |
| LOGFILE | Il nome del file di log di Zabbix agent. |
| LOGTYPE | Il tipo di output del log. |
| NONMSICONFNAME | Il percorso completo di un file di configurazione personalizzato per Zabbix agent. Durante l'installazione, tutti i parametri di configurazione validi dell'agent presenti in questo file (limitati a quelli elencati in questa tabella) verranno scritti nel file di configurazione dell'agent appena creato. Il file deve contenere almeno il parametro Server. Esempio: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Solo Zabbix agent 2. Il file in cui Zabbix agent 2 deve mantenere il database SQLite. |
| PERSISTENTBUFFERPERIOD | Solo Zabbix agent 2. Il periodo di tempo per cui i dati devono essere conservati quando non c'è connessione al server o al proxy. |
| SERVER | Un elenco di indirizzi IP separati da virgole, facoltativamente in notazione CIDR, oppure nomi DNS di server Zabbix o proxy Zabbix. Questo parametro è obbligatorio, tranne quando STARTAGENTS è impostato su 0. |
| SERVERACTIVE | L'indirizzo del server/proxy Zabbix o la configurazione del cluster da cui ottenere i controlli attivi. |
| SKIP | Usare SKIP=fw per impedire al programma di installazione MSI di aggiungere una regola di eccezione nel Windows Firewall per Zabbix agent. |
| SOURCEIP | L'indirizzo IP sorgente per le connessioni in uscita verso server Zabbix o proxy Zabbix, oppure per effettuare connessioni durante l'esecuzione di alcuni item (web.page.get, net.tcp.port, ecc.). |
| STARTAGENTS | Il numero di istanze pre-fork di zabbix_agentd che elaborano i controlli passivi. Se impostato su 0, i controlli passivi sono disabilitati e l'agent non resterà in ascolto su alcuna porta TCP. |
| STARTUPTYPE | Tipo di avvio del servizio Zabbix agent. Valori possibili: automatic - avvia il servizio automaticamente all'avvio di Windows; delayed - (predefinito) ritarda l'avvio del servizio dopo che i servizi avviati automaticamente hanno completato l'avvio (disponibile in Windows Vista/Server 2008 e versioni successive); manual - avvia il servizio manualmente (da un utente o da un'applicazione); disabled - disabilita il servizio in modo che non possa essere avviato da un utente o da un'applicazione. Esempio: STARTUPTYPE=disabled |
| STATUSPORT | Solo Zabbix agent 2. Se impostato, l'agent resterà in ascolto su questa porta per richieste di stato HTTP (http://localhost:<port>/status). |
| TIMEOUT | Specifica per quanto tempo attendere (in secondi) per stabilire la connessione e scambiare dati con proxy o server Zabbix. |
| TLSACCEPT | Le connessioni in ingresso da accettare (usato per i controlli passivi). Se impostato su psk, anche TLSCONNECT verrà impostato su psk (se non specificato diversamente). |
| TLSCAFILE | Il percorso completo di un file contenente i certificati della CA di livello superiore per la verifica del certificato del peer. |
| TLSCERTFILE | Il percorso completo di un file contenente il certificato dell'agent o la catena di certificati. |
| TLSCONNECT | Come l'agent deve connettersi al server o proxy Zabbix (usato per i controlli attivi). Se impostato su psk, anche TLSACCEPT verrà impostato su psk (se non specificato diversamente). |
| TLSCRLFILE | Il percorso completo di un file contenente certificati revocati. |
| TLSKEYFILE | Il percorso completo di un file contenente la chiave privata di Zabbix agent. |
| TLSPSKFILE | Il percorso completo di un file contenente la chiave precondivisa di Zabbix agent. Se sono impostati sia TLSPSKFILE sia TLSPSKVALUE, il valore di TLSPSKVALUE verrà scritto nel file specificato in TLSPSKFILE. Si consiglia di limitare l'accesso al file della chiave precondivisa regolando le impostazioni di sicurezza del file in modo che solo Zabbix agent (o l'utente che esegue l'agent) possa leggerlo. |
| TLSPSKIDENTITY | La stringa identificativa della chiave precondivisa. |
| TLSPSKVALUE | Il valore stringa della chiave precondivisa. Se sono impostati sia TLSPSKFILE sia TLSPSKVALUE, il valore di TLSPSKVALUE verrà scritto nel file specificato in TLSPSKFILE. Esempio: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | L'emittente del certificato del server (proxy) consentito. |
| TLSSERVERCERTSUBJECT | Il soggetto del certificato del server (proxy) consentito. |
| UNSAFEUSERPARAMETERS | Consente di passare tutti i caratteri negli argomenti ai parametri definiti dall'utente. |
Esempi
L'esempio seguente installa Zabbix agent con una configurazione personalizzata. Abilita inoltre il supporto TLS utilizzando chiavi precondivise.
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[*]"L'esempio successivo installa una versione più recente di Zabbix agent e utilizza un file di configurazione template (CONF="C:\agent-template.conf").
Durante l'installazione, questo file diventerà il file di configurazione dell'agent.
Per ereditare i parametri dal vecchio file di configurazione, utilizzare i segnaposto dei parametri (ad esempio, [AllowDenyKey]).
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"
# Esempio di agent-template.conf:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]In alternativa, è possibile utilizzare un file di configurazione personalizzato (NONMSICONFNAME="C:\agent-custom.conf").
Durante l'installazione, tutti i parametri di configurazione validi dell'agent presenti in questo file (limitati a quelli elencati nella tabella sopra) verranno scritti nel file di configurazione dell'agent appena creato.
Per mantenere la configurazione esistente dell'agent, definire i parametri da preservare.
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"
# Esempio di agent-custom.conf:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2BPlugin caricabili di Zabbix agent 2
I plugin caricabili di Zabbix agent 2 possono essere installati su Windows utilizzando pacchetti di installazione MSI a 64 bit, disponibili per il download.
I requisiti minimi del sistema operativo per l'installazione tramite MSI sono Windows 10 (64 bit) o Windows Server 2016.
Prima di installare un plugin, controlla il relativo file README. Potrebbe contenere requisiti specifici e istruzioni di installazione.
Analogamente a Zabbix agent/agent2, i plugin caricabili possono essere installati utilizzando la procedura guidata di installazione o la riga di comando.
Installazione tramite Setup Wizard
1. Fare doppio clic sul file MSI scaricato per avviare l'installazione.
2. Accettare il Contratto di licenza con l'utente finale.
3. Selezionare i plugin caricabili di Zabbix agent 2 da installare.
Si consiglia di utilizzare il percorso di installazione predefinito fornito dal programma di installazione. L'utilizzo di un percorso personalizzato senza le autorizzazioni necessarie può compromettere la sicurezza dell'installazione.
4. Fare clic su Install per avviare l'installazione.
Tutti i plugin caricabili di Zabbix agent 2 selezionati verranno installati nel percorso specificato (predefinito: C:\Program Files\Zabbix Agent 2), con i relativi file di configurazione installati nella sottocartella zabbix_agent2.d.
5. Fare clic sul pulsante Finish per uscire dal Setup Wizard.
Installazione dalla riga di comando
I plugin caricabili di Zabbix agent 2 possono essere installati dalla riga di comando eseguendo il programma di installazione MSI con msiexec. Ad esempio:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-8.0.0-windows-amd64.msi" /qn+I pacchetti del programma di installazione MSI dei plugin caricabili di Zabbix agent 2 supportano i seguenti parametri.
| Parameter | Description |
|---|---|
| ADDDEFAULT | Un elenco di componenti separati da virgole da installare nella loro configurazione predefinita. Per ulteriori informazioni, vedere proprietà ADDDEFAULT. Valori possibili: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginEsempio: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Un elenco di componenti separati da virgole da installare localmente. Per ulteriori informazioni, vedere proprietà ADDLOCAL. Valori possibili: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginEsempio: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Il percorso completo di una cartella in cui verranno installati i componenti Zabbix, con i relativi file di configurazione installati nella sottocartella zabbix_agent2.d.Esempio: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |