Site Search - Liferay Learn

Websphere is a complex application server that does not behave like Tomcat, making its patching process slightly different Resolution There are two ways to patch Liferay Portal in Websphere, but in both ways it is very important that Websphere, along with any nodes in a cluster, is shut...

Checking for Collisions Before Installing a Hotfix

legacy How To

This article will walk through the basic steps that can be used to check for code collisions between a new fix pack or hotfix and custom plugins. NOTE: This procedure requires that the patches being installed include the source code. This option is available for Patching Tool v. 19 - v....

Patching Tool 1.0.23

legacy Troubleshooting

The Patching Tool 1.0.23 is a maintenance release which includes fixes and minor updates. This article outlines improvements to the Patching tool, Steps on How to configure the Patching Tool behind a proxy server, Known Issues, Bug Fixes, as well as information on changes to this...

Patching Tool v22

legacy

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 Patching Tool v22 is a maintenance release which includes fixes and minor updates. This article describes new...

Patching a Liferay Cluster With No Down Time

legacy How To

This article describes steps for customers to patch Liferay instances in a cluster with no down time for the cluster environment. Known as a rolling change, there are limitations to this method; DO NOT use this method if the fix pack or hotfix makes changes to the database schema and if...

User is Able to Access Web Content Functions Without Proper Permissions

legacy Troubleshooting

This article documents a known issue in LPE-15180 where users are able to access web content functions without proper permissions. This vulnerability was fixed by the Portal-143-6210 Fix Pack. However, this fix was limited to only newly created web content. Resolution To patch this issue...

Dockbar Display Error After Patch Installation With Patching Tool

legacy Troubleshooting

After installation of a new hotfix, the dockbar fails to display and an error message can be found in the logs: ERROR [http-bio-8080-exec-1][LiferayMethodExceptionEventHandler:34]com.liferay.portal.kernel.portlet.PortletContainerException:...

"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 : 2][PatcherImpl:212] Patch level on portal-impl.jar: [dxp-28-7110, hotfix-xxxx-7110] WARN...

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: 2025.Q1.0 LTS * Patching Tool version: 4.0.5 * Time: 2025-03-03 20:44Z...

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 "Organizations tab". import com.liferay.portal.kernel.service.*; out.println...

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 the expected behavior for the guest site in a given instance. For the guest...

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 reused for all subsequent requests until the cache entry is cleared or expires....

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 DXP Quarterly Release 2024.Q3.0 Resolution Entity IDs are not preserved during...

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 table's size remains manageable Environment DXP 7.4 Resolution There are a few...

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+ Resolution Sadly this is currently a limitation of...

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 shorter maxLifetime value. Environment DXP 7.4 PostgreSQL Resolution We strongly recommend...

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 library. Does the upgrade touch the doclib files during the...

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 following error message is displayed in the logs:...

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 Menu at the top is also inoperative, resulting in these error:...

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 logs, resembles the following: INFO...

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 Panel > Users > Roles. 2. Create a new regular role. 3. Click on the 'Define...

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 https://learn.liferay.com/w/dxp/installation-and-upgrades/upgrading-liferay/upgrade-basics/using-the-database-upgrade-tool and ran the upgrade via DB upgrade tool. However, the...

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 > Localization > Languages. When trying to modify these repeated languages...

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, 2024.Q3 Resolution A while back there was the portal property...

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. Environment Quarterly Release Resolution This issue is resolved by LPD-39115...

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 2024.Q2+ Resolution The above described behavior is the intended behavior The...

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 intended behavior because any of the incoming portlet requests (action, render, or...

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 2024.Q1.11 Resolution The company.default.home.url property provides the...

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 Resolution This is not currently possible, but there is a feature request open at...

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 Important This feature is currently behind a beta feature flag. To add...

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' interchangeable with 'Export Analytics DXP Entities'? Environment Quarterly...

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 "java.lang.NoClassDefFoundError" for "Validator.isNotNull" code. I would like to know any...

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: Creating and Managing User Groups Importing User Groups’ Memberships...

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 – the easiest way is to either use API (e.g. patch account) or use a...

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 using the @Reference annotation @Reference(unbind = "-") public void...

Remove the Site Name and Portal Name from the Browser Title

legacy Troubleshooting

Issue While hovering the mouse on a browser tab of any page, it displays the "Page Name - Site Name - Portal Name". How to remove the Portal Name part from it? Environment Liferay DXP 7.4 Resolution Create the...

Admins can't sign in when LDAP Required is enabled if they only exist in Liferay but not in LDAP

legacy

Issue When LDAP is configured with the option Required, admin users that exist in Liferay but not in LDAP are not able to log in. Environment Quarterly Release 2024.Q2 Resolution As indicated in the documentation, when Required is enabled only users existing also in LDAP will be able to...

Unable to Cancel Shutdown Event

legacy Troubleshooting

Issue After scheduling a shutdown event, and trying to cancel it, you see an error: "Error:Text verification failed." When trying to cancel a shutdown event, I'm prompted to input a CAPTCHA, but there is no text box. Environment Liferay DXP Quarterly Release 2024.Q1.7+ Resolution To...

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 execution of this task? Environment Liferay DXP 2024.Q2 Resolution No, that...

SecureXMLFactoryProviderImpl.class_blocked.pdf is not listed

legacy Troubleshooting

Issue The user was unable to install a patch or hotfix, even after restarting the server and attempting with a vanilla instance, the following errors can be seen: ERROR [Patcher:-1] The command has failed. Please see the log for details. 25 Jul 2024 18:22:10,625 DEBUG [Patcher:-1]...

Is it possible to map non-basic user attributes with SAML?

legacy

Issue Can non-basic user attributes(e.g. jobTitle) from an Identity Provider(IdP) get mapped to their respective fields on the Service Provider's User_ table? Environment 2024.Q2 Resolution Currently, LDAP can only be used to directly map non-basic fields to the User_ table. Additional...

Why is Zendesk Chat Provider missing after upgrading to a Quarterly Release?

legacy

Issue If you configured Zendesk Chat Provider in an earlier version of 7.4, you may notice that it is missing in Instance Settings after upgrading to a Quarterly Release Environment Quarterly Release Resolution The original Zendesk Chat Provider was renamed as Zendesk Web Widgets Classic...

User's chosen Prefix does not save when switching between Languages

legacy

Issue When editing a user's preferences, I've found that the pre-selected options for "Prefix" do not remain saved when changing the "Language" option Environment Quarterly Release Resolution Liferay doesn't have automatic conversions for prefixes because a prefix may not exist in a...

com.liferay.portal.kernel.exception.LocaleException occurs during upgrade

legacy Troubleshooting

Issue I am receiving the following locale exception error when upgrading my database: ERROR - Failed upgrade process for module com.liferay.layout.admin.web com.liferay.portal.kernel.upgrade.UpgradeException: com.liferay.portal.kernel.exception.LocaleException ... Caused by:...

Understanding the 'locales.enabled' property and the Instance Settings language configuration

legacy

Issue There is a portal property to specify the locales that are enabled by default: locales.enabled. However you can change that from Control Panel > Instance Settings > Localization. How that portal property and that instance setting interact with each other? Environment Liferay DXP...

Why do I experience slowness after Liferay 7.4 2023.q4?

legacy Troubleshooting

Issue User experiences a slowness in the Liferay 7.4 Q1+ while they check the below query: SELECT COUNT (*) AS col_0_0_ FROM PortletPreferences portletpre0_ WHERE (portletpre0_.ownerType = ?) AND (portletpre0_.plid = ?) AND (portletpre0_.portletId = ?) AND portletpre0_.ctCollectionId = 0...

Can't add a new admin or requester to our project

legacy Troubleshooting

Issue We tried to add a new user to our Zendesk project but they still can't access the tickets Environment Zendesk Resolution You should check if you have support seats left available, if they are full, you should contact your sales representative requesting to increase the support seat...

PatchFileStructureException: Could not find hotfix.json or hotfix.sign

legacy Troubleshooting

Issue In some circumstances, users are unable to install the hotfix in their environment. The cause is often due to the incompatibility of the patching tool version. Sometimes, users receive the following error line: Problem occurred during the parsing of the hotfix:...

New Users Are Not Being Indexed, But Exist in the Database

legacy Troubleshooting

Issue After upgrading to 7.4, users are not being indexed, but we are able to see them in the database. New users are unable to login and are not searchable within the portal. Admin is unable to search new users to add them to groups or roles. Environment Liferay DXP 7.4 & Quarterly...

Changing the default Mail Domain in DXP

How To

Issue Configure the default email domain applied to newly created user environments within Liferay DXP. Environment Liferay DXP 7.3+ Resolution Follow these steps: Open the Global Menu and navigate to the Control Panel. Click Instance Settings. Select Instance Configuration. Locate...

"Prefix" does not save when switching between "Languages" for a User

legacy Troubleshooting

Issue When editing the "Language" selection for a User the "Prefix" does not always save the pre-selected response. Example: Set the "Prefix" to "Mr" and "Language" to "English" for a User and click Save. Change the "Language": "English" to another language where "Mr" is not the same...

Theme upgrade issues

legacy Troubleshooting

Issue We are moving from Liferay 7.3 to Quarterly releases and we would like to upgrade our theme, but facing errors e.g. "No mixin named media-query." or "Undefined variable: '$nav-underline-font-size'." Environment Liferay Quarterly Releases Liferay Theme Generator Resolution Make sure...

Known Issue [Resolved]: Control Panel access not correctly being provided through role assigned to user group

legacy Troubleshooting

Issue A user is not able to see the control panel, even though they are in a user group which correctly has assigned the application permissions and resource permissions relating to control panel access Environment 2024.Q1 Resolution This is resolved in 2024.Q2.0+, via the fix for...

Permissions assignments only save the most recently viewed page's selections

legacy How To

Issue When assigning permissions to Documents or Web Content assets, after selecting permissions for users on the first page, navigating to the second page, and saving, only the permissions selected on the second page are being saved. I would expect the values selected in the first page...

When adding a User to a child organization, it automatically assigns them to the parent organization

legacy How To

Issue I've observed a difference in behavior when assigning a User to a child organization. DXP 7.2: the user would only be assigned to the child organization and not the parent organization. Quarterly Release: the user would be assigned to the child organization and automatically be...

Unable to see the list of assignees for Site Roles, Organization Roles, Asset Library Roles and Account Roles

legacy How To

Issue I would like to access a list of Roles and Assignees for "Site Roles", "Organization Roles", "Asset Library Roles", and "Account Roles" without having to go through each individual account to get information.This function is available for "Regular Roles" but unavailable for other...

How to define user and email notifications for each asset

legacy How To

Issue I want to disable email notifications for blogs How to configure notifications for each asset to receive them by email or as user notifications. Environment DXP 7.4 Resolution It is possible to choose the notification method for each asset of the portal from the user profile menu...

How do you create a role that allows a user to edit details of other users?

legacy How To

Note, this is just one method and can be tailored to different preferences. Issue How do you create a role that can edit the details of other users? Like email address, etc. How do you create and assign a specific role? Environment Liferay DXP 7.3 Resolution Creating Users and Roles...

Parent organization membership is also displayed

legacy Troubleshooting

Issue We found a bug with how organization membership is displayed on the user account page: when a suborganization is assigned to a user, the parent organization of the assigned suborganization is also displayed. We only wish to see the suborganization and not the parent organization....

Creating a User Account Without an Email Address

legacy How To

Issue How can I create a user without requiring the user to have an email address? Environment Liferay Quarterly Releases Resolution You can create a user without requiring an email address by setting the following properties in the portal-ext.properties file....

Search Results