Liferayの旧バージョンをアップデートする
常に最新の情報を得ることで、最高のセキュリティと品質を得ることができます。
-
セキュリティアップデート は、最新のセキュリティ問題に即座に対応するためのリリースです。
-
アップデート は、最新のセキュリティアップデート、確認されたバグの修正、新機能の追加などを行ったリリースです。 これらの機能はデフォルトでは無効になっていますが、必要に応じてUIでオプトインすることができます。
ここでは、新しいLiferay Dockerイメージへのアップデート、新しいLiferay Tomcat Bundleへのアップデート、アプリケーションサーバーのLiferayインストールのアップデートの方法をご紹介します。
Liferay DXP/Portalをアップデートする前に、必ず データベースとインストールをバックアップしてください。
Liferay DXP 7.3 SP3以前のバージョンでは、代わりにパッチモデルを使用しています。 Liferay DXP 7.3 SP3以前のバージョンをお使いの方は、Patching 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/*アプリケーションサーバーのキャッシュを削除します。 キャッシュの場所については、アプリケーションサーバーのベンダーのドキュメントを参照してください。
noteモジュールの変更が内部のみである場合、変更は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バンドルへの更新
-
変更した System Settings ( ファイルストレージ と Elasticsearch の設定を含む) を
.configファイル にエクスポートし、[Liferay Home]/osgi/configs/フォルダーにコピーしてください。例えば、 Advanced File System Store または 簡易ファイルシステムストア を使用している場合、ファイルストア設定を
.configファイル にエクスポートし、[Liferay Home]/osgi/configs/フォルダにコピーしてください。 以下に例を示します。com.liferay.portal.store.file.system.configuration.AdvancedFileSystemStoreConfiguration.configファイルに必要なrootDirパラメータ。rootDir="data/document_library" -
Commerce を使用していて、リリースノートにCommerceのデータベースのアップグレードが記載されている場合は、アップグレードの準備をしてください。 詳細については、 Liferay Commerceのアップグレード を参照してください。
-
アプリケーションサーバーをシャットダウンします。
理由:
- Unixスタイルのシステムでは、通常、実行中のファイルを置き換えることができますが、古いファイルはメモリに常駐します。
- Windowsシステムでは、使用中のファイルはロックされており、パッチを適用できません。
-
インストールをバックアップしてください。
-
ヘルプセンター (サブスクライバー) または コミュニティダウロード から、ご希望のLiferay DXP/Portal Tomcatバンドルのアップデートをダウンロードしてください。
-
バンドルを任意の場所に解凍します。
-
新しいバンドルの
[Liferay Home]/dataフォルダを、 バックアップのの[Liferay Home]/dataフォルダに置き換えます。 -
これらのファイルをバックアップから新しいインストールにコピーします。
- 設定ファイル（
.configファイル）。 - DXPアクティベーションキー（サブスクライバー）
- ポータルプロパティ (例：
portal-ext.properties)
詳細は、構成とプロパティの移行を参照してください。
- 設定ファイル（
-
Tomcatのカスタマイズ内容（
[tomcat version]/confフォルダのコンテンツや追加したライブラリなど）を、 バックアップ から新しいインストールに複製します。 -
カスタムウィジェットとモジュールを新しいインストールにコピーします。
-
リリースノートにデータベースの変更が記載されている場合は、互換性のある database upgrade option を使用して、すべての必要な変更と必要なオプションの変更を適用します。
-
アプリケーションサーバーを起動します。
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/*アプリケーションサーバーのキャッシュを削除します。 キャッシュの場所については、アプリケーションサーバーのベンダーのドキュメントを参照してください。
noteモジュールの変更が内部のみである場合、変更はOSGiフレームワークからは見えず、モジュールはインストールされたままであり、モジュールの状態は保持されます。 次回のサーバー起動前にOSGiバンドルの状態情報をクリアすることで、そのようなモジュールが適切な状態で再インストールされるようになります。
-
リリースノートにデータベースの変更が記載されている場合は、互換性のある database upgrade option を使用して、すべての必要な変更と必要なオプションの変更を適用します。
-
アプリケーションサーバーを再度起動します。
Liferayインスタンスがアップデートされ、実行されています。