manual:appliance

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Previous revision
Last revision Both sides next revision
manual:appliance [2020/04/06 12:20]
manual:appliance [2020/04/07 07:45]
yuriii [7.2 HDD/flash image (raw)]
Line 1: Line 1:
 +====== 6. Zabbix appliance ======
 +
 +=== Overview ===
 +
 +As an alternative to setting up manually or reusing an existing server for Zabbix, users may [[http://​www.zabbix.com/​download_appliance|download]] a Zabbix appliance or a Zabbix appliance installation CD image. ​
 +
 +Zabbix appliance and installation CD versions are based upon the following OS: 
 +^Zabbix appliance version^OS^
 +|4.4 |CentOS 8  |
 +
 +Zabbix appliance installation CD can be used for instant deployment of Zabbix server (MySQL).
 +
 +|{{:​manual:​installation_cd_boot_menu1.png?​600|}}|
 +|Zabbix installation CD/DVD boot menu|
 +Zabbix appliance contains a Zabbix server (configured and running on MySQL) and a frontend.
 +
 +Zabbix virtual appliance is available in the following formats:
 +
 +  * VMWare (.vmx)
 +  * Open virtualization format (.ovf)
 +  * Microsoft Hyper-V 2012 (.vhdx)
 +  * Microsoft Hyper-V 2008 (.vhd)
 +  * KVM, Parallels, QEMU, USB stick, VirtualBox, Xen (.raw)
 +  * KVM, QEMU (.qcow2)
 +
 +To get started, boot the appliance and point a browser at the IP the appliance has received over DHCP. 
 +
 +To get the IP address from inside the virtual machine run:
 +  ip addr show
 +
 +To access Zabbix frontend, go to **<​nowiki>​http://<​host_ip></​nowiki>​** (for access from the host's browser bridged mode should be enabled in the VM network settings). ​
 +
 +<note tip>If the appliance fails to start up in Hyper-V, you may want to press ''​Ctrl+Alt+F2''​ to switch tty sessions.</​note>​
 +=== - Changes to CentOS 8 configuration ===
 +
 +The appliance is based on CentOS 8. There are some changes applied to the base CentOS configuration.
 +
 +== - Repositories ==
 +
 +Official Zabbix [[manual:​installation:​install_from_packages/​rhel_centos|repository]] has been added to ///​etc/​yum.repos.d//:​
 +  [zabbix]
 +  name=Zabbix Official Repository - $basearch
 +  baseurl=http://​repo.zabbix.com/​zabbix/​4.5/​rhel/​8/​$basearch/​
 +  enabled=1
 +  gpgcheck=1
 +  gpgkey=file:///​etc/​pki/​rpm-gpg/​RPM-GPG-KEY-ZABBIX-A14FE591
 +
 +== - Firewall ==
 +
 +The appliance uses iptables firewall with predefined rules:
 +  * Opened SSH port (22 TCP);
 +  * Opened Zabbix agent (10050 TCP) and Zabbix trapper (10051 TCP) ports;
 +  * Opened HTTP (80 TCP) and HTTPS (443 TCP) ports;
 +  * Opened SNMP trap port (162 UDP);
 +  * Opened outgoing connections to NTP port (53 UDP);
 +  * ICMP packets limited to 5 packets per second;
 +  * All other incoming connections are dropped.
 +
 +
 +== - Using a static IP address ==
 +
 +By default the appliance uses DHCP to obtain the IP address. To specify a static IP address:
 +
 +  * Log in as root user;
 +  * Open ///​etc/​sysconfig/​network-scripts/​ifcfg-eth0//​ file;
 +  * Replace //​BOOTPROTO=dhcp//​ with //​BOOTPROTO=none//​
 +  * Add the following lines:
 +    * //​IPADDR=<​IP address of the appliance>//​
 +    * //​PREFIX=<​CIDR prefix>//​
 +    * //​GATEWAY=<​gateway IP address>//​
 +    * //​DNS1=<​DNS server IP address>//​
 +  * Run **systemctl restart network** command.
 +
 +Consult the official Red Hat [[https://​access.redhat.com/​documentation/​en-us/​red_hat_enterprise_linux/​6/​html/​deployment_guide/​s1-networkscripts-interfaces|documentation]] if needed.
 +== - Changing 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
 +
 +
 +
 +
 +=== - Zabbix configuration ===
 +
 +Zabbix appliance setup has the following passwords and configuration changes:
 +
 +== - Credentials (login:​password) ==
 +
 +System:
 +  * root:zabbix
 +
 +Zabbix frontend:
 +  * Admin:​zabbix
 +Database:
 +  * root:<​random>​
 +  * zabbix:<​random>​
 +
 +<​note>​Database passwords are randomly generated during the installation process.\\ Root password is stored inside the /​root/​.my.cnf file. It is not required to input a password under the "​root"​ account.</​note>​
 +
 +To change the database user password, changes have to be made in the following locations:
 +  * MySQL;
 +  * /​etc/​zabbix/​zabbix_server.conf;​
 +  * /​etc/​zabbix/​web/​zabbix.conf.php.
 +
 +<​note>​ Separate users ''​zabbix_srv''​ and ''​zabbix_web''​ are defined for the server and the frontend respectively. </​note>​
 +
 +== - File locations ==
 +
 +  * Configuration files are located in **/​etc/​zabbix**.
 +  * Zabbix server, proxy and agent logfiles are located in **/​var/​log/​zabbix**.
 +  * Zabbix frontend is located in **/​usr/​share/​zabbix**.
 +  * Home directory for the user **zabbix** is **/​var/​lib/​zabbix**.
 +
 +== - Changes to Zabbix configuration ==
 +
 +  * Frontend timezone is set to Europe/Riga (this can be modified in **/​etc/​php-fpm.d/​zabbix.conf**);​
 +
 +
 +=== - Frontend access ===
 +
 +By default, access to the frontend is allowed from anywhere.
 +
 +The frontend can be accessed at //​http:​%%//​%%<​host>//​.
 +
 +This can be customised in **/​etc/​nginx/​conf.d/​zabbix.conf**. Nginx has to be restarted after modifying this file. To do so, log in using SSH as **root** user and execute:
 +
 +  systemctl restart nginx
 +
 +=== - Firewall ===
 +
 +By default, only the ports listed in the [[#​firewall1configuration| configuration changes]] above are open. To open additional ports, modify "///​etc/​sysconfig/​iptables//"​ file and reload firewall rules:
 +
 +  systemctl reload iptables
 +
 +
 +=== - Upgrading ===
 +
 +The Zabbix appliance packages may be upgraded. To do so, run:
 +  dnf update zabbix*
 +
 +=== - System Services ===
 +
 +Systemd services are available:
 +  systemctl list-units zabbix*
 +
 +
 +=== - Format-specific notes ===
 +
 +== - 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 [[http://​www.vmware.com/​products/​converter/​|VMware converter]].
 +== - HDD/flash image (raw) ==
 +
 +  dd if=./​zabbix_appliance_4.4.0.raw of=/dev/sdc bs=4k conv=fdatasync
 +  ​
 +Replace ///​dev/​sdc//​ with your Flash/HDD disk device.