データ初期化

データベースのアップグレード前に、Liferay はデータ クリーンアップ プロセスを実行して、古いデータを含むデータベースを修復します。 これにより、アップグレード ツールの負荷が軽減され、パフォーマンスが向上し、オーバーヘッドが削減されます。

Liferay DXP 2025.Q4/Portal 2026 以降、これらのプロセスはアップグレードの前に 自動的に実行 されます。 以前のバージョンでは、Liferay は既に 手動で実行する簡単な方法を提供していました。

アップグレード前の自動データクリーンアップ

Liferay DXP 2025年第4四半期以降 / ポータル 2026年第1四半期以降

すべてのアップグレードの前、および 検証プロセスを実行した後、データ クリーンアップ プロセスはデータベースをチェックして、アップグレード失敗の最も一般的な原因を探します。 次に、不要になった孤立データを削除し、誤った値を修正し、存在しなくなったデータへの参照を消去します。

データ クリーンアップ プロセスが失敗した場合、アップグレードは直ちに停止され、コンソールにエラーが記録されます。 アップグレード レポートには、主に upgrade_report_diagnostics.txt ファイルの データ クリーンアップ セクションに追加情報が含まれています。

自動データ クリーンアップはデフォルトで有効になっていますが、ポータル プロパティ upgrade.database.preupgrade.data.cleanup.enabled を falseに設定することで無効にできます。

注

データベース アップグレード ツールを使用してアップグレードする場合は、 tools/portal-tools-db-upgrade-client/portal-upgrade-ext.properties ファイルでポータル プロパティを設定します。

ブラックリストのクリーンアッププロセス

クリーンアップ プロセスは古いデータにのみ影響しますが、データを修復するプロセスをブラックリストに登録することで、重要と思われるデータを保護することができます。 upgrade.database.preupgrade.data.cleanup.blacklist プロパティを、実行しない DataCleanupPreupgradeProcess クラスの名前に設定して、クリーンアップ プロセスのブラックリストを作成します。

upgrade.database.preupgrade.data.cleanup.blacklist=\
	com.liferay.portal.upgrade.data.cleanup.AnalyticsMessageDataCleanupPreupgradeProcess,\
	com.liferay.portal.upgrade.data.cleanup.GroupDataCleanupPreupgradeProcess

注

データベース アップグレード ツールを使用してアップグレードする場合は、 tools/portal-tools-db-upgrade-client/portal-upgrade-ext.properties ファイルでポータル プロパティを設定します。

手動でデータをクリーンアップする

実行中の Liferay インスタンスでデータ クリーンアップ プロセスを手動で実行することもできます。

1. グローバル メニュー () を開き、 コントロール パネル → システム設定 → アップグレード → データの削除の順に進みます。

   

2. 削除するデータを選択します。

   • 期限切れの記事

   • ドキュメントライブラリプレビュー変更追跡ストアコンテンツのデータ（公開）

   • 公開変更追跡ストアコンテンツデータ（公開）

   重要

   Liferayバージョンが 7.3 U10または7.4 U37より前のものを使用している場合のみ、公開変更追跡ストアコンテンツデータを削除します。 タスク実行後は、この不要なデータがこれ以上蓄積されないようにアップグレードしてください。

3. [保存]をクリックします。

Liferay はデータ クリーンアップ プロセスを実行し、現在利用可能なアプリとモジュールから古いデータを削除します。 古くて利用できないアプリやモジュールからすべてのデータを削除するには、

1. もう一度 グローバル メニュー () を開き、 コントロール パネル → システム設定 → アップグレード → データ クリーンアップの順に進みます。

   

2. クリーンアップするモジュールを選択し、［保存］をクリックします。

   注

   クリーンアップ設定を 構成ファイルに保存するには、 [アクション] メニューをクリックし、 [エクスポート]を選択します。

サーバーから古いデータが削除され、すべてのモジュールのデータ クリーンアップが自動的に無効になります。 これにより、不要な重複するデータのクリーンアップが防止されます。

7.4 以前のデータのクリーンアップ

Liferay バージョン 7.3 以前では、データ クリーンアップ設定は保持されます。 これらの古いバージョンでクリーンアップを無効にするには、データクリーンアップ画面ですべてのモジュールのチェックを外して、 保存 をクリックするか、 com.liferay.data.cleanup.internal.configuration.DataCleanupConfiguration.config 構成ファイルでモジュールクリーンアップキー false を設定します。

注

また、 com.liferay.data.cleanup.internal.configuration.DataCleanupConfiguration.config 構成ファイルを使用して、サーバーの起動時にモジュールデータをクリーンアップすることもできます（ Liferay Docker コンテナ またはローカルマシン上）。 クリーンアップ後、 osgi/configs フォルダから構成ファイルを削除して、後続のサーバ起動時にクリーンアップが再度実行されるのを防ぎます。

関連トピック

• 構成ファイルの使用
• Upgrading Via Docker
• コンテナへのファイルの提供
• Using the Upgrade Tool