Preparing a New Liferay DXP Server for Data Upgrade

To upgrade your Liferay DXP database, prepare a new server for hosting Liferay DXP 7.2. You’ll use this server to run the database upgrade and run Liferay DXP 7.2. Then you can run your production server while you’re configuring a new server to host Liferay DXP 7.2 exactly the way you want.

Get the latest fixes for Liferay DXP 7.2 by requesting an upgrade patch.

Request an Upgrade Patch from Liferay Support (Liferay DXP only)

An upgrade patch contains the latest fix pack and hot fixes planned for the next service pack. Upgrade patches provide the latest fixes available for your data upgrade.

Install Liferay

Install Liferay DXP on your application server or use Liferay DXP bundled with your application server of choice.

Install the Latest Upgrade Patch or Fix Pack (Liferay DXP only)

Install the upgrade patch (if you requested it from Liferay Support) or the latest Fix Pack.

Migrate Your OSGi Configurations (7.0+)

Copy your OSGi configuration files (i.e., .config files) to your new server’s [Liferay Home]/osgi/configs folder.

Migrate Your Portal Properties

It is likely that you have overridden portal properties to customize your installation. If so, you must update the properties files (e.g., and to Liferay DXP 7.2. For features that use OSGi Config Admin, you must convert your properties to OSGi configurations. As you do this, you must account for property changes in all versions of Liferay DXP since your current version up to and including Liferay DXP 7.2. Start with updating your portal properties.

Update Your Portal Properties

If you’re coming from a version prior to Liferay Portal 6.2, start with these property-related updates:

When a new version of Liferay DXP is released, there are often changes to default settings, and this release is no different. If you rely on the defaults from your old version, you should review the changes and decide to keep the defaults from your old version or accept the defaults of the new.

Because no existing properties changed from 7.1 to 7.2, here’s a list of the 6.2 properties that have changed in 7.2:


This property was removed:


The latest portal properties reference provides property details and examples. Some properties are replaced by OSGi configurations.

Convert Applicable Properties to OSGi Configurations

Properties in modularized features have changed and must now be deployed separately in OSGi configuration files (OSGi Config Admin).

Use the blade upgradeProps command to scan your file to discover which properties are now set via OSGi Config Admin. You can also check the upgrade log from previous attempts for traces like these:

2019-03-09 17:05:17.678 ERROR [main][VerifyProperties:161] Portal property "layout.first.pageable[link_to_layout]" is obsolete
2019-03-09 17:05:17.679 ERROR [main][VerifyProperties:136] Portal property "journal.article.check.interval" was modularized to com.liferay.journal.web as "check.interval"

Update Your Database Driver

Install the recommended database driver and update your database connection driver specified in your See the Database Templates.

Configure Your Documents and Media File Store

General document store configuration (e.g.,[File Store Impl Class]) continues to be done using But here’s what’s changed for document storage:

  • Store implementation class package names changed from* in Liferay Portal 6.2 to* in Liferay DXP 7.0+. Make sure your file sets in one of these ways:
  • JCR Store was deprecated in Liferay DXP 7.0. The Document Repository Configuration documentation describes other store options. Migrate to a supported document store before upgrading your data.

  • CMIS Store was deprecated since 7.0.10 Fix Pack 14 and was removed in Liferay DXP 7.2. The Document Repository Configuration documentation describes other store options. Migrate to a supported document store before upgrading your data.

  • Since Liferay DXP 7.0, document store type-specific configuration (e.g., specific to Simple File Store, Advanced File Store, S3, etc.) is done in the Control Panel at Configuration → System Settings → File Storage or using OSGi configuration files (.config files). Type specific configuration is no longer done using

For example, these steps to create a .config file specifying a root file location for a Simple File Store or Advanced File Store:

  1. Create a .config file named after your store implementation class.

    Simple File Store:

    Advanced File Store:

  2. Set the following rootDir property and replace {document_library_path} with your file store’s path.

  3. Copy the .config file to your [Liferay Home]/osgi/configs folder.

The Document Repository Configuration provides more document store configuration details.

Configure Kerberos in place of NTLM

If you’re using NTLM to authenticate Microsoft Windows ™ accounts with Liferay DXP, switch to using Kerberos. Security vulnerabilities persist with NTLM. NTLM has been deprecated and removed from the bundle, but you can still build and deploy the module.

Disable Indexing

Before starting the upgrade process in your new installation, you must disable indexing to prevent upgrade process performance issues that arise when the indexer attempts to re-index content.

To disable indexing, create a file called in your [Liferay Home]/osgi/configs folder and add the following content:


After you complete the upgrade, re-enable indexing by removing the .config file or setting indexReadOnly="false".

Your new Liferay DXP 7.2 server is ready for upgrading your database.

« Preparing to Upgrade the Liferay DXP DatabaseUpgrading the Liferay DXP Data »
Was this article helpful?
0 out of 1 found this helpful