Installing and configuring Zabbix can happen without a hiccup for one user and with a constant stream of problems for another. The reasons for the problems can differ from user to user - buggy libraries, bad distribution packaging, unintuitive configuration in Zabbix, or maybe even an occasional bug in Zabbix itself. Here we will look at common problems new users experience when performing various tasks:
There are several common stumbling blocks in the installation process that are sometimes caused by well hidden factors.
Q: I am trying to compile Zabbix on a 64-bit distribution. I have the corresponding development packages installed, but Zabbix claims they are not present.
A: Double check that development packages are installed for the correct architecture.
Q: I am trying to compile Zabbix on CentOS/RedHat. I have curl development packages installed for the correct architecture, but Zabbix complains about them being missing.
A: On some CentOS/RedHat versions such an error can be because one or more of the following development packages are also required:
e2fsprogs-devel
krb5-devel
libgssapi-devel
Q: I am trying to compile Zabbix on SLES, but Zabbix complains about a missing Net-SNMP development library, even though it is installed.
A: There are two possible solutions, depending on SLES version:
Install the package named
tcpd-devel
Run export
CFLAGS=-lssl
beforeconfigure
Q: I am trying to compile Zabbix on CentOS/RedHat, but Zabbix complains about a missing Net-SNMP development library, even though it is installed.
A: Install the package named
openssl-devel
.Q: Compilation fails with:
/usr/bin/ld: cannot find -lc
A: Install the package named
glibc-devel
.Q: I am trying to compile Zabbix from svn, but the
configure
script fails with an error:
syntax error near unexpected token `IKSEMEL,iksemel,'
A: Install the
pkg-config
package and re-run the commands to generate theconfigure
script.Q: I am trying to compile Zabbix, but it fails.
A: It is useful to reduce the number of possible causes. Verify that you are not compiling with
--enable-static
that is known to cause compilation problems. If compilation fails without that flag, checkconfig.log
file contents in the source directory. It often contains exact error details.
Q: I have installed the Zabbix frontend. What's the default username and password?
A: The username is
admin
, and the password iszabbix
.Q: I have installed the frontend, but it says at the top of the page "This file is a place-holder.", along with other text.
A: This is a Fedora/EPEL packages specific problem - remove
conf/zabbix.conf.php
and regenerate it with the installation wizard, or copyzabbix.conf.php.example
tozabbix.conf.php
and edit it manually.
Q: I am attempting to start the Zabbix server or agent daemon, but it fails, mentioning semaphores. What's wrong?
A: This usually happens if you have attempted to start an older version of Zabbix daemon previously. Rebooting the server helps, but is often too drastic - you can list semaphores and shared memory segments with command
ipcs
. With all Zabbix services stopped, you can remove Zabbix-related structures withipcrm
. Consult the documentation for these commands for more details.