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

Liferayの以前のバージョンを更新する

常に最新の情報を得ることで、最高のセキュリティと品質を得ることができます。

  • セキュリティアップデートは、最新のセキュリティ問題に即座に対応するためのリリースです。

  • アップデート は、最新のセキュリティアップデート、確認されたバグの修正、新機能の追加などを行ったリリースです。 これらの機能はデフォルトでは無効になっていますが、必要に応じてUIでオプトインすることができます。

ここでは、新しいLiferay Dockerイメージへのアップデート、新しいLiferay Tomcat Bundleへのアップデート、アプリケーションサーバーのLiferayインストールのアップデートの方法をご紹介します。

警告
重要

Liferay DXP 7.3 SP3以前のバージョンでは、代わりにパッチモデルを使用しています。 Liferay DXP 7.3 SP3 より前のバージョンを使用している場合は、 DXP のパッチ適用 を参照してください。

注

Liferay DXP/Portal の General Availability (GA) リリースは、ソースコードからビルドされます。 アップデートとセキュリティアップデートはGAに沿って行われ、またソースコードから構築されます。

新しいDocker Imageへのアップデート

  1. 現在のDockerコンテナをシャットダウンします。

  2. Liferayのキャッシュを削除します。

    [Liferay Home]/osgi/stateフォルダーを削除します。

    cd [Liferay Home]
    rm -rf osgi/state
    

    [Liferay Home]/work フォルダーを空にします。

    rm -rf work/*
    

    アプリケーションサーバーのキャッシュを削除します。 キャッシュの場所については、アプリケーションサーバーのベンダーのドキュメントを参照してください。

    注

    モジュールの変更が内部のみである場合、変更はOSGiフレームワークからは見えず、モジュールはインストールされたままであり、モジュールの状態は保持されます。 次回のサーバー起動前にOSGiバンドルの状態情報をクリアすることで、そのようなモジュールが適切な状態で再インストールされるようになります。

  3. Docker HubでLiferayのDockerイメージとタグ情報を検索します。

  4. データベースの変更やインデックスの変更については、リリースノートを確認してください。

    データベースに変更があった場合は、 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
    
  5. 新しいDockerイメージを、現在の環境とパラメータ、および必要なデータベース/インデックス環境の設定(前のステップから)で実行します。 例えば、次のコマンドはイメージを実行するためのもので、 は という名前のローカルフォルダを liferay 新しいイメージにバインドマウントします。

    docker run -it -m 8g -p 8080:8080 \
    -v $(pwd)/liferay:/mnt/liferay \
    liferay/[place image name here]:[place tag here]
    
  6. docker run コマンドでデータベースのアップグレードやインデックスの更新を有効にした場合、コンソールやログにアップグレードの失敗やエラー、追加でアップグレードすべきオプションモジュールなどがすべて報告されます。 Gogo Shell コマンド を使用して、それらにアクセスできます。 アップグレードが正常に完了したら、Dockerコンテナを停止して新しいコンテナを作成し、 docker run コマンドを で実行し、データベースのアップグレードやインデックスの更新の環境設定を行わない ようにします。

新しいLiferayアップデートDockerイメージで動作しています。

新しいLiferay Tomcatバンドルへの更新

  1. 変更したシステム設定 ( ファイル ストレージ と 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"
    
  2. Liferay Commerceを使用している場合、リリースノートにCommerceのデータベースのアップグレードに関する記述があれば、アップグレードの準備をしてください。 詳細については、 Liferay Commerce のアップグレード を参照してください。

  3. アプリケーションサーバーをシャットダウンします。

    理由:

    • Unixスタイルのシステムでは、通常、実行中のファイルを置き換えることができますが、古いファイルはメモリに常駐します。
    • Windowsシステムでは、使用中のファイルはロックされており、パッチを適用できません。
  4. インストールをバックアップしてください。

  5. 必要な Liferay DXP/Portal Tomcat Bundle のアップデートを ヘルプセンター (購読者) または コミュニティ ダウンロード からダウンロードしてください。

  6. バンドルを任意の場所に解凍します。

  7. 新しいバンドルの [Liferay Home]/data フォルダーを、 [Liferay Home]/data フォルダー( バックアップ から)に置き換えます。

  8. バックアップ から新しいインストール先に以下のファイルをコピーしてください。

    • 設定ファイル(.config ファイル)。
    • DXPアクティベーションキー(サブスクライバー)
    • ポータルプロパティ (例: portal-ext.properties)

    詳細については、 構成とプロパティの移行 を参照してください。

  9. Tomcatのカスタマイズ内容( [tomcat version]/conf フォルダのコンテンツや追加したライブラリなど)を、 バックアップ から新しいインストールに複製します。

  10. カスタムウィジェットとモジュールを新しいインストールにコピーします。

  11. リリース ノートにデータベースの変更について記載されている場合は、互換性のある データベース アップグレード オプション を使用して、必要なすべての変更と必要なオプションの変更を適用してください。

  12. アプリケーションサーバーを起動します。

LiferayアップデートTomcatバンドルで動作しています。

アプリケーションサーバのインストールのアップデート

  1. アップデートの .war ファイルとOSG依存関係のZIPファイルをダウンロードします。

  2. アプリケーションサーバーをシャットダウンします。

    理由:

    • Unixスタイルのシステムでは、通常、実行中のファイルを置き換えることができますが、古いファイルはメモリに常駐します。
    • Windowsシステムでは、使用中のファイルはロックされており、パッチを適用できません。
  3. アプリケーションサーバーのインストールで、既存のLiferay Webアプリケーションの上に.war ファイルのコンテンツを展開します。

    サポートされているアプリケーションサーバーへのLiferayのインストールに関する詳細な情報へのリンクです。

  4. OSGi依存関係のZIPファイルのコンテンツを、 [Liferay Home]/osgi フォルダにマージします。

  5. Liferayのキャッシュを削除します。

    [Liferay Home]/osgi/stateフォルダーを削除します。

    cd [Liferay Home]
    rm -rf osgi/state
    

    [Liferay Home]/work フォルダーを空にします。

    rm -rf work/*
    

    アプリケーションサーバーのキャッシュを削除します。 キャッシュの場所については、アプリケーションサーバーのベンダーのドキュメントを参照してください。

    注

    モジュールの変更が内部のみである場合、変更はOSGiフレームワークからは見えず、モジュールはインストールされたままであり、モジュールの状態は保持されます。 次回のサーバー起動前にOSGiバンドルの状態情報をクリアすることで、そのようなモジュールが適切な状態で再インストールされるようになります。

  6. リリース ノートにデータベースの変更について記載されている場合は、互換性のある データベース アップグレード オプション を使用して、必要なすべての変更と必要なオプションの変更を適用してください。

  7. アプリケーションサーバーを再度起動します。

  Liferayインスタンスがアップデートされ、実行されています。