ML8用インストールマニュアル

目次

1. ML8系OS向けMIRACLE ZBX 6.0パッケージ一覧
2. dnfリポジトリの登録
3. SELinuxの設定
4. ファイアウォールの設定
5. MIRACLE ZBXサーバとWebフロントエンドのインストール
   1. データベースにMariaDB／MySQLを使用する場合
   2. データベースにPostgreSQLを使用する場合
   3. WebサーバにApacheを使用する場合
   4. Webサーバにnginxを使用する場合
6. MIRACLE ZBXプロキシのインストール
   1. データベースにMariaDB／MySQLを使用する場合
   2. データベースにPostgreSQLを使用する場合
7. MIRACLE ZBX Java ゲートウェイのインストール
8. MIRACLE ZBX Web サービスのインストール
9. MIRACLE ZBXエージェントのインストール
10. MIRACLE ZBXエージェント2のインストール
    1. プラグインパッケージのインストール

ML8系OS向けMIRACLE ZBX 6.0パッケージ一覧

dnfリポジトリの登録

MIRACLE ZBX 6.0用のdnfリポジトリを登録します。

# dnf install https://ftp.miraclelinux.com/zbx/6.0/miracle-zbx-release-6.0-1.noarch.rpm

SELinuxの設定

SELinuxをEnforcingモードにしたままMIRACLE ZBXサーバ／Webフロントエンド／プロキシ／エージェントを動作させるには miracle-zbx-selinuxパッケージをインストールします。

# dnf install miracle-zbx-selinux

ファイアウォールの設定

インストールするMIRACLE ZBXのコンポーネントに応じて適宜ファイアウォールを設定してください。

例としてfirewalldを使用している場合にポート80/tcpへのアクセスを許可するには次のように実行します。

# firewall-cmd --permanent --add-port=80/tcp
# firewall-cmd --reload

MIRACLE ZBXサーバとWebフロントエンドのインストール

データベースは以下の表に示すバージョンをインストールしてください。

ここではMIRACLE ZBXのインストール対象と同じホスト上でデータベースサーバが起動しているものとします。

データベースにMariaDB／MySQLを使用する場合

MariaDB／MySQL用のMIRACLE ZBXパッケージをインストールします。

# dnf install miracle-zbx-server-mysql miracle-zbx-sql-scripts

データベースサーバにMIRACLE ZBXサーバ用のデータベースとユーザを作成します。 次の実行例ではデータベース名をzabbix、データベースユーザ名をzabbixとして指定しています。 データベースの文字コードはutf8mb4、照合順序をutf8mb4_binと指定します。 初期データのインポートのため、log_bin_trust_function_creatorsを有効化する必要があります。

# mysql -uroot
mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin;
mysql> create user zabbix@localhost identified by 'パスワード';
mysql> grant all privileges on zabbix.* to zabbix@localhost;
mysql> set global log_bin_trust_function_creators = ON;
mysql> exit

MIRACLE ZBXの初期データをインポートします。

# zcat /usr/share/doc/miracle-zbx-sql-scripts/mysql/create.sql.gz | mysql zabbix -uzabbix -p

MIRACLE ZBXサーバの設定ファイル/etc/zabbix/zabbix_server.confを編集します。

サービスzabbix-serverを起動します。

# systemctl enable --now zabbix-server

データベースにPostgreSQLを使用する場合

PostgreSQL用のMIRACLE ZBXサーバパッケージをインストールします。

# dnf install miracle-zbx-server-pgsql miracle-zbx-sql-scripts

データベースサーバにMIRACLE ZBXサーバ用のデータベースとユーザを作成します。 次の実行例ではデータベース名をzabbix、 データベースユーザ名をzabbixとして指定しています。

# sudo -u postgres createuser --pwprompt zabbix
# sudo -u postgres createdb --encoding=UTF-8 --template=template0 --locale=ja_JP.UTF-8 -O zabbix zabbix

PostgreSQLの認証設定ファイル/var/lib/pgsql/data/pg_hba.confを編集し、 ローカルホストからzabbixデータベースへの接続を許可してください。

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   zabbix          zabbix                                  md5
local   all             all                                     peer
# IPv4 local connections:
host    zabbix          zabbix          127.0.0.1/32            md5
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    zabbix          zabbix          ::1/128                 md5
host    all             all             ::1/128                 ident

設定変更後はPostgreSQLサービスを再起動します。

# systemctl restart postgresql

MIRACLE ZBXの初期データをインポートします。

# zcat /usr/share/doc/miracle-zbx-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix

MIRACLE ZBXサーバの設定ファイル/etc/zabbix/zabbix_server.confを編集します。

サービスzabbix-serverを起動します。

# systemctl enable --now zabbix-server

WebサーバにApacheを使用する場合

MIRACLE ZBXのWebフロントエンド用パッケージと一緒にApache用のパッケージをインストールします。

// MySQL/MariaDB

# dnf install miracle-zbx-web-mysql miracle-zbx-web-japanese miracle-zbx-apache-conf

// PostgreSQL

# dnf install miracle-zbx-web-pgsql miracle-zbx-web-japanese miracle-zbx-apache-conf

サービスhttpdとphp-fpmを起動します。

# systemctl enable --now httpd php-fpm

Webフロントエンドにアクセスし初期設定をします。 ApacheではMIRACLE ZBX WebフロントエンドのURLがhttp://サーバIP/zabbixとなります。

Webサーバにnginxを使用する場合

MIRACLE ZBXのWebフロントエンド用パッケージと一緒にnginx用のパッケージをインストールします。

// MySQL/MariaDB

# dnf install miracle-zbx-web-mysql miracle-zbx-web-japanese miracle-zbx-nginx-conf

// PostgreSQL

# dnf install miracle-zbx-web-pgsql miracle-zbx-web-japanese miracle-zbx-nginx-conf

nginxパッケージが標準で提供している設定ファイル/etc/nginx/nginx.confを使わず、 代わりに/etc/nginx/nginx.conf.defaultを設定ファイルとして使います。

# mv /etc/nginx/nginx.conf /etc/nginx/nginx.conf.orig
# cp /etc/nginx/nginx.conf.default /etc/nginx/nginx.conf

/etc/nginx/nginx.confを編集します。 /etc/nginx/conf.d/zabbix.confをincludeしてください。

http {
    include       mime.types;
    include       /etc/nginx/conf.d/zabbix.conf;
    default_type  application/octet-stream;
}

サービスnginxとphp-fpmを起動します。

# systemctl enable --now nginx php-fpm

Webフロントエンドにアクセスし初期設定をします。 nginxではMIRACLE ZBX WebフロントエンドのURLがhttp://サーバIPとなります。

MIRACLE ZBXプロキシのインストール

データベースは以下の表に示すバージョンをインストールしてください。

ここではMIRACLE ZBXのインストール対象と同じホスト上でデータベースサーバが起動しているものとします。

データベースにMariaDB／MySQLを使用する場合

MariaDB／MySQL用のMIRACLE ZBXパッケージをインストールします。

# dnf install miracle-zbx-proxy-mysql miracle-zbx-sql-scripts

データベースサーバにMIRACLE ZBXサーバ用のデータベースとユーザを作成します。 次の実行例ではデータベース名をzabbix_proxy、データベースユーザ名をzabbixとして指定しています。 データベースの文字コードはutf8mb4、照合順序をutf8mb4_binと指定します。

# mysql -uroot
mysql> create database zabbix_proxy character set utf8mb4 collate utf8mb4_bin;
mysql> create user zabbix@localhost identified by 'パスワード';
mysql> grant all privileges on zabbix_proxy.* to zabbix@localhost;
mysql> exit

MIRACLE ZBXの初期データをインポートします。

# zcat /usr/share/doc/miracle-zbx-sql-scripts/mysql/schema.sql.gz | mysql zabbix_proxy -uzabbix -p

MIRACLE ZBXプロキシの設定ファイル/etc/zabbix/zabbix_proxy.confを編集します。

サービスzabbix-proxyを起動します。

# systemctl enable --now zabbix-proxy

データベースにPostgreSQLを使用する場合

PostgreSQL用のMIRACLE ZBXパッケージをインストールします。

# dnf install miracle-zbx-proxy-pgsql miracle-zbx-sql-scripts

データベースサーバにMIRACLE ZBXサーバ用のデータベースとユーザを作成します。 次の実行例ではデータベース名をzabbix_proxy、 データベースユーザ名をzabbixとして指定しています。

# sudo -u postgres createuser --pwprompt zabbix
# sudo -u postgres createdb --encoding=UTF-8 --template=template0 --locale=ja_JP.UTF-8 -O zabbix zabbix_proxy

PostgreSQLの認証設定ファイル /var/lib/pgsql/data/pg_hba.conf を編集し、 ローカルホストからzabbix_proxyデータベースへの接続を許可してください。

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   zabbix_proxy    zabbix                                  md5
local   all             all                                     peer
# IPv4 local connections:
host    zabbix_proxy    zabbix          127.0.0.1/32            md5
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    zabbix_proxy    zabbix          ::1/128                 md5
host    all             all             ::1/128                 ident

設定変更後はPostgreSQLサービスを再起動します。

# systemctl restart postgresql

MIRACLE ZBXの初期データをインポートします。

# zcat /usr/share/doc/miracle-zbx-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix_proxy

MIRACLE ZBXプロキシの設定ファイル/etc/zabbix/zabbix_proxy.confを編集します。

サービスzabbix-proxyを起動します。

# systemctl enable --now zabbix-proxy

MIRACLE ZBX Java ゲートウェイのインストール

パッケージをインストールします。

# dnf install miracle-zbx-java-gateway

サービスzabbix-java-gatewayを起動します。

# systemctl enable --now zabbix-java-gateway

MIRACLE ZBXサーバの設定ファイル/etc/zabbix/zabbix_server.confを編集し、 次のパラメータに変更を加えてください。 MIRACLE ZBXプロキシ経由での監視の場合は/etc/zabbix/zabbix_proxy.confを編集してください。

JavaGateway=MIRACLE ZBX Java ゲートウェイを起動したホストのIPアドレス
StartJavaPollers=JavaPollerの初期起動数

「JavaPollerの初期起動数」には、MIRACLE ZBX Java ゲートウェイを インストールしたホスト上のファイル/etc/zabbix/zabbix_java_gateway.confの パラメータSTART_POLLERS（初期値： 5）を超えない数値を指定してください。

サービスzabbix-serverもしくはzabbix-proxyを再起動します。

# systemctl restart zabbix-server
// もしくは
# systemctl restart zabbix-proxy

MIRACLE ZBX Web サービスのインストール

MIRACLE ZBX Web サービスにはGoogle Chromeが必要です。Googleの公式サイトからインストールします。

# dnf install https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm

MIRACLE ZBX Web サービスパッケージをインストールします。

# dnf install miracle-zbx-web-service

設定ファイル/etc/zabbix/zabbix_web_service.confを編集します。 MIRACLE ZBXサーバと同一のマシンにインストールした場合は127.0.0.1を指定してください。

AllowedIP=<MIRACLE ZBX Web サービス への接続を許可する MIRACLE ZBX サーバの IP アドレス>

サービスzabbix-web-serviceを起動します。

# systemctl enable --now zabbix-web-service

MIRACLE ZBX サーバの設定ファイル/etc/zabbix/zabbix_server.confを編集します。

StartReportWriters=<ReportWriter の初期起動数>
WebServiceURL=<MIRACLE ZBX Web サービス への URL>

StartReportWritersには1以上の値を設定します。 MIRACLE ZBX Web サービス をMIRACLE ZBX サーバと同一のマシンにインストールしている場合は、 WebServiceURLにhttp://localhost:10053/reportを指定してください。

サービスzabbix-serverを再起動します。

# systemctl restart zabbix-server

ブラウザからZBX WebフロントエンドURL/zabbix.php?action=miscconfig.editにアクセスします。 MIRACLE ZBX Web サービスとMIRACLE ZBX Web フロントエンドが同一マシンにインストールされている場合は WebインターフェースURLにhttp://localhost/zabbixを指定します。

MIRACLE ZBXエージェントのインストール

パッケージをインストールします。

# dnf install miracle-zbx-agent

設定ファイル/etc/zabbix/zabbix_agentd.confを編集します。 Server／ServerActive／Hostnameを設定します。

Server=MIRACLE ZBXサーバのIPアドレス
ServerActive=MIRACLE ZBXサーバのIPアドレス
Hostname=MIRACLE ZBX Webフロントエンドのホストに登録するホスト名

サービスzabbix-agentを起動します。

# systemctl enable --now zabbix-agent

MIRACLE ZBXエージェントがインストールされているホストにて、 SELinuxがEnforcingモードかつ miracle-zbx-selinuxパッケージがインストールされていない場合 ログ出力をsyslogに転送する機能を利用できません。 このパッケージのインストールについては「SELinuxの設定」を参照してください。

MIRACLE ZBXエージェント2のインストール

パッケージをインストールします。

# dnf install miracle-zbx-agent2

設定ファイル/etc/zabbix/zabbix_agent2.confを編集します。 Server／ServerActive／Hostnameを設定します。

Server=MIRACLE ZBXサーバのIPアドレス
ServerActive=MIRACLE ZBXサーバのIPアドレス
Hostname=MIRACLE ZBX Webフロントエンドのホストに登録するホスト名

サービスzabbix-agent2を起動します。

# systemctl enable --now zabbix-agent2

MIRACLE ZBXエージェント2がインストールされているホストにて、 SELinuxがEnforcingモードかつ miracle-zbx-selinuxパッケージがインストールされていない場合 ログ出力をsyslogに転送する機能を利用できません。 このパッケージのインストールについては「SELinuxの設定」を参照してください。

プラグインパッケージのインストール

MIRACLE ZBX 6.0.10-5 時点ではmiracle-zbx-agent2パッケージとは別に、 Linux OS向けに以下のプラグインを提供しています。 監視にこれらのプラグインが必要な場合はプラグインパッケージをインストールしてください。

プラグインパッケージのインストール後はプラグインをMIRACLE ZBXエージェント2に読み込ませるために サービスzabbix-agent2を再起動します。

# systemctl restart zabbix-agent2