Site Search - Liferay Learn

Upgrading Liferay Commerce To enhance the quality of your experience with Liferay Commerce, Liferay provides periodic product upgrades with bug fixes and new features. Users should consider...

Installing Commerce 2.1 and Below

Official Documentation

Installing Commerce 2.1 and Below Previous releases of Liferay Commerce required additional installation steps that are no longer necessary on Commerce 3.x and above. Prerequisites Before...

Deploying Liferay Commerce to an Existing Liferay Installation

Official Documentation

Deploying Liferay Commerce to an Existing Liferay Installation This article documents how to deploy Liferay Commerce to an existing Liferay DXP instance. Because Liferay Commerce is built on...

Upgrading Liferay

Official Documentation

Upgrading Liferay Liferay is continuously being enhanced with new features as new versions are released. To access these features in your current project, you must upgrade your Liferay instance to...

Preparing for an Upgrade

Official Documentation

Preparing for an Upgrade Preparation and planning may be of little consequence for small, casual installations but is mandatory for large enterprise-level installations. Create a Back Up Always...

Post-Upgrade Considerations

Official Documentation

Post-Upgrade Considerations After upgrading the database, you should configure Liferay for production again and check up on feature changes that might affect your Liferay instance. Re-enable...

Troubleshooting Upgrades

Official Documentation

Troubleshooting Upgrades Liferay has many out-of-the-box tools and features to identify and solve issues that may arise when performing an upgrade. To troubleshoot, you can upgrade modules...

Upgrading the Database

Official Documentation

Upgrading the Database Liferay's tools and instructions facilitate upgrading DXP and Portal environments safely and quickly. Non-clustered environments that have small data sets, can be upgraded...

Updating Customizations

Official Documentation

Updating Customizations Plugins (e.g., themes, apps, and customizations) you've developed must be adapted to the new Liferay version. This can be as simple as updating dependencies or involve...

Custom Code and Patch Compatibility

Official Documentation

Custom Code and Patch Compatibility Subscribers If you deploy code that customizes or patches your DXP 7.2 installation, you must maintain its compatibility with all patches you're using. The...

Slimming Down Patched Installations

Official Documentation

Slimming Down Patched Installations Subscribers In Liferay DXP 7.2, patch information is retained in Patch Files in the installation by default. This facilitates restoring DXP to a previous patch...

Applying a Hotfix

Official Documentation

Applying a Hotfix Subscribers A Hotfix is a fix or collection of fixes delivered between Updates (or between Fix Packs for versions before DXP 7.3 SP3) to address a customer's confirmed critical...

Backing Up

Official Documentation

Backing Up Once you have your DXP installation running, you should implement a comprehensive backup plan that accounts for unforeseen events. Backup copies are also valuable for testing updates...

Maintaining Clustered Installations

Official Documentation

Maintaining Clustered Installations Setting up your Liferay DXP installation to function in a cluster provides performance and scalability improvements, but also requires additional consideration...

Blue-Green Deployments

Official Documentation

Blue-Green Deployments Blue-green is a deployment technique in which you duplicate your production environment (the blue environment) and modify the duplicate (the green environment) with software...

Performing Rolling Restarts

Official Documentation

Performing Rolling Restarts The rolling restart cluster maintenance process involves shutting down and updating nodes one at a time (while the other nodes are running) until they're all updated....

Advanced Patching for DXP 7.2

Official Documentation

Advanced Patching for DXP 7.2 Here are the DXP 7.2 advanced patching topics: Using Slim Bundles demonstrates conserving disk space by using DXP fix pack bundles that don't include Patch Files. ...

Using Slim Bundles

Official Documentation

Using Slim Bundles Subscribers Liferay DXP 7.2 Fix Packs and Service Packs are also released bundled with the Tomcat application server. They are available as traditional bundles and Slim Bundles....

Installing Patches in Earlier Versions

Official Documentation

Installing Patches in Earlier Versions Subscribers The Patching Tool applies Fix Packs (including Security Fix Packs and Service Packs) for versions prior to Liferay DXP 7.3 SP3. It also applies...

Configuring the Patching Tool

Official Documentation

Configuring the Patching Tool Subscribers The Patching Tool can be adapted to any DXP installation. The tool's auto-discovery option is the easiest way to configure the Patching Tool. If you...

Uninstalling Patches

Official Documentation

Uninstalling Patches Subscribers After you install a patch, you may decide to restore your installation to a previous patch level. Here you'll learn how to Uninstall Patches Revert (uninstall)...

Updating Previous Versions of Liferay

Official Documentation

Updating Previous Versions of Liferay Staying current with updates gives you the best security and quality. Security Updates are releases that address the latest security issues immediately. ...

Reference

Official Documentation

Reference When installing Liferay, you must take into consideration the specifics of your environment. These topics help you integrate Liferay into your existing environment and aid in...

JVM Configuration

Official Documentation

JVM Configuration As of Liferay DXP 2024.Q3+/Portal GA125+, Liferay DXP/Portal requires a Java JDK 17 or 21 (prior versions support JDKs 8 and 11) with specific JVM option settings. There are also...

Activating Liferay DXP

Official Documentation

Activating Liferay DXP Subscription Required Liferay DXP is activated using an XML (.xml) activation key. It specifies your DXP subscription terms or trial agreement. When you run Liferay DXP for...

"Inconsistent patch level detected" error occured in the logs

Troubleshooting

Issue The following error occurs in the logs due to an inconsistency in patch levels: Example 1: ERROR [server.startup : 2][PatcherImpl:204] Inconsistent patch level detected WARN [server.startup :...

Hotfix created for 2025.Q1.X won't install

legacy Troubleshooting

Issue A hotfix created for 2025.Q1.X won't install even though it is being installed on the required version. The following information appears in the patching-tool info file. Product information: * DXP version:...

Organization tab do not shows the user when user is added to organization via Groovy Script

legacy Troubleshooting

Issue After the execution of the below syntax in the Groovy Script, the Organization name gets appended to the user and can be seen only under the "User's details Organization Tab" but not under the...

Restricting the Guest Role's Access to the Home Page

Troubleshooting

Issue When trying to change the view permission of a page it's not possible to do it for the Guest role in the first page: it shows as non-interactive. Environment QR 2024.Q3, 2024.Q4, 2025.Q1 Resolution This is...

Unable to Provision Users via SCIM

legacy Troubleshooting

Issue User provisioning via SCIM is failing. Liferay logs indicate a permission error: ERROR [org.wso2.charon3.core.protocol.endpoints.AbstractResourceManager] Unable to provision a portal user for null...

Impersonation Clashes with Cached Web Content Templates

legacy Troubleshooting

Issue Web Content Templates can be configured for caching to boost performance. When not cached, the generated HTML is rendered for each request. When cached, the generated HTML is stored in the cache and...

How to preserve the structureId and formId during export/import to avoid mismatches between environments?

legacy Troubleshooting

Issue When we export/import web content articles and forms, their IDs sometimes change. How to preserve the structureId and formId during export/import to avoid mismatches between environments? Environment...

Handling an excess number of User Notifications

legacy Troubleshooting

Issue As my Liferay system sends out User Notifications over time, the UserNotificationEvent table accumulates many records quickly. I would like to schedule the cleanup of old User Notifications, so that the...

Using Required for system configurations.

legacy Troubleshooting

Issue We would like to add required = true configuration to our system configuration. Upon requesting the data through a groovy script the string returns empty when required = true is set. Environment DXP 7.4+...

Liferay instance node going into hang mode - Failed to validate connection

legacy Troubleshooting

Issue Liferay instance node goes into hang mode and the following error appears: HikariPool-1 - Failed to validate connection ... (This connection has been closed.) ... Possibly consider using a...

Does upgrade touch the doclib?

legacy

Issue We are preparing the upgrade from a Liferay 7.3 FP2 to a Liferay 7.4 2024.Q1 and we are trying to prepare a rollback system if something goes wrong and we need go reinstall the 7.3. My question is about the document...

Insufficient Permissions to Access Folders When Uploading Documents to Web Content

legacy Troubleshooting

Issue Users with a role other than Administrator, for example, the "Editor" role, receive a permissions error when they try to access folders within Documents and Media while uploading a document to Web Content. The...

'External Reference Code' field on the UI

legacy

Issue An 'External Reference Code' for the 'Address' field on UI is required since it is already there in the database for the entity. Environment Liferay DXP 2024.Q1 Resolution LIferay has started working on this...

The assignments are missing between roles and user groups when transfer from one enviornment to another

legacy Troubleshooting

Issue The export/import of UserGroups and Roles does not contain the assignments between roles and user groups. So when 'transporting' the user groups and roles from one stage (or backup) to another stage (new...

Portlet 3.0 Control Panel Apps cause unexpected errors

legacy Troubleshooting

Issue Following the deployment of a Portlet 3.0 Control Panel App, other areas of the control panel are experiencing malfunctions. For instance, the My Sites selector is not responding, and in version 7.3, the Global...

DuplicateFileEntryException on Virtual Instance Startup

legacy Troubleshooting

Issue A `DuplicateFileEntryException` error occurs when starting a clustered DXP instance after a virtual instance is created, even if the file already exists in the Document Library. The error, seen in the...

Unable to see the add button to create a new language override key

legacy Troubleshooting

Issue When create a new user and assigning that user to a newly created regular role, then the add button to create a language override key is not visible to that user. Steps to reproduce: 1. Navigate to Control...

Failed upgrade process for module com.liferay.portal.workflow.kaleo.service: Unable to convert XML to JSON

legacy Troubleshooting

Issue We are currently upgrading our DXP 7.4 u92 DB to 2024.Q1.12 We configured things for DB upgrade based on...

There are repeated languages that can't be modified in the Localization settings

legacy Troubleshooting

Issue The default language for the site is shown repeated several times in the column of Current languages in Site Settings > Localization > Languages. It can also happen for the instance in Instance Settings >...

Avoid last name field being mandatory when creating users

legacy How To

Issue When creating new users, some fields (such as first name and last name) are mandatory, marked with a red asterisk. How can one specify the mandatory fields? Environment Quarterly Release 2024.Q1, 2024.Q2,...

Users are redirected to home page on SAML sign-in in a clustered environment

legacy Troubleshooting

Issue Users are sometimes redirected to the home page on login rather than their page of entry. The environment is clustered with SAML authentication, and the property auth.forward.by.last.path is set to true....

I cannot disable the execution of Groovy scripts in Server Administration

legacy How To

Issue Despite disabling Groovy scripting in System Settings > Security section > Script Management, Administrators are still able to execute Groovy scripts in the Server Administration > Script tab. Environment...

Session keeps extending itself indefinitely in Page Edit Mode

legacy

Issue When a user leaves a Page idle in Edit mode for a long time, the session keeps extending itself indefinitely, and the user is never logged out. Environment Quarterly Releases Resolution This is the...

How does "company.default.home.url" property work?

legacy

Issue I don't understand how company.default.home.url in portal-ext.properties and the setting of Control Panel ->Instance Settings -> Instance Configuration -> General -> Home URL work together. Environment DXP...

Cannot access .zip file error occurs when installing a hotfix with Patching Tool

legacy Troubleshooting

Issue When I try to install a hotfix in my environment I get the following error: Installing hotfix-3... Cannot access .zip file: ../osgi/portal/com.liferay.portal.zip.jar: java.nio.file.NoSuchFileException:...

Can default landing pages be based on user group membership?

legacy How To

Issue I would like to set default landing pages based on user group membership so that I can redirect users to different pages on login based on their user group membership. Environment Quarterly Releases...

SCIM API is not working as expected to link existing users to SCIM Client

legacy

Issue I'm unable to use the PUT API to update users as linked to the SCIM Client. I'm not able to add new users and then update them using the PUT API linking them to the SCIM client. Environment 2024.Q1+ Resolution...

Export Analytics DXP Entities is missing and is replaced by export-analytics-dxp-entities

legacy Troubleshooting

Issue We've observed that when accessing the Job Scheduler, the property 'Export Analytics DXP Entities', is missing. We see that 'export-analytics-dxp-entities' is available. Is 'export-analytics-dxp-entities'...

When changing the User's "Language" and "Prefix" selection to another set, each selection needs to be done individually

legacy Troubleshooting

Issue We've observed an undesirable behavior when editing a User's preferred "Language" and "Prefix" selection. When editing/changing a User's "Language" and "Prefix" existing selection, each selection needs to be...

jUnit throws exception

legacy Troubleshooting

Issue We are encountering issues with jUnit and Liferay Spring MVC portlet. We have SubscriptionUtilTest class and when trying to run it by right click and run as "Junit" then throws error as...

Group Memberships are being removed after signing in via SAML after upgrading to 2024.Q2 from 2023.Q4

legacy Troubleshooting

Issue We have observed that some users's existing group memberships are missing after they login via SAML(Okta). Environment Quarterly Release 2024.Q2 Resolution This is due to the change reported in these articles:...

The account email address is set to null

legacy Troubleshooting

Issue When updating a custom field at the account entry, the account email address is set to null Steps to reproduce: Create a new Account, “Account”. Attach an e-mail address “abc@liferay.com” to the account entry...

Calling UserImporter in com.liferay.portal.security.exportimport.api throws unsatisfied references error.

legacy Troubleshooting

Issue On 7.3 we are using this class to Import users from a SamlProvider: com.liferay.portal.security.exportimport.UserImporter.importUser(long companyId, String emailAddress, String screenName) We call the service by...

Adding or Editing a Web Content in an Asset Publisher does not display a success message

legacy Troubleshooting

Issue When editing or adding a Web Content in an Asset Publisher that is on one of my Portal pages, no message is displayed to the user confirming that the action was performed or if it was successful. If this step is...

Can I schedule the garbage collector to run periodically?

legacy

Issue The 'Run the garbage collector to free up memory' task can be manually executed from Control Panel > Server Administration. Does the product offer any functionality for scheduling or automating the periodic...

Search Results