このセクションではDebian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix5.4.xからZabbix6.0 .xへのアップグレードを成功させるために必要な手順を説明します。
Zabbixエージェントのアップグレードは必須ではありませんが推奨します。 Zabbixサーバーとプロキシは同じメジャーバージョンである必要があります。 したがってサーバープロキシ設定では、Zabbixサーバーとすべてのプロキシを停止してアップグレードする必要があります。 サーバーのアップグレード中にプロキシを実行し続けても、プロキシのアップグレード中に古いデータが破棄され、プロキシ構成がサーバーと同期されるまで新しいデータが収集されないため、メリットがありません。
プロキシ上のSQLiteデータベースは、データベースのアップグレードがサポートされておらず、データベースファイルを手動で削除する必要があるため、アップグレード前のプロキシからの履歴データは失われることに注意してください。プロキシが初めて起動され、SQLiteデータベースファイルが見つからない場合、プロキシはそれを自動的に作成します。
データベースのサイズによっては、バージョン6.0へのデータベースアップグレードに時間がかかる場合があります。
アップグレードする前にアップグレードノートを必ずお読みください。
次のアップグレードノートが利用可能です。
アップグレード元 | アップグレードノート全文 | バージョン間の重要な変更 |
---|---|---|
5.4.x | For: Zabbix 6.0 |
要求データベースバージョン上昇 古いデータベースの場合、サーバー/プロキシは起動不能に データベース構造の変更により監査ログレコードが失効 |
5.2.x | For: Zabbix 5.4 Zabbix 6.0 |
要求データベースバージョン上昇 集計アイテムが個別のタイプから削除 |
5.0.x LTS | For: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
要求PHPバージョンが7.2.0から7.2.5に |
4.4.x | For: Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
IBMDB2のサポート終了 要求PHPバージョンが5.4.0から7.2.0に 要求データベースバージョン上昇 ZabbixPHPファイルディレクトリ変更 |
4.2.x | For: Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Jabber、EZ Textingメディアタイプ削除 |
4.0.x LTS | For: Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
古いプロキシからアップグレードされたサーバーへのにデータ報告が不能に 新しいエージェントは古いZabbixサーバーと連携不能に |
3.4.x | For: 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 | For: 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サーバー/フロントエンドのバックエンドデータベースが削除されたため、SQLiteがサポートされます。 POSIX拡張の代わりに、Perl互換正規表現(PCRE)がサポートされます。 「libpcre」および「libevent」ライブラリが必須に 「nowait」フラグのないユーザーパラメータ、リモートコマンド、system.run[]アイテム、およびZabbixサーバーで実行されるスクリプトの終了コードチェックが追加 Zabbix Javaゲートウェイは、新しい機能をサポートするためにアップグレードする必要があります。 |
3.0.x LTS | For: 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 | For: 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 | For: 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 | For: 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の要件を確認することもできます。
アップグレード中に並列で2つのSSHセッションを実行し、一方でアップグレード手順を実行し、もう一方でサーバー/プロキシのログを監視すると便利な場合があります。たとえば、2番目のSSHセッションで tail -f zabbix_server.log
またはtail -f zabbix_proxy.log
を実行すると、最新のログファイルエントリと発生する可能性のあるエラーがリアルタイムで表示されます。これは、実稼働インスタンスにとって重要な場合があります。
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バイナリ:
アップグレードを続行するには、現在のリポジトリパッケージをアンインストールする必要があります。
新しいリポジトリパッケージをインストールします。
Debian 11では次の通りです:
# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb
# dpkg -i zabbix-release_6.0-1+debian11_all.deb
Debian 10では次の通りです:
# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
# dpkg -i zabbix-release_6.0-1+debian10_all.deb
Debian 9では次の通りです:
# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
# dpkg -i zabbix-release_6.0-1+debian9_all.deb
Ubuntu 20.04 では次の通りです:
# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
# dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb
Ubuntu 18.04では次の通りです:
# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
# dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb
Ubuntu 16.04では次の通りです:
# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
# dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.deb
Ubuntu 14.04では次の通りです:
# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
# dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb
リポジトリ情報を更新します。
Zabbixコンポーネントをアップグレードするには、次を実行します。
PostgreSQLを使用している場合は、コマンドのmysql
をpgsql
に置き換えます。プロキシをアップグレードする場合は、コマンドのserver
をproxy
に置き換えてください。エージェント2をアップグレードする場合は、コマンドのzabbix-agent
をzabbix-agent2
に置き換えてください。
Apacheを使用しているWebフロントエンドを正しくアップグレードするには、次を実行します
ディストリビューションDebian10(buster)/ Ubuntu 18.04(bionic)/ Raspbian 10(buster)より前のバージョンは、Zabbixフロントエンド5.0に必要なPHP7.2以降を提供していません。古いディストリビューションへのZabbixフロントエンドのインストールについては、情報を参照してください。
必須の変更の詳細については(あれば)アップグレードノートを参照してください。
新しいオプションのパラメーターについては、What's newセクションを参照してください。
更新されたZabbixコンポーネントを起動します。
# service zabbix-server start
# service zabbix-proxy start
# service zabbix-agent start
# service zabbix-agent2 start
アップグレード後、Zabbix ウェブインターフェイスが正しく機能するために、ウェブブラウザのクッキーとキャッシュのクリアが必要になる場合があります。
6.0.xはマイナーバージョンアップグレード可能です。(たとえば6.0.1から6.0.3)マイナーバージョンアップグレードは簡単です。
Zabbix全体をマイナーバージョンアップグレードするには、次のコマンドを実行します。
Zabbixサーバーをマイナーバージョンアップグレードするには、次のコマンドを実行します。
Zabbixエージェントをマイナーバージョンアップグレードするには、次のコマンドを実行します。
エージェント2の場合は