Documentation

構成とプロパティの移行

現在のDXPインストールのOSGi構成(7.0以降)とプロパティ(ポータルプロパティシステムプロパティなど)によって、ニーズに合わせてDXPインスタンスがセットアップされます。 これらの設定を新しいDXPインスタンスで使用するには、それらを新しいLiferay Homeに移行して更新する必要があります。

Liferayホームおよびアプリケーションサーバーファイルの移行

  1. バックアップからインストールに追加および編集した Liferayホームファイル および アプリケーションサーバーファイル をマージします。 ファイルには次のものが含まれる場合がありますが、これらに限定されません。

    • /license/*:アクティベーションキー。 (サブスクリプション)

    • /log/*:ログファイル。

    • /osgi/configs/*.config:OSGi設定ファイル。

    • portal-*.propertiesportal-ext.propertiesのようなポータルプロパティファイル。

    • アプリケーションサーバーファイル:変更されたスクリプトと設定ファイル。

    • web.xml:ポータルWebアプリケーション記述子。

  2. 新しいインストールの[Liferay Home]/dataフォルダを、バックアップの[Liferay Home]/dataフォルダと置き換えます。

  3. ファイル ストア (ドキュメント ライブラリ)を、バックアップから新しいインストールにコピーするか、または .configファイル を介して使用するように新しいインストールを設定してセットアップします。

データベースアップグレードの設定の更新

DXPおよび一部のマーケットプレイスアプリのアップグレードプロセスでは、ポータルプロパティとOSGi構成を使用します。 カスタムコードのアップグレードプロセスでも、プロパティの更新と構成の更新が必要になる場合があります。 これらの設定と更新は、データベースのアップグレード に行う必要があります。 その他の更新は、データベースのアップグレード後に行うことができます。

DXPアップグレードプロセスに必要な設定の更新は次のとおりです。

重要

マーケットプレイスアプリとカスタムコードで、必要な設定の更新を確認してください。

データベースドライバー

推奨されるデータベースドライバーについては、データベースベンダーのドキュメントを確認してください。 新しいドライバーが推奨されている場合は、既存のドライバーのJARファイルを置き換え、portal-ext.propertiesファイルのjdbc.default.driverClassNameプロパティを新しいドライバークラス名で更新します。

MySQLの例:

jdbc.default.driverClassName=com.mysql.cj.jdbc.Driver

その他のドライバーの例については、 データベーステンプレート を参照してください。

ポータルプロパティの移行

重要

locales ポータルプロパティ をオーバーライドした場合は、アップグレードする前に新しいインストールでそれをオーバーライドしてください。 これにより、すべてのロケールのデータが確実にアップグレードされます。

ここで説明するプロパティは、データベースのアップグレード後に更新できます。 プロパティの移行には、次のアクションが含まれます。

  • liferay.homeプロパティを更新する(変更している場合)

  • Blade CLIを使用してプロパティの変更を報告する

  • プロパティをOSGi構成に変換する

  • プロパティの移行に関する特別な考慮事項

ブレードCLIを使用して互換性のないプロパティを報告する

Blade CLIツールのupgradePropsコマンドは、ポータルプロパティファイル間の変更を報告します。 このツールは、次のタイプの変更を報告します。

  • 更新されていない場合に例外を発生させるプロパティ。

  • モジュールのportal.propertiesファイルに移動されたプロパティ。

  • OSGi構成に移動されたプロパティ。

  • 新しいDXPバージョンにはないプロパティ。

多くの場合、upgradePropsコマンドは、必要な更新を説明するか、プロパティの変更に関する詳細情報を参照します。

blade upgradePropsコマンドの形式:

blade upgradeProps -p {old_liferay_home_path}/portal-ext.properties -d {new_liferay_home_path}

次に、blade upgradePropsコマンドを実行した場合の出力例を示します。

...
index.search.query.suggestion.dictionary
    MODULARIZE AS OSGI - This property matches with the following OSGI config, select the most appropriate:
        - searchQueryResultWindowLimit from com.liferay.portal.search.configuration.DefaultSearchResultPermissionFilterConfiguration

index.search.spell.checker.dictionary
    KEEP - This property is still present in the new portal.properties.

sites.friendly.url.page.not.found
    KEEP - This property is still present in the new portal.properties.

web.server.protocol
    KEEP - This property is still present in the new portal.properties.
...

プロパティをOSGi構成に変換する

モジュール化された機能のプロパティが変更され、OSGi構成ファイル(OSGi構成管理)にデプロイされるようになりました。

たとえば、6.2では、Simple File Storeがこのポータルプロパティを使用して、ストアのルートディレクトリを指定していました。

dl.store.file.system.root.dir=${liferay.home}/data/document_library

これで、ストアはcom.liferay.portal.store.file.system.configuration.FileSystemStoreConfiguration.configと呼ばれる.configファイルで構成され、次のような設定でルートディレクトリを指定します。

rootDir="{document_library_path}"

.configファイルを[Liferay Home]/osgi/configsというフォルダに配置します。

   コントロールパネルの[*System Settings*]画面([*Configuration*]の下)は、OSGi構成管理の値を管理します。 これらの画面は ``.config`` ファイルを作成する最も正確な方法です。 構成する機能の構成画面を見つけて*保存*をクリックし、オプションボタンを [使用して画面の構成](../../../system-administration/configuring-liferay/configuration-files-and-factories/using-configuration-files.md) を ``.config`` ファイルにエクスポートします。

プロパティの移行に関する特別な考慮事項

特定の環境、Liferayのバージョン、および機能に関連するプロパティを移行するためのリソースがあります。 便宜上、ここで呼び出しています。

  1. ファイルストア設定の更新については、Updating the File Storeで説明しています。

  2. Liferay Portal 6.1以前を使用している場合は、 Liferay Portal 6.2で導入された新しいデフォルトにプロパティを適合 させてください。

  3. シャード化された環境がある場合は、シャード化されていない環境を生成するようにアップグレードを構成します。

  4. 7.3および7.2でのデフォルトのポータルプロパティの変更を調べます。

  5. Liferayの画像スプライトフレームワークは7.2で非推奨になり、デフォルトでは無効になっています。 フレームワークには、画像スプライト用のスキャンプラグインが必要です。 フレームワークを使用しない場合、画像スプライトをスキャンするためにフレームワークを使用する必要はありません。 フレームワークを使用する場合は、デフォルトのsprite.enabledポータルプロパティ(7.2以降)の値を、portal-ext.propertiesファイルの次の設定でオーバーライドすることにより、フレームワークを有効にします。

    sprite.enabled=true
    

    注釈

    好きなフレームワークを使用して画像スプライトを作成し、プラグインにデプロイできます。

  6. 7.3以降、キャッシュはEhcache XMLファイルを使用してのみ構成されます。 ポータルプロパティでキャッシュを有効にしたり設定したりすることができなくなりました。 ポータルプロパティを使用してキャッシュを構成した場合は、モジュール内のEhcache XMLファイルを使用してキャッシュを構成してください。 詳細は、 キャッシュ構成 を参照してください。

次のステップ

Liferayの設定を新しいDXPインスタンスで使用する準備ができました。 次に、ファイルストアを更新します。