第9章トラブルシューティング

インプレースアップグレードは複雑なプロセスであり、問題や障害が発生することがよくあります。次のトラブルシューティングリソースとヒントを参照し、問題の解決に役立ててください。

9.1. トラブルシューティングのリソース
リンクのコピー

アップグレードプロセス全体で発生する問題を診断および解決するために、さまざまなトラブルシューティングリソースを使用できます。

コンソールの出力

デフォルトでは、エラーおよび重大のログレベルのメッセージのみが Leapp ユーティリティーによってコンソール出力に出力されます。ログレベルを変更するには、leapp upgrade コマンドで --verbose または --debug オプションを使用します。

ログ

/var/log/leapp/leapp-upgrade.log ファイルには、initramfs フェーズで見つかった問題が記載されます。
/var/log/leapp/dnf-debugdata/ ディレクトリーには、トランザクションのデバッグデータが含まれます。このディレクトリーは、leapp upgrade コマンドを --debug オプション付きで実行した場合にのみ存在します。
/var/log/leapp/answerfile には、Leapp が回答を求めている質問が記載されます。
journalctl ユーティリティーでは、すべてのログが出力されます。

レポート

/var/log/leapp/leapp-report.txt ファイルには、アップグレード前のフェーズで見つかった問題が記載されます。レポートは Web コンソールでも利用できます。Web コンソールを使用したアップグレードの可能性の評価および自動修復の適用を参照してください。
/var/log/leapp/leapp-report.json ファイルには、マシンが判読可能な形式でアップグレード前のフェーズで見つかった問題が記載され、カスタムスクリプトを使用してレポートを処理することができます。詳細は Red Hat Enterprise Linux のアップグレード前のレポートワークフローの自動化を参照してください。