Wasim's Site

Liferay Upgrade Planner

Pick a source and target Liferay version to get an ordered, checkable upgrade plan — breaking changes, deprecated APIs, data-upgrade steps, and commands.

Choose your upgrade path

Liferay 7.3 → Liferay DXP 2024.Q (Quarterly)0 of 10 done · 2 hops
1

Liferay 7.3 → Liferay 7.4

(5 steps)
Breaking Change

7.4 consolidated many apps and introduced Objects and an expanded headless API. Recompile all modules against the 7.4 target platform and review any custom entities that overlap with Objects.

Breaking Change

More legacy properties were removed or moved to OSGi configuration in 7.4. Diff your portal-ext.properties against the 7.4 defaults and migrate anything that no longer applies.

Deprecated / Removed

APIs deprecated across the 7.x line are removed in 7.4. Rebuild and fix any remaining references before deploying.

Data Upgrade

Back up the database and DL, deploy 7.4, complete the upgrade processes, and reindex search.

Tooling / Environment

JDK 11 is the recommended runtime for 7.4 and JDK 8 is deprecated. Standardize your build and runtime on JDK 11.

2

Liferay 7.4 → Liferay DXP 2024.Q (Quarterly)

(5 steps)
Pre-flight

DXP Quarterly (2024.Qx) replaces the old fix-pack cadence with cumulative quarterly releases. Plan to track a specific quarter and apply its updates rather than discrete patches.

Breaking Change

Update your Liferay Workspace to the DXP quarterly target platform version so dependencies resolve against that release’s BOM.

Data Upgrade

Back up the database and DL, deploy the quarterly release, and let its upgrade processes run on startup. Verify completion and reindex.

Tooling / Environment

Quarterly releases require a current LTS JDK (11, and 21 on later quarters). JDK 8 is unsupported. Confirm your runtime and rebuild modules accordingly.

Tooling / Environment

Quarterly releases expect a remote search engine. Verify your Elasticsearch 7 (or supported OpenSearch) cluster and connector configuration before upgrading.

Tip: This is a representative checklist of the major steps for each version hop, ordered pre-flight → breaking → deprecated → data upgrade → tooling. Always take a full database and Document Library backup before each hop, and confirm exact requirements against the official Liferay upgrade docs for your edition.

Upgrading Liferay 7.3 to Liferay DXP 2024.Q (Quarterly)

This plan covers the full path from Liferay 7.3 to Liferay DXP 2024.Q (Quarterly) — 2 version hops and 10 steps in total. Work through each numbered hop in order; every hop runs its own database and module upgrade processes, so they cannot be skipped. Take a full database and Document Library backup before starting each one.

Hops in this path

  1. Liferay 7.3 → Liferay 7.4 — 5 steps
  2. Liferay 7.4 → Liferay DXP 2024.Q (Quarterly) — 5 steps

Before you start

  • Back up the database and the Document Library, and test the upgrade on a copy of production first.
  • Patch your current version to its latest fix pack before beginning.
  • Confirm exact JDK, app server, and Elasticsearch requirements for Liferay DXP 2024.Q (Quarterly) in the official docs.