ソースからのアップグレード
概要
このセクションでは、公式のZabbixソースを使用してZabbix 7.4.xからZabbix 8.0.xへのアップグレードを成功させるために必要な手順を説明します。
アップグレードの前に、関連するアップグレードノートを必ずお読みください!
8.0の要件も確認することをお勧めします。
アップグレード中は、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.2.0です。必要に応じてアップデートし、インストール手順に従ってください。
8 Webブラウザのクッキーとキャッシュのクリア
アップグレード後、Zabbix Webインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。
プロキシのアップグレードプロセス
1 プロキシのを停止
Zabbixプロキシを停止します。
2 設定ファイルとZabbixプロキシバイナリのバックアップ
Zabbixプロキシバイナリと設定ファイルのバックアップコピーを作成します。
3 新しいプロキシバイナリのインストール
これらの 手順 を使用して、ソースからZabbixプロキシをコンパイルします。
4 プロキシの設定パラメータの確認
アップグレード時の注意事項を確認し、設定パラメータに変更が必要かどうかを確認してください。
新しいオプションパラメータについては、新機能ページを参照してください。
5 新しいZabbixプロキシの起動
新しいZabbixプロキシを起動し、ログファイルをチェックしてプロキシが正常に開始されたかどうかを確認してください。
Zabbixプロキシはデータベースを自動的にアップグレードします。データベースのアップグレードは、Zabbixサーバーを起動するときと同様に行われます。
エージェントのアップグレードプロセス
エージェントのアップグレードは必須ではありません。新しい機能にアクセスする必要がある場合にのみ、エージェントをアップグレードする必要があります。
このセクションで説明するアップグレード手順は、ZabbixエージェントとZabbixエージェント2の両方をアップグレードするために使用できます。
1 エージェントの停止
Zabbixエージェントを停止します。
2 設定ファイルとZabbixエージェントバイナリのバックアップ
Zabbixエージェントバイナリと設定ファイルのバックアップコピーを作成します。
3 新しいエージェントバイナリのインストール
Zabbixエージェントをソースからコンパイルするには、この手順を使用してください。
または、Zabbixダウンロードページから事前にコンパイルされたZabbixエージェントをダウンロードすることもできます。
4 エージェントの設定パラメータの確認
アップグレード時の注意事項を確認し、設定パラメータに変更が必要かどうかを確認してください。
新しいオプションパラメータについては、新機能ページを参照してください。
5 新しいZabbixエージェントの起動
新しいZabbixエージェントを起動し、ログファイルをチェックして、エージェントが正常に起動したかどうかを確認します。
マイナーバージョン間のアップグレード
8.0.xのマイナーバージョン間(例: 8.0.1から8.0.3)でアップグレードする場合、メジャーバージョン間のアップグレード時と同じアクションをサーバー/プロキシ/エージェントに対して実行する必要があります。唯一の違いは、マイナーバージョン間のアップグレードではデータベースに変更が加えられないことです。