データベースのアップグレード
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の依存関係をアプリケーションサーバーにインストールします。