アップグレードのトラブルシューティング
Liferayには、アップグレード時に発生する可能性のある問題を特定して解決するための、すぐに使えるツールや機能が多数用意されています。
トラブルシューティングを行うには、 Gogoシェルコマンドを使用してモジュールを個別にアップグレードし、アップグレードの問題の原因を特定したり、サーバーが稼働中に小規模なアップグレードを実行したりできます。
アップグレードレポートとアップグレードログを有効にするか、 MBeansを使用してアップグレードプロセスを監視およびトラブルシューティングできます。これらのツールを使用することで、パフォーマンスの問題の原因やエラーの原因を特定できます。アップグレードの停止検出機能はデフォルトで実行され、停止していると思われるクエリを報告します。アップグレード手順で数時間アクティビティが見られない場合、停止検出ログは、クエリがリソースロックを待機しているのか、単に時間がかかっているだけなのかを記録します。
Liferay DXP 2026.Q4以降では、アップグレード後にデータベースの検証が実行され、データベースとLiferay DXPで定義されているテーブル、ビュー、列、インデックス、主キーとの間の差異が報告されます。
Liferay DXP 2025.Q3以降、データベースアップグレードツールは、アップグレードを実行する前に検証プロセスを自動的に実行します。これにより、システムに変更が加えられる前にアップグレードが失敗します。このようにすれば、データに影響は出ていないため、データバックアップを復元する必要はありません。
ポータルプロパティを使用すると、これらの検証をスキップできます。
-
upgrade.database.preupgrade.verify.enabled=false検証プロセスを完全に無効にします。検証ツールが誤ってアップグレードをブロックした場合に、これを使用できます。 -
upgrade.database.dl.storage.check.disabled=true、ドキュメントライブラリに固有の検証チェックをスキップします。このプロパティはポータル開発者プロパティに含まれています。
トラブルシューティングの詳細については、 「よくあるアップグレードの問題」を参照してください。