 |
This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. 概要
Checkmk サーバー上の Linux ディストリビューションのリリースをアップグレードするには、いくつかの推奨される方法があります。 どの方法が最適かは、IT 環境の機能、Checkmk インストールに関するデータのインベントリ、および予想されるダウンタイムによって異なります。 ここでは、さまざまな方法とその要件について説明します。
基本的に、1 つの方法は、その場での更新、つまり「その場（in situ、ラテン語）での更新」です。 もう 1 つの方法は、バックアップをアーカイブとして使用し、そのアーカイブに基づいて基本システムの再インストールを行い、最後に同じアーカイブを復元する、つまり「その場（ex situ）での更新」です。 英語では、この 2 つの方法に「in-place」または「out-of-place」という類似の用語が使用されることがあります。
ここで紹介する方法を組み合わせることも可能です。たとえば、/opt/omd または/opt/omd/sites を別のマウントポイントに配置した場合などです。
ここでは、Ubuntu 22.04 (Jammy) から 24.04 (Noble) への変更を例に、リリースアップグレードについて説明します。 他のディストリビューションでは、アップグレードおよびパッケージ管理コマンドが多少異なる場合があります。
この例では、1 つのサイトのみを使用しています。 アップグレードするシステムで複数のサイト（たとえば、本番用とテスト用）を実行している場合は、サイトごとに適切なコマンドを繰り返し実行してください。
Linux ディストリビューションのリリースアップグレードと Checkmkのバージョンアップデートを組み合わせて実行したい場合（たとえば、古い Checkmk バージョンが新しい Linux ディストリビューションバージョンでは提供されなくなった場合など）は、アップデートマトリックスを使用して、実行する適切な順序を決定してください。
2. バックアップに関する注意事項
IT プロフェッショナルである私たちは、一貫性もチェックされる、十分に包括的なデータバックアップの重要性について、特に説明する必要はありません。 理想的なシナリオ（たとえば、仮想マシンで Checkmk を実行している場合）では、ハードディスクイメージをコピーするだけで、フルバックアップを簡単に実行できます。
最低限、以下のことを推奨します：
バックアップは、アップグレードするマシンとは別の場所に保管し、本番システムに最初の変更を加える前にバックアップをテストしてください。
Checkmk サーバーのインストール時に ZFS や BTRFS などのコピーオンライトファイルシステムを選択した場合は、アップグレード前にスナップショットを作成してください。 これは、別途保存したバックアップに代わるものではありませんが、アップグレードに失敗した場合にシステムを元の状態に復元する際のダウンタイムを大幅に短縮することができます。
3. アップグレードのインプレース実行
この方法は、大容量のデータセットを扱う専用ハードウェアで Checkmk を使用する場合に、アーカイブをコピーして復元するとダウンタイムが大幅に増加する場合に役立ちます。
3.1. 準備
準備は、主に、すでに不要になったすべてのCheckmk パッケージを削除することです。 これにより、実際のアップグレード中にパッケージ管理の問題が発生することを回避できます。 さらに、新しいディストリビューションバージョン用の正しい Checkmk インストールパッケージをすでにダウンロードしておく必要があります。
-
まず、現在インストールされているすべての Checkmk バージョンの概要を確認します…
root@linux# omd versions 2.3.0p23.cre 2.4.0p1.cee 2.4.0p2.cee (default) -
… 次に、実際に使用されているバージョンを確認します：
root@linux# omd sites SITE VERSION COMMENTS mysite 2.4.0p2.cee default versionこれらのバージョンについては、新しいオペレーティングシステム用のインストールパッケージをダウンロードする必要があります。 重要：Checkmk のエディションおよびバージョン番号は、これまで使用していたものとまったく同じである必要があります。
-
次に、使用していないすべての Checkmk バージョンをアンインストールします。 次のコマンドでは、
--purgeパラメータにより、古い設定ファイルも確実に消去されます。root@linux# apt-get remove --purge -y check-mk-enterprise-2.4.0p1 Reading package lists... Done Building dependency tree Reading state information... Done The following packages will be REMOVED: check-mk-enterprise-2.4.0p1* 0 upgraded, 0 newly installed, 1 to remove and 1 not upgraded. After this operation, 884 MB disk space will be freed. (Reading database ... 125980 files and directories currently installed.) Removing check-mk-enterprise-2.4.0p1 (0.focal) ... (Reading database ... 89444 files and directories currently installed.) Purging configuration files for check-mk-enterprise-2.4.0p1 (0.focal) ... Processing triggers for systemd (245.4-4ubuntu3.21) ...
3.2. 実行
そして、Checkmk サーバーが利用できないホットフェーズに入ります。
-
Checkmk サイトを停止します。
root@linux# omd stop mysite -
使用している Checkmk インストールを指すソフトリンクの名前を変更します。次のコマンドを実行すると、
versionが_versionに変更されます。root@linux# mv -v /opt/omd/sites/mysite/{,_}version -
これで、Checkmk をアンインストールできます。 この場合、既存の設定ファイルは保持されます。
root@linux# apt-get remove -y check-mk-enterprise-2.4.0p2 Reading package lists... Done Building dependency tree Reading state information... Done The following packages will be REMOVED: check-mk-enterprise-2.4.0p2* ... -
各ディストリビューターが提供する指示に従って、Linux のアップグレードを実行します。 Ubuntu の場合、以下のようになります。
root@linux# do-release-upgrade再起動が推奨される場合は、次の手順に進む前にその指示に従ってください。
-
使用している Checkmk インストールを指すソフトリンクの登録を解除します。次のコマンドで、
_versionからversionに戻します。root@linux# mv -v /opt/omd/sites/mysite/{_,}version -
次に、使用しているディストリビューションの新しいバージョンと一致する Checkmk のパッケージをインストールします。 Ubuntu の場合、この時点で次のコマンドを実行するだけで十分です。
root@linux# apt install /tmp/check-mk-enterprise-2.4.0p2_0.noble_amd64.debCheckmk を再インストールする場合は、お使いのディストリビューションに応じた詳細なインストール手順に従ってください。
-
Checkmk サイトを再起動してください。
root@linux# omd start mysite
4. アーカイブ、再インストール、および復元（アップグレードの置き換え）
この方法は、仮想化環境で Checkmk を使用する場合に役立ちます。この環境では、準備として、新しいディストリビューションバージョンの 2 台目のサーバーを「プルアップ」し、これを並行して初期テストを行うことができます。 さらに、このアプローチは、Linux ディストリビューションも同時に変更できるため、柔軟性が高くなります。 技術的には、これはシステム障害が発生した場合の手順に対応しています。
4.1. 準備
最も重要な準備手順は、新しいディストリビューションバージョンに適した Checkmk インストールパッケージをダウンロードすることです。
サイトで使用されている Checkmk バージョンの概要を確認します。
root@linux# omd sites
SITE VERSION COMMENTS
mysite 2.4.0p2.cee default versionサイトに関する情報に基づいて、新しいオペレーティングシステムバージョン用の適切なインストールパッケージをダウンロードする必要があります。
重要：Checkmk のエディションおよびバージョン番号は、以前使用していたものとまったく同じである必要があります。
4.2. 実行
ここで順を追って説明する手順は、多くの場合、部分的に並行して実行することができます。これにより、仮想マシンを使用している場合や、新しいハードウェアの取得がすでにスケジュールされている場合など、ダウンタイムを最小限に抑えることができます。
-
Checkmk サイトを停止します。この手順は必須ではありませんが、データの整合性を確保するために推奨されます。
root@linux# omd stop mysite -
サイトのアーカイブ（他の状況ではバックアップ）を作成します。 この例では、ネットワーク共有をターゲットとして使用しています。これは、後で新しいインストールでも使用できます。
OMD[mysite]:~$ omd backup /mnt/someshare/mysite.tgz 次に、ターゲットシステムを準備し、Checkmk に必要なソフトウェア（電子メールシステムなど）を構成します。 ソースシステムと同じホスト名と IP アドレスを使用してください。
-
新しいディストリビューションに適した、以前にダウンロードした Checkmk バージョンをインストールします。
Ubuntu の場合、この時点で次のコマンドで十分です。
root@linux# apt install /tmp/check-mk-enterprise-2.4.0p2_0.noble_amd64.deb -
バックアップしたサイトと同じ名前の新しいサイトを作成します。
root@linux# omd create mysite -
次に、サイトユーザーとして、アーカイブから復元を行います。
OMD[mysite]:~$ omd restore /mnt/someshare/mysite.tgz -
Checkmk サイトを再起動します。
OMD[mysite]:~$ omd start