データベースのアップグレード
Liferayのツールや説明書は、DXPやポータル環境を安全かつ迅速にアップグレードするのに役立ちます。 データ セットが小さい非クラスター環境は、 Docker イメージを使用してアップグレードできます。 大規模なデータ セットや多くのカスタマイズが含まれる複雑な DXP およびポータルは、 データベース アップグレード ツールを使用してアップグレードされます。 起動時に自動アップグレード を有効にすることもできます。
クラスタ化またはシャード化されたインストールについては、 クラスタ化およびシャード化された環境のアップグレードを参照してください。
Liferay データベースをアップグレードするには、次のいくつかの方法があります。
-
データベース アップグレード ツール は、サーバーがオフラインのときにコアおよびモジュール データベースのアップグレードを実行できます。
-
自動アップグレード をポータルプロパティで有効にすると、Liferay の起動時にアップグレードが実行されます。
-
Docker イメージ では、次の環境変数を使用して、構成されたデータベースでデータベース アップグレード ツールを自動実行できます。
-e LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN=true -
Gogo Shell コマンド を使用すると、サーバーの実行中にモジュールのアップグレードを一覧表示して呼び出すことができます。 ただし、コア データベースのアップグレードには他のいずれかの方法が必要です。
リリース、更新、およびパッチには、データベース スキーマの変更をアップグレードするために使用できるさまざまなオプションがあります。 次の表に、各スキーマ変更レベルのデータベース アップグレード オプションを示します。
| データベーススキーマの変更 | データベースアップグレードオプション |
|---|---|
| モジュールマイクロバージョン (オプションのアップグレード) | * データベースアップグレードツール * 自動アップグレード * Dockerイメージ * Gogoシェル |
| モジュールメジャー/マイナーバージョン (必須アップグレード) | * データベースアップグレードツール * 自動アップグレード * Dockerイメージ * Gogoシェル |
| コアデータスキーマ(必須アップグレード) | * データベースアップグレードツール * 自動アップグレード * Dockerイメージ |
データベースのアップグレードは、対象となる新規インストールから行うことも、データベースのアップグレードに便利な別のインストールから行うこともできます。 たとえば、アプリケーションサーバーを使用している場合は、新しい Liferay Docker イメージを使用してデータベースをアップグレードし、新しい Liferay WAR と依存関係をアプリケーションサーバーにインストールし、アプリケーションサーバーを再起動して新しい Liferay バージョンを実行できます。
DXP/Portalのインストールには3つのタイプがあります。
ここでは、各インストールタイプでデータベースのアップグレードオプションを使用するための一般的な手順を説明します。
Liferay Dockerイメージのデータベースアップグレード
データベースアップグレードツールの使用:
-
Liferay Tomcat バンドルを構成します。
-
バンドルからデータベース アップグレード ツールを実行します。
-
アップグレードが正常に完了したら、新規のDockerイメージ上でデータベースを構成します。
Docker の使用:
-
新しいイメージを構成します。
-
アップグレード環境変数を有効にして実行します。
-
アップグレードが正常に完了したら、新規イメージの新規コンテナにデータベースを設定します（アップグレードを有効にしない）。
Liferay Tomcatバンドルのデータベースアップグレード
データベースアップグレードツールの使用:
-
新しい Liferay Tomcat バンドルを構成します。
-
データベースアップグレードツールの実行
Docker の使用:
-
新しい Docker イメージを構成します。
-
アップグレード環境変数を有効にして実行します。
-
アップグレードが正常に完了したら、Liferay Tomcatバンドル上でデータベースを構成します。
アプリケーションサーバインストール時のデータベースアップグレード
データベースアップグレードツールの使用:
-
新しい Liferay Tomcat バンドルを構成します。
-
バンドルからデータベース アップグレード ツールを実行します。
-
アップグレードが正常に完了したら、新規のLiferay WARとOSGiの依存関係をアプリケーションサーバーにインストールします。
Docker の使用:
-
新しい Docker イメージを構成します。
-
アップグレード環境変数を有効にして実行します。
-
アップグレードが正常に完了したら、新規のLiferay WARとOSGiの依存関係をアプリケーションサーバーにインストールします。