BTRFSがマウントまたはロードされている際にアップグレードが失敗し、パーティション内のデータが失われる事象について確認する方法
Issue
Alma OSは「BTRFS」をサポートしていないため、BTRFSファイルシステムを使用している場合、これはサポートされなくなり、データが失われる可能性があります。(Netwitnessにて、デフォルトではbtrfsファイルシステムを使用しません。) 万が一Netwitnessお客様の中で使用している場合は、ALMA OSにアップグレードする前に、btrfsパーティションをアンマウントし、そこに存在するデータを再配置する必要があります。
シナリオ 1
os-migration-checklistパラメータを指定して「nw-precheck-tool」を実行すると、このKB記事を確認するためのリファレンスが表示されます。
シナリオ 2
precheck ツールが実行されておらず、BTRFS ファイルシステムがマウントされている場合、Leapp Preupgrade失敗でアップグレードに失敗します。以下のエラーが「/var/log/salt/minion」ログと「/var/log/leapp/leapp-report.txt」に表示されます。
Leappはbtrfsを阻害要因として扱い、アップグレードを停止します。
/var/log/salt/minion
[salt.loaded.ext.module.nw_platform:523 ][INFO ][15475] [4/5] Running leapp pre-upgrade
[salt.loaded.ext.module.nw_platform:556 ][ERROR ][15475] Failed to execute "leapp preupgrade"
[salt.loaded.ext.module.nw_platform:556 ][ERROR ][15475] Failed to execute "leapp preupgrade"
Risk Factor: high (inhibitor)
Title: Btrfs has been removed from RHEL8
Summary: The Btrfs file system was introduced as Technology Preview with the initial release of Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 7. As of versions 6.6 and 7.4 this technology has been deprecated and removed in RHEL8.
Title: Btrfs has been removed from RHEL8
Summary: The Btrfs file system was introduced as Technology Preview with the initial release of Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 7. As of versions 6.6 and 7.4 this technology has been deprecated and removed in RHEL8.
対処法: [ヒント] 実行中のシステムからモジュールをアンロードするには、付随するコマンドをチェックしてください。
[コマンド] modprobe -r btrfs
Cause
BTRFSパーティションはALMAではサポートされていません。OS移行時にBTRFSがマウントされていると、アップグレードが失敗し、パーティションに存在するデータが失われ、アップグレード後にNW経由で利用できなくなります。
Resolution
ケース 1:BTRFSがマウントされている場合- 以下のコマンドを実行して、BTRFSがマウントされているかどうかを確認する
mount | grep btrf
- 以下の手順に従って、BTRFSパーティションをアンマウントしてください。
ii. 以下のコマンドでBTRFSパーティションをアンマウントする。
umount -l <btrfs partition path>
iii. btrfs パーティション情報は /etc/fstab や df -hT コマンドで取得できます。
iv. /etc/fstab から BTRFS パーティションを削除する。
v. 「lsmod | grep btrfs」を使用して、カーネルがまだアンロードされているかどうかを確認する。
vi. カーネルがまだロードされている場合は、以下のコマンドでbtrfsカーネル・モジュールをアンロードする。
iv. /etc/fstab から BTRFS パーティションを削除する。
v. 「lsmod | grep btrfs」を使用して、カーネルがまだアンロードされているかどうかを確認する。
vi. カーネルがまだロードされている場合は、以下のコマンドでbtrfsカーネル・モジュールをアンロードする。
modprobe -r btrfs
vii. アップグレードをトリガー、もしくは、リトリガーする。
ケース 2: BTRFSがロードされているが、マウントされていない場合
- 以下のコマンドを実行して、BTRFSがマウントされているかどうかを確認する。
lsmod | grep btrfs
- 以下のコマンドを実行し、BTRFSをアンロードする。
modprobe -r btrfs注: BTRFSをアンロードする前に、BTRFSパーティションがアンマウントされていることを確認してください。
Notes
本ナレッジの英語版は How to check Upgrade Fails and Data in Partition is Lost when BTRFS is Mounted or Loadedとなりますので、ご参照ください。Product Details
NetWitness Product Set: NetWitness PlatformNetWitness Product/Service Type: すべてのノード
NetWitness Version/Condition: 12.3.x ,12.4 以降
Platform: Alma & CentOS
Summary
BTRFSパーティションはALMAではサポートされていません。 OSの移行中にBTRFSがマウントされている場合、アップグレードは失敗し、パーティションに存在するデータは失われます。 ALMA OSにアップグレードする前に、BTRFSパーティションをアンマウントし、そこに存在するデータを再配置するようお客様に注意させる必要があります。
Approval Reviewer Queue
Technical approval queue