Table of Contents
2 Debian/Ubuntu
概要
このセクションでは、Debian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix 5.4.xからZabbix 6.0.xの最新バージョンへのアップグレードを成功させるために必要な手順を説明します。
Zabbixエージェントのアップグレードは必須ではありません(推奨)が、Zabbixサーバーとプロキシは同じメジャーバージョンである必要があります。したがってサーバープロキシ構成では、Zabbixサーバーとすべてのプロキシを停止してアップグレードする必要があります。サーバーのアップグレード中にプロキシを実行し続けても、プロキシのアップグレード中に古いデータが破棄され、プロキシ設定がサーバーと同期されるまで新しいデータが収集されないため、メリットがありません。
プロキシ上のSQLiteデータベースは、データベースのアップグレードがサポートされておらず、データベースファイルを手動で削除する必要があるため、アップグレード前のプロキシからのヒストリデータは失われることに注意してください。プロキシが初めて起動され、SQLiteデータベースファイルが見つからない場合、プロキシは自動的に作成します。
データベースのサイズによっては、バージョン6.0へのデータベースアップグレードに時間がかかる場合があります。
アップグレードする前にアップグレード時の注意点を必ずお読みください！
アップグレード時の注意点は以下のようにまとめられています。
| アップグレード元 | 全ての注意点を読む | バージョン間の重要な変更点 |
|---|---|---|
| 5.4.x | Zabbix 6.0 | データベースの必須バージョンの上昇。 古いデータベースの場合、サーバー/プロキシは起動不能に。 データベースの構造変更のため監査ログレコードが失効。 |
| 5.2.x | Zabbix 5.4 Zabbix 6.0 |
データベースの必須バージョンの上昇。 集計アイテムが個別のタイプから削除。 |
| 5.0.x LTS | Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
PHPの必須バージョンが7.2.0から7.2.5へ変更。 |
| 4.4.x | Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
IBM DB2のサポート終了。 PHPの必須バージョンが5.4.0から7.2.0へ変更。 データベースの必須バージョンの上昇。 ZabbixのPHPファイルディレクトリの変更。 |
| 4.2.x | Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Jabber、EZ Textingメディアタイプの削除。 |
| 4.0.x LTS | Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
古いプロキシからアップグレードされたサーバーへのにデータ報告が不可能に。 新しいエージェントは古いZabbixサーバーと連携不可能に。 |
| 3.4.x | Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
'libpthread'および'zlib'ライブラリが必須に。 プレーンテキストプロトコルのサポートが削除されヘッダーが必須に。 バージョン1.4以前のZabbixエージェントのサポート終了。 パッシブプロキシの設定にサーバーパラメーターが必須に。 |
| 3.2.x | Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
ZabbixサーバーとWebインターフェースのバックエンドデータベースとしてのSQLiteサポートが削除。 POSIX拡張の代わりにPerl互換正規表現(PCRE)をサポート。 Zabbixサーバーに'libpcre'および'libevent'ライブラリが必須に。 'nowait'フラグが設定されていないユーザーパラメーター、リモートコマンド、およびsystem.run[]アイテムに対して、Zabbixサーバーが実行したスクリプト同様に終了コードのチェックが追加。 Zabbix Javaゲートウェイは新しい機能をサポートするためにアップグレードが必須。 |
| 3.0.x LTS | Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
ヒストリテーブルのサイズによっては、データベースのアップグレードに時間がかかる。 |
| 2.4.x | Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
PHPの必須バージョンが5.3.0から5.4.0へ変更。 LogFileエージェントパラメーターの指定が必須に。 |
| 2.2.x LTS | Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
ノードベースの分散監視の削除。 |
| 2.0.x | Zabbix 2.2 Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
PHPの必須バージョンが5.1.6から5.3.0へ変更。 ZabbixサーバーとMySQLデータベースが適切に動作するには、大文字と小文字を区別するデータベースおよび文字セットutf8とutf8_binの照合順序が必須に。参照: データベース作成スクリプト。 PHP拡張機能の'mysql'の代わりに'mysqli'が必須に。 |
6.0の要件も確認してください。
アップグレード中に並行してSSHのセッションを実行し、一方でアップグレード手順を実行し、もう一方でサーバーやプロキシのログを監視すると便利な場合があります。例えば、tail -f zabbix_server.logまたはtail -f zabbix_proxy.logを実行すると、最新のログとエラー発生をリアルタイムで把握することができます。これは本番環境のインスタンスにとって重要です。
Zabbix 6.0.xのマイナーバージョン間 (たとえば、6.0.1から6.0.3)へのアップグレード手順については、マイナーバージョン間のアップグレードを参照してください。
アップグレード手順
1 Zabbixプロセスの停止
Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。
Zabbixプロキシやエージェント、エージェント2もアップグレードする場合は、同様に停止します。
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バイナリ:
4 リポジトリ構成パッケージ更新
アップグレードを続行するには、現在のリポジトリパッケージをアンインストールする必要があります。
次に、最新のリポジトリ構成パッケージをインストールして、最新のパッケージとの互換性を確保し、最新のセキュリティパッチやバグ修正を含めます。
Debian 12では次を実行します。
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.debDebian 11では次を実行します。
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb
dpkg -i zabbix-release_latest+debian11_all.debDebian 10では次を実行します。
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian10_all.deb
dpkg -i zabbix-release_latest+debian10_all.deb古いDebianバージョンの場合は、上記のリンクをZabbixリポジトリの正しいリンクに置き換えてください。 ただし、これらのバージョンのパッケージには、Zabbixコンポーネントが何か含まれていない可能性があることに注意してください。 含まれるコンポーネントのリストについては、Zabbixパッケージを参照してください。
Ubuntu 24.04では次を実行します。
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.debUbuntu 22.04では次を実行します。
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.debUbuntu 20.04では次を実行します。
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb
dpkg -i zabbix-release_latest+ubuntu20.04_all.debUbuntu 18.04では次を実行します。
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu18.04_all.deb
dpkg -i zabbix-release_latest+ubuntu18.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リポジトリ設定をインストールします。
次に、リポジトリ情報を更新します。
5 Zabbixコンポーネントのアップグレード
Zabbixコンポーネントをアップグレードするには、次を実行します。
- 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フロントエンドを正しくアップグレードするには、次を実行します
ディストリビューションDebian10 (buster)/Ubuntu 18.04 (bionic)/Raspbian 10(buster)より前のバージョンは、Zabbixフロントエンド6.0に必要なPHP7.2以降を提供していません。古いディストリビューションへのZabbixフロントエンドのインストールについては、情報を参照してください。
6 コンポーネント設定パラメーターの確認
必ずアップグレード時の注意点を参照して、設定パラメーターの変更が必要かどうかを確認してください。
7 Zabbixプロセスの開始
更新されたZabbixコンポーネントを起動します。
systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent28 Webブラウザのクッキーとキャッシュのクリア
アップグレード後、Zabbix Webインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。
マイナーバージョンアップグレード
Zabbix 6.0.xはマイナーバージョン間の、たとえば6.0.1から6.0.3のアップグレードが可能です。
まず、リポジトリ情報を更新します。
次に、Zabbixマイナーバージョンをアップグレードするために、次を実行してください。
Zabbixサーバーのみのマイナーバージョンをアップグレードするには、次を実行してください。
Zabbixエージェントのみのマイナーバージョンアップグレードをするには、次を実行してください。
また、Zabbixエージェント2の場合は