�����IJ�

2 Server

Overview

�����IJ� server is the central process of �����IJ� software.

The server performs the polling and trapping of data, it calculates triggers, sends notifications to users. It is the central component to which �����IJ� agents and proxies report data on availability and integrity of systems. The server can itself remotely check networked services (such as web servers and mail servers) using simple service checks.

The server is the central repository in which all configuration, statistical and operational data is stored, and it is the entity in �����IJ� that will actively alert administrators when problems arise in any of the monitored systems.

The functioning of a basic �����IJ� server is broken into three distinct components; they are: �����IJ� server, web frontend and database storage.

All of the configuration information for �����IJ� is stored in the database, which both the server and the web frontend interact with. For example, when you create a new item using the web frontend (or API) it is added to the items table in the database. Then, about once a minute �����IJ� server will query the items table for a list of the items which are active that is then stored in a cache within the �����IJ� server. This is why it can take up to two minutes for any changes made in �����IJ� frontend to show up in the latest data section.

Server process

If installed as package

�����IJ� server runs as a daemon process. The server can be started by executing:

shell> service zabbix-server start

This will work on most of GNU/Linux systems. On other systems you may need to run:

shell> /etc/init.d/zabbix-server start

Similarly, for stopping/restarting/viewing status, use the following commands:

shell> service zabbix-server stop
       shell> service zabbix-server restart
       shell> service zabbix-server status

Start up manually

If the above does not work you have to start it manually. Find the path to the zabbix_server binary and execute:

shell> zabbix_server

You can use the following command line parameters with �����IJ� server:

-c --config <file>        absolute path to the configuration file (default is /usr/local/etc/zabbix_server.conf)
       -R --runtime-control <option>   perform administrative functions
       -h --help                       give this help
       -V --version                    display version number

Examples of running �����IJ� server with command line parameters:

shell> zabbix_server -c /usr/local/etc/zabbix_server.conf
       shell> zabbix_server --help
       shell> zabbix_server -V

Runtime control

Runtime control options:

Allowed range of PIDs for changing the log level of a single Zabbx process is from 1 to 65535. On systems with large PIDs <process type,N> target option can be used for changing the log level of a single process.

Example of using runtime control to reload the server configuration cache:

shell> zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload

Examples of using runtime control to change log level:

Increase log level of all processes:
       shell> zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase
       
       Increase log level of second poller process:
       shell> zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2
       
       Increase log level of process with PID 1234:
       shell> zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234
       
       Decrease log level of all http poller processes:
       shell> zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller"

Process user

�����IJ� server is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run server as any non-root user without any issues.

If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run server as 'root' if you modify the 'AllowRoot' parameter in the server configuration file accordingly.

If �����IJ� server and agent are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in �����IJ� can quite easily retrieve, for example, the database password.

Configuration file

See the configuration file options for details on configuring zabbix_server.

Start-up scripts

The scripts are used to automatically start/stop �����IJ� processes during system's start-up/shutdown. The scripts are located under directory misc/init.d.

Supported platforms

Due to the security requirements and mission-critical nature of server operation, UNIX is the only operating system that can consistently deliver the necessary performance, fault tolerance and resilience. �����IJ� operates on market leading versions.

�����IJ� server is tested on the following platforms:

• Linux
• Solaris
• AIX
• HP-UX
• Mac OS X
• FreeBSD
• OpenBSD
• NetBSD
• SCO Open Server
• Tru64/OSF1