Documentation

アップグレードの基本

Liferayのツールや説明書は、DXPやポータルCE環境を安全かつ迅速にアップグレードするのに役立ちます。 小さなデータセットを持つ非クラスター環境などは、Dockerイメージを使ってアップグレードすることができます。 複雑で、より大きなデータセットを持つ、または多くのカスタマイズがあるDXP環境およびポータルCE環境は、データベースアップグレードツールを使用してアップグレードします。

警告

アップグレードする前に、必ずデータベースとインストールを バックアップ してください。 バックアップコピーでアップグレードプロセスをテストすることをお勧めします。

注釈

Docker経由でのアップグレード は、小規模でカジュアルなポータルCE環境でデータベースをアップグレードする最も簡単な方法です。

アップグレードを始める前に、必要な項目を検討しましょう。 アップグレードに関するトピックは、次のカテゴリに分類されます。

準備と計画

準備と計画は、小規模でカジュアルなインストールではあまり重要でない場合がありますが、大規模なエンタープライズレベルのインストールでは 必須 です。

利用可能なアップグレードパスの確認

次の表で現在のLiferay DXP/ポータルのバージョンを調べて、インストールのアップグレードパスを確認してください。

アップグレードパス

説明

Liferay DXP/Portal 6.2+ → DXP 7.3

Liferay Portal 6.1.x → DXP/Portal 7.1 → DXP 7.3

Liferay Portal 6.1のサポート期間は終了しました

Liferay Portal 5.xおよび6.0.x → Liferay Portal 6.2 → Liferay DXP 7.3

Liferay Portal 5.0、5.1、5.2、および6.0のサポート期間は終了しました

パスにLiferay Portal 6.2へのアップグレードが含まれている場合は、最初に Liferay Portal 6.2のアップグレード手順 に従ってください。

非推奨項目およびデフォルト設定の変更点を確認する

Liferayの新しいバージョンでは、機能と構成のデフォルトが変更されている場合があります。 最新の非推奨項目および機能と設定の変更点については、リファレンスセクションまたは次の記事を参照してください。

アップグレードパッチのリクエスト(サブスクリプション)

サブスクリプション

Liferay DXPサブスクリプションをお持ちの場合は、最新のフィックスパックにアップデートするか、データベースのアップグレードの準備をするためのアップグレードパッチをリクエストしてください。 このプロセスを開始するには、 ヘルプセンター でチケットを提出してください。

マーケットプレイスアプリの更新

Liferayデータベースをアップグレードする前に、マーケットプレイスアプリを現在使用しているLiferayバージョンの最新バージョンに更新する必要があります。 アプリの更新をスキップすると問題が発生し、アプリが新しいLiferayバージョンで有効にならない場合があります。

重要

アップグレードする前に、現在のインストールでこれを行ってください。

データベースをアップグレードした後、新しいLiferayインスタンスの最新のアプリバージョンをインストールします。

カスタム開発のアップグレード

開発したプラグイン(テーマ、アプリ、カスタマイゼーションなど)は、新しいLiferayバージョンに適合させる必要があります。 これは、依存関係の更新と同じくらい簡単な場合もあれば、APIの変更に合わせたコードの更新が必要な場合もあります。 カスタムプラグインの更新をしないと、新しいLiferayバージョンで無効になる場合があります。 カスタム開発のアップグレード では、コードのアップグレードのプロセスを説明しています。

構成とインフラストラクチャの移行と更新

構成と対応するインフラストラクチャを、以前のインストールから新しいインストールに移行して更新する必要があります。

重要

6.2以前からアップグレードする場合は、ファイルストアの構成を更新します。 詳細は、 Updating the File Store を参照してください。

データベースのアップグレードが完了してから、他の設定を更新します。 詳細は、構成とプロパティの移行を参照してください。

アップグレードパフォーマンスの向上

不要なデータをそのままにしておいたり、パフォーマンスチューニングをしていないと、大規模なデータセットのアップグレードに非常に長い時間がかかる場合があります。 データベースのアップグレードを迅速化する方法はいくつかあります。

データを削除する

Liferayサーバーに不要なインスタンス、サイト、ページ、またはバージョン管理されたコンテンツアイテム(Webコンテンツの記事、ドキュメント、メディアファイルなど)がある場合、それらを削除するとアップグレード時間が大幅に短縮されます。 不要なデータを削除する方法については、より高速なアップグレードのためのデータベースのプルーニングを参照してください。

データベースのパフォーマンスを調整する

アップグレード操作(本番環境よりもデータ書き込みが多い)用にデータベースを調整すると、データベースのアップグレードパフォーマンスが向上します。 詳細は、アップグレードのためのデータベース調整を参照してください。

データベースのアップグレードの実行

Liferayデータベースをアップグレードするには、2つの方法があります。

  • Dockerによるアップグレードでは、Dockerイメージを起動するためのコマンドに自動アップグレードパラメータを渡します。 イメージはデータベースを更新し、アップグレードされたデータベースを使用して起動します。

  • データベースアップグレードツールの使用 。 アップグレードツールは、Liferayインスタンスから切り離された状態でLiferayデータベースを更新するためのクライアントプログラムです。 これにより、アップグレードプロセスに重点が置かれ、アップグレード操作のためのデータベースの調整不要なデータの削除が容易になり、データベースのアップグレードが迅速化されます。

まとめ

上記のタスクを完了すると、アップグレードが完了します。 ただし、Liferayを使用する前に、必要なランタイム設定を再確立し、アップグレード固有の調整を元に戻す必要があります。 さらに、新しいLiferay本番環境インスタンスに推奨される、以前のLiferayバージョンでは利用できなかったアプリケーションがある場合があります。 詳細は、アップグレード後の考慮事項を参照してください。

アップグレードコンポーネントについて理解したので、Liferayインスタンスをアップグレードできます。 データベースをアップグレードする前に、現在のインストールで準備作業を必ず行ってください。 カスタムプラグインコードのアップグレードとデータベースのアップグレードを並行して実行するのが一般的です。 データベースのアップグレードは最初に開始する一般的なタスクであるため、以下に2つの方法へのリンクを示します。

さらに、アップグレードに関連する以下のアップグレードシナリオを参照してください。