構成とプロパティの移行
現在のDXPインストールのOSGi構成（7.0以降）とプロパティ（ポータルプロパティやシステムプロパティなど）によって、ニーズに合わせてDXPインスタンスがセットアップされます。 これらの設定を新しいDXPインスタンスで使用するには、それらを新しいLiferay Homeに移行して更新する必要があります。
概要
Liferayホームおよびアプリケーションサーバーファイルの移行
バックアップからインストールに追加および編集した Liferayホームファイル および アプリケーションサーバーファイル をマージします。 ファイルには次のものが含まれる場合がありますが、これらに限定されません。
/license/*：アクティベーションキー。 (サブスクリプション)/log/*：ログファイル。/osgi/configs/*.config：OSGi設定ファイル。portal-*.properties：portal-ext.propertiesのようなポータルプロパティファイル。- アプリケーションサーバーファイル：変更されたスクリプトと設定ファイル。
web.xml：ポータルWebアプリケーション記述子。
新しいインストールの
［Liferay Home］/dataフォルダを、バックアップの［Liferay Home］/dataフォルダと置き換えます。ファイル ストア (ドキュメント ライブラリ)を、バックアップから新しいインストールにコピーするか、または
.configファイル を介して使用するように新しいインストールを設定してセットアップします。
データベースアップグレードの設定の更新
DXPおよび一部のマーケットプレイスアプリのアップグレードプロセスでは、ポータルプロパティとOSGi構成を使用します。 カスタムコードのアップグレードプロセスでも、プロパティの更新と構成の更新が必要になる場合があります。 これらの設定と更新は、データベースのアップグレード 前 に行う必要があります。 その他の更新は、データベースのアップグレード後に行うことができます。
DXPアップグレードプロセスに必要な設定の更新は次のとおりです。
- データベースドライバー
- ドキュメントライブラリストアの実装名（ Updating the File Store を参照）
マーケットプレイスアプリとカスタムコードで、必要な設定の更新を確認してください。
データベースドライバー
推奨されるデータベースドライバーについては、データベースベンダーのドキュメントを確認してください。 新しいドライバーが推奨されている場合は、既存のドライバーのJARファイルを置き換え、portal-ext.propertiesファイルのjdbc.default.driverClassNameプロパティを新しいドライバークラス名で更新します。
MySQLの例：
jdbc.default.driverClassName=com.mysql.cj.jdbc.Driver
その他のドライバーの例については、 データベーステンプレート を参照してください。
ポータルプロパティの移行
locales ポータルプロパティをオーバーライドした場合は、アップグレードする前に新しいインストールでそれをアップグレードしてください。 これにより、すべてのロケールのデータが確実にアップグレードされます。
ここで説明するプロパティは、データベースのアップグレード後に更新できます。 プロパティの移行には、次のアクションが含まれます。
liferay.homeプロパティを更新する（変更している場合）- ブレードCLIを使用してプロパティの変更を報告する
- プロパティをOSGi構成に変換する
- プロパティの移行に関する特別な考慮事項
Blade 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ファイルを作成する最も正確な方法です。 設定したい機能を設定している画面を見つけて Save をクリックし、オプションボタンを使って 画面の設定をエクスポートする して .config ファイルに保存します。
プロパティの移行に関する特別な考慮事項
特定の環境、Liferayのバージョン、および機能に関連するプロパティを移行するためのリソースがあります。 便宜上、ここで呼び出しています。
ファイルストア設定の更新については、Updating the File Storeで説明しています。
Liferay Portal 6.1以前を使用している場合は、 Liferay Portal 6.2で導入された新しいデフォルトにプロパティを適合 させてください。
シャード化された環境がある場合は、シャード化されていない環境を生成するようにアップグレードを構成します。
Liferayの画像スプライトフレームワークは7.2で非推奨になり、デフォルトでは無効になっています。 フレームワークには、画像スプライト用のスキャンプラグインが必要です。 フレームワークを使用しない場合、画像スプライトをスキャンするためにフレームワークを使用する必要はありません。 フレームワークを使用する場合は、デフォルトの
sprite.enabledポータルプロパティ（7.2以降）の値を、portal-ext.propertiesファイルの次の設定でオーバーライドすることにより、フレームワークを有効にします。sprite.enabled=truenote好きなフレームワークを使用して画像スプライトを作成し、プラグインにデプロイできます。
次のステップ
Liferayの設定を新しいDXPインスタンスで使用する準備ができました。 次に、ファイルストアを更新します。