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

Liferayインスタンスの移行

Liferay DXP 2025.Q2+/ポータル GA148+

ベータ機能

データベースパーティションを抽出および挿入することで、異なる Liferay インストール間で仮想インスタンスを移行できます。たとえば、既存の仮想インスタンスを Liferay Self-Hosted から Liferay PaaS に移動する場合などにこれを実行できます。インストール内の仮想インスタンスをコピーすることもできます。

重要

現在、この機能はベータ機能フラグ (LPD-11342) によってサポートされています。

注

Liferay インストールには、ドキュメントライブラリや検索インデックスなど、スタンドアロンパーティションに抽出されないその他のインフラストラクチャコンポーネントが含まれています。仮想インスタンスを移行またはコピーするときには、これらを個別に処理する必要があります。

抽出ステップでは、Liferay は現在のインストールの仮想インスタンスデータベースからのテーブルのコピーを含むスタンドアロンパーティションを作成します。これにより、 lextracted_[companyId]という新しいデータベーススキーマがトリガーされます。挿入ステップでは、現在のインストールのデータベース内のスタンドアロンパーティションが新しい仮想インスタンスとして統合されます。

重要

Liferay SaaS で仮想インスタンスをエクスポートまたは挿入するには、Liferay Cloud サポートにお問い合わせください。

データベースパーティションの検証

始める前に、データベースの準備ができていることを確認する必要があります。 Liferay には、移行を実行する前にデータベースパーティションを検証するツールが含まれています。ソースデータベースとターゲットデータベースを分析し、互換性があるかどうかを示します。

重要

ソース環境とターゲット環境の両方で MySQL または PostgreSQL を使用し、同じ Liferay バージョンを使用する必要があります。

データベースパーティション移行検証ツールは、エクスポートと検証の 2 つのモードで動作します。

エクスポートモード

ツールをエクスポートモードで実行するには、

bundles/tools/portal-tools-db-partition-migration-validator フォルダに移動します。ツールの .jar ファイルとそれを実行するスクリプトがあります。
ソースデータベースに対して次のパラメータを使用して db_partition_migration-validator.sh を実行します。
- --company-id [arg]: 抽出する仮想インスタンスの会社ID。
- --jdbc-url [arg]: JDBC URL。
- --output-dir [arg] (オプション): ツールが生成された JSON ファイルを出力するディレクトリ。デフォルトでは、ファイルは エクスポート フォルダーに生成されます。
- --password [arg]: データベースユーザーのパスワード。
- --schema-name [arg] (オプション): ソースパーティションのデータベーススキーマ名。デフォルトでは、ツールは --jdbc-url パラメータ内のスキーマを抽出します。
- --help (オプション): パラメータ情報を表示します。
ターゲットデータベースに対してコマンドを再度実行します。

エクスポートモードでは、ソースデータベースとターゲットデータベースに関する情報を含む 2 つの JSON ファイルが作成されます。検証モードでは、これらのファイルを使用して互換性があるかどうかを確認します。

検証モード

エクスポートモードで両方の JSON ファイルを生成した後、同じデータベースパーティション移行検証ツールを使用してそれらを検証できます。ツールを検証モードで実行するには、

引き続き bundles/tools/portal-tools-db-partition-migration-validator フォルダー内で、次のパラメーターを使用して db_partition_migration-validator.sh を再度実行します。
- --source-file [arg]: エクスポートモードでツールによって生成されたソースパーティションの情報を含むファイル。
- --target-file [arg]: エクスポートモードでツールによって生成されたターゲットパーティションの情報を含むファイル。
- --help (オプション): パラメータ情報を表示します。

データベースパーティションの抽出

データベースの互換性を確認した後、新しいデータベーススキーマを作成して、現在のインストールからパーティションを抽出できます。このスキーマは、別のインストールに挿入することも、単一インスタンスのインストールとして独立して使用することもできます。抽出後も、仮想インスタンスはソースデータベース内で完全に機能します。

グローバルメニュー () で、 コントロールパネル → 構成 → システム設定に移動します。
プラットフォーム → 仮想インスタンスに移動します。
抽出会社 ID フィールドに、スタンドアロンパーティションの会社 ID を入力します。

あるいは、OSGi 構成を使用してパーティションを抽出することもできます。

com.liferay.portal.instances.internal.configuration.ExtractPortalInstanceConfiguration.configという名前のファイルを作成します。
.config ファイルに会社IDを書き込みます。例えば、
```
extractCompanyId=L"12345"
```
設定ファイルを [Liferay Home]/osgi/configsに移動してデプロイします。

このプロセスにより、 lextracted_[companyId] という新しいデータベースが作成され、これを対象の Liferay インストールにインポートして挿入プロセスを実行できます。抽出により、プロセスが繰り返されるのを避けるために構成ファイルが削除されます。

データベースパーティションの挿入

最後に、スタンドアロンパーティションを別のインストールに統合できます。

グローバルメニュー () で、 コントロールパネル → 構成 → システム設定に移動します。
プラットフォーム → 仮想インスタンス → ポータルインスタンス挿入に移動します。
会社 ID の挿入 フィールドにスタンドアロンパーティションの会社 ID を入力します。 ID はターゲットインストール内のどの ID とも異なる必要があります。
オプションで、 新しい名前、 新しい仮想ホスト名、および 新しい Web ID フィールドに入力して、新しいインストールでこれらのプロパティを変更します。
新しいサーバーを起動し、移行されたインスタンスが利用可能であり、期待どおりに機能していることを確認します。

あるいは、OSGi 構成を使用してパーティションを挿入することもできます。

com.liferay.portal.instances.internal.configuration.InsertPortalInstanceConfiguration.configという名前のファイルを作成します。
.config ファイルに次のフィールドを書き込みます。
```
insertCompanyId=L"12345"
newName="aNewName"
newVirtualHostname="aNewVirtualHostName"
newWebId="aNewWebId"
```
- insertCompanyId: スタンドアロンパーティションの仮想インスタンス ID。 ID はターゲットインストール内のどの ID とも異なる必要があります。
- newName (オプション): 仮想インスタンスを挿入するときに会社名を変更します。
- newVirtualHostname (オプション): 仮想インスタンスを挿入するときに、仮想ホスト名を変更します。
- newWebId (オプション): 仮想インスタンスが挿入されたときに、その Web ID を変更します。
設定ファイルを [Liferay Home]/osgi/configsに移動してデプロイします。
新しいサーバーを起動し、移行されたインスタンスが利用可能であり、期待どおりに機能していることを確認します。

このプロセスは、 lextracted_[companyId] データベースの名前をスタンドアロンパーティションから lpartition_[companyId]に変更します。次に、挿入により、プロセスが繰り返されないように構成ファイルが削除されます。

データベースパーティションのコピー

Liferay インストール内で仮想インスタンスをコピーすることもできます。

重要

この機能は MySQL と PostgreSQL でのみ使用できます。

グローバルメニュー () で、 コントロールパネル → 構成 → システム設定に移動します。
プラットフォーム → 仮想インスタンス → ポータルインスタンスコピーに移動します。
[名前] フィールドに、スタンドアロンパーティションの会社 ID を入力します。 ID はターゲットインストール内のどの ID とも異なる必要があります。
「ソース会社 ID」フィールドに、コピーする仮想インスタンスの会社 ID を入力します。
仮想ホスト名フィールドに、仮想インスタンスのコピーの新しい仮想ホスト名を入力します。
Web ID フィールドに、仮想インスタンスのコピーの新しい Web ID を入力します。
古い仮想インスタンスを保持する場合は、[宛先会社 ID] フィールドにコピーの新しい ID を入力します。このフィールドを空白のままにすると、古い仮想インスタンスが新しいインスタンスに上書きされます。
[保存]をクリックします。
コピーに新しい ID を選択しなかった場合は、古い仮想インスタンスを削除し、サーバーを再起動して、インスタンスが使用可能であり、期待どおりに機能していることを確認します。

あるいは、OSGi 構成を使用して仮想インスタンスをコピーすることもできます。

com.liferay.portal.instances.internal.configuration.CopyPortalInstanceConfiguration.configという名前のファイルを作成します。
.config ファイルに次のフィールドを書き込みます。
```
sourceCompanyId=L"12345"
name="www.able.com"
virtualHostname="www.able.com"
webId="www.able.com"
```
- sourceCompanyId: コピーする仮想インスタンスのID。
- destinationCompanyId (オプション): 仮想インスタンスのコピーの新しい ID。
- name: 仮想インスタンスのコピーの新しい名前。
- virtualHostname: 仮想インスタンスのコピーの新しい仮想ホスト名。
- webId: 仮想インスタンスのコピーの新しい Web ID。
設定ファイルを [Liferay Home]/osgi/configsに移動してデプロイします。
コピーに新しい ID を選択しなかった場合は、古い仮想インスタンスを削除し、サーバーを再起動して、インスタンスが使用可能であり、期待どおりに機能していることを確認します。

Capability:

DXP Self-Hosted Installation, Maintenance, and Administration

Resource Type:

Official Documentation

Deployment Approach:

Liferay PaaS

Liferay Self-Hosted