Zabbixサーバ3.0系をソースファイルからインストールする際の手順をまとめます。
インストール手順は、基本的に公式ドキュメントにしたがって進めていきます。
■公式ドキュメント https://www.zabbix.com/documentation/3.0/manual/installation/install
環境
インストールを行った環境は、以下の通りです。
インストールするものは、以下です。
- Zabbix Server 3.0.5
事前準備
ソースファイルのダウンロード
以下のサイトから、ソースファイルをダウンロードします。
wgetでダウンロードする場合は、以下のような感じで大丈夫です。 ダウンロードしたファイルは、展開しておきましょう。
[bash]
cd /usr/local/src
wget http://downloads.sourceforge.net/project/zabbix/ZABBIX%20Latest%20Stable/3.0.5/zabbix-3.0.5.tar.gz
tar zxvf zabbix-3.0.5.tar.gz
ls -al
ls -al | grep zabbix
drwxr-xr-x. 13 1000 1000 4096 Sep 30 18:47 zabbix-3.0.5 -rw-r--r--. 1 root root 15412400 Sep 30 18:52 zabbix-3.0.5.tar.gz [/bash]
私はwgetしたのですが、ダウンロードしたファイルの名前にゴミが付いていたので、リネームしてから展開しました。
[bash]
ls -al
-rw-r--r--. 1 root root 15412400 Sep 30 18:52 zabbix-3.0.5.tar.gz?r=
mv -i zabbix-3.0.5.tar.gz\?r\= zabbix-3.0.5.tar.gz
ls -al
-rw-r--r--. 1 root root 15412400 Sep 30 18:52 zabbix-3.0.5.tar.gz [/bash]
ユーザ・グループの作成
Zabbixは、特権ユーザ以外で実行する必要がありますので、Zabbix用のユーザとグループを作成しておきます。
[bash]
groupadd -g 502 zabbix
useradd -u 502 -g zabbix zabbix
[/bash]
上の例では、グループID、ユーザIDを「502」としていますが、好きなIDを指定して問題ありません。指定せずに、OSの採番に任せてもOKです。
インストール
コンパイルオプション
早速、ソースファイルをコンパイルしていくのですが、その前にコンパイルオプションにはどのようなものがあるか確認してみます。
[bash]
cd /usr/local/src/zabbix-3.0.5
pwd
cd /usr/local/src/zabbix-3.0.5
./configure --help
`configure' configures Zabbix 3.0.5 to adapt to many kinds of systems.
Usage: ./configure [OPTION]... [VAR=VALUE]...
To assign environment variables (e.g., CC, CFLAGS...), specify them as VAR=VALUE. See below for descriptions of some of the useful variables.
Defaults for the options are specified in brackets.
Configuration:
-h, --help display this help and exit
--help=short display options specific to this package
--help=recursive display the short help of all the included packages
-V, --version display version information and exit
-q, --quiet, --silent do not print checking ...' messages
--cache-file=FILE cache test results in FILE [disabled]
-C, --config-cache alias for
--cache-file=config.cache'
-n, --no-create do not create output files
--srcdir=DIR find the sources in DIR [configure dir or `..']
Installation directories: --prefix=PREFIX install architecture-independent files in PREFIX [/usr/local] --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX [PREFIX]
By default, make install' will install all the files in
/usr/local/bin', /usr/local/lib' etc. You can specify
an installation prefix other than
/usr/local' using --prefix',
for instance
--prefix=$HOME'.
For better control, use the options below.
Fine tuning of the installation directories: --bindir=DIR user executables [EPREFIX/bin] --sbindir=DIR system admin executables [EPREFIX/sbin] --libexecdir=DIR program executables [EPREFIX/libexec] --sysconfdir=DIR read-only single-machine data [PREFIX/etc] --sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com] --localstatedir=DIR modifiable single-machine data [PREFIX/var] --libdir=DIR object code libraries [EPREFIX/lib] --includedir=DIR C header files [PREFIX/include] --oldincludedir=DIR C header files for non-gcc [/usr/include] --datarootdir=DIR read-only arch.-independent data root [PREFIX/share] --datadir=DIR read-only architecture-independent data [DATAROOTDIR] --infodir=DIR info documentation [DATAROOTDIR/info] --localedir=DIR locale-dependent data [DATAROOTDIR/locale] --mandir=DIR man documentation [DATAROOTDIR/man] --docdir=DIR documentation root [DATAROOTDIR/doc/zabbix] --htmldir=DIR html documentation [DOCDIR] --dvidir=DIR dvi documentation [DOCDIR] --pdfdir=DIR pdf documentation [DOCDIR] --psdir=DIR ps documentation [DOCDIR]
Program names: --program-prefix=PREFIX prepend PREFIX to installed program names --program-suffix=SUFFIX append SUFFIX to installed program names --program-transform-name=PROGRAM run sed PROGRAM on installed program names
System types: --build=BUILD configure for building on BUILD [guessed] --host=HOST cross-compile to build programs to run on HOST [BUILD]
Optional Features: --disable-option-checking ignore unrecognized --enable/--with options --disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no) --enable-FEATURE[=ARG] include FEATURE [ARG=yes] --enable-silent-rules less verbose build output (undo: "make V=1") --disable-silent-rules verbose build output (undo: "make V=0") --enable-dependency-tracking do not reject slow dependency extractors --disable-dependency-tracking speeds up one-time build --disable-largefile omit support for large files --enable-static Build statically linked binaries --enable-server Turn on build of Zabbix server --enable-proxy Turn on build of Zabbix proxy --enable-agent Turn on build of Zabbix agent and client utilities --enable-java Turn on build of Zabbix Java gateway --enable-ipv6 Turn on support of IPv6
Optional Packages: --with-PACKAGE[=ARG] use PACKAGE [ARG=yes] --without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no) --with-ibm-db2=[ARG] use IBM DB2 CLI from given sqllib directory (ARG=path); use /home/db2inst1/sqllib (ARG=yes); disable IBM DB2 support (ARG=no) --with-ibm-db2-include=[DIR] use IBM DB2 CLI headers from given path --with-ibm-db2-lib=[DIR] use IBM DB2 CLI libraries from given path --with-mysql[=ARG] use MySQL client library [default=no], optionally specify path to mysql_config --with-oracle=[ARG] use Oracle OCI API from given Oracle home (ARG=path); use existing ORACLE_HOME (ARG=yes); disable Oracle OCI support (ARG=no) --with-oracle-include=[DIR] use Oracle OCI API headers from given path --with-oracle-lib=[DIR] use Oracle OCI API libraries from given path --with-postgresql[=ARG] use PostgreSQL library [default=no], optionally specify path to pg_config --with-sqlite3[=ARG] use SQLite 3 library [default=no], optionally specify the prefix for sqlite3 library
If you want to use Jabber protocol for messaging: --with-jabber[=DIR] Include Jabber support [default=no]. DIR is the iksemel library install directory.
If you want to use XML library: --with-libxml2[=ARG] use libxml2 client library [default=no], optionally specify path to xml2-config
If you want to use unixODBC library: --with-unixodbc[=ARG] use ODBC driver against unixODBC package [default=no], optionally specify full path to odbc_config binary.
If you want to use Net-SNMP library: --with-net-snmp[=ARG] use Net-SNMP package [default=no], optionally specify path to net-snmp-config
If you want to use SSH2 based checks: --with-ssh2[=DIR] use SSH2 package [default=no], DIR is the SSH2 library install directory.
If you want to check IPMI devices: --with-openipmi[=DIR] Include OPENIPMI support [default=no]. DIR is the OPENIPMI base install directory, default is to search through a number of common places for the OPENIPMI files.
If you want to use encryption provided by mbed TLS (PolarSSL) library: --with-mbedtls[=DIR] use mbed TLS (PolarSSL) package [default=no], DIR is the libpolarssl install directory.
If you want to use encryption provided by GnuTLS library: --with-gnutls[=DIR] use GnuTLS package [default=no], DIR is the libgnutls install directory.
If you want to use encryption provided by OpenSSL library: --with-openssl[=DIR] use OpenSSL package [default=no], DIR is the libssl and libcrypto install directory.
If you want to check LDAP servers: --with-ldap[=DIR] Include LDAP support [default=no]. DIR is the LDAP base install directory, default is to search through a number of common places for the LDAP files.
If you want to use cURL library: --with-libcurl[=DIR] use cURL package [default=no], optionally specify path to curl-config
If you want to specify iconv installation directories: --with-iconv=[DIR] use iconv from given base install directory (DIR), default is to search through a number of common places for the iconv files. --with-iconv-include=[DIR] use iconv include headers from given path. --with-iconv-lib=[DIR] use iconv libraries from given path.
Some influential environment variables: CC C compiler command CFLAGS C compiler flags LDFLAGS linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir> LIBS libraries to pass to the linker, e.g. -l<library> CPPFLAGS (Objective) C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir> CPP C preprocessor PKG_CONFIG path to pkg-config utility PKG_CONFIG_PATH directories to add to pkg-config's search path PKG_CONFIG_LIBDIR path overriding pkg-config's built-in search path IKSEMEL_CFLAGS C compiler flags for IKSEMEL, overriding pkg-config IKSEMEL_LIBS linker flags for IKSEMEL, overriding pkg-config
Use these variables to override the choices made by `configure' or to help it to find libraries and programs with nonstandard names/locations.
Report bugs to the package provider. [/bash]
コンパイル
以下のオプションを付与して、コンパイルしてみました。
[bash]
cd /usr/local/src/zabbix-3.0.5
./configure --prefix=/usr/local/zabbix-3.0.5 --enable-server --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2
make
make install
cd /usr/local
ln -s zabbix-3.0.5 zabbix
[/bash]
ただ、私の場合は以下に記載するエラーが色々でたので、最終的にconfigureオプションはこうなりました。
[bash] ./configure --prefix=/usr/local/zabbix-3.0.5 --enable-server --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-mysql=/usr/local/mysql/bin/mysql_config --with-net-snmp=/usr/local/net-snmp/bin/net-snmp-config --with-libcurl=/usr/local/curl/bin/curl-config [/bash]
「LIBXML2 library not found」となる場合
以下のパッケージをインストールすることで解消すると思います。
[bash]
yum install libxml2
yum install libxml2-devel
[/bash]
「net-snmp library not found」となる場合
以下のパッケージをインストールすることで解消すると思います。
[bash]
yum install net-snmp
yum install net-snmp-devel
[/bash]
net-snmpをソースファイルからインストールしている場合
net-snmp は、以下の記事のように「--prefix=/usr/local/net-snmp」としてコンパイル・インストールしている前提です。
http://tech-wiki.pomme-verte.net/?p=67
net-snmpインストール後、コンパイルオプションとして「--with-net-snmp=/usr/local/net-snmp/bin/net-snmp-config」を追加してコンパイルすればエラーは解消すると思います。
[bash]
./configure --prefix=/usr/local/zabbix-3.0.5 --enable-server --with-mysql --enable-ipv6 --with-net-snmp=/usr/local/net-snmp/bin/net-snmp-config --with-libcurl --with-libxml2
[/bash]
「MySQL library not found」となる場合
以下のパッケージをインストールすることで解消すると思います。
[bash]
yum install mysql-devel
[/bash]
MySQLをバイナリでインストールしている場合
MySQLを以下の記事のようにバイナリからインストールしている前提です。
http://tech-wiki.pomme-verte.net/?cat=6
MySQLインストール後、コンパイルオプションとして「--with-mysql=/usr/local/mysql/bin/mysql_config」を追加してコンパイルすればエラーは解消すると思います。
[bash]
./configure --prefix=/usr/local/zabbix-3.0.5 --enable-server --with-mysql=/usr/local/mysql/bin/mysql_config --enable-ipv6 --with-net-snmp=/usr/local/net-snmp/bin/net-snmp-config --with-libcurl --with-libxml2
[/bash]
「Curl library not found」となる場合
curlをインストールしましょう。 以下を参照ください。
http://tech-wiki.pomme-verte.net/?p=266
インストール後、コンパイルオプションとして「--with-libcurl=/usr/local/curl/bin/curl-config」を追加してコンパイルすればエラーは解消すると思います。
[bash]
./configure --prefix=/usr/local/zabbix-3.0.5 --enable-server --with-mysql=/usr/local/mysql/bin/mysql_config --enable-ipv6 --with-net-snmp=/usr/local/net-snmp/bin/net-snmp-config --with-libcurl=/usr/local/curl/bin/curl-config --with-libxml2
[/bash]
サマリ
コンパイル後、以下のようなサマリが表示されました。 (コンパイルオプションによって、多少違いはあると思います。)
[bash]
Configuration:
Detected OS: linux-gnu Install path: /usr/local/zabbix-3.0.5 Compilation arch: linux
Compiler: gcc Compiler flags: -I/usr/local/curl/include -g -O2
Library-specific flags: database: -I/usr/local/mysql/include -fabi-version=2 -fno-omit-frame-pointer libXML2: -I/usr/include/libxml2 Net-SNMP: -I. -I/usr/local/net-snmp/include
Enable server: yes Server details: With database: MySQL WEB Monitoring: cURL Native Jabber: no SNMP: yes IPMI: no SSH: no TLS: no ODBC: no Linker flags: -L/usr/local/mysql/lib -L/usr/local/net-snmp/lib -L/usr/local/curl-7.51.0/lib -rdynamic Libraries: -lmysqlclient -lxml2 -lnetsnmp -lcurl -lm -ldl -lresolv
Enable proxy: no
Enable agent: no
LDAP support: no IPv6 support: yes
- Now run 'make install' *
- *
- Thank you for using Zabbix! *
- <http://www.zabbix.com> *
[/bash]
make
続いて、makeしてインストールしましょう。
[bash]
make
make install
[/bash]
事後処理
インストールが終わったら、今後のことを考えて以下の対応をしておきます。
シンボリックリンクの作成
バージョン付きのディレクトリにインストールされていますので、バージョンなしでアクセスできるようにシンボリックリンクを作ります。
これで、仮に新しいバージョンのzabbixをインストールする際も、バージョン付きディレクトリにインストールして、シンボリックリンク「/usr/local/zabbix」を作り直せば、新バージョンへの切替・切り戻しが簡単にできます。
これでインストールは完了です。
自動起動設定
続いて、自動起動させるための設定を行います。
起動スクリプトは、ソースファイル内の以下のディレクトリに含まれています。
[bash] (ソースファイルを展開した場所)/zabbix-3.0.5/misc/init.d [/bash]
READMEファイルがあるので、中を見てみると
Subdirectory misc/init.d contains examples of Zabbix server and agentd start/stop scripts. The scripts are not actively maintained and tested, they may be not up-to-date with the most recent versions of UNIX/Linux distributions.
と書かれてました。 メンテナンスしてないようなので、使えるのか試してみます。
/usr/local/src/zabbix-3.0.5/misc/init.d/fedora/core
[bash]
!/bin/bash
#
chkconfig: - 90 10
description: Starts and stops Zabbix Server using chkconfig
Tested on Fedora Core 2 - 5
Should work on all Fedora Core versions
#
@name: zabbix_server
@author: Alexander Hagenah <hagenah@topconcepts.com>
@created: 18.04.2006
#
Modified for Zabbix 2.0.0
May 2012, Zabbix SIA
#
Source function library.
. /etc/init.d/functions
Variables
Edit these to match your system settings
Zabbix-Directory
BASEDIR=/usr/local
Binary File
BINARY_NAME=zabbix_server
Full Binary File Call
FULLPATH=$BASEDIR/sbin/$BINARY_NAME
PID file
PIDFILE=/tmp/$BINARY_NAME.pid
Establish args
ERROR=0 STOPPING=0
#
No need to edit the things below
#
application checking status
if [ -f $PIDFILE ] && [ -s $PIDFILE ]
then
PID=cat $PIDFILE
if [ "x$PID" != "x" ] && kill -0 $PID 2>/dev/null && [ $BINARY_NAME == ps -e | grep $PID | awk '{print $4}'
]
then
STATUS="$BINARY_NAME (pid pidof $APP
) running.."
RUNNING=1
else
rm -f $PIDFILE
STATUS="$BINARY_NAME (pid file existed ($PID) and now removed) not running.."
RUNNING=0
fi
else
if [ ps -e | grep $BINARY_NAME | head -1 | awk '{ print $1 }'
]
then
STATUS="$BINARY_NAME (pid pidof $APP
, but no pid file) running.."
else
STATUS="$BINARY_NAME (no pid file) not running"
fi
RUNNING=0
fi
functions
start() { if [ $RUNNING -eq 1 ] then echo "$0 $ARG: $BINARY_NAME (pid $PID) already running" else action $"Starting $BINARY_NAME: " $FULLPATH touch /var/lock/subsys/$BINARY_NAME fi }
stop() { echo -n $"Shutting down $BINARY_NAME: " killproc $BINARY_NAME RETVAL=$? echo [ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/$BINARY_NAME RUNNING=0 }
logic
case "$1" in start) start ;; stop) stop ;; status) status $BINARY_NAME ;; restart) stop sleep 10 start ;; help|*) echo $"Usage: $0 {start|stop|status|restart|help}" cat <<EOF
start - start $BINARY_NAME stop - stop $BINARY_NAME status - show current status of $BINARY_NAME restart - restart $BINARY_NAME if running by sending a SIGHUP or start if not running help - this screen
EOF exit 1 ;; esac
exit 0 [/bash]