IMPORTANT: As we revamp and transition our documentation to this site, you may find the articles you need on Liferay's Help Center.

Analytics Cloud Commerce DXP / Portal DXP Cloud Reference

Documentation Menu

Highlighting

Remove Highlighting

Go Back

• Getting Started
• Site Building
• Content Authoring and Management
• Process Automation
• Using Search
• Collaboration and Social
• Users and Permissions
• System Administration
• Building Applications
• Liferay Internals
• Headless Delivery
• Installation and Upgrades
  • Installing Liferay
  • Setting Up Liferay
  • Securing Liferay
  • Maintaining a Liferay Installation
  • Upgrading Liferay
    • Upgrade Basics
    • Migrating Configurations and Properties
    • Upgrade Stability and Performance
    • Other Upgrade Scenarios
    • Upgrading Custom Development
    • Reference
      • Data Cleanup
      • Data Removal
      • Database Upgrade Options
      • Database Upgrade Tool Reference
      • Default Setting Changes in 7.4
      • Default Setting Changes in 7.3
      • Default Setting Changes in 7.2
      • File Store Updates
      • Maintenance Mode and Deprecations in 7.4
      • Maintenance Mode and Deprecations in 7.3
      • Maintenance Mode and Deprecations in 7.2
      • Renamed Language Keys
      • Troubleshooting Upgrades
      • Upgrade Reports
  • Reference

English

• Japanese
• English

• Liferay Learn
• DXP
• Installation and Upgrades
• Upgrading Liferay
• Reference
• Upgrade Reports

Upgrade Reports

When you upgrade data, it’s important to know the changes made and any issues that occurred. The Database Upgrade Tool captures this information in reports that include these details:

• Execution date and time

• Initial, expected, and final DXP/Portal schema versions and build numbers

• 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)

• 20 longest-running upgrade processes

• Errors and each type’s frequency

• Warnings and each type’s frequency

The tool reports this information to a file called upgrade_report.info in the tools/portal-tools-db-upgrade-client/reports folder. 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

Upgrade reporting is available for Liferay DXP/Portal 7.4+.

Upgrade reporting is enabled by setting the upgrade.report.enabled=true Portal 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

The Database Upgrade Tool generates an upgrade report the next time you run it.

Additional Information

• Upgrade Basics

• Running the Database Upgrade Tool

• Database Upgrade Tool Reference

• Troubleshooting Upgrades

Not finding what you're looking for?

Pardon our dust as we revamp and transition our product documentation to this site. If something seems missing, please check Liferay Help Center documentation for Liferay DXP 7.2 and previous versions.

Try Liferay's Help Center