legacy-knowledge-base
公開されました Sep. 10, 2025

Liferay DXPのよくあるアップグレードエラーについて

written-by

Justin Choi

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

legacy-article

learn-legacy-article-disclaimer-text

この記事は、Liferay Digital Experience Platform(DXP)、バージョン7.0または7.1へのアップグレード中に遭遇する可能性のある一般的な設定エラーについて文書化したものです。

このような問題を解決するために、あるいは問題を完全に回避するために、以下をお読みください。

解像度

エラー: DXPへのアップグレードについて

Summary: レガシーポータルのバージョンからのアップグレード処理に失敗することがあります。

一般的な原因

  1. パーミッションアルゴリズム6
    1. Liferay Portal 6.2以降、これまでのアルゴリズムはすべて非推奨となりました。
  2. 文書保存と画像保存: dl.store.impl=image.hook.
    1. Liferayプラットフォームでは、Liferay Portal、バージョン6.1および6.2から、 file.system.store に変更となりました。
  3. データベースの接続が正しくない

推奨ソリューション

  1. ユーザーがどのポータルのバージョンからアップグレードを始めたかにかかわらず、新しいバンドルの portal-ext.propertiesを準備することは非常に重要です。 Liferayはアップグレードのための仮想チェックリストを提供します。 これは非常に短いリストです(長いリストについては、dev.liferay.comとKBの記事の全文をお読みください)。
    1. データベース名や接続先が同じか?
    2. パーミッションアルゴリズムは6に設定されています。
    3. ドキュメントとイメージのストアとフックは、ポータル6.0以前のドキュメントとイメージの別々のギャラリーから、6.1以降の新しい結合したドキュメントとメディアのポートレットへのデータ移行を管理します。
  2. portal-ext.propertiesの他に、JVM、データベース、アプリケーションサーバーに問題がある可能性があります。 Liferay DXPがこれらの環境に対応していることをご確認ください。

予防のためのヒント

  1. アップグレードをスムーズに行うために、アップグレードを開始する前に、データのバックアップを取ることを忘れないでください。
  2. portal.propertiesとportal-ext.propertiesを確認してください。 Liferay DXP にアップグレードする利点として、アップグレードパスが portal.properties にすでに含まれており、 portal-ext.propertiesで書き直す必要がないことが挙げられます。
  3. Liferayは、アップグレードのプロセスに関する広範なドキュメントを提供していますので、アップグレードの前にそれらを読んでください。

追加情報

did-this-article-resolve-your-issue

legacy-knowledge-base