ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

構成とプロパティの移行

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

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

バックアップから追加および編集した Liferay Home ファイルとアプリケーションサーバーファイルをインストールにマージします。ファイルには次のものが含まれる場合がありますが、これらに限定されません。
- /license/*：アクティベーションキー。 (サブスクリプション)
- /log/*：ログファイル。
- /osgi/configs/*.config：OSGi設定ファイル。カスタム構成ファイルのみをコピーします。 Liferay によって生成された *-default.config ファイルは含めないでください。
- portal-*.properties：portal-ext.propertiesのようなポータルプロパティファイル。
- アプリケーションサーバーファイル：変更されたスクリプトと設定ファイル。
- web.xml：ポータルWebアプリケーション記述子。
新しいインストールの［Liferay Home］/dataフォルダを、バックアップの［Liferay Home］/dataフォルダと置き換えます。
ファイルストア (ドキュメントライブラリ) をバックアップから新しいインストールにコピーするか、 .config ファイル経由でそれを使用するように新しいインストールを構成することによってセットアップします。

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

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

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

データベースドライバー
ドキュメントライブラリストアの実装名（ファイルストアの更新を参照）

重要

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

データベースドライバー

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

MySQLの例：

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

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

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

重要

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

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

liferay.homeプロパティを更新する（変更している場合）
Blade 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 Config Admin) にデプロイされるようになりました。

たとえば、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というフォルダに配置します。

ヒント

コントロールパネルの システム設定 画面 ( 構成の下) は、OSGi Config Admin 値を管理します。これらの画面は、 .config ファイルを作成するための最も正確な方法です。設定したい機能を設定する画面を見つけて、 [保存]をクリックし、オプションボタンを使用して画面の設定を .config ファイルにエクスポートします。

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

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

ファイルストア設定の更新については、ファイルストアの更新で説明します。
Liferay Portal 6.1 以前を使用している場合は、プロパティを Liferay Portal 6.2 で導入された新しいデフォルトに適合させてください。
シャード化された環境がある場合は、アップグレードを構成して、非シャード化された環境を生成します。
7.4、 7.3、および 7.2のデフォルトのポータルプロパティの変更を確認します。
Liferayの画像スプライトフレームワークは7.2で非推奨になり、デフォルトでは無効になっています。フレームワークには、画像スプライト用のスキャンプラグインが必要です。フレームワークを使用しない場合、画像スプライトをスキャンするためにフレームワークを使用する必要はありません。フレームワークを使用する場合は、デフォルトのsprite.enabledポータルプロパティ（7.2以降）の値を、portal-ext.propertiesファイルの次の設定でオーバーライドすることにより、フレームワークを有効にします。
```
sprite.enabled=true
```
注

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

今後の流れ

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