構成とプロパティの移行
現在の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=true
note好きなフレームワークを使用して画像スプライトを作成し、プラグインにデプロイできます。
次のステップ
Liferayの設定を新しいDXPインスタンスで使用する準備ができました。 次に、ファイルストアを更新します。