このセクションではZabbixの公式ソースを使用して、Zabbix5.4.xからZabbix6.0 .xへのアップグレードを成功させるために必要な手順を説明します。
Zabbixエージェントのアップグレードは必須ではありません (推奨)が、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サーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。
これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗(ディスク容量の不足、電源オフ、予期しない問題)した場合に役立ちます。
Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。
手順を使用して、ソースからZabbixサーバーをコンパイルします。
アップグレード時の注意点および新機能ページの関連サブセクションに記載されている最新の構成パラメータがあれば、必ず実装してください。
新しいバイナリを開始します。ログファイルをチェックして、バイナリが正常に開始されたかどうかを確認します。
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 Webインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。
Zabbixプロキシを停止します。
Zabbixプロキシバイナリと設定ファイルのバックアップコピーを作成します。
手順を参照して、ソースからZabbixプロキシをコンパイルします。
必ずアップグレード時の注意点を参照して、設定パラメーターの変更が必要かどうかを確認してください。
新しいZabbixプロキシを起動し、ログファイルをチェックしてプロキシが正常に開始されたかどうかを確認してください。
Zabbixプロキシはデータベースを自動的にアップグレードします。データベースのアップグレードは、Zabbixサーバーを起動するときと同様に行われます。
エージェントのアップグレードは必須ではありません。新しい機能にアクセスする必要がある場合にのみ、エージェントをアップグレードする必要があります。
このセクションで説明するアップグレード手順は、ZabbixエージェントとZabbixエージェント2の両方をアップグレードするために使用できます。
Zabbixエージェントを停止します。
Zabbixエージェントバイナリと設定ファイルのバックアップコピーを作成します。
手順を参照して、ソースからZabbixエージェントをコンパイルします。
またはZabbixダウンロードページからコンパイル済みのZabbixエージェントをダウンロードすることもできます。
このバージョンではエージェントまたはエージェント2のパラメーターに必須の変更はありません。
新しいZabbixエージェントを起動し、ログファイルをチェックして、エージェントが正常に起動したかどうかを確認します。
6.0.xをマイナーバージョンアップグレード(たとえば、6.0.1から6.0.3)する場合は、メジャーバージョンアップグレード時と同じアクションをサーバー/プロキシ/エージェントに対して実行する必要があります。唯一の違いは、マイナーバージョンアップグレードする場合、データベースに変更が加えられないことです。