[comment]: # ({a25b2d94-91aab3e5}) # Debian/Ubuntu [comment]: # ({/a25b2d94-91aab3e5}) [comment]: # ({545ec22f-d02acea9}) #### 概要 このセクションでは、Debian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix **7.4.x** から最新バージョンのZabbix **8.0.x** へのアップグレード手順を説明します。 ::: notewarning アップグレードの前に、関連する[アップグレードノート](/manual/installation/upgrade)を確認し、システムがZabbix 8.0の[要件](/manual/installation/requirements)を満たしていることを確認してください。 ::: ::: noteclassic アップグレード中は、2つのSSHセッションを並行して実行することを検討してください。1つはアップグレード手順の実行用、もう1つはサーバー/プロキシのログ監視用です。 たとえば、2つ目のセッションで `tail -f zabbix_server.log` または `tail -f zabbix_proxy.log` を実行し、最新のログエントリやエラーをリアルタイムで確認できます。 これは本番環境では非常に重要です。 ::: Zabbix 8.0.x のマイナーバージョン間（例：8.0.1 から 8.0.3 へのアップグレード）のアップグレード手順については、[マイナーバージョン間のアップグレード](#upgrade-between-minor-versions)を参照してください。 [comment]: # ({/545ec22f-d02acea9}) [comment]: # ({93ff8b03-93ff8b03}) #### アップグレード手順 [comment]: # ({/93ff8b03-93ff8b03}) [comment]: # ({b7813e36-f8102233}) ##### 1 Zabbixプロセスの停止 Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。 ```bash systemctl stop zabbix-server ``` Zabbixプロキシやエージェント、エージェント2もアップグレードする場合は、同様に停止します。 ```bash systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ``` [comment]: # ({/b7813e36-f8102233}) [comment]: # ({906e7b99-ab13a6a4}) ##### 2 Zabbixデータベースのバックアップ 既存のZabbixデータベースをバックアップして、アップグレードの失敗 (ディスク容量の問題、電源喪失、予期せぬ問題など) から保護します。 [comment]: # ({/906e7b99-ab13a6a4}) [comment]: # ({9978590c-6c141723}) ##### 3 Zabbix設定ファイル、PHPファイル、Zabbixバイナリのバックアップ 既存のZabbix設定ファイル、PHP ファイル、およびZabbixバイナリをバックアップします。 設定ファイルの場合は、次を実行します。 ```bash 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バイナリの場合は、次を実行します。 ```bash cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ``` [comment]: # ({/9978590c-6c141723}) [comment]: # ({08c42842-31c75b55}) ##### 4 リポジトリ設定パッケージの更新 アップグレードを進める前に、現在のZabbixリポジトリパッケージをアンインストールしてください: ```bash rm -Rf /etc/apt/sources.list.d/zabbix.list ``` また、作業ディレクトリから古いZabbixパッケージを手動で削除する必要がある場合があります（例: ``rm zabbix-release_latest+debian12_all.deb``）。これは、アップグレード時にパッケージマネージャが古いバージョンを再利用するのを防ぐためです。 次に、最新のリポジトリ設定パッケージをインストールして、最新のパッケージとの互換性を確保し、最近のセキュリティパッチやバグ修正を含めます。 **Debian 12** では、以下を実行します: ```bash wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb dpkg -i zabbix-release_latest+debian12_all.deb ``` ::: noteclassic 古いDebianバージョンの場合は、上記のリンクを[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/)から正しいものに置き換えてください。ただし、これらのバージョンのパッケージにはすべてのZabbixコンポーネントが含まれていない場合があり、パッケージからそれらのコンポーネントをアップグレードするにはOSのアップグレードを検討してください。含まれるコンポーネントの一覧については、[Zabbixパッケージ](https://www.zabbix.com/download?zabbix=8.0&os_distribution=debian&os_version=11&components=agent&db=&ws=)を参照してください。 ::: **Ubuntu 24.04** では、以下を実行します: ```bash wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb dpkg -i zabbix-release_latest+ubuntu24.04_all.deb ``` **Ubuntu 22.04** では、以下を実行します: ```bash wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb dpkg -i zabbix-release_latest+ubuntu22.04_all.deb ``` ::: noteclassic 古いUbuntuバージョンの場合は、上記のリンクを[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/)から正しいものに置き換えてください。ただし、これらのバージョンのパッケージにはすべてのZabbixコンポーネントが含まれていない場合があり、パッケージからそれらのコンポーネントをアップグレードするにはOSのアップグレードを検討してください。含まれるコンポーネントの一覧については、[Zabbixパッケージ](https://www.zabbix.com/download?zabbix=8.0&os_distribution=ubuntu&os_version=20.04&components=agent&db=&ws=)を参照してください。 ::: Zabbixリポジトリ設定に関するプロンプトが表示される場合があります: ```bash Configuration file '/etc/apt/sources.list.d/zabbix.list' ==> Deleted (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix.list (Y/I/N/O/D/Z) [default=N] ? ``` Zabbixリポジトリ設定のパッケージメンテナのバージョンをインストールするには、`Y`（または`I`）を入力してください。 その後、リポジトリ情報を更新します: ```bash apt update ``` [comment]: # ({/08c42842-31c75b55}) [comment]: # ({a78e76d3-08c7383c}) ##### 5 Zabbixコンポーネントのアップグレード Zabbixコンポーネントをアップグレードするには、次を実行します。 ```bash apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent ``` - PostgreSQLを使用している場合は、コマンドの`mysql`を`pgsql`に置き換えます。 - プロキシをアップグレードする場合は、コマンドの`server`を`proxy`に置き換えます。 - Zabbixエージェント2をアップグレードする場合は、コマンドの`zabbix-agent`を`zabbix-agent2 zabbix-agent2-plugin-*`に置き換えます。 ::: noteimportant 'apt install zabbix-agent2'コマンドを使用して Zabbixエージェント2をアップグレードすると、エラーが発生する可能性があります。 詳細については[*既知の問題点*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older)を参照してください。 ::: Zabbixサーバー (またはプロキシ)の設定に関するプロンプトが表示される場合があります。 ```bash Configuration file '/etc/zabbix/zabbix_server.conf' ==> Modified (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ? ``` 状況に最も適したオプションを入力してください。 たとえば、`D`と入力して現在の設定と新しい設定を比較し、パッケージ管理者のバージョン (`Y`または`I`) をインストールするかどうかを決定します。 次に、Apacheを使用したZabbixフロントエンドをアップグレードし、再起動するには、次のコマンドを実行します。 ```bash apt install zabbix-apache-conf systemctl restart apache2 ``` [comment]: # ({/a78e76d3-08c7383c}) [comment]: # ({06ed5d87-455f4e97}) ##### 6 コンポーネントの設定パラメータの確認 関連する[アップグレードノート](/manual/installation/upgrade_notes)を確認し、設定パラメータに変更が必要かどうかを確認してください。 新しいオプションパラメータについては、[新機能](/manual/whatsnew)ページを参照してください。 [comment]: # ({/06ed5d87-455f4e97}) [comment]: # ({e83479d6-624a8fc7}) ##### 7 Zabbixプロセスの起動 アップグレードされたZabbixコンポーネントを起動します。 ```bash systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ``` [comment]: # ({/e83479d6-624a8fc7}) [comment]: # ({0d20ecac-49e4f43e}) ##### 8 Webブラウザのクッキーとキャッシュのクリア アップグレード後、Zabbix Webインターフェースが正しく動作するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。 [comment]: # ({/0d20ecac-49e4f43e}) [comment]: # ({d6c45268-9bab02f2}) #### マイナーバージョン間のアップグレード Zabbix 8.0.x のマイナーバージョン間（例: 8.0.1 から 8.0.3 へのアップグレード）が可能です。 まず、リポジトリ情報を更新します: ```bash apt update ``` 次に、すべてのZabbixコンポーネントをアップグレードするには、以下を実行します: ```bash apt install --only-upgrade 'zabbix*' ``` - Zabbixサーバーのみをアップグレードする場合は、コマンド内の `'zabbix*'` を `'zabbix-server*'` に置き換えてください。 - Zabbixプロキシのみをアップグレードする場合は、コマンド内の `'zabbix*'` を `'zabbix-proxy*'` に置き換えてください。 - Zabbixエージェントのみをアップグレードする場合は、コマンド内の `'zabbix*'` を `'zabbix-agent*'` に置き換えてください。 - Zabbixエージェント2のみをアップグレードする場合は、コマンド内の `'zabbix*'` を `'zabbix-agent2*'` に置き換えてください。 [comment]: # ({/d6c45268-9bab02f2})