データベースアップグレードツールのデフォルト動作が変更されました

ユーザーの皆様からのフィードバックに基づき、データベースアップグレードツールのデフォルトの動作にいくつかの変更を加え、アップグレードプロセスの使いやすさとパフォーマンスを向上させました。

1. デフォルトの最大ヒープメモリが2048MBから4096MBに倍増されました。以前のデフォルト設定では大規模なアップグレードには不十分であり、メモリ不足エラーが発生する可能性があった。新しいデフォルト設定により、余裕が生まれ、アップグレードの安定性が向上します。

   1. カスタムメモリ制限は、 --jvm-opts パラメータを使用して設定できます。
   2. データベースのサイズによっては、さらに大きな制限が必要になる場合もあります。

2. 最近のDXPバージョンでは、バージョン番号（例：tomcat-10.1.43）を含める代わりに、よりシンプルなTomcatディレクトリ名が採用されています。これは、バンドルされたTomcatリリースとDockerイメージの両方に適用されます。 app-server.properties のデフォルト値がこの変更に合わせて更新されました。これにより、最新のDXPインストール環境をアップグレードする際の、手動によるプロパティ管理の必要性が軽減されます。

3. 対話型セットアップでは、入力された情報が入力時に検証され、アップグレードが開始される前に問題が検出されるようになりました。従来は、アプリケーションサーバーの種類とデータベースの種類のみが検証されていたため、無効な値であっても処理が続行され、後々の段階でエラーが発生するまで処理が継続されていました。このアプローチでは、設定ミスがアップグレード実行中に障害を引き起こす前に、早期にミスを検出します。以下の入力値が検証されます。

   1. ディレクトリ パス: Liferay ホーム、アプリケーション サーバー ディレクトリ、追加ライブラリ、グローバル ライブラリ、またはポータル ディレクトリのパスを入力すると、ツールはそれらが存在することを確認します。無効なパスを指定すると、問題を説明するエラーメッセージが表示され、プロンプトが繰り返されます。
   2. データベースホスト: このツールは、データベースホスト名が DNS 経由で解決できるかどうかを確認します。解決に失敗すると、詳細を含むエラーメッセージが表示されます。
   3. データベースポート: ポート番号は、有効な範囲 (0-65535) 内にあることを確認するために検証されます。無効なポートはエラーとともに即座に拒否されます。

4. このツールは、再入力を必要とせず、既存のデータベース構成を portal-ext.properties から読み込むようになりました。これは、 portal-upgrade-ext.properties によって上書きされる可能性があります。

5. デフォルトの JVM パラメータは、 --jvm-opts からのカスタム パラメータに加えて自動的に適用されます。ユーザーが明示的に変更しない限り、以下の設定が適用されます。

   1. -Dfile.encoding=UTF8
   2. -Duser.country=US
   3. -Duser.language=en
   4. -Duser.timezone=GMT
   5. -Xmx4096m

6. データベースのアップグレードパフォーマンスを向上させるため、データベース接続はバッチ挿入最適化パラメータを使用して自動的に構成されるようになり、アップグレード時のJDBC URLの手動構成が不要になりました。ユーザー定義パラメータは引き続き保持されます。

   1. PostgreSQL:reWriteBatchedInserts=true を追加し、バッチ挿入の最適化を有効にする
   2. MySQL/MariaDB: バッチステートメントの書き換えを有効にするために、rewriteBatchedStatements=true を追加します。
   3. SQL Server: useBulkCopyForBatchInsert=true を追加して、バッチ操作の一括コピーを有効にします。

7. アップグレードツールは、すべてのアップグレード設定に単一の設定ファイルを使用するようになりました。すべてのプロパティは portal-upgrade-ext.properties から設定されます。 portal-upgrade-database.properties は現在非推奨となり、無視されます。

8. app-server.properties テンプレートの両方のデフォルトのアプリケーション サーバー ディレクトリ パスが、アップグレード ファイル パスに関する混乱を減らすために、明示的な相対パス表記を使用するように更新されました。

   1. /bin → ./bin
   2. /lib → ./lib
   3. /webapps/ROOT → ./webapps/ROOT
   4. /WEB-INF/... → ./WEB-INF/...

9. アップグレードツールの対話型ウィザードは、デフォルトのデータベースとしてPostgreSQLを使用するようになりました。この変更は、PostgreSQLが広く採用され、Liferay DXPで推奨されている利用方法を反映したものです。ユーザーは、プロンプトに別の値を入力することで、サポートされている任意のデータベースを選択できます。

関連チケット

• LPD-59502 - アップグレードツールのユーザビリティ改善