Site Search - Liferay Learn

Maintaining a Liferay Installation Starting with Liferay DXP 7.3 SP3+ and 7.4 GA1+, Liferay adopted a new release model for delivering updates and fixes. This new approach is referred to as Bundle...

Upgrading to a New Docker Image

Official Documentation

Upgrading to a New Docker Image As new Liferay versions are released as Docker images, you can upgrade to them. Upgrading Liferay describes the process. Always back up your data and installation...

Configuring Containers

Official Documentation

Configuring Containers Everything that is configurable in a Liferay installation is configurable in a Liferay Docker container. Here are the most common things to configure: JVM Options Portal...

Using Liferay Docker Images

Official Documentation

Using Liferay Docker Images Docker Hub hosts Liferay DXP and Liferay Portal Docker images, bundled with Tomcat on Linux. The Liferay Docker Hub pages provide image details and tags for the...

Providing Files to the Container

Official Documentation

Providing Files to the Container The Liferay container uses the files you provide to execute the following use cases: Configure Liferay with .properties Files and .config files Configure Tomcat...

Accessing DXP Patch Code

Official Documentation

Accessing DXP Patch Code Subscribers Liferay DXP Fix Pack and Hotfix source code is available in a private GitHub repository called liferay-dxp. The source code facilitates identifying and...

Getting Patch Information

Official Documentation

Getting Patch Information Subscribers You can see patch information at a glance, which helps maintain your installation and get help from Liferay Support. The Patching Tool's info command lists...

Installing the Patching Tool

Official Documentation

Installing the Patching Tool Subscribers The Patching Tool is easy to install and update. Installation Download the Patching Tool from the Customer Portal. For DXP 7.3+, download the latest...

Updating Liferay

Official Documentation

Updating Liferay Liferay DXP 7.3 SP3+/Portal 7.4 GA1+ Update your Liferay installation with Bundle Releases. The latest features, security releases, as well as library updates are all delivered...

Installing Liferay on an Application Server

Official Documentation

Installing Liferay on an Application Server You can install Liferay DXP or Liferay Portal on any supported application server. This is typically the most practical installation type to use in...

Maintenance and Troubleshooting in Docker

Official Documentation

Maintenance and Troubleshooting in Docker The Liferay Docker container has tools for maintenance and troubleshooting out-of-the-box. You can set various environment variables to modify settings...

Migrating Liferay Instances

Official Documentation

Migrating Liferay Instances Liferay DXP 2025.Q2+/Portal GA148+ [Beta Feature](../../security-and-administration/administration/configuring-liferay/feature-flags.md#beta-feature-flags) You can...

Installing Liferay DXP in Amazon Web Services

Official Documentation

Installing Liferay DXP in Amazon Web Services You can run Liferay DXP on AWS using a new or an existing EKS cluster; a plain installation or Liferay's offering on AWS Marketplace. Either...

Provisioning Liferay in Kubernetes

Official Documentation

Provisioning Liferay in Kubernetes Cloud environments require a layer of orchestration to manage containers, and that is usually Kubernetes. If you're already heavily invested in the cloud, you can...

Docker Packages

Official Documentation

Docker Packages These are the packages Liferay installs in the Ubuntu OS to support a full Liferay DXP environment. This list includes neither the JDK nor the dependencies the packages require. ...

Building Liferay Docker Images

Official Documentation

Building Liferay Docker Images Liferay is open-source and fully customizable. You can create your own Liferay Docker images using Dockerfiles to suit the needs of your installation. For example,...

Installing Earlier Liferay Versions on JBoss EAP

Official Documentation

Installing Earlier Liferay Versions on JBoss EAP Liferay DXP 2025.Q2/Portal 2025.Q1 or below Installing on JBoss EAP requires installing the DXP WAR, installing dependencies, configuring JBoss,...

Installing Earlier Liferay Versions on Tomcat

Official Documentation

Installing Earlier Liferay Versions on Tomcat Liferay DXP 2025.Q2/Portal 2025.Q1 or below Using a Liferay-Tomcat bundle or Docker image is the fastest way to get started using Liferay DXP. This...

Installing Earlier Liferay Versions on Application Servers

Official Documentation

Installing Earlier Liferay Versions on Application Servers As new Liferay versions are released, their dependencies and installation steps change. Liferay made a big change for DXP with the 2025.Q3...

Installing Earlier Liferay Versions on Wildfly

Official Documentation

Installing Earlier Liferay Versions on Wildfly Liferay DXP 2025.Q2/Portal 2025.1 or below Installing on WildFly requires installing the DXP WAR, installing dependencies, configuring WildFly, and...

Installing Earlier Liferay Versions on WebLogic

Official Documentation

Installing Earlier Liferay Versions on WebLogic Liferay DXP 2025.Q2/Portal 2025.Q1 or below If you are using WebLogic as your application server, it is highly recommended to install DXP to a...

StaleStateException Error During Startup with OpenID Connect Configuration

legacy Troubleshooting

Issue During a Liferay DXP startup, the following error message appears in the logs, related to OpenID Connect provider configuration: ERROR [...][BatchingBatch:139] HHH000315: Exception executing batch...

Can Liferay Support add a new user to the SaaS environment?

legacy

Issue Is the Liferay Support team able to add a new user to the SaaS environment (i.e., the Liferay DXP environment)? Environment Liferay SaaS Resolution A new user will either need to be created on the site of your...

Email Sender Configuration is not being saved

legacy Troubleshooting

Issue When modifying the Email Sender Name in our PROD environment by following these steps: Control Panel > Instance Settings > Email Access "Email Sender" in the left menu Set "XYZ" in the "Name" field > Save the...

User Workflows Not Appearing Under 'Assigned to My Roles'

legacy Troubleshooting

Issue We have enabled a workflow for approving new user account creation. While the Admin user gets the notficiation about the workflow task, if they navigate to My Workflow Tasks > Assigned to my Roles, the task is...

CVE-2021-29044

legacy How To

Issue We would like to verify if our Liferay instance is vulnerable to CVE-2021-29044 Environment DXP 7.2, DXP 7.3 Resolution Please see if your current patch level is higher than 7.2 FP10, or 7.3 DXP1. If your current...

Hotfix Currently not installed Won't be installed requires version 2025.q1

legacy Troubleshooting

Issue Trying to install a hotfix on a 2025.q1 version got an error showing : Currently not installed; Won't be installed: requires version 2025.q1.0-lts Environment Liferay DXP 2025.Q1 Resolution...

I am getting "Someone may be trying to circumvent the permission checker" while accessing Password Policies

legacy Troubleshooting

Issue When I try to access Control Panel → Password Policies, I get "Password Policies is temporarily unavailable." I get the following error message: 2024-07-30 13:15:07.411 ERROR...

java.lang.StringIndexOutOfBoundsException: begin 0, end -1, length 1

legacy Troubleshooting

Issue While upgrading to Liferay DXP 7.4, following errors were observed in the logs: ERROR [http-nio-8080-exec-21][OpenIdConnectSessionValidationFilter:53] java.lang.StringIndexOutOfBoundsException: begin 0, end...

Failed upgrade process com.liferay.dynamic.data.mapping.internal.upgrade.v4_0_0.DDMStructureUpgradeProcess

legacy Troubleshooting

Issue You might encounter an issue when upgrading from 7.2 to 7.4 where the upgrade step for module com.liferay.dynamic.data.mapping.service fails due to a NoSuchGroupException: 2024-05-22 13:18:39.512 INFO...

Audit portlet only available for Administrators

legacy How To

Issue After upgrading to U78+ you might encounter a behavior where the Audit portlet is only available for Administrators, whereas before U78 you could create a regular role with access to it The reason behind this...

Failed upgrade process com.liferay.asset.display.page.internal.upgrade.v2_3_2.UpgradeAssetDisplayPageEntry

legacy Troubleshooting

Issue The following error is thrown while upgrading a DXP 7.3 instance:...

Table 'OA2Auths_OA2ScopeGrants' already exists

legacy Troubleshooting

Issue The following error occurs while upgrading a database to DXP 7.1 or higher Table 'OA2Auths_OA2ScopeGrants' already exists Environment Upgrading Portal 6.2 or DXP 7.0 -> DXP 7.1 or higher Resolution This...

"invalid keyLength value" error in console at the time of login post upgrade from Liferay 6.1 to DXP 7.1

legacy Troubleshooting

Issue Post upgrade from Liferay 6.1 to DXP 7.1 user is unable to login and "invalid keyLength value" error observed in the server console. 2021-07-16 12:42:48.447 ERROR [http-nio-8080-exec-6][LoginMVCActionCommand:147]...

Migrating to Liferay DXP: Best Practices, High Level Approach, and Strategy

legacy How To

This paper is to help organizations assess their own resources at-hand and come up with a plan for their migration project. It contains a questionnaire to guide customers in developing their migration plans, such as...

Duplicate Logging in Upgrade to DXP 7.1

legacy Troubleshooting

Issue Upgrade to DXP 7.1 shows duplicate logging during the VerifyProcess steps. For example: 2019-02-26 00:13:25.995 INFO [main][VerifyProcess:65] Verifying...

"Incorrect string value: '\xC2\x80\xC2\x99s ...' for column 'description' at row 1"?

legacy Troubleshooting

Issue During the upgrade process, you may encounter an error like the following: Incorrect string value: '\xC2\x80\xC2\x99s ...' for column 'description' at row 1 Environment Liferay DXP 7.0+ Resolution The...

Benchmark Study of Liferay Digital Enterprise 7.0

legacy

This whitepaper is a benchmark study of Liferay Digital Enterprise 7.0 and describes optimal configuration, settings, and the methodology used for this study. The whitepaper also contains the results based on the...

Removing Product Information Displayed in the HTTP Headers

legacy How To

Issue Customers might want to remove the product information found in the HTTP Headers and in the console logs for security reasons. The information displays: Liferay-Portal: Liferay Digital Experience Platform 7.0.10...

How to Upgrade to Liferay DXP from Liferay 6.X

legacy

This whitepaper aims to set a framework for Liferay’s recommended upgrade path for your organization. A major technology upgrade is an endeavor requiring a deep analysis of your business requirements, careful planning,...

Liferay DXP 7.1 Upgrade Performance Benchmark

legacy

The Liferay Support and Liferay Engineering tuned Liferay 6.2 EE databases for upgrade and tested upgrading them to Liferay DXP 7.1. Databases from several vendors were tested. This whitepaper describes the test...

Upgrading from Liferay DXP 7.0 to 7.1

legacy How To

This paper is a high-level overview of the effort involved in moving from Liferay DXP 7.0 to 7.1. It contains an upgrade checklist, the upgrade steps, and what to do after a successful upgrade. The paper is available...

Updating to Liferay DXP 7.2 SP1 / Fix Pack 2 (or Above) from Liferay DXP 7.2 GA1 or Fix Pack 1

legacy How To

Issue When migrating from 7.2 GA1 or Fix Pack 1 to Liferay DXP 7.2 Fix Pack 2 (ie: SP1) or above, you will be required to run the upgrade tool after installing the patch. The reason for this is, SP1 and FP2 have...

I would like to upgrade my portlets to Liferay DXP but can not find where XML Descriptors have been moved to

legacy

Issue Upgrading from Liferay 6.2 to Liferay 7.0+ is a significant process. One of the changes implemented is the use of OSGi components. Several XML Descriptors have been converted to OSGi services. Environment...

Upgrade Tool Uses Wrong Version of Tomcat

legacy Troubleshooting

Issue When upgrading to Liferay DXP 7.0 or DXP 7.1 and using the SP1 + Tomcat bundle, the wrong version of Tomcat is suggested by the Upgrade Tool For 7.1 the bundle includes Tomcat 9.0.6, but the...

Installing Fix Packs and Hotfixes on Liferay DXP

legacy How To

This document has been updated and ported to Liferay Learn and is no longer maintained here. To install Fix Packs and hotfixes on Liferay DXP, customers must first download the latest...

DXP 7.3 Upgrade Reference Guide

legacy How To

An upgrade to Liferay DXP 7.3 gives you access to the latest Liferay technology, complete with all of the newest features, and the assurance of continued support for your Liferay environment. Our Subscription Services Team...

Taking Heap Dumps From a JVM

legacy How To

Liferay Support does not recommend or endorse specific third-party products over others. Liferay is not responsible for any instructions herein or referenced regarding these products....

LDAP settings and upgrading from 5.2.x to 6.x

legacy Troubleshooting

This article pertains to portals in which LDAP is configured in Liferay Portal 5.2.x and an upgrade is performed. When a user attempts to login, an error is thrown, and the user is not...

Permissions Are Not Working Post-Upgrade

legacy Troubleshooting

After upgrading from Liferay Portal 5.2, permissions settings may act in an undesirable manner. This could include not being able to change permissions, as well as not being able to access the control panel or any other...

High Priority Issue Checklist

legacy Troubleshooting

This article provides a brief checklist of items to run through when your server is frozen, or goes down entirely. Collecting this information before opening a support ticket is a...

User's group membership not updating with LDAP after upgrading to Liferay Portal 6.0 EE SP2

legacy Troubleshooting

This article is a legacy article. It applies to previous versions of the Liferay product. While the article is no longer maintained, the information may still be applicable. Beginning in Liferay 6.0 EE SP2, the...

Issues Encountered with Upgrades to Liferay Portal EE Versions

legacy Troubleshooting

This article is a legacy article. It applies to previous versions of the Liferay product. While the article is no longer maintained, the information may still be applicable. The...

Before Opening an Upgrade Ticket

legacy How To

The following article outlines a short checklist of questions to ask and steps to take before opening an upgrade ticket. By taking a moment to go through this checklist before opening a request, you are ensuring the...

Error when going to Portal Settings After Upgrading to Liferay Portal 6.1

legacy Troubleshooting

After an upgrade to Portal 6.1 EE GA1 when clicking on Control Panel > Portal settings, an error pops up: 11:53:46,699 ERROR [BeanPropertiesImpl:480] jodd.bean.BeanException: Simple property not found: hostname...

Backslashes in Screen Name Are No Longer Valid After Upgrading to Liferay Portal 6.2

legacy

After upgrading from Liferay Portal version 5.2 EE SP4 to 6.2 EE, backslashes in the screen name are not allowed when using the liberal screen name validator. In Portal 5.2, backslashes were allowed in the screen name....

[Upgrade] Handling Quartz Data during Liferay Portal Upgrades

legacy How To

Quartz data is a unique type of data. If quartz data is part of the database upgrade, then there are some potential additional steps to take during the upgrade process. Resolution If there are not any publishing jobs,...

Liferay Upgrades: Updating Custom Plugins

legacy How To

The following article describes how to update plugins to be compatible with a new version of the Liferay platform. Resolution The Liferay API may change from release to release, causing issues when trying to port...

Internal Server Error after Upgrade

legacy Troubleshooting

A common error is that sometimes when certain pages display an internal server error and there is no stacktrace. If there was a custom theme before the upgrade the page layouts will still reference them and if one has not...

Migrating Tag Sets During the Upgrade Process From Liferay Portal 5.2 to 6.0

legacy How To

This article outlines the changes to Tags and Tag Sets between Liferay Portal 5.2 to Liferay Portal 6.0, and later versions. Specifically: The changes to the Tags Navigation Portlet (Where Did Tag Sets Go?) How to...

Search Results