manual:concepts:server

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
manual:concepts:server [2014/09/08 15:01]
Igors H [Runtime control] edited runtime control options (igors)
manual:concepts:server [2018/02/01 06:04]
martins-v utf-8 locale required for server
Line 1: Line 1:
-==== - #2 Server ====+==== Server ====
  
 === Overview === === Overview ===
Line 14: Line 14:
  
 === Server process === === Server process ===
 +
 +== If installed as package ==
  
 Zabbix server runs as a daemon process. The server can be started by executing: Zabbix server runs as a daemon process. The server can be started by executing:
  
-  shell> ​cd sbin +  shell> ​service zabbix-server start 
-  shell> ./​zabbix_server+ 
 +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 Zabbix server :+You can use the following command line parameters with Zabbix server:
  
-<​code>​-c --config <​file> ​             ​absolute ​path to the configuration file (default is /etc/zabbix/​zabbix_server.conf)+<​code>​ 
 +-c --config <​file> ​             path to the configuration file (default is /usr/local/etc/​zabbix_server.conf)
 -R --runtime-control <​option> ​  ​perform administrative functions -R --runtime-control <​option> ​  ​perform administrative functions
 -h --help ​                      give this help -h --help ​                      give this help
Line 29: Line 47:
 <​note>​Runtime control is not supported on OpenBSD and NetBSD.</​note>​ <​note>​Runtime control is not supported on OpenBSD and NetBSD.</​note>​
  
-Examples of command line parameters:+Examples of running Zabbix server with command line parameters:
  
   shell> zabbix_server -c /​usr/​local/​etc/​zabbix_server.conf   shell> zabbix_server -c /​usr/​local/​etc/​zabbix_server.conf
Line 42: Line 60:
 ^Option^Description^Target^ ^Option^Description^Target^
 |config_cache_reload|Reload configuration cache. Ignored if cache is being currently loaded.| | |config_cache_reload|Reload configuration cache. Ignored if cache is being currently loaded.| |
-|log_level_increase[=<​**target**>​]|Increase log level, affects all processes if target is not specified.|**pid** - Process identifier \\ **process type** - All processes of specified type (e.g., poller) \\ **process type,N** - Process type and number (e.g., poller,3)|+|housekeeper_execute|Start the housekeeping procedure. Ignored if the housekeeping procedure is currently in progress.| | 
 +|log_level_increase[=<​**target**>​]|Increase log level, affects all processes if target is not specified.|**pid** - Process identifier ​(1 to 65535) ​\\ **process type** - All processes of specified type (e.g., poller) \\ **process type,N** - Process type and number (e.g., poller,3)|
 |log_level_decrease[=<​**target**>​]|Decrease log level, affects all processes if target is not specified.|:::​| |log_level_decrease[=<​**target**>​]|Decrease log level, affects all processes if target is not specified.|:::​|
 +
 +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: 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   shell> zabbix_server -c /​usr/​local/​etc/​zabbix_server.conf -R config_cache_reload
 +  ​
 +  ​
 +Example of using runtime control to trigger execution of housekeeper:​
 +
 +  shell> zabbix_server -c /​usr/​local/​etc/​zabbix_server.conf -R housekeeper_execute
  
 Examples of using runtime control to change log level: Examples of using runtime control to change log level:
Line 66: Line 92:
 Zabbix 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. Zabbix 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 [[:2.4/manual/installation/install|present]] on your system. You can only run server as '​root'​ if you modify the '​AllowRoot'​ parameter in the server configuration file accordingly.+If you will try to run it as '​root',​ it will switch to a hardcoded '​zabbix'​ user, which must be [[manual:installation:install|present]] on your system. You can only run server as '​root'​ if you modify the '​AllowRoot'​ parameter in the server configuration file accordingly.
  
-If Zabbix server and [[:​2.4/​manual/​concepts/​agent|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 Zabbix can quite easily retrieve, for example, the database password.+If Zabbix server and [[agent|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 Zabbix can quite easily retrieve, for example, the database password.
  
 == Configuration file == == Configuration file ==
  
-See the [[:2.4/manual/appendix/config/zabbix_server|configuration file]] options for details on configuring zabbix_server.+See the [[manual:appendix:config:zabbix_server|configuration file]] options for details on configuring zabbix_server.
  
 == Start-up scripts == == Start-up scripts ==
Line 97: Line 123:
 <​note>​Zabbix may work on other Unix-like operating systems as well.</​note>​ <​note>​Zabbix may work on other Unix-like operating systems as well.</​note>​
  
-(linking to other sections, ​like zabbix maintenance etc)+=== Locale === 
 + 
 +Note that the server requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically.