Upgrade Report

Available 7.4+

When you perform upgrades, it is important to know the changes made and any issues that occurred. The upgrade report captures this information in a report that include these details:

  • Execution date and time
  • Total execution time of the upgrade
  • Initial, expected, and final DXP/Portal schema versions and build numbers
  • Type of upgrade that has taken place (i.e. No upgrade, Major, Minor, or Micro)
  • The upgrade status (i.e. Success, Failure, or Unresolved)
  • Result of the release manager OSGi check command. This lists any pending upgrades that have not been applied.
  • Database vendor and version
  • Upgrade-related Portal property settings
  • Document Library Store and rootDir configuration settings
  • Document Library size (for File System Store and Advanced File System Store)
  • List of database tables with their initial size in rows and their final size in rows
  • 20 longest-running upgrade processes
  • Errors and each type’s frequency
  • Warnings and each type’s frequency
note

The upgrade status returns combined results for 1. Core Upgrades, 2. Module Upgrades, 3. Verify Process Exceptions, and 4. Unsatisfied Components. A Success is when all four have passed. A Failure is when 1, 2, or 3 has failed. And Unresolved is when 4 has failed.

The upgrade report is available through the upgrade tool or at startup with a portal property.

Note, the upgrade report information can also be output in your console logs by enabling the upgrade log context.

Upgrade Report through the Upgrade Tool

Upgrade reporting is enabled by setting the upgrade.report.enabled=true property in the tools/portal-tools-db-upgrade-client/portal-upgrade-ext.properties file. For example,

cd liferay-home
echo "upgrade.report.enabled=\"true\"" << tools/portal-tools-db-upgrade-client/portal-upgrade-ext.properties

Optionally, define an output directory for the upgrade report by setting the upgrade.report.dir={your_directory} property. If none is set, the report is generated in the /tools/portal-tools-db-upgrade-client/reports folder.

Upgrade Report at Startup with Portal Properties

To enable the upgrade report upon startup, set the following two portal properties in your portal-ext.properties file:

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

Optionally, define an output directory for the upgrade report by setting the upgrade.report.dir={your_directory} property. If none is set, the report is generated in the {liferay-home}/reports folder.

Additional Information

On subsequent upgrades, the tool appends a time stamp to the file name (e.g., upgrade_report.info.1631029824000) and then reports new upgrade details to a new upgrade_report.info file.

Note, calculating the document library size may require long wait times. Therefore, the timeout period is set to ten seconds by default. To change this duration, modify the upgrade.report.dl.storage.size.timeout property in your portal-ext.properties file. Increase the time or set the value to 0 to disable the timeout.

Sample Upgrade Report

Here is an example upgrade report:

...
Date: Tue, Jul 26, 2022 09:02:44 UTC

Upgrade completed in 388 seconds

Initial portal build number: 7310
Initial portal schema version: 8.18.4
Final portal build number: 7413
Final portal schema version: 16.0.0
Expected portal build number: 7413
Expected portal schema version: 16.0.0

Using mariadb version 10.7

liferay.home=/Users/liferay/tomcat/liferay-dxp-7.4.13.u34
...
dl.store.impl=com.liferay.portal.store.file.system.FileSystemStore
rootDir=/Users/liferay/tomcat/liferay-dxp-7.4.13.u34/data/document_library

The document library storage size is 689.01 KB

Tables in database sorted by initial number of rows:
Table name                           Rows (initial)         Rows (final)
--------------                       --------------       --------------
ResourceAction                                 1822                 2043
ResourcePermission                             1440                 1488
Marketplace_Module                             1195                 2538
...
SegmentsExperience                                0                    1

Top 20 longest running upgrade processes:
	com.liferay.client.extension.internal.upgrade.v3_1_0.ClientExtensionEntryUpgradeProcess took 6866 ms to complete
	com.liferay.client.extension.internal.upgrade.v2_0_0.RemoteAppEntryUpgradeProcess took 4938 ms to complete
	com.liferay.portal.upgrade.v7_4_x.UpgradeCountry took 4429 ms to complete
   ...
	com.liferay.batch.engine.internal.upgrade.v4_4_0.BatchEngineExportTaskUpgradeProcess took 1228 ms to complete

No errors thrown during upgrade

Warnings thrown during upgrade process

...

Capabilities

Product

Contact Us

Connect

Powered by Liferay
© 2024 Liferay Inc. All Rights Reserved • Privacy Policy