Liferayの以前のバージョンを更新する
常に最新の情報を得ることで、最高のセキュリティと品質を得ることができます。
-
セキュリティアップデートは、最新のセキュリティ問題に即座に対応するためのリリースです。
-
アップデート は、最新のセキュリティアップデート、確認されたバグの修正、新機能の追加などを行ったリリースです。 これらの機能はデフォルトでは無効になっていますが、必要に応じてUIでオプトインすることができます。
ここでは、新しいLiferay Dockerイメージへのアップデート、新しいLiferay Tomcat Bundleへのアップデート、アプリケーションサーバーのLiferayインストールのアップデートの方法をご紹介します。
Liferay DXP/Portal を更新する前に、必ず データベースとインストールをバックアップしてください。
Liferay DXP 7.3 SP3以前のバージョンでは、代わりにパッチモデルを使用しています。 Liferay DXP 7.3 SP3 より前のバージョンを使用している場合は、 DXP のパッチ適用 を参照してください。
Liferay DXP/Portal の General Availability (GA) リリースは、ソースコードからビルドされます。 アップデートとセキュリティアップデートはGAに沿って行われ、またソースコードから構築されます。
新しいDocker Imageへのアップデート
-
現在のDockerコンテナをシャットダウンします。
-
Liferayのキャッシュを削除します。
[Liferay Home]/osgi/stateフォルダーを削除します。cd [Liferay Home] rm -rf osgi/state[Liferay Home]/workフォルダーを空にします。rm -rf work/*アプリケーションサーバーのキャッシュを削除します。 キャッシュの場所については、アプリケーションサーバーのベンダーのドキュメントを参照してください。
注モジュールの変更が内部のみである場合、変更はOSGiフレームワークからは見えず、モジュールはインストールされたままであり、モジュールの状態は保持されます。 次回のサーバー起動前にOSGiバンドルの状態情報をクリアすることで、そのようなモジュールが適切な状態で再インストールされるようになります。
-
Docker HubでLiferayのDockerイメージとタグ情報を検索します。
-
データベースの変更やインデックスの変更については、リリースノートを確認してください。
データベースに変更があった場合は、
docker runコマンドでこの環境設定を使用して、データベースのアップグレードが自動的に実行できるようにします。-e LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN=trueインデックスの変更がある場合は、
docker runコマンドで、この環境設定を使用してインデックスの更新を有効にします。-e LIFERAY_DATABASE_PERIOD_INDEXES_PERIOD_UPDATE_PERIOD_ON_PERIOD_STARTUP=true -
新しいDockerイメージを、現在の環境とパラメータ、および必要なデータベース/インデックス環境の設定(前のステップから)で実行します。 例えば、次のコマンドはイメージを実行するためのもので、 は という名前のローカルフォルダを
liferay新しいイメージにバインドマウントします。docker run -it -m 8g -p 8080:8080 \ -v $(pwd)/liferay:/mnt/liferay \ liferay/[place image name here]:[place tag here] -
docker runコマンドでデータベースのアップグレードやインデックスの更新を有効にした場合、コンソールやログにアップグレードの失敗やエラー、追加でアップグレードすべきオプションモジュールなどがすべて報告されます。 Gogo Shell コマンド を使用して、それらにアクセスできます。 アップグレードが正常に完了したら、Dockerコンテナを停止して新しいコンテナを作成し、docker runコマンドを で実行し、データベースのアップグレードやインデックスの更新の環境設定を行わない ようにします。
新しいLiferayアップデートDockerイメージで動作しています。
新しいLiferay Tomcatバンドルへの更新
-
変更したシステム設定 ( ファイル ストレージ と Elasticsearch の設定を含む) を
.configファイル にエクスポートし、それらを[Liferay Home]/osgi/configs/フォルダーにコピーします。例えば、 Advanced File System Store または Simple File System Storeを使用している場合は、ファイル ストアの設定を
.configファイル にエクスポートし、それを[Liferay Home]/osgi/configs/フォルダーにコピーします。 以下に例を示します。com.liferay.portal.store.file.system.configuration.AdvancedFileSystemStoreConfiguration.configファイルに必要なrootDirパラメータ。rootDir="data/document_library" -
Liferay Commerceを使用している場合、リリースノートにCommerceのデータベースのアップグレードに関する記述があれば、アップグレードの準備をしてください。 詳細については、 Liferay Commerce のアップグレード を参照してください。
-
アプリケーションサーバーをシャットダウンします。
理由:
- Unixスタイルのシステムでは、通常、実行中のファイルを置き換えることができますが、古いファイルはメモリに常駐します。
- Windowsシステムでは、使用中のファイルはロックされており、パッチを適用できません。
-
必要な Liferay DXP/Portal Tomcat Bundle のアップデートを ヘルプセンター (購読者) または コミュニティ ダウンロード からダウンロードしてください。
-
バンドルを任意の場所に解凍します。
-
新しいバンドルの
[Liferay Home]/dataフォルダーを、[Liferay Home]/dataフォルダー( バックアップ から)に置き換えます。 -
バックアップ から新しいインストール先に以下のファイルをコピーしてください。
- 設定ファイル(
.configファイル)。 - DXPアクティベーションキー(サブスクライバー)
- ポータルプロパティ (例:
portal-ext.properties)
詳細については、 構成とプロパティの移行 を参照してください。
- 設定ファイル(
-
Tomcatのカスタマイズ内容(
[tomcat version]/confフォルダのコンテンツや追加したライブラリなど)を、 バックアップ から新しいインストールに複製します。 -
カスタムウィジェットとモジュールを新しいインストールにコピーします。
-
リリース ノートにデータベースの変更について記載されている場合は、互換性のある データベース アップグレード オプション を使用して、必要なすべての変更と必要なオプションの変更を適用してください。
-
アプリケーションサーバーを起動します。
LiferayアップデートTomcatバンドルで動作しています。
アプリケーションサーバのインストールのアップデート
-
アップデートの
.warファイルとOSG依存関係のZIPファイルをダウンロードします。 -
アプリケーションサーバーをシャットダウンします。
理由:
- Unixスタイルのシステムでは、通常、実行中のファイルを置き換えることができますが、古いファイルはメモリに常駐します。
- Windowsシステムでは、使用中のファイルはロックされており、パッチを適用できません。
-
アプリケーションサーバーのインストールで、既存のLiferay Webアプリケーションの上に
.warファイルのコンテンツを展開します。サポートされているアプリケーションサーバーへのLiferayのインストールに関する詳細な情報へのリンクです。
-
OSGi依存関係のZIPファイルのコンテンツを、
[Liferay Home]/osgiフォルダにマージします。 -
Liferayのキャッシュを削除します。
[Liferay Home]/osgi/stateフォルダーを削除します。cd [Liferay Home] rm -rf osgi/state[Liferay Home]/workフォルダーを空にします。rm -rf work/*アプリケーションサーバーのキャッシュを削除します。 キャッシュの場所については、アプリケーションサーバーのベンダーのドキュメントを参照してください。
注モジュールの変更が内部のみである場合、変更はOSGiフレームワークからは見えず、モジュールはインストールされたままであり、モジュールの状態は保持されます。 次回のサーバー起動前にOSGiバンドルの状態情報をクリアすることで、そのようなモジュールが適切な状態で再インストールされるようになります。
-
リリース ノートにデータベースの変更について記載されている場合は、互換性のある データベース アップグレード オプション を使用して、必要なすべての変更と必要なオプションの変更を適用してください。
-
アプリケーションサーバーを再度起動します。
Liferayインスタンスがアップデートされ、実行されています。