21/04/13

5. Zabbix appliance [Zabbix]

Contact Us | Customer Login Zabbix documentation Zabbix 1.8 Zabbix 2.0 contrib Zabbix manpages Zabbix Manual 1. Introduction 2. Zabbix concepts 3. Installation 4. Quickstart 5. Zabbix appliance 6. Configuration 7. IT services 8. Web monitoring 9. Maintenance 10. Regular expressions 11. Event acknowledgment 12. Configuration export/import 13. Discovery 14. Distributed monitoring 15. Web interface 16. Appendixes Zabbix API Zabbix 2.2 Zabbix documentation in French Zabbix documentation in Japanese Zabbix documentation in Portuguese Zabbix documentation in Russian

5. Zabbix appliance
As an alternative to setting up manually or reusing existing server for Zabbix, users may download Zabbix appliance [http://www.zabbix.com/download.php#appliance]. To get started, boot the appliance and point your browser at the IP it has received over DHCP.

https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance

1/8

21/04/13

5. Zabbix appliance [Zabbix]

Booting Zabbix appliance

Zabbix appliance versions are based upon the following OpenSUSE versions:
Zabbix appliance version OpenSUSE version 2.0.0 2.0.2 2.0.3 2.0.4 12.2* 12.1

* Initial 2.0.4 appliance builds were with OpenSUSE 12.1, final builds are with OpenSUSE 12.2. It is available in the following formats: vmdk (VMWare/Virtualbox); OVF (Open Virtualisation Format); CD iso; HDD/flash image; Preload ISO [http://blog.susestudio.com/2010/10/new-preload-iso-build-format.html]; Xen guest. It has Zabbix server configured and running on MySQL, as well as frontend available. The appliance has been built using SUSE Studio [http://susestudio.com].

1 Changes to SUSE configuration

There are some changed applied to the base OpenSUSE configuration. 1.1 MySQL configuration changes Binary log is disabled; InnoDB is configured to store data for each table in a separate file. 1.2 Using a static IP address By default the appliance uses DHCP to obtain IP address. To specify a static IP address: Log in as root user; Open file /etc/sysconfig/network/ifcfg-eth0 in your favourite editor;
https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance 2/8

21/04/13

5. Zabbix appliance [Zabbix]

Set BOOTPROTO variable to static; Set IPADDR, NETMASK and any other parameters as required for your network; Create file /etc/sysconfig/network/routes. For the default route, use default 192.168.1.1 - (replacing with your gateway address). Run the command rcnetwork restart. To configure DNS, add nameserver entries in /etc/resolv.conf , specifying each nameserver on its own line: nameserver 192.168.1.2. Alternatively, just use yast configuration utility to update network settings. 1.3 Changing time zone By default the appliance uses UTC for the system clock. To change the time zone, copy appropriate file from /usr/share/zoneinfo to /etc/localtime, for example:
c p/ u s r / s h a r e / z o n e i n f o / E u r o p e / R i g a/ e t c / l o c a l t i m e

1.4 Other changes Network is configured to use DHCP to obtain IP address; Utility fping is set to have permissions 4710 and is owned by group zabbix - suid and only alowed to be used by zabbix group; ntpd configured to synchronise to the public pool servers; Various basic utilities have been added that could make working with Zabbix and monitoring in general easier.

2 Zabbix configuration
Appliance Zabbix setup has the following passwords and other configuration changes: 2.1 Passwords System: root:zabbix zabbix:zabbix Database: root:zabbix zabbix:zabbix Zabbix frontend: admin:zabbix If you change frontend password, do not forget to update password setting web monitoring (Configuration WEB). To change the database user password it has to be changed in the following locations: MySQL; zabbix_server.conf; zabbix.conf.php. 2.2 File locations
https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance 3/8

21/04/13

5. Zabbix appliance [Zabbix]

Configuration files are placed in /etc. Zabbix logfiles are placed in /var/log/zabbix. Zabbix frontend is placed in /usr/share/zabbix. Home directory for user zabbix is /var/lib/zabbix. 2.3 Changes to Zabbix configuration Server name for Zabbix frontend set to Zabbix 2.0 Appliance; Frontend timezone is set to Europe/Riga, Zabbix home (this can be modified in /etc/php5/apache2/php.ini); Disabled triggers and web scenarios are shown by default to reduce confusion. 2.4 Preserving configuration If you are running live CD version of the appliance or for some other reason can't have persistent storage, you can create a backup of whole database, including all configuration and gathered data. To create the backup, run:
m y s q l d u m pz a b b i x|b z i p 29>d b d u m p . b z 2

Now you can transfer file dbdump.bz2 to another machine. To restore from the backup, transfer it to the appliance and execute:
b z c a td b d u m p . b z 2|m y s q lz a b b i x

Make sure that Zabbix server is stopped while performing the restore.

3 Frontend access
Access to frontend by default is allowed from: 127.0.0.1 192.168.0.0/16 10.0.0.0/8 ::1 Root (/) is redirected to /zabbix on the webserver, thus frontend can be accessed both as http://<host> and http://<host>/zabbix. This can be customised in /etc/apache2/conf.d/zabbix.conf. You have to restart webserver after modifying this file. To do so, log in using SSH as root user and execute:
s e r v i c ea p a c h e 2r e s t a r t

4 Firewall
By default, only two ports are open - 22 (SSH) and 80 (HTTP). To open additional ports - for example, Zabbix server and agent ports - modify iptables rules with SuSEfirewall2 utility:
S u S E f i r e w a l l 2o p e nE X TT C Pz a b b i x t r a p p e rz a b b i x a g e n t

Then reload the firewall rules:

S u S E f i r e w a l l 2s t o p S u S E f i r e w a l l 2s t a r t
https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance 4/8

21/04/13

5. Zabbix appliance [Zabbix]

5 Monitoring capabilities
Zabbix server is compiled with support for the following: SNMP; IPMI; Web monitoring; SSH2; IPv6. In the provided configuration Zabbix server itself is monitored with the help of locally installed agent for some base parameters, additionally Zabbix frontend is monitored as well using web monitoring.

https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance

5/8

21/04/13

5. Zabbix appliance [Zabbix]

Zabbix appliance monitoring own web frontend

Note that web frontend monitoring logs in - this can add lots of entries to the audit log.

6 Naming, init and other scripts

Appropriate init scripts are provided. To control Zabbix server, use any of these:
s e r v i c ez a b b i x _ s e r v e rs t a t u s r c z a b b i x _ s e r v e rs t a t u s / e t c / i n i t . d / z a b b i x _ s e r v e rs t a t u s

Replace server with agentd for Zabbix agent daemon. 6.1 Scheduled scripts There is a scheduled script, run from the crontab every 10 minutes that restarts Zabbix server if it is not running, /var/lib/zabbix/bin. It logs timestamped problems and starting attempts at /var/log/zabbix/server_problems.log. Make sure to disable this crontab entry if stopping of Zabbix server is desired. 6.2 Increasing available diskspace Create a backup of all data before attempting any of the steps. 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 virtualisation environment, then follow these steps. Start fdisk to change the partition size. As root , execute:
f d i s k/ d e v / s d a

This will start fdisk on disk sda. Next, switch to sectors by issuing:
u

Don't disable DOS compatibility mode by entering c. Proceeding with it disabled will damage the partition. Then delete the existing partition and create new one with desired size. In majority of cases you will accept the available maximum, which will expand the filesystem to whatever size you made available for the virtual disk. To do so, enter the following sequence in fdisk prompt:
d n p 1 ( a c c e p td e f a u l t6 3 ) ( a c c e p td e f a u l tm a x )

If you wish to leave some space for additional partitions (swap etc), you can enter another value for last sector . When done, save the changes by issuing:
w

Reboot the virtual machine (as the partition we modified is in use currently). After reboot, filesystem resizing
https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance 6/8

21/04/13

5. Zabbix appliance [Zabbix]

can take place.

r e s i z e 2 f s/ d e v / s d a 1

That's it, filesystem should be grown to the partition size now.

7 Format-specific notes
7.1 Xen To use images in Xen server, run:
x mc r e a t ecf i l e w i t h s u f f i x . x e n c o n f i g

See the following pages for more information on using Xen images: http://en.opensuse.org/openSUSE:How_to_use_downloaded_SUSE_Studio_appliances#Using_Xen_guests
[http://en.opensuse.org/openSUSE:How_to_use_downloaded_SUSE_Studio_appliances#Using_Xen_guests]

http://old-en.opensuse.org/SUSE_Studio_Xen_Howtos
en.opensuse.org/SUSE_Studio_Xen_Howtos]

[http://old-

Converting image for XenServer To use Xen images with Citrix Xenserver you have to convert the disk image. To do so: Create a virtual disk which is at least as large as the image Find out the UUID for this disk
x ev d i l i s tp a r a m s = a l l

If there are lots of disks, they can be filtered by name parameter name-label, as assigned when creating the virtual disk Import the image
x ev d i i m p o r tf i l e n a m e = " i m a g e . r a w "u u i d = " < U U I D > "

Instructions from Brian Radford blog [http://radfordbw.squidpower.com/2009/10/16/convert-xen-oss-hypervisor-toxenserver/]. 7.2 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 converter [http://www.vmware.com/products/converter/]. 7.3 HDD/flash image (raw) See http://en.opensuse.org/openSUSE:SUSE_Studio_Disc_Image_Howtos
[http://en.opensuse.org/openSUSE:SUSE_Studio_Disc_Image_Howtos] for more information on disk images.

8 Known issues
8.1 Extracting on Windows Windows archive management software is known to mishandle the appliance archives. If extraction fails, try different software. Open source tool 7-zip [http://www.7-zip.org/] might work.

https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance

7/8

21/04/13

5. Zabbix appliance [Zabbix]

8.2 For the 2.0.0 appliance Web monitoring is not preconfigured. Locales other than English do not work. To enable other locales, run the following commands:
/ u s r / s h a r e / z a b b i x / l o c a l e / m a k e _ m o . s h r c a p a c h e 2r e s t a r t

Static it.

IP

address

might

not

work

because

of

systemd

problem

[https://bugzilla.novell.com/show_bug.cgi?id=727771]. Updating the system with zypper up should solve

8.3 For the 2.0.2 appliance Web monitoring is not preconfigured. Locales other than English do not work. See 2.0.0 notes for solution. 8.4 For the 2.0.4 appliance SSH daemon could not be started in the initial appliance builds. Please download latest builds (post2013.01.27). Web monitoring is not preconfigured.

2 .0 /manual/applianc e.txt L as t modified: 2 0 1 3 /0 2 /0 1 1 1 :0 1 by ric hlv

Except where otherwise noted, content on this wiki is licensed under the following license:CC AttributionNoncommercial-Share Alike 3.0 Unported [http://creativecommons.org/licenses/by-nc-sa/3.0/]

https://www.zabbix.com/documentation/doku.php?id=2.0/manual/appliance

8/8