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

目次

  1. ML9系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. プラグインパッケージのインストール

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

パッケージアーキテクチャ説明
miracle-zbx-server-mysql x86_64MySQL/MariaDB用のMIRACLE ZBXサーバ
miracle-zbx-server-pgsql x86_64PostgreSQL用のMIRACLE ZBXサーバ
miracle-zbx-proxy-mysql x86_64MySQL/MariaDB用のMIRACLE ZBXプロキシ
miracle-zbx-proxy-pgsql x86_64PostgreSQL用のMIRACLE ZBXプロキシ
miracle-zbx-web x86_64MIRACLE ZBX Webフロントエンド
miracle-zbx-web-mysql x86_64MySQL/MariaDB用のMIRACLE ZBX Webフロントエンド
miracle-zbx-web-pgsql x86_64PostgreSQL用のMIRACLE ZBX Webフロントエンド
miracle-zbx-web-japanese x86_64MIRACLE ZBX Webフロントエンドの日本語ロケール
miracle-zbx-apache-conf x86_64MIRACLE ZBX WebフロントエンドのApache用設定ファイル
miracle-zbx-nginx-conf x86_64MIRACLE ZBX Webフロントエンドのnginx用設定ファイル
miracle-zbx-java-gateway x86_64JMX(Java Management Extensions)経由の監視用
miracle-zbx-agent aarch64, x86_64MIRACLE ZBXエージェント
miracle-zbx-agent2 aarch64, x86_64次世代型のMIRACLE ZBXエージェント
miracle-zbx-agent2-plugin-ember-plusx86_64MIRACLE ZBXエージェント2のEmber+プラグイン
miracle-zbx-agent2-plugin-mongodb aarch64, x86_64MIRACLE ZBXエージェント2のMongoDBプラグイン
miracle-zbx-agent2-plugin-mssql x86_64MIRACLE ZBXエージェント2のMSSQLプラグイン
miracle-zbx-agent2-plugin-postgresqlaarch64, x86_64MIRACLE ZBXエージェント2のPostgreSQLプラグイン
miracle-zbx-get aarch64, x86_64MIRACLE ZBXエージェントから監視データを取得するツール
miracle-zbx-sender aarch64, x86_64MIRACLE ZBXサーバへ監視データを送信するツール
miracle-zbx-js x86_64MIRACLE ZBX内で使用するJavaScriptをテストするツール
miracle-zbx-web-service x86_64定期レポート生成用のサービス
miracle-zbx-sql-scripts x86_64MIRACLE ZBX用のDBスキーマ
miracle-zbx-selinux aarch64, x86_64MIRACLE ZBX用のSELinuxポリシー

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のコンポーネントに応じて適宜ファイアウォールを設定してください。

コンポーネントポート
MIRACLE ZBX Webフロントエンド80/tcp
MIRACLE ZBXエージェント/エージェント210050/tcp
MIRACLE ZBXプロキシ10051/tcp
MIRACLE ZBX Java ゲートウェイ10052/tcp

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

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

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

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

DB最小最大
MySQL8.0.x8.3.x
MariaDB10.3.x11.2.x
PostgreSQL12.x16.x

ここでは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

log_bin_trust_function_creatorsを無効にします。

# mysql -uroot
mysql> set global log_bin_trust_function_creators = OFF;
mysql> exit

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

設定項目設定内容
DBPasswordMariaDB/MySQLのzabbixユーザに設定したパスワードを書いてください。

サービス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を編集します。

設定項目設定内容
DBPasswordPostgreSQLのzabbixユーザに設定したパスワードを書いてください。

サービス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


サービスhttpdphp-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.confincludeしてください。

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

サービスnginxphp-fpmを起動します。

# systemctl enable --now nginx php-fpm

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

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

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

DB最小最大
MySQL8.0.x8.3.x
MariaDB10.3.x11.2.x
PostgreSQL12.x16.x

ここでは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を編集します。

設定項目設定内容
ServerZBXサーバのIPアドレスまたはDNS名を書いてください。
HostnameZBXプロキシのホスト名を書いてください。フロントエンドからプロキシを設定するとき「プロキシ名」として参照されます。
DBPasswordMariaDB/MySQLのzabbixユーザに設定したパスワードを書いてください。

サービス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を編集します。

設定項目設定内容
ServerZBXサーバのIPアドレスまたはDNS名を書いてください。
HostnameZBXプロキシのホスト名を書いてください。フロントエンドからプロキシを設定するとき「プロキシ名」として参照されます。
DBPasswordPostgreSQLのzabbixユーザに設定したパスワードを書いてください。

サービス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 サーバと同一のマシンにインストールしている場合は、 WebServiceURLhttp://localhost:10053/reportを指定してください。

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

# systemctl restart zabbix-server

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

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

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

# dnf install miracle-zbx-agent

設定ファイル/etc/zabbix/zabbix_agentd.confを編集します。 ServerServerActiveHostnameを設定します。

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を編集します。 ServerServerActiveHostnameを設定します。

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向けに以下のプラグインを提供しています。 監視にこれらのプラグインが必要な場合はプラグインパッケージをインストールしてください。

プラグインパッケージ名初出リリース番号
Ember+miracle-zbx-agent2-plugin-ember-plus6.0.31-2
MongoDBmiracle-zbx-agent2-plugin-mongodb6.0.6-3
MSSQLmiracle-zbx-agent2-plugin-mssql6.0.31-2
PostgreSQLmiracle-zbx-agent2-plugin-postgresql6.0.10-5

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

# systemctl restart zabbix-agent2
MIRACLE ZBX サポートRSS

アップデート情報RSS

サポート関連情報RSS