Site Search - Liferay Learn

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