Table of Contents

2 Debian/Ubuntu

2 Debian/Ubuntu

概要

このセクションではDebian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix 6.2.xからZabbix 6.4.xの最新バージョンへのアップグレードを成功させるために必要な手順を説明します。

アップグレードする前にアップグレード時の注意点を必ずお読みください！

6.4の要件も確認してください。

アップグレード中に並行してSSHのセッションを実行し、一方でアップグレード手順を実行し、もう一方でサーバーやプロキシのログを監視すると便利な場合があります。例えば、tail -f zabbix_server.logまたはtail -f zabbix_proxy.logを実行すると、最新のログとエラー発生をリアルタイムで把握することができます。これは本番環境のインスタンスにとって重要です。

Zabbix 6.4.xのマイナーバージョン間 (たとえば、6.4.1から6.4.3)へのアップグレード手順については、マイナーバージョン間のアップグレードを参照してください。

アップグレード手順

1 Zabbixプロセスの停止

Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。

# systemctl stop zabbix-server

Zabbixプロキシやエージェント、エージェント2もアップグレードする場合は、同様に停止します。

# systemctl stop zabbix-proxy
       # systemctl stop zabbix-agent
       # systemctl stop zabbix-agent2

2 既存Zabbixデータベースのバックアップ

これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗（ディスク容量の不足、電源オフ、予期しない問題）した場合に役立ちます。

3 設定ファイル、PHPファイル、Zabbixバイナリのバックアップ

Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。

設定ファイル:

# mkdir /opt/zabbix-backup/
       # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
       # cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

PHPファイルとZabbixバイナリ:

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       # cp -R /usr/share/zabbix-* /opt/zabbix-backup/

4 リポジトリ構成パッケージ更新

アップグレードを続行するには、現在のリポジトリパッケージをアンインストールする必要があります。

# rm -Rf /etc/apt/sources.list.d/zabbix.list

次に、最新のリポジトリ構成パッケージをインストールして、最新のパッケージとの互換性を確保し、最新のセキュリティパッチやバグ修正を含めます。

Debian 12では次を実行します。

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
       # dpkg -i zabbix-release_latest+debian12_all.deb

Debian 11では次を実行します。

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb
       # dpkg -i zabbix-release_latest+debian11_all.deb

古いDebianバージョンの場合は、上記のリンクをZabbixリポジトリの正しいリンクに置き換えてください。ただし、これらのバージョンのパッケージには、Zabbixコンポーネントが何か含まれていない可能性があることに注意してください。含まれるコンポーネントのリストについては、Zabbixパッケージを参照してください。

Ubuntu 24.04では次を実行します。

# wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
       # dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

Ubuntu 22.04では次を実行します。

# wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
       # dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Ubuntu 20.04では次を実行します。

# wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb
       # dpkg -i zabbix-release_latest+ubuntu20.04_all.deb

古いUbuntuバージョンの場合は、上記のリンクをZabbixリポジトリの正しいリンクに置き換えてください。ただし、これらのバージョンのパッケージには、Zabbixコンポーネントが何か含まれていない可能性があることに注意してください。含まれるコンポーネントのリストについては、Zabbixパッケージを参照してください。

Zabbixリポジトリ設定に関するプロンプトが表示される場合があります。

# Configuration file '/etc/apt/sources.list.d/zabbix.list'
       # ==> Deleted (by you or by a script) since installation.
       # ==> Package distributor has shipped an updated version.
       # What would you like to do about it ?  Your options are:
       # Y or I  : install the package maintainer's version
       # N or O  : keep your currently-installed version
       # D       : show the differences between the versions
       # Z       : start a shell to examine the situation
       # The default action is to keep your current version.
       # *** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Y (またはI)を入力して、パッケージ管理者のバージョンのZabbixリポジトリ設定をインストールします。

次に、リポジトリ情報を更新します。

# apt update

5 Zabbixコンポーネントのアップグレード

Zabbixコンポーネントをアップグレードするには、次を実行します。

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

PostgreSQLを使用している場合は、コマンドのmysqlをpgsqlに置き換えます。
プロキシをアップグレードする場合は、コマンドのserverをproxyに置き換えます。
エージェント2をアップグレードする場合は、コマンドのzabbix-agentをzabbix-agent2 zabbix-agent2-plugin-*に置き換えます。

'apt install zabbix-agent2'コマンドを使用して Zabbixエージェント2をアップグレードすると、エラーが発生する可能性があります。詳細については既知の問題点を参照してください。

Zabbixサーバー (またはプロキシ)の設定に関するプロンプトが表示される場合があります。

# Configuration file '/etc/zabbix/zabbix_server.conf'
       # ==> Modified (by you or by a script) since installation.
       # ==> Package distributor has shipped an updated version.
       # What would you like to do about it ?  Your options are:
       # Y or I  : install the package maintainer's version
       # N or O  : keep your currently-installed version
       # D       : show the differences between the versions
       # Z       : start a shell to examine the situation
       # The default action is to keep your current version.
       # *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

状況に最も適したオプションを入力してください。たとえば、Dと入力して現在の設定と新しい設定を比較し、パッケージ管理者のバージョン (YまたはI) をインストールするかどうかを決定します。

Apacheを使用したWebフロントエンドを正しくアップグレードするには、次のコマンドも実行します。

# apt install zabbix-apache-conf

ディストリビューションDebian10 (buster)/Ubuntu 18.04 (bionic)/Raspbian 10(buster)より前のバージョンは、Zabbixフロントエンド5.0に必要なPHP7.2以降を提供していません。古いディストリビューションへのZabbixフロントエンドのインストールについては、情報を参照してください。

6 コンポーネント設定パラメーターの確認

必ずアップグレード時の注意点を参照して、設定パラメーターの変更が必要かどうかを確認してください。

新しいオプションのパラメーターについては、新機能ページを参照してください。

7 Zabbixプロセスの開始

更新されたZabbixコンポーネントを起動します。

# systemctl start zabbix-server
       # systemctl start zabbix-proxy
       # systemctl start zabbix-agent
       # systemctl start zabbix-agent2

8 Webブラウザのクッキーとキャッシュのクリア

アップグレード後、ZabbixのWebインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。

マイナーバージョンアップグレード

Zabbix 6.4.xはマイナーバージョン間の、たとえば6.4.1から6.4.3のアップグレードが可能です。

まず、リポジトリ情報を更新します。

# apt update

次に、Zabbixマイナーバージョンをアップグレードするために、次を実行してください。

# apt install --only-upgrade 'zabbix*'

Zabbixサーバーのみのマイナーバージョンをアップグレードするには、次を実行してください。

# apt install --only-upgrade 'zabbix-server*'

Zabbixエージェントのみのマイナーバージョンアップグレードをするには、次を実行してください。

# apt install --only-upgrade 'zabbix-agent*'

また、Zabbixエージェント2の場合は

# apt install --only-upgrade 'zabbix-agent2*'

Documentation