This is an old revision of the document!
As an alternative to setting up manually or reusing an existing server for Zabbix, users may download a Zabbix appliance or Zabbix appliance installation CD image.
Zabbix appliance and installation CD versions are based upon the following OS:
|Zabbix appliance version||OS|
Zabbix appliance installation CD can be used for instant deployment of Zabbix server (MySQL).
Zabbix appliance contains a Zabbix server (configured and running on MySQL) and a frontend.
Zabbix virtual appliance is available in the following formats:
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 http://<host_ip> (for access from the host's browser bridged mode should be enabled in the VM network settings).
Ctrl+Alt+F2to switch tty sessions.
The appliance is based on CentOS 8. There are some changes applied to the base CentOS configuration.
Official Zabbix 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
The appliance uses iptables firewall with predefined rules:
By default the appliance uses DHCP to obtain the IP address. To specify a static IP address:
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
Appliance Zabbix setup has the following passwords and other configuration changes:
To change the database user password it has to be changed in the following locations:
zabbix_webare defined for server and frontend respectively.
If you are running a Live CD/DVD version of the appliance or for some other reason cannot have persistent storage, you can create a backup of the whole database, including all configuration and gathered data.
To create the backup, run:
sudo mysqldump zabbix | bzip2 -9 > dbdump.bz2
Now the dbdump.bz2 file can be transferred to another machine.
To restore from the backup, transfer it to the appliance and execute:
bzcat dbdump.bz2 | sudo mysql zabbix
Access to frontend by default is allowed from everywhere.
The frontend can be accessed http://<host>/zabbix.
This can be customised in /etc/apache2/conf-available/zabbix.conf. You have to restart the webserver after modifying this file. To do so, log in using SSH as root user and execute:
service apache2 restart
By default, only the ports listed in changes are open. To open additional ports just modify “/etc/iptables/rules.v4” or “/etc/iptables/rules.v6” files and reload firewall rules:
service iptables-persistent reload
Zabbix installation is provided with the support for the following:
Zabbix appliance uses snmptrapfmt to handle SNMP traps. It is configured to receive all traps from everywhere.
Authentication is not required. To enable authentication, open the /etc/snmp/snmptrapd.conf file and specify required auth settings.
All traps are stored in the /var/log/zabbix/snmptrapfmt.log file. It is rotated by logrotate before reaching 2GB file size.
The appliance Zabbix packages may be upgraded. To do so, run:
sudo apt install --only-upgrade 'zabbix.*'
Appropriate init scripts are provided. To control Zabbix server, use any of these:
service zabbix-server status
Replace server with agent for Zabbix agent daemon or with proxy for Zabbix proxy daemon.
Available diskspace on the appliance might not be sufficient. In that case it is possible to expand the disk. To do so, first expand the block device in your virtualization environment, then follow these steps.
Start fdisk to change the partition size. As root, execute:
This will start fdisk on disk sda. Next, switch to sectors by issuing:
Then delete the existing partition and create a new one with the desired size. In the majority of cases you will accept the available maximum, which will expand the filesystem to the size you made available for the virtual disk. To do so, enter the following sequence in fdisk prompt:
d n p 1 (accept default 63) (accept default max)
If you wish to leave some space for additional partitions (swap etc), enter another value for last sector. When done, save the changes by issuing:
After partition creation (new disk or extended existing) create physical volume:
Check newly created physical volume:
Check available physical volumes. There must be 2 volumes zabbix-vg and newly created:
Extend an existing volume group with the newly created physical volume:
vgextend zabbix-vg /dev/sdb1
Check “zabbix-vg” volume group:
Now extend the logical volume with the free PE space:
lvextend -l +100%FREE /dev/mapper/zabbix--vg-root
Resize the root volume (can be done on a live sysyem):
Reboot the virtual machine (as the modified partition is currently in use). The filesystem should be increased to the partition size. Check “/dev/mapper/zabbix–vg-root” volume:
Converting image for XenServer
To use Xen images with Citrix Xenserver, the disk image has to be converted first. To do so:
xe vdi-list params=all
xe vdi-import filename="image.raw" uuid="<UUID>"
Instructions from Brian Radford blog.
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 converter.
dd if=./zabbix_appliance_4.0.0_x86_64.raw of=/dev/sdc bs=4k conv=fdatasync
Replace /dev/sdc with your Flash/HDD disk device.