Zabbix 7.0から7.2へのアップグレード手順まとめ

インフラ

本記事では、Zabbix 7.0 を 7.2 にアップグレードする手順を紹介します。Zabbix Webの「Forbidden」エラーへの対処も含め、RHEL系(RHEL / AlmaLinux / Rocky Linux)環境を前提に説明しています。

1. バックアップ(重要)

アップグレード前には、以下のバックアップを必ず取得しましょう。

  • データベース(PostgreSQLの場合):
    pg_dump -U zabbix -h localhost -Fc zabbix > /root/zabbix_backup.dump
  • 設定ファイル:
    cp -a /etc/zabbix /root/zabbix_conf_backup
    cp -a /etc/httpd/conf.d/zabbix.conf /root/

2. リポジトリの更新

Zabbix 7.2 用のリポジトリに切り替えます。

sudo rpm -Uvh https://repo.zabbix.com/zabbix/7.2/rhel/9/x86_64/zabbix-release-7.2-1.el9.noarch.rpm
sudo dnf clean all  

3. Zabbix パッケージのアップグレード

PostgreSQL 環境を例にしています。

sudo dnf upgrade zabbix-server-pgsql zabbix-web-pgsql zabbix-apache-conf zabbix-agent

4. Apache設定の修正(重要)

Zabbix 7.2 から Web UI のディレクトリが変更されているため、/etc/httpd/conf.d/zabbix.conf を修正する必要があります。

正しい設定例(Zabbix 7.2)

Alias /zabbix /usr/share/zabbix/ui

<Directory "/usr/share/zabbix/ui">
    Options FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>

誤って旧パスのままにすると、「Forbidden – You don’t have permission to access this resource」 エラーになります。

5. Apache を再起動

sudo systemctl restart httpd

6. Zabbix サーバを再起動

sudo systemctl restart zabbix-server

ログで DB のアップグレード進行を確認:

tail -f /var/log/zabbix/zabbix_server.log

以下のような行が出ていれば成功です:

database upgrade from version 07000000 to 07020000

7. Webアクセス確認

ブラウザから http://<サーバIP>/zabbix にアクセスし、ログインできることを確認します。

8. Zabbix Agent のアップグレード(任意)

sudo dnf upgrade zabbix-agent
sudo systemctl restart zabbix-agent

9. トラブルシュート:「Forbidden」エラーの対処

原因の多くは Apache 設定のパス不一致または SELinux による制限です。

Apache設定の修正

sed -i 's:/usr/share/zabbix:/usr/share/zabbix/ui:g' /etc/httpd/conf.d/zabbix.conf

修正後、Apache を再起動します。

sudo systemctl restart httpd

10. バージョン確認

zabbix_server -V
zabbix_agentd -V

まとめ

Zabbix 7.2 では Web UI ディレクトリ構成や PHP バージョン要件が変更されています。Apache 設定変更と Web ディレクトリの確認が最大のポイントです。

本手順を参考に、安全にアップグレードを実施してください。

コメント

タイトルとURLをコピーしました