アップグレードのトラブルシューティング

Liferayには、アップグレード時に発生する可能性のある問題を特定して解決するための、すぐに使えるツールや機能が多数用意されています。

トラブルシューティングを行うには、 Gogo シェル コマンド を使用してモジュールを個別にアップグレードし、アップグレードの問題の原因を特定したり、サーバーの実行中に小規模なアップグレードを実行したりできます。

アップグレードレポートやアップグレードログを有効にしたり、MBeansを使用してアップグレードプロセスの監視やトラブルシューティングを行うことができます。 これらのツールを使用することで、パフォーマンスの問題の原因やエラーの原因を特定できます。 アップグレード停止検出 はデフォルトで実行され、停止していると思われるクエリを報告します。 アップグレード手順で数時間アクティビティが見られない場合、停止検出ログは、クエリがリソースロックを待機しているのか、単に時間がかかっているだけなのかを記録します。

Liferay DXP 2025.Q3 以降、 データベースアップグレードツール は、アップグレードを実行する前に検証プロセスを自動的に実行します。 これにより、システムに変更が加えられる前にアップグレードが失敗します。 このようにすれば、データに影響は出ていないため、データバックアップを復元する必要はありません。

注記

ポータルプロパティ を使用して、これらの検証をスキップできます。

• upgrade.database.preupgrade.verify.enabled=false は検証プロセスを完全に無効にします。 検証ツールが誤ってアップグレードをブロックした場合に、これを使用できます。

• upgrade.database.dl.storage.check.disabled=true ドキュメントライブラリに固有の検証チェックをスキップします。 このプロパティは、 ポータル開発者プロパティ に含まれています。

トラブルシューティングの詳細については、 一般的なアップグレードの問題 を参照してください。