Liferay Upgrade Planner

Update the liferay.workspace.target.platform.version in gradle.properties so BOM-managed dependency versions resolve against 7.2.

liferay.workspace.target.platform.version=7.2.1-1

Methods deprecated back in 7.0/7.1 are removed in 7.2. Rebuild every module against the 7.2 target platform and fix any unresolved references.

Snapshot the database and document library, deploy 7.2, and complete all module upgrade processes before allowing traffic.

Each release targets a specific Elasticsearch line. Confirm your ES cluster matches the version 7.2 supports before upgrading, and update the search connector configuration accordingly.

Several core apps were rewritten on React with Clay 3. If you customized their JSPs or markup, re-validate those customizations against the new front end.

Back up the database and DL, deploy 7.3, run the upgrade processes, and reindex all search indexes.

Liferay 7.3 requires Elasticsearch 7. Provision an ES7 cluster, reconnect the search connector, and reindex after the data upgrade.

7.3 supports both JDK 8 and JDK 11. If you plan to move to JDK 11, test module compilation and any reflection-heavy code under it now.

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.

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.

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

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

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

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.

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

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

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

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