【ZABBIXの正しいセットアップ手順】公式通りではうまくいかない！エラーやグラフに文字が表示されない問題の正しい対処法をメモ

パソコン

2021.09.042021.06.18

ネットワーク機器やサーバーの監視用にラズベリーパイ3B（Raspbian 9 Stretch）にZABBIXを構築してみました。

構築したZabbixのバージョンは4.0.4です。

$zabbix_server -V
zabbix_server (Zabbix) 4.0.4
Revision 89349 4 February 2019, compilation time: Feb  6 2019 00:50:40

ラズベリーパイ3B（Raspbian 9 Lite）にセットアップしましたが、後日Raspbian 10 Buster でも同様の方法でセットアップできました。

公式サイトの情報ではうまくいかないので注意！

はじめ、Zabbix公式サイトに記載されている通りにセットアップしてみました。

Download and install Zabbix

Zabbix is being downloaded over 4 000 000 times every year for a reason. Download and install Zabbix for free and try it yourself!

しかし、情報が古いようで、あるはずのファイルがなかったり、WebGUIからのセットアップ中にエラーが発生したりして、うまくいきません。

Unable to select configuration.

its “users” table is empty

いろいろなエラーに阻まれ、めちゃくちゃ大変でした。

正しいセットアップ手順

ということで、正しいセットアップ手順をご紹介します。

インストール

まずパッケージのインストールですが、これは公式サイトの通りでOKです。

リポジトリのインストールを行います。

# wget https://repo.zabbix.com/zabbix/4.0/raspbian/pool/main/z/zabbix-release/zabbix-release_4.0-3+stretch_all.deb
# dpkg -i zabbix-release_4.0-3+stretch_all.deb
# apt update

次のコマンドでパッケージをインストールします。

# apt install zabbix-server-mysql zabbix-frontend-php zabbix-agent

ZABBIXサーバー本体である「zabbix-Server」、サーバー本体の監視を行う「Zabbix-Agent」、そしてWebブラウザから使用できるダッシュボード「Zabbix-frontend-php」をインストールしています。

サイトによってはこの他のパッケージも必要とされていましたが、実際にはこの3つだけでOKでした。

DB作成

データベースの作成も公式サイトの通りで問題ありません。

create database zabbix character set utf8;
create user zabbix@localhost identified by 'password';
grant all privileges on zabbix.* to zabbix@localhost;

データベース作成・ユーザー作成・権限設定を行っています。

スキーマ作成・初期データの投入

ここは公式通りやるとうまくいきません！

作成したデータベースをZabbixから利用するには、はじめに使用するテーブルを作成し、初期データを投入する必要があります。

テーブルの作成や初期データの投入は、Zabbixのインストール時に一緒にダウンロードされているsqlファイルを使用して行います。

公式サイトの説明とは異なり、sqlファイルは/usr/share/zabbix-server-mysql/にあります。

schema.sql.gz
images.sql.gz
data.sql.gz

上記3つのsqlファイルを順にmysqlへダンプしてください。

次のコマンドを実行します。

$ zcat /usr/share/zabbix-server-mysql/schema.sql.gz |  mysql -uzabbix -p zabbix
$ zcat /usr/share/zabbix-server-mysql/images.sql.gz |  mysql -uzabbix -p zabbix
Enter password:
$ zcat /usr/share/zabbix-server-mysql/data.sql.gz |  mysql -uzabbix -p zabbix
Enter password:

zcatコマンドにより、解凍しながら内容を標準出力しています。標準出力をパイプによりmysqlコマンドへ流し込むことで、必要なテーブルや初期データが作成されます。