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

アップグレードログのコンテキスト

Liferay DXP 7.4 U72 / Liferay Portal 7.4 GA72

アップグレード ログ コンテキストを有効にすると、コンソール ログにアップグレード関連プロセスの識別子が表示されます。 可能な識別子は次のとおりです。

  • {upgrade.component=portal}: ポータル関連のアップグレードプロセス用
  • {upgrade.component=framework}: アップグレードフレームワークロジックに関連するプロセス用
  • {upgrade.component=<bundleSymbolicName>}: モジュール関連のアップグレードプロセス用

ログは、 アップグレード ツール を通じて、またはポータル プロパティを使用して起動時に有効にすることができます。

アップグレード ツールを使用する場合は、 /tools/portal-tools-db-upgrade-client/portal-upgrade-ext.properties ファイルで upgrade.log.context.enabled=true を設定します。

起動時にアップグレードを有効にする場合は、 upgrade.log.context.enabled=true を {Liferay-Home}/portal-ext.properties ファイルで設定します。

次に、 portal-impl/src/META-INF/portal-log4j.xml ファイルを bundles/tomcat/webapps/ROOT/WEB-INF/classes/META-INF にコピーし、ファイル名を portal-log4j-ext.xmlに変更します。 次に、アペンダーの定義を見つけます。

<Appender name="CONSOLE" type="Console">
	<Layout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p [%t][%c{1}:%L] %m%n" type="PatternLayout" />
</Appender>

スレッドコンテキスト情報を出力するようにLog4jに指示する %Xを含むように定義を変更します。

<Appender name="CONSOLE" type="Console">
	<Layout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p [%t][%c{1}:%L] %m %X%n" type="PatternLayout" />
</Appender>

アップグレード ID を含むログ行の例を次に示します。

...
2023-05-24 23:29:31.143 INFO  [main][LoggingTimer:83] Starting com.liferay.portal.verify.VerifyProperties#verifySystemProperties {upgrade.component=portal}
2023-05-24 23:29:31.145 INFO  [main][LoggingTimer:44] Completed com.liferay.portal.verify.VerifyProperties#verifySystemProperties in 3 ms {upgrade.component=portal}
...
2023-05-24 23:29:34.012 INFO  [main][LoggingTimer:83] Starting com.liferay.portal.events.StartupHelperUtil#initResourceActions {upgrade.component=framework}
2023-05-24 23:29:34.029 INFO  [main][LoggingTimer:44] Completed com.liferay.portal.events.StartupHelperUtil#initResourceActions in 17 ms {upgrade.component=framework}
...
2023-05-24 23:30:17.046 INFO  [main][LoggingTimer:83] Starting com.liferay.portal.db.index.IndexUpdaterUtil#lambda$updateIndexes$1#Updating database indexes for com.liferay.wiki.service {upgrade.component=com.liferay.wiki.service}
2023-05-24 23:30:17.094 INFO  [main][BaseDB:776] Dropping stale indexes {upgrade.component=com.liferay.wiki.service}
2023-05-24 23:30:17.095 INFO  [main][BaseDB:846] drop index IX_18565130 on WikiPage {upgrade.component=com.liferay.wiki.service}
...

アップグレードレポートと一緒に有効化

アップグレード レポート がアップグレード ログ コンテキストとともに有効になっている場合は、アップグレード レポートの内容もコンソール ログに出力されます。 注意: レポートは、 upgrade_report.info ファイルとは少し異なる形式で表示されます。

アップグレードレポートキー説明
upgrade.report.database.versionデータベースのベンダーとバージョン.
upgrade.report.document.library.storage.sizeドキュメント ライブラリのサイズ。
upgrade.report.errorsアップグレード プロセス中にキャプチャされたエラーを含む配列。 発生源、クラス、同じエラーの発生回数別にグループ化されます。
upgrade.report.execution.dateレポートが生成された日時。
upgrade.report.execution.timeアップグレードが完了するまでにかかった合計時間（秒）。
upgrade.report.longest.upgrade.processes最も長い 20 個のアップグレード プロセスの配列。プロセスの名前と、各プロセスの完了に要した時間を示します。
upgrade.report.portal.expected.build.numberアップグレード実行後の予想される最終ビルド番号。
upgrade.report.portal.expected.schema.versionアップグレード実行後の予期されるスキーマ バージョン。
upgrade.report.portal.final.build.numberアップグレードが実行された後の実際の最終ビルド番号。
upgrade.report.portal.final.schema.versionアップグレードが実行された後の実際の最終スキーマ バージョン。
upgrade.report.portal.initial.build.numberアップグレードが実行される前の初期ビルド番号。
upgrade.report.portal.initial.schema.versionアップグレードが実行される前の初期スキーマ バージョン。
upgrade.report.property.dl.store.implドキュメント ライブラリ ストレージ用に構成された実装。
upgrade.report.property.liferay.homeLiferay ホーム フォルダへの絶対パス。
upgrade.report.property.locales利用可能なすべてのロケールの配列。
upgrade.report.property.locales.enabledすべてのロケールが有効になっている配列。
upgrade.report.property.rootDirドキュメント ライブラリのルート フォルダーへの絶対パス。
upgrade.report.resultすべてのアップグレードが実行された後に計算されたアップグレードの結果。
upgrade.report.statusOSGi によって提供されるアップグレード情報のステータス。 すべてのアップグレードが実行されたか、または保留中のアップグレードがあるかどうかを示します。
upgrade.report.tables.initial.final.rowsすべてのテーブルの名前と、アップグレード前後の各テーブルの行数を含む配列。
upgrade.report.type行われたアップグレードの種類（例： メジャー、マイナー、マイクロ）。 スキーマ バージョンに基づきます。
upgrade.report.warningsアップグレード プロセス中にキャプチャされた警告を含む配列。 発生元、クラス、同じ警告の発生回数別にグループ化されます。

データベース アップグレード ツールの使用 アップグレード レポート データベース アップグレード ツール リファレンス MBean によるアップグレードの監視