データ初期化

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

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

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

Liferay DXP 2025.Q4+

すべてのアップグレードの前と、ベリファイ処理の実行後に、データ・クリーンアップ処理は、アップグレードに失敗する最も頻繁な原因についてデータベースをチェックします。 次に、不要になった孤立データを削除し、誤った値を修正し、もはや存在しないデータへの参照を消去します。

データクリーンアップ処理が失敗した場合、アップグレードは直ちに停止され、エラーがコンソールに記録されます。 アップグレード レポートには追加情報が含まれており、そのほとんどは 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のインストール環境で検出された場合にのみ表示されます。 手順はLiferayのバージョンによって異なります。

Liferay DXP 2026.Q1+

まず、システムデータをクリーンアップしてください。

1. グローバルメニュー を開き、 コントロールパネル → サーバー管理 → リソース →システムクリーンアップアクション に移動します。

   

2. をクリックして を実行すると、データが削除されます。

重要

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

次に、古くて利用できないアプリやモジュールから不要なデータを削除します。

1. グローバルメニュー を開き、 コントロールパネル → サーバー管理 → リソース → モジュールクリーンアップアクション に移動します。

   

2. をクリックして を実行し、古いモジュールデータを削除します。

注

モジュールクリーンアップ処理は一度しか実行できません。 処理が完了すると、モジュールのリリースエントリは削除され、重複したクリーンアップを避けるため、以降のシステム起動時には表示されません。

Liferay DXP 7.4 から Liferay DXP 2025.Q4 への移行

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

   

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

   • 期限切れの記事

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

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

   重要

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

3. ［保存］をクリックします。

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

1. グローバルメニュー () を再度開き、 コントロールパネル → システム設定 → アップグレード → データクリーンアップ に移動します。

   

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

   注

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

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

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

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

注

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

関連トピック

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