1 ソースからのアップグレード
概要
このセクションでは、公式 Zabbix ソースを使用して Zabbix 7.2.x から Zabbix 7.4.x へ正常にアップグレードするために必要な手順を説明します。
アップグレード前に、関連するアップグレードノートを必ずお読みください。
また、7.4 の要件も確認しておくとよいでしょう。
アップグレード中は、2 つの SSH セッションを並行して使用すると便利です。1 つのセッションでアップグレード手順を実行し、もう 1 つのセッションでサーバー/プロキシのログを監視します。たとえば、2 つ目の SSH セッションで tail -f zabbix_server.log または tail -f zabbix_proxy.log を実行すると、最新のログファイルの内容や発生したエラーをリアルタイムで確認できます。これは本番環境では特に重要です。
サーバーのアップグレードプロセス
1 Zabbixプロセスの停止
Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。
2 既存Zabbixデータベースのバックアップ
これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗(ディスク容量の不足、電源オフ、予期しない問題)した場合に役立ちます。
3 設定ファイル、PHPファイル、Zabbixバイナリのバックアップ
Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。
4 新しいサーバーバイナリをインストールする
ソースから Zabbix サーバーをコンパイルするには、こちらの手順を使用してください。
5 サーバー設定パラメータの確認
設定パラメータに変更が必要かどうかを確認するため、アップグレードノート を必ず確認してください。
新しい任意パラメータについては、新機能 ページを参照してください。
6 新しい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
サーバーを起動する前に:
- データベースユーザーに十分な権限があることを確認してください(テーブルの作成、テーブルの削除、インデックスの作成、インデックスの削除)
- 十分な空きディスク容量があることを確認してください。
7 新しい Zabbix Webインターフェースのインストール
必要な最小 PHP バージョンは 8.0.0 です。必要に応じて更新し、 インストール手順 に従ってください。
8 Webブラウザのクッキーとキャッシュのクリア
アップグレード後、Zabbix Webインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。
プロキシのアップグレードプロセス
1 プロキシのを停止
Zabbixプロキシを停止します。
2 設定ファイルとZabbixプロキシバイナリのバックアップ
Zabbixプロキシバイナリと設定ファイルのバックアップコピーを作成します。
3 新しいプロキシバイナリをインストールする
ソースから Zabbix プロキシをコンパイルするには、これらの instructions を使用してください。
4 プロキシ設定パラメータの確認
設定パラメータに変更が必要かどうかを確認するため、Upgrade notes を必ず確認してください。
新しい任意パラメータについては、What's new ページを参照してください。
5 新しいZabbixプロキシの起動
新しいZabbixプロキシを起動し、ログファイルをチェックしてプロキシが正常に開始されたかどうかを確認してください。
Zabbixプロキシはデータベースを自動的にアップグレードします。データベースのアップグレードは、Zabbixサーバーを起動するときと同様に行われます。
エージェントのアップグレードプロセス
エージェントのアップグレードは必須ではありません。新しい機能にアクセスする必要がある場合にのみ、エージェントをアップグレードする必要があります。
このセクションで説明するアップグレード手順は、ZabbixエージェントとZabbixエージェント2の両方をアップグレードするために使用できます。
1 エージェントの停止
Zabbixエージェントを停止します。
2 設定ファイルとZabbixエージェントバイナリのバックアップ
Zabbixエージェントバイナリと設定ファイルのバックアップコピーを作成します。
3 新しいエージェントバイナリをインストールする
以下の instructions を使用して、ソースから Zabbix エージェントをコンパイルします。
または、Zabbix download page から事前にコンパイルされた Zabbix エージェントをダウンロードすることもできます。
4 エージェント設定パラメータの確認
設定パラメータに変更が必要かどうかを確認するため、Upgrade notes を必ず確認してください。
新しいオプションパラメータについては、What's new ページを参照してください。
5 新しいZabbixエージェントの起動
新しいZabbixエージェントを起動し、ログファイルをチェックして、エージェントが正常に起動したかどうかを確認します。
マイナーバージョン間のアップグレード
7.4.x のマイナーバージョン間でアップグレードする場合(たとえば 7.4.1 から 7.4.3 へ)は、メジャーバージョン間のアップグレード時と同様に、サーバー/プロキシ/エージェントに対して同じ手順を実行する必要があります。唯一の違いは、マイナーバージョン間のアップグレードではデータベースに変更が加えられないことです。