Create Zabbix database
For Zabbix server and proxy daemons, as well as Zabbix frontend, a database is required. It is not needed to run Zabbix agent.
SQL scripts are provided for creating database schema and inserting the dataset. Zabbix proxy database needs only the
schema while Zabbix server database requires also the dataset on top of the schema.
For example: config mysql
shell> mysql -u<username> -p<password>
mysql> create database zabbix character set utf8 collate utf8_bin;
mysql> quit;
shell> mysql -u<username> -p<password> zabbix < database/mysql/schema.sql
# stop here if you are creating database for Zabbix proxy
shell> mysql -u<username> -p<password> zabbix < database/mysql/images.sql
shell> mysql -u<username> -p<password> zabbix < database/mysql/data.sql
Having created a Zabbix database, proceed to the following steps of compiling Zabbix. Configure the sources
When configuring the sources for a Zabbix server or proxy, you must specify the database type to be used. Only one database type can be compiled with a server or proxy process at a time.
To see all of the supported configuration options, inside the extracted Zabbix source directory run:
#./configure --help
To configure the sources for a Zabbix server and agent, you may run something like:
note: –with-libxml2 configuration option is required for virtual machine monitoring, supported since Zabbix 2.2.0.
To configure the sources for a Zabbix server (with PostgreSQL etc.), you may run:
#./configure --enable-server --with-postgresql --with-net-snmp
To configure the sources for a Zabbix proxy (with SQLite etc.), you may run:
#./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2
To configure the sources for a Zabbix agent, you may run:
#./configure --enable-agent
Make and install everything
#make install
This step should be run as a user with sufficient permissions (commonly ‘root’, or by using sudo).
Running make install will by default install the daemon binaries (zabbix_server, zabbix_agentd, zabbix_proxy) in /usr/local/sbin and the client binaries (zabbix_get, zabbix_sender) in /usr/local/bin.
To specify a different location than /usr/local, use a --prefix key in the previous step of configuring sources, for example --prefix=/home/zabbix. In this case daemon binaries will be installed under /sbin, while utilities under /bin. Man pages will be installed under /share.
Review and edit configuration files
edit the Zabbix agent configuration file /usr/local/etc/zabbix_agentd.conf
You need to configure this file for every host with zabbix_agentd installed.
You must specify the Zabbix server IP address in the file. Connections from other hosts will be denied.
edit the Zabbix server configuration file /usr/local/etc/zabbix_server.conf
You must specify the database name, user and password (if using any).
With SQLite the full path to database file must be specified; DB user and password are not required.
The rest of the parameters will suit you with their defaults if you have a small installation (up to ten monitored hosts). You should change the default parameters if you want to maximize the performance of Zabbix server (or proxy) though. See the performance tuning section for more details.
if you have installed a Zabbix proxy, edit the proxy configuration file /usr/local/etc/zabbix_proxy.conf
You must specify the server IP address and proxy hostname (must be known to the server), as well as the database name, user and password (if using any)
With SQLite the full path to database file must be specified; DB user and password are not required.
Start up the daemons
Run zabbix_server on the server side.
#zabbix_server
Make sure that your system allows allocation of 36MB (or a bit more) of shared memory, otherwise the server may not start and you will see “Cannot allocate shared memory for .” in the server log file. This may happen on FreeBSD, Solaris 8.
See the “See also” section at the bottom of this page to find out how to configure shared memory.
Run zabbix_agentd on all the monitored machines.
#zabbix_agentd
Make sure that your system allows allocation of 2MB of shared memory, otherwise the agent may not start and you will see “Cannot allocate shared memory for collector.” in the agent log file. This may happen on Solaris 8.
If you have installed Zabbix proxy, run zabbix_proxy.
#zabbix_proxy
Installing Zabbix web interface
Copying PHP files
Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. Installation is done by simply copying the PHP files from frontends/php to the webserver HTML documents directory.
#mkdir /var/www/html/zabbix
#cd frontends/php
# cp -a . /var/www/html/zabbix
Installing frontend
Step 1
In your browser, open Zabbix URL: http://<server_ip_or_name>
You should see the first screen of the frontend installation wizard.
Step 2
Make sure that all software prerequisites are met.
Current value Required
PHP version 5.5.9-1ubuntu4.12 5.3.0 OK
PHP option memory_limit 128M 128M OK
PHP option post_max_size 8M 16M Fail
PHP option upload_max_filesize 2M 2M OK
PHP option max_execution_time 30 300 Fail
PHP option max_input_time 60 300 Fail
PHP time zone unknown Fail
PHP databases support MySQL OK
PHP bcmath on OK
PHP mbstring on OK
PHP sockets on OK
PHP gd 2.1.1 2.0 OK
PHP gd PNG support on OK
PHP gd JPEG support on OK
PHP gd FreeType support on OK
PHP libxml 2.9.1 2.6.15 OK
PHP xmlwriter on OK
PHP xmlreader on OK
PHP ctype on OK
PHP session on OK
PHP session auto start off off OK
PHP gettext on OK
Current value Required
PHP version 5.5.9-1ubuntu4.12 5.3.0 OK
PHP option memory_limit 128M 128M OK
PHP option post_max_size 32M 16M OK
PHP option upload_max_filesize 2M 2M OK
PHP option max_execution_time 300 300 OK
PHP option max_input_time 300 300 OK
PHP time zone Asia/Shanghai OK
PHP databases support MySQL OK
PHP bcmath on OK
PHP mbstring on OK
PHP sockets on OK
PHP gd 2.1.1 2.0 OK
PHP gd PNG support on OK
PHP gd JPEG support on OK
PHP gd FreeType support on OK
PHP libxml 2.9.1 2.6.15 OK
PHP xmlwriter on OK
PHP xmlreader on OK
PHP ctype on OK
PHP session on OK
PHP session auto start off off OK
PHP gettext on OK
Step 3
Enter details for connecting to the database. Zabbix database must already be created.
Step 4
Enter Zabbix server details.
Step 5
Review a summary of settings.
Step 6
Download the configuration file and place it under conf/.
Step 7
Finish the installation.
Step 8
Zabbix frontend is ready! The default user name is Admin, password zabbix. ISSUES missing libmysqld-dev
#./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2
...
checking for mysql_config... no
configure: error: MySQL library not found
Resolve:
#apt-get install -y libmysqld-dev
missing libxml2-dev
#./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2
...
checking for xml2-config... no
configure: error: LIBXML2 library not found
Resolve:
#apt-get install -y libxml2-dev
missing libsnmp-dev
#./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2
...
checking for net-snmp-config... no
configure: error: Invalid Net-SNMP directory - unable to find net-snmp-config
Resolve:
#apt-get install libsnmp-dev
missing libcurl4-openssl-dev
#./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2
...
checking for curl-config... no
configure: error: Curl library not found
Resolve:
#apt-get install -y libcurl4-openssl-dev
On the dashboard of zabbix, it’s display:
"Zabbix server is not running: the information displayed may not be current."
Resolve:
## at first, test the port: 10051
# telnet localhost 10051
Trying ::1...
Trying 127.0.0.1...
telnet: Unable to connect to remote host: Connection refused
## use netstat to check
#netstat -anlp |grep 10051
## not found 10051
## check zabbix_server log
#less /tmp/zabbix_server.log
...
2317:20150901:140732.342 [Z3001] connection to database 'zabbix' failed: [1045] Access denied for user 'root'@'localhost' (using password: NO)
2317:20150901:140732.342 Database is down. Reconnecting in 10 seconds.
2317:20150901:140742.342 [Z3001] connection to database 'zabbix' failed: [1045] Access denied for user 'root'@'localhost' (using password: NO)
2317:20150901:140742.342 Database is down. Reconnecting in 10 seconds.
2317:20150901:140752.343 [Z3001] connection to database 'zabbix' failed: [1045] Access denied for user 'root'@'localhost' (using password: NO)
...
#vim /usr/local/etc/zabbix_server.conf
...
112 # DBPassword=
113 DBPassword=yourdbpassword
##and then,restart zabbix_server
#killall zabbix_server && zabbix_server