en	# 6 Zabbix appliance

en	#### Overview Zabbix appliance provides a way to instantly deploy Zabbix server and frontend, instead of setting them up manually or reusing an existing server for Zabbix. The appliance is based on AlmaLinux 8 (x86\_64) and contains a pre-configured Zabbix server running on MySQL and frontend running on Nginx web server. ::: noteimportant This appliance is designed for evaluating Zabbix. Using it in serious production environments is discouraged. ::: Appliance images are available for [download](http://www.zabbix.com/download_appliance) in the following formats: - Installation CD/DVD (.iso) - VMware (.vmx) - see [notes](#vmware) - Open virtualization format (.ovf) - Microsoft Hyper-V (.vhd/.vhdx) - see [notes](#hyper-v) - KVM, Parallels, QEMU, USB stick, VirtualBox, Xen (.raw) - see [notes](#hddflash-image-raw) - KVM, QEMU (.qcow2) Zabbix installation CD/DVD boot menu: ![](../../assets/en/manual/installation_cd_boot_menu1.png){width="600"}
pt-br	#### Visão geral O appliance Zabbix fornece uma maneira de implantar instantaneamente o Zabbix server e o frontend, em vez de configurá-los manualmente ou reutilizar um servidor existente para o Zabbix. O appliance é baseado no AlmaLinux 8 (x86\_64) e contém um Zabbix server pré-configurado rodando no MySQL e o frontend rodando no servidor web Nginx. ::: noteimportant Este appliance foi projetado para avaliação do Zabbix. O uso em ambientes de produção sérios não é recomendado. ::: As imagens do appliance estão disponíveis para [download](http://www.zabbix.com/download_appliance) nos seguintes formatos: - CD/DVD de instalação (.iso) - VMware (.vmx) - veja [notas](#vmware) - Formato de virtualização aberto (.ovf) - Microsoft Hyper-V (.vhd/.vhdx) - veja [notas](#hyper-v) - KVM, Parallels, QEMU, pen drive USB, VirtualBox, Xen (.raw) - veja [notas](#hddflash-image-raw) - KVM, QEMU (.qcow2) Menu de inicialização do CD/DVD de instalação do Zabbix: ![](../../assets/en/manual/installation_cd_boot_menu1.png){width="600"}

en	#### Quick start
pt-br	#### Início rápido

en	##### Pre-requisites 1. Make sure the host machine has sufficient resources to meet the virtual machine's system requirements: - *RAM*: 4 GB - *Disk space*: at least 8 GB should be allocated for the virtual machine - *CPU*: 2 cores minimum 2. If not yet installed, install the virtualization software for booting the appliance image (for example, [VirtualBox](https://www.virtualbox.org)). 3. [Download](https://www.zabbix.com/download_appliance) the appliance in the format supported by your virtualization software. 4. Check network settings to ensure that DHCP is enabled on the host machine.
pt-br	##### Pré-requisitos 1. Certifique-se de que a máquina host possui recursos suficientes para atender aos requisitos de sistema da máquina virtual: - *RAM*: 4 GB - *Espaço em disco*: pelo menos 8 GB devem ser alocados para a máquina virtual - *CPU*: mínimo de 2 núcleos 2. Caso ainda não tenha sido instalado, instale o software de virtualização para inicializar a imagem do appliance (por exemplo, [VirtualBox](https://www.virtualbox.org)). 3. [Baixe](https://www.zabbix.com/download_appliance) o appliance no formato suportado pelo seu software de virtualização. 4. Verifique as configurações de rede para garantir que o DHCP esteja habilitado na máquina host.

en	##### Installation 1. Boot the appliance virtual machine from the downloaded image. 2. Configure virtual machine network settings to allow access from a browser on the host machine. This can be achieved by enabling *Bridged mode*. 3. Log in to the virtual machine using default system [credentials](#system). 4. To retrieve the IP address, run the following command on the virtual machine: ``` ip addr show ``` 5. Open a browser on the host machine and point it to the IP address the appliance has received over DHCP. 6. Log in to Zabbix using default [credentials](#zabbix-frontend) and start monitoring.
pt-br	##### Instalação 1. Inicialize a máquina virtual do appliance a partir da imagem baixada. 2. Configure as configurações de rede da máquina virtual para permitir o acesso a partir de um navegador na máquina host. Isso pode ser feito ativando o *modo Bridge*. 3. Faça login na máquina virtual usando as [credenciais](#system) padrão do sistema. 4. Para obter o endereço IP, execute o seguinte comando na máquina virtual: ``` ip addr show ``` 5. Abra um navegador na máquina host e aponte para o endereço IP que o appliance recebeu via DHCP. 6. Faça login no Zabbix usando as [credenciais](#zabbix-frontend) padrão e comece a monitorar.

en	#### Configuration This section describes frequently required default configuration settings along with available customization options.
pt-br	#### Configuração Esta seção descreve as configurações padrão frequentemente necessárias, juntamente com as opções de personalização disponíveis.

en	##### Credentials ###### System - Username: root - Password: zabbix ###### Zabbix frontend - Username: Admin - Password: zabbix After logging in, you can change default password in the [user profile settings](/manual/web_interface/user_profile#user-profile) or [create new users](/manual/config/users_and_usergroups/user) and delete the default one. ###### Database Passwords for all database users are randomly generated during the installation process. The following users are defined for the database: *Root:* - Username: root - Password: the password is stored in the `/root/.my.cnf` file. It is not required to input a password under the root account. *Zabbix server:* - Username: zabbix_srv - Password: the password is stored in the `/etc/zabbix/zabbix\_server.conf` *Zabbix frontend:* - Username: zabbix_web - Password: the password is stored in the `/etc/zabbix/web/zabbix.conf.php` To change a database user password, modify it in MySQL and the corresponding configuration file.
pt-br	##### Credenciais ###### Sistema - Nome de usuário: root - Senha: zabbix ###### Frontend do Zabbix - Nome de usuário: Admin - Senha: zabbix Após o login, você pode alterar a senha padrão nas [configurações do perfil do usuário](/manual/web_interface/user_profile#user-profile) ou [criar novos usuários](/manual/config/users_and_usergroups/user) e excluir o padrão. ###### Banco de dados As senhas para todos os usuários do banco de dados são geradas aleatoriamente durante o processo de instalação. Os seguintes usuários são definidos para o banco de dados: *Root:* - Nome de usuário: root - Senha: a senha é armazenada no arquivo `/root/.my.cnf`. Não é necessário inserir uma senha na conta root. *Servidor Zabbix:* - Nome de usuário: zabbix_srv - Senha: a senha é armazenada no arquivo `/etc/zabbix/zabbix\_server.conf` *Frontend do Zabbix:* - Nome de usuário: zabbix_web - Senha: a senha é armazenada no arquivo `/etc/zabbix/web/zabbix.conf.php` Para alterar a senha de um usuário do banco de dados, modifique-a no MySQL e no arquivo de configuração correspondente.

en	##### Frontend access Zabbix frontend can be accessed at *http://<virtual machine's IP>*. By default, access is allowed from anywhere. To limit the access, modify `/etc/nginx/conf.d/zabbix.conf`. After saving the edited file, restart Nginx by logging in via SSH as [root user](#system) and executing: ``` systemctl restart nginx ```
pt-br	##### Acesso ao frontend O frontend do Zabbix pode ser acessado em *http://<IP da máquina virtual>*. Por padrão, o acesso é permitido de qualquer lugar. Para limitar o acesso, modifique o arquivo `/etc/nginx/conf.d/zabbix.conf`. Após salvar o arquivo editado, reinicie o Nginx conectando-se via SSH como [usuário root](#system) e executando: ``` systemctl restart nginx ```

en	##### Static IP address By default, the appliance uses DHCP to obtain the IP address. To set a static IP address: - Log in as [root user](#system). - Run the following commands, replacing values with your custom IP addresses: ``` 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 ``` Alternatively, you can open the file `/etc/NetworkManager/system-connections/eth0.nmconnection` and add the following lines: ``` [ipv4] address1=192.168.1.10/24,192.168.1.1 dns=8.8.8.8 method=manual ``` After saving the edited file, run the command `systemctl restart network`.
pt-br	##### Endereço IP estático Por padrão, o appliance usa DHCP para obter o endereço IP. Para definir um endereço IP estático: - Faça login como [usuário root](#system). - Execute os seguintes comandos, substituindo os valores pelos endereços IP personalizados: ``` nmcli connection modify eth0 ipv4.addresses 192.168.1.10/24 # Endereço IP do appliance/prefixo CIDR nmcli connection modify eth0 ipv4.gateway 192.168.1.1 # Endereço IP do gateway nmcli connection modify eth0 ipv4.dns 8.8.8.8 # Endereço IP do servidor DNS nmcli connection modify eth0 ipv4.method manual systemctl restart network ``` Como alternativa, você pode abrir o arquivo `/etc/NetworkManager/system-connections/eth0.nmconnection` e adicionar as seguintes linhas: ``` [ipv4] address1=192.168.1.10/24,192.168.1.1 dns=8.8.8.8 method=manual ``` Após salvar o arquivo editado, execute o comando `systemctl restart network`.

en	##### Firewall configuration To manage firewall settings, the appliance uses iptables with predefined rules: - Open SSH port (22 TCP) - Open Zabbix agent (10050 TCP) and Zabbix trapper (10051 TCP) ports - Open HTTP (80 TCP) and HTTPS (443 TCP) ports - Open SNMP trap port (162 UDP) - Open outgoing connections to NTP port (123 UDP) - Limit ICMP packets to 5 packets per second - Drop all other incoming connections To open additional ports, modify `/etc/sysconfig/iptables` file and reload firewall rules: ``` systemctl reload iptables ```
pt-br	##### Configuração do firewall Para gerenciar as configurações do firewall, o appliance usa o iptables com regras predefinidas: - Abrir a porta SSH (22 TCP) - Abrir as portas do agent Zabbix (10050 TCP) e do trapper Zabbix (10051 TCP) - Abrir as portas HTTP (80 TCP) e HTTPS (443 TCP) - Abrir a porta SNMP trap (162 UDP) - Abrir conexões de saída para a porta NTP (123 UDP) - Limitar pacotes ICMP a 5 pacotes por segundo - Bloquear todas as outras conexões de entrada Para abrir portas adicionais, modifique o arquivo `/etc/sysconfig/iptables` e recarregue as regras do firewall: ``` systemctl reload iptables ```

en	##### Repositories Zabbix appliance uses *zabbix-release* package from the Zabbix [repository](https://repo.zabbix.com/zabbix/7.4/release/alma/8/). Repositories are configured in `/etc/yum.repos.d/*` directory.
pt-br	##### Repositórios O appliance Zabbix utiliza o pacote *zabbix-release* do [repositório](https://repo.zabbix.com/zabbix/7.4/release/alma/8/) do Zabbix. Os repositórios são configurados no diretório `/etc/yum.repos.d/*`.

en	##### Time zone By default, the appliance uses UTC for the system clock. To change the time zone, copy the appropriate file from `/usr/share/zoneinfo` to `/etc/localtime`, for example: ``` cp /usr/share/zoneinfo/Europe/Riga /etc/localtime ``` :::noteclassic Zabbix [frontend time zone](/manual/web_interface/time_zone) is set separately and can be changed in the frontend settings. The default time zone for Zabbix frontend is Europe/Riga. :::
pt-br	##### Fuso horário Por padrão, o appliance usa UTC para o relógio do sistema. Para alterar o fuso horário, copie o arquivo apropriado de `/usr/share/zoneinfo` para `/etc/localtime`, por exemplo: ``` cp /usr/share/zoneinfo/Europe/Riga /etc/localtime ``` :::noteclassic O [fuso horário do frontend](/manual/web_interface/time_zone) do Zabbix é definido separadamente e pode ser alterado nas configurações do frontend. O fuso horário padrão do frontend do Zabbix é Europe/Riga. :::

en	##### File locations - Configuration files are located in `/etc/zabbix` - Zabbix server, proxy, and agent log files are located in `/var/log/zabbix` - Zabbix frontend is located in `/usr/share/zabbix` - The home directory for *zabbix* user is `/var/lib/zabbix`
pt-br	##### Localização dos arquivos - Os arquivos de configuração estão localizados em `/etc/zabbix` - Os arquivos de log do Zabbix server, proxy e agent estão localizados em `/var/log/zabbix` - O frontend do Zabbix está localizado em `/usr/share/zabbix` - O diretório home do usuário *zabbix* é `/var/lib/zabbix`

en	##### System services Systemd services are available. To see the list of Zabbix services, run the following command on the virtual machine: ``` systemctl list-units zabbix* ```
pt-br	##### Serviços do sistema Serviços systemd estão disponíveis. Para ver a lista de serviços do Zabbix, execute o seguinte comando na máquina virtual: ``` systemctl list-units zabbix* ```

en	#### Image format-specific notes
pt-br	#### Observações específicas do formato de imagem

en	###### VMware The images in *vmdk* format are usable directly in VMware Player, Server, and Workstation products. For use in ESX, ESXi, and vSphere they must be converted using [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) (authentication required for download). If you use VMware vCenter Converter, you may encounter issues with the hybrid network adapter. In that case, you can try specifying the E1000 adapter during the conversion process. Alternatively, after the conversion is complete, you can delete the existing adapter and add an E1000 adapter.
pt-br	###### VMware As imagens no formato *vmdk* podem ser usadas diretamente nos produtos VMware Player, Server e Workstation. Para uso no ESX, ESXi e vSphere, elas devem ser convertidas usando o [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) (autenticação necessária para download). Se você usar o VMware vCenter Converter, pode encontrar problemas com o adaptador de rede híbrido. Nesse caso, você pode tentar especificar o adaptador E1000 durante o processo de conversão. Como alternativa, após a conclusão da conversão, você pode excluir o adaptador existente e adicionar um adaptador E1000.

en	###### HDD/flash image (raw) To boot the image, run: ``` dd if=./zabbix_appliance_7.4.0.raw of=/dev/sdc bs=4k conv=fdatasync ``` Replace `/dev/sdc` with your Flash/HDD disk device path.
pt-br	###### Imagem HDD/flash (raw) Para inicializar a imagem, execute: ``` dd if=./zabbix_appliance_7.4.0.raw of=/dev/sdc bs=4k conv=fdatasync ``` Substitua `/dev/sdc` pelo caminho do seu dispositivo de disco Flash/HDD.

en	###### Hyper-V If the appliance fails to start up in Hyper-V, try pressing **Ctrl+Alt+F2** to switch a TTY session.
pt-br	###### Hyper-V Se o appliance não iniciar no Hyper-V, tente pressionar **Ctrl+Alt+F2** para alternar para uma sessão TTY.

en	#### Troubleshooting If you encounter the error message *Access denied for user 'replace_user'@'localhost' (using password: YES)* while trying to log in to the frontend, it may indicate that the installation is still in progress. ![](../../assets/en/manual/appliance_troubleshoot.png) If the error persists after waiting a few minutes, or if you observe any other unexpected behavior, it likely means that the installation process has not completed successfully. In this case, we recommend deleting the current appliance and redeploying it by following the same installation instructions. This step typically resolves the issue. Note that attempting to manually fix a broken installation is not recommended, as it may lead to further complications.
pt-br	#### Solução de problemas Se você encontrar a mensagem de erro *Access denied for user 'replace_user'@'localhost' (using password: YES)* ao tentar fazer login no frontend, isso pode indicar que a instalação ainda está em andamento. ![](../../assets/en/manual/appliance_troubleshoot.png) Se o erro persistir após aguardar alguns minutos, ou se você observar qualquer outro comportamento inesperado, provavelmente significa que o processo de instalação não foi concluído com sucesso. Nesse caso, recomendamos excluir o appliance atual e implantá-lo novamente seguindo as mesmas instruções de instalação. Essa etapa geralmente resolve o problema. Observe que tentar corrigir manualmente uma instalação com problemas não é recomendado, pois pode levar a complicações adicionais.