以前、CentOS 8にインストールしたZabbix 3.0を、5.0にアップグレードしました。
今回は、Ubuntu上にZabbixサーバーを再構築しましたので、今すぐアップグレードは必要ありませんが、6.0(LTS)がリリースましたので、将来に備えてアップグレード手順をもう一度整理したいと思います!
アップグレード手順
Zabbix公式サイトの手順を参考に、Zabbixのメジャーバージョンをアップグレードする手順は以下の通りです。
- 1Zabbixプロセスを停止
- 2既存のZabbixデータベースをバックアップ
- 3構成ファイル、PHPファイル、Zabbixバイナリをバックアップ
- 4リポジトリ構成パッケージを更新
- 5Zabbixコンポーネントをアップグレード
- 6コンポーネント構成パラメーターを確認
- 7Zabbixプロセスを開始
- 8WebブラウザのCookieとキャッシュをクリア
1. Zabbixプロセスを停止
Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。
1 |
# service zabbix-server stop |
2. 既存のZabbixデータベースをバックアップ
これは非常に重要なステップです。
データベースのバックアップがあることを確認してください。
アップグレード手順が失敗した場合(ディスク容量の不足、電源オフ、予期しない問題)に役立ちます。
MySQLデータベースのmysqldumpによるバックアップの方法はこちらが参考になります。
3. 構成ファイル、PHPファイル、Zabbixバイナリをバックアップ
Zabbixバイナリ、設定ファイル、PHPファイルをディレクトリごとバックアップコピーを作成します。
構成ファイル
1 2 3 |
# 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バイナリ
1 2 |
# cp -R /usr/share/zabbix/ /opt/zabbix-backup/ # cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/ |
4. リポジトリ構成パッケージを更新
更新を続行するには、現在のリポジトリパッケージをアンインストールする必要があります。
※著者の場合は上書きしたので、特に消さなくても大丈夫でした
1 |
# rm -Rf /etc/apt/sources.list.d/zabbix.list |
次に、新しいリポジトリ構成パッケージをインストールします。
1 2 |
# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb # dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb |
リポジトリ情報を更新します。
1 |
# apt-get update |
5. Zabbixコンポーネントをアップグレード
Zabbixコンポーネントをアップグレードするには、次のコマンドを実行します。
1 |
# apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent |
PostgreSQLを使用している場合はmysqlをpgsqlに、プロキシをアップグレードする場合はserverをproxyに、agent2をアップグレードする場合はagentをagent2にそれぞれ置き換えてください。
次に、Apacheを使用してWebフロントエンドを正しくアップグレードするには、次のコマンドも実行します。
1 |
# apt-get install zabbix-apache-conf |
Ubuntu 18.04(bionic)より前のディストリビューションは、Zabbixフロントエンド6.0に必要なPHP7.2以降を提供していません。
UbuntuのバージョンとPHPのデフォルトバージョンの関係は以下の通りです。
Ubuntuバージョン | PHPバージョン |
---|---|
Ubuntu 20.04 (focal) | 7.4 |
Ubuntu 18.04 (bionic) | 7.2 |
Ubuntu 16.04 (xenial) | 7.0 |
Ubuntu 14.04 (trusty) | 5.5 |
6. コンポーネント構成パラメーターを確認
必須の変更の詳細については、アップグレードノートを参照してください。
特に気になったのは、アイテム名のユーザーマクロがサポートされなくなったことでしょうか。
Zabbix 4.0以降廃止されたアイテム名(検出ルール名を含む)でのユーザーマクロのサポートは完全に削除されてます。
あとは、Zabbixエージェント2のプラグインやユーザーのパスワードの複雑化くらいです。
今後、様々な新機能が紹介されると思います。
興味のある方は読んでみてください。
7. Zabbixプロセスを開始
更新されたZabbixコンポーネントを起動します。
※自分に必要なものだけ記載しています
1 2 3 4 5 |
# service zabbix-server start # service zabbix-agent start または、Zabbixエージェント2の場合 # service zabbix-agent2 start |
8. WebブラウザのCookieとキャッシュをクリア
アップグレード後、ZabbixのWebインターフェイスを正しく機能させるために、WebブラウザのCookieとキャッシュをクリアする必要がある場合があります。
【おまけ】マイナーバージョン間のアップグレード
6.0.xのマイナーバージョン(たとえば、6.0.1から6.0.3)に簡単にアップグレードすることができます。
Zabbixのマイナーバージョンをアップグレードするには、以下を実行してください。
1 |
# apt install --only-upgrade 'zabbix.*' |
Zabbixサーバーのマイナーバージョンをアップグレードするには、以下を実行してください。
1 |
# apt install --only-upgrade 'zabbix-server.*' |
Zabbixエージェントのマイナーバージョンをアップグレードするには、以下を実行してください。
1 2 3 |
# apt install --only-upgrade 'zabbix-agent.*' または、Zabbixエージェント2の場合 # apt install --only-upgrade 'zabbix-agent2.*' |
以上でZabbixのアップグレード手順になります。
お疲れ様でした!
コメント