[comment]: # ({8c911baa-8c911baa})
# 6 Zabbix appliance

[comment]: # ({/8c911baa-8c911baa})

[comment]: # ({c057ba97-cfa1a361})
#### Panoramica

L'appliance Zabbix offre un modo per distribuire immediatamente Zabbix server e frontend, invece di configurarli manualmente o di riutilizzare un server esistente per Zabbix. 

L'appliance è basata su AlmaLinux 8 (x86\_64) e contiene un Zabbix server preconfigurato in esecuzione su MySQL e un frontend in esecuzione sul web server Nginx. 

::: noteimportant
Questa appliance è progettata per valutare Zabbix.
Si sconsiglia di utilizzarla in ambienti di produzione critici.
:::

Le immagini dell'appliance sono disponibili per il [download](http://www.zabbix.com/download_appliance) nei seguenti formati:

-   CD/DVD di installazione (.iso)
-   VMware (.vmx) - vedere le [note](#vmware)
-   Open Virtualization Format (.ovf)
-   Microsoft Hyper-V (.vhd/.vhdx) - vedere le [note](#hyper-v)
-   KVM, Parallels, QEMU, chiavetta USB, VirtualBox, Xen (.raw) - vedere le [note](#hddflash-image-raw)
-   KVM, QEMU (.qcow2)

Menu di avvio del CD/DVD di installazione di Zabbix:

![](../../assets/en/manual/installation_cd_boot_menu1.png){width="600"}

[comment]: # ({/c057ba97-cfa1a361})

[comment]: # ({62396ce2-3e0e619d})
#### Avvio rapido

[comment]: # ({/62396ce2-3e0e619d})

[comment]: # ({750fe2fd-b3fd5276})
##### Prerequisiti

1. Assicurarsi che la macchina host disponga di risorse sufficienti per soddisfare i requisiti di sistema della macchina virtuale:

-   *RAM*: 4 GB
-   *Spazio su disco*: devono essere allocati almeno 8 GB per la
    macchina virtuale
-   *CPU*: minimo 2 core 

2. Se non è ancora installato, installare il software di virtualizzazione per avviare l'immagine dell'appliance (ad esempio, [VirtualBox](https://www.virtualbox.org)).

3. [Scaricare](https://www.zabbix.com/download_appliance) l'appliance nel formato supportato dal software di virtualizzazione in uso.

4. Verificare le impostazioni di rete per assicurarsi che DHCP sia abilitato sulla macchina host.

[comment]: # ({/750fe2fd-b3fd5276})

[comment]: # ({721965b7-73b26b19})
##### Installazione 

1. Avviare la macchina virtuale dell'appliance dall'immagine scaricata. 

2. Configurare le impostazioni di rete della macchina virtuale per consentire l'accesso da un browser sulla macchina host.
Questo può essere ottenuto abilitando la *modalità Bridged*.

3. Accedere alla macchina virtuale utilizzando le [credenziali](#system) di sistema predefinite.

4. Per recuperare l'indirizzo IP, eseguire il seguente comando sulla macchina virtuale:

```
ip addr show
```

5. Aprire un browser sulla macchina host e inserirvi l'indirizzo IP che l'appliance ha ricevuto tramite DHCP.

6. Accedere a Zabbix utilizzando le [credenziali](#zabbix-frontend) predefinite e iniziare il monitoraggio.

[comment]: # ({/721965b7-73b26b19})

[comment]: # ({92ae58ac-eb5aa46b})
#### Configurazione

Questa sezione descrive le impostazioni di configurazione predefinite richieste più di frequente, insieme alle opzioni di personalizzazione disponibili.

[comment]: # ({/92ae58ac-eb5aa46b})

[comment]: # ({bced8966-d39b5151})
##### Credenziali

###### Sistema

-   Nome utente: root
-   Password: zabbix

###### Zabbix frontend

-   Nome utente: Admin
-   Password: zabbix

Dopo aver effettuato l'accesso, è possibile modificare la password predefinita nelle [impostazioni del profilo utente](/manual/web_interface/user_profile#user-profile) oppure [creare nuovi utenti](/manual/config/users_and_usergroups/user) ed eliminare quello predefinito. 

###### Database 

Le password per tutti gli utenti del database vengono generate casualmente durante il processo di installazione.
Per il database sono definiti i seguenti utenti:

*Root:* 

- Nome utente: root
- Password: la password è memorizzata nel file `/root/.my.cnf`.
Non è necessario inserire una password con l'account root.

*Zabbix server:*

- Nome utente: zabbix_srv 
- Password: la password è memorizzata in `/etc/zabbix/zabbix\_server.conf`

*Zabbix frontend:*

- Nome utente: zabbix_web 
- Password: la password è memorizzata in `/etc/zabbix/web/zabbix.conf.php`

Per modificare la password di un utente del database, cambiarla in MySQL e nel file di configurazione corrispondente.

[comment]: # ({/bced8966-d39b5151})

[comment]: # ({47f5860f-2c4e4239})
##### Accesso al frontend

È possibile accedere al frontend di Zabbix all'indirizzo *http://<virtual machine's IP>*.

Per impostazione predefinita, l'accesso è consentito da qualsiasi posizione. Per limitarlo, modificare `/etc/nginx/conf.d/zabbix.conf`.
Dopo aver salvato il file modificato, riavviare Nginx accedendo tramite SSH come [utente root](#system) ed eseguendo:

```
systemctl restart nginx
```

[comment]: # ({/47f5860f-2c4e4239})

[comment]: # ({4e5f98e8-b2283a9a})
##### Indirizzo IP statico

Per impostazione predefinita, l'appliance utilizza DHCP per ottenere l'indirizzo IP.
Per impostare un indirizzo IP statico:

-   Accedere come [utente root](#system).
-   Eseguire i seguenti comandi, sostituendo i valori con i propri indirizzi IP personalizzati:

```
nmcli connection modify eth0 ipv4.addresses 192.168.1.10/24    # Appliance IP address/CIDR prefix
nmcli connection modify eth0 ipv4.gateway 192.168.1.1     # Gateway IP address
nmcli connection modify eth0 ipv4.dns 8.8.8.8    # DNS server IP address
nmcli connection modify eth0 ipv4.method manual
systemctl restart network
```

In alternativa, è possibile aprire il file `/etc/NetworkManager/system-connections/eth0.nmconnection` e aggiungere le seguenti righe:

```
[ipv4]
address1=192.168.1.10/24,192.168.1.1
dns=8.8.8.8
method=manual
```

Dopo aver salvato il file modificato, eseguire il comando `systemctl restart network`.

[comment]: # ({/4e5f98e8-b2283a9a})

[comment]: # ({d4b9dae8-589dc798})
##### Configurazione del firewall

Per gestire le impostazioni del firewall, l'appliance utilizza iptables con regole predefinite:

-   Apertura della porta SSH (22 TCP)
-   Apertura delle porte di Zabbix agent (10050 TCP) e Zabbix trapper (10051 TCP)
-   Apertura delle porte HTTP (80 TCP) e HTTPS (443 TCP)
-   Apertura della porta SNMP trap (162 UDP)
-   Apertura delle connessioni in uscita verso la porta NTP (123 UDP)
-   Limitazione dei pacchetti ICMP a 5 pacchetti al secondo
-   Blocco di tutte le altre connessioni in ingresso

Per aprire porte aggiuntive, modificare il file `/etc/sysconfig/iptables` e ricaricare le regole del firewall:

```
systemctl reload iptables
```

[comment]: # ({/d4b9dae8-589dc798})

[comment]: # ({73ed9ac5-193d3b23})
##### Repository

Zabbix appliance utilizza il pacchetto *zabbix-release* dal [repository](https://repo.zabbix.com/zabbix/7.4/release/alma/8/) di Zabbix.
I repository sono configurati nella directory `/etc/yum.repos.d/*`.

[comment]: # ({/73ed9ac5-193d3b23})

[comment]: # ({9f96afb1-acf06935})
##### Fuso orario

Per impostazione predefinita, l'appliance utilizza UTC per l'orologio di sistema.
Per cambiare il fuso orario, copiare il file appropriato da `/usr/share/zoneinfo` a `/etc/localtime`, ad esempio:

```
cp /usr/share/zoneinfo/Europe/Riga /etc/localtime
```

:::noteclassic
Il [fuso orario del frontend](/manual/web_interface/time_zone) di Zabbix è impostato separatamente e può essere modificato nelle impostazioni del frontend.
Il fuso orario predefinito per il frontend di Zabbix è Europe/Riga. 
:::

[comment]: # ({/9f96afb1-acf06935})

[comment]: # ({da362b66-f11ee379})
##### Posizioni dei file

-   I file di configurazione si trovano in `/etc/zabbix`
-   I file di log di Zabbix server, proxy e agent si trovano in `/var/log/zabbix`
-   Zabbix frontend si trova in `/usr/share/zabbix`
-   La directory home dell'utente *zabbix* è `/var/lib/zabbix`

[comment]: # ({/da362b66-f11ee379})

[comment]: # ({6fc05e2c-d167c766})
##### Servizi di sistema

I servizi systemd sono disponibili.
Per visualizzare l'elenco dei servizi Zabbix, eseguire il seguente comando sulla macchina virtuale:

```
systemctl list-units zabbix*
```

[comment]: # ({/6fc05e2c-d167c766})

[comment]: # ({f5387f48-a582d1bf})
#### Note specifiche sul formato dell'immagine

[comment]: # ({/f5387f48-a582d1bf})

[comment]: # ({2fd840aa-a45df55b})
###### VMware

Le immagini in formato *vmdk* sono utilizzabili direttamente nei prodotti VMware Player, Server e Workstation.
Per l'uso in ESX, ESXi e vSphere devono essere convertite utilizzando [VMware vCenter Converter](https://support.broadcom.com/group/ecx/productfiles?subFamily=VMware%20vCenter%20converter&displayGroup=Standard&release=6.6.0&os=&servicePk=203348&language=EN) (autenticazione richiesta per il download).
Se si utilizza VMware vCenter Converter, si potrebbero riscontrare problemi con l'adattatore di rete ibrido.
In tal caso, è possibile provare a specificare l'adattatore E1000 durante il processo di conversione.
In alternativa, una volta completata la conversione, è possibile eliminare l'adattatore esistente e aggiungere un adattatore E1000.

[comment]: # ({/2fd840aa-a45df55b})

[comment]: # ({1ece9a7f-7d1c1440})
###### Immagine HDD/flash (raw)

Per avviare l'immagine, eseguire:

```
dd if=./zabbix_appliance_7.4.0.raw of=/dev/sdc bs=4k conv=fdatasync
```

Sostituire `/dev/sdc` con il percorso del dispositivo del disco Flash/HDD.

[comment]: # ({/1ece9a7f-7d1c1440})

[comment]: # ({201bd994-e4636c3c})
###### Hyper-V

Se l'appliance non riesce ad avviarsi in Hyper-V, provare a premere **Ctrl+Alt+F2** per passare a una sessione TTY.

[comment]: # ({/201bd994-e4636c3c})

[comment]: # ({c4ea6515-58d994da})
#### Risoluzione dei problemi

Se durante il tentativo di accesso al frontend viene visualizzato il messaggio di errore *Access denied for user 'replace_user'@'localhost' (using password: YES)*, ciò potrebbe indicare che l'installazione è ancora in corso.

![](../../assets/en/manual/appliance_troubleshoot.png)

Se l'errore persiste dopo alcuni minuti di attesa, oppure se si osserva qualsiasi altro comportamento imprevisto, è probabile che il processo di installazione non sia stato completato correttamente.
In questo caso, si consiglia di eliminare l'appliance corrente e distribuirla nuovamente seguendo le stesse istruzioni di installazione.
Questo passaggio in genere risolve il problema.

Si noti che non è consigliabile tentare di correggere manualmente un'installazione danneggiata, poiché ciò potrebbe causare ulteriori complicazioni.

[comment]: # ({/c4ea6515-58d994da})
