Upgrading via Auto Upgrade

You can upgrade your database automatically by enabling auto upgrade via the portal property before starting up your instance.

important

Always back up your database and existing installation before upgrading. Testing the upgrade process on backup copies is advised.

Upgrading with a Tomcat Bundle

  1. Review the preparation and planning steps and ensure you have accounted for features such as publications, custom development, database pruning, etc.

  2. Download the latest Liferay-Tomcat bundle you plan to use for the upgrade.

  3. Extract the bundle to your host location.

  4. Start the new bundle for the first time. The Setup Wizard appears.

  5. In the database section, click Change and enter your Liferay installation’s database settings.

    Input your database settings in the database section of the setup wizard.

  6. Click Finish Configuration. Your database settings are stored in the portal-setup-wizard.properties file in your Liferay home folder.

  7. In the same Liferay home folder, create a portal-ext.properties file. Configuration options are set in this portal properties file.

  8. Open the file and set upgrade.database.auto.run=true.

  9. (Optional) Set upgrade.report.enabled=true to enable upgrade reporting. Further, define an output directory for the upgrade report by setting the upgrade.report.dir={your_directory} portal property. If none is set, Liferay_Home/reports is the default report directory.

  10. (Optional) Set upgrade.log.context.enabled=true to enable upgrade log context.

  11. Save the property file, and restart Liferay.

  12. As Liferay restarts, the database is updated automatically, and progress appears in your console log. If you enabled upgrade reporting, the report is available in the output directory.

note

Make sure to remove the upgrade.database.auto.run property or set the value to false to continue using Liferay after the upgrade.

Capabilities

Product

Contact Us

Connect

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