アップグレードレポート

7.4以降で利用可能

アップグレードを実行するときは、行われた変更と発生した問題を把握することが重要です。

注

アップグレード ステータスでは、コア アップグレード、モジュール アップグレード、検証プロセス例外、および満たされていないコンポーネントの組み合わせた結果が返されます。 成功 とは、4つすべてが合格したことを意味します。 失敗 は、最初の 3 つのうち 1 つが失敗したときです。 未解決 は、コンポーネントの依存関係チェックが失敗した場合です。

アップグレード レポートは、 アップグレード ツール を通じて、またはポータル プロパティを使用して起動時に入手できます。

なお、 アップグレード ログ コンテキストを有効にすると、アップグレード レポート情報をコンソール ログに出力することもできます。

アップグレードレポート構造

Liferay DXP 2024.Q4+/Portal GA129+以降、アップグレード情報は2つのファイルで報告されます。

• upgrade_report.txt

  • 実行日時
  • アップグレードの総実行時間
  • リリース マネージャーの OSGi チェック コマンドの結果。 このリストには、適用されていない保留中のアップグレードが表示されます。
  • アップグレードのステータス（成功、失敗、未解決）
  • アップグレードの種類 (メジャー、 マイナー、 マイクロ、または アップグレードなし)
  • DXP / Portalスキーマの初期バージョン、想定されるバージョン、および最終バージョンとビルド番号
  • データベースのベンダーとバージョン
  • ドキュメントライブラリのルートディレクトリ、ストレージの実装、およびストレージのサイズ
  • Liferayホームへの道
  • Liferayバンドルで使用されるJVM引数
  • 上書きされたポータルプロパティ
  • ポータルのプロパティが設定されているプロパティファイル
  • ポータル構成
  • *.config 設定が設定されているファイル
  • データベーステーブル名と行数の初期サイズおよび最終サイズ

• upgrade_report_diagnostics.txt

  • 実行日時
  • JVM エラーと各タイプの頻度
  • 失敗したSQLクエリ
  • 最も長く実行されている20のアップグレードプロセス
  • 最も長く実行されているSQLクエリ20件
  • 警告と各タイプの頻度

ヒント

大規模なドキュメント ライブラリがある場合は、ドキュメント ライブラリのストレージ サイズのレポートを無効にすることで、アップグレード レポートを高速化できます。 これを行うには、 upgrade.report.dl.storage.size.timeout プロパティを 0 または空の文字列に設定します。

upgrade.report.dl.storage.size.timeout=0
upgrade.report.dl.storage.size.timeout=

注

以前のバージョンでは、アップグレード情報は upgrade_report.info ファイルに報告されます。 Liferay のバージョンによって、同じ情報が含まれていない場合があります。

アップグレードツールによるアップグレードレポート

アップグレード レポートはデフォルトで有効になっています。 これを無効にするには、 tools/portal-tools-db-upgrade-client/portal-upgrade-ext.properties ファイルで upgrade.report.enabled=false プロパティを設定します。 例:

cd liferay-home

echo "upgrade.report.enabled=\"false\"" << tools/portal-tools-db-upgrade-client/portal-upgrade-ext.properties

必要に応じて、 upgrade.report.dir={your_directory} プロパティを設定して、アップグレード レポートの出力ディレクトリを定義します。 何も設定されていない場合、レポートは /tools/portal-tools-db-upgrade-client/reports フォルダーに生成されます。

ポータルプロパティを使用した起動時のアップグレードレポート

起動時にアップグレード レポートを有効にするには、 portal-ext.properties ファイルで次の 2 つの ポータル プロパティ を設定します。

upgrade.database.auto.run=true
upgrade.report.enabled=true

必要に応じて、 upgrade.report.dir=[your_directory] プロパティを設定して、アップグレード レポートの出力ディレクトリを定義します。 何も設定されていない場合、レポートは [liferay-home]/reports フォルダに生成されます。

追加情報

以降のアップグレードでは、ツールはファイル名にタイムスタンプを追加し (例: upgrade_report.txt.1631029824000)、新しいアップグレードの詳細を新しい upgrade_report.txt ファイルに報告します。

ドキュメント ライブラリのサイズを計算すると、長い待機時間が必要になる場合があることに注意してください。 したがって、タイムアウト期間はデフォルトで 10 秒に設定されています。 この期間を変更するには、 portal-ext.properties ファイル内の upgrade.report.dl.storage.size.timeout プロパティを変更します。 タイムアウトを無効にするには、時間を増やすか、値を 0 に設定します。

関連トピック

• データベースアップグレードツールの使用
• データベースアップグレードツールのリファレンス
• アップグレードのトラブルシューティング