このセクションではZabbixの公式ソースを使用して、Zabbix5.4.xからZabbix6.0 .xへのアップグレードを成功させるために必要な手順を説明します。
Zabbixエージェントのアップグレードは必須ではありませんが推奨します。 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ファイルディレクトリのバックアップコピーを作成します。
手順を使用して、ソースからZabbixサーバーをコンパイルします。
必須の変更の詳細については、アップグレードノートを参照してください。
新しいオプションのパラメーターについてはWhat's newセクションを参照してください。
新しいバイナリを開始します。ログファイルをチェックして、バイナリが正常に開始されたかどうかを確認します。
Zabbixサーバーはデータベースを自動的にアップグレードします。起動時に、Zabbixサーバーは現在の(必須およびオプションの)データベースバージョンと必要なデータベースバージョンを確認します。現在の必須バージョンが必要なバージョンよりも古い場合、Zabbixサーバーは必要なデータベースアップグレードパッチを自動的に実行します。データベースアップグレードの開始レベルと進行レベル(パーセンテージ)は、Zabbixサーバーのログファイルに書き込まれます。アップグレードが完了すると、「データベースのアップグレードが完全に完了しました」というメッセージがログファイルに書き込まれます。アップグレードパッチのいずれかが失敗した場合、Zabbixサーバーは起動しません。現在のデータベースバージョンが必要なバージョンよりも新しい場合も、Zabbixサーバーは起動しません。 Zabbixサーバーは、現在のデータベースバージョンがバージョンに対応している場合にのみ起動します。
8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000
サーバーを起動する前に:
要求PHPバージョンは7.2.5です。必要に応じて更新しインストール手順に従ってください。
アップグレード後、Zabbix ウェブインターフェイスが正しく機能するために、ウェブブラウザのクッキーとキャッシュのクリアが必要になる場合があります。
Zabbixプロキシを停止します。
Zabbixプロキシバイナリと設定ファイルのバックアップコピーを作成します。
手順を参照して、ソースからZabbixプロキシをコンパイルします。
このバージョンでは、プロキシパラメータに必須の変更はありません。
新しいZabbixプロキシを起動し、ログファイルをチェックしてプロキシが正常に開始されたかどうかを確認してください。
Zabbixプロキシはデータベースを自動的にアップグレードします。データベースのアップグレードは、Zabbixサーバーを起動するときと同様に行われます。
####エージェントのアップグレードプロセス
エージェントのアップグレードは必須ではありません。新しい機能にアクセスする必要がある場合にのみ、エージェントをアップグレードする必要があります。
このセクションで説明するアップグレード手順は、ZabbixエージェントとZabbixエージェント2の両方をアップグレードするために使用できます。
Zabbixエージェントを停止します。
Zabbixエージェントバイナリと設定ファイルのバックアップコピーを作成します。
手順を参照して、ソースからZabbixエージェントをコンパイルします。
またはZabbixダウンロードページからコンパイル済みのZabbixエージェントをダウンロードすることもできます。
このバージョンではagentまたはagent 2のパラメーターに必須の変更はありません。
新しいZabbixエージェントを起動し、ログファイルをチェックして、エージェントが正常に起動したかどうかを確認します。
####マイナーバージョンアップグレード
6.0.xをマイナーバージョンアップグレード(たとえば、6.0.1から6.0.3)する場合は、メジャーバージョンアップグレード時と同じアクションをサーバー/プロキシ/エージェントに対して実行する必要があります。唯一の違いは、マイナーバージョンアップグレードする場合、データベースに変更が加えられないことです。