Site Search - Liferay Learn

Knowledge Base Section Widget does not displaying the current version of Knowledge Base Article

Issue When displaying Knowledge Base Articles using a Knowledge Base Section widget, once an article is edited, the displayed content will not reflect the changes made This behavior is reproducible when the Knowledge Base Article is placed in a Folder / Sub-Folder For example: January...

Brave Browser Issues

legacy Troubleshooting

Issue I am experiencing an issue in Liferay, that is only reproducible in Brave browser, but not reproducible in Chrome, Firefox, Safari, or Edge. Environment Quarterly Releases Resolution The Compatibility Matrix does not contain Brave browser, therefore, Liferay Support cannot release...

Tomcat Vulnerabilities CVE-2024-50379 and CVE-2024-56337 in Liferay DXP

legacy Troubleshooting

Issue Vulnerability for Tomcat discovered after moving to Liferay DXP 7.4. How to remediate Apache Tomcat 9 Remote Code Execution (RCE) Via Write Enabled Default Servlet Vulnerability (CVE-2024-50379) and Denial of Service (DoS) via OutOfMemoryError (CVE-2024-56337). Environment Liferay...

Enabling ElasticSearch Sidecar logs

legacy Troubleshooting

Issue I would like to raise the log levels for ElasticSearch Sidecar The folder [liferay-home]/elasticsearch-sidecar/7.x.x/logs does not contain any log files Environment Quarterly Releases Resolution The ElasticSearch Sidecar is only intended for development and demonstration purposes....

Received "java.lang.IllegalArgumentException: Unsupported class file major version 65" when using JDK 21

legacy Troubleshooting

Issue I encountered the following error when compiling my custom JSON Webservice Module with JDK 21. exception "Unsupported class file major version 65" throwable "java.lang.IllegalArgumentException: Unsupported class file major version 65" Environment Liferay 2023.Q4.0 Resolution...

'Error: Please enter content with valid content size no larger than 1 MB' when using Liferay Forms

legacy Troubleshooting

Issue When I am saving a form with a large amount of data, I get the following error: Error: Please enter content with valid content size no larger than 1 MB. Environment Liferay Quarterly Releases Resolution Increase the threshold size with the following property: # Set the threshold...

Certificate Renewal Failing with 403 Error on Liferay PaaS

legacy Troubleshooting

Issue When attempting to renew the SSL certificate generated by Let’s Encrypt, the process fails with multiple 403 (Forbidden) errors. The error messages suggest a security restriction that is preventing the certificate from being recreated: Reason: Error accepting authorization: acme:...

Expiring license error occurs in clustered environment for Liferay PaaS

legacy Troubleshooting

Issue The following expired licensing error displays in Liferay PaaS logs: ERROR [main][LicenseManager:-1] Digital Enterprise Unlimited Enterprise-Wide license is expired Environment Liferay PaaS Resolution There are two workarounds that will work to resolve the issue: Delete the cached...

Browser Back Button Issue with Multiple Asset Publishers

legacy Troubleshooting

Issue When a page contains multiple Asset Publishers, the browser's back button may not work as expected. Clicking the back button may require multiple clicks to return to the previous page. Environment Liferay DXP 7.4 2024.Q2.0+ Resolution This is related to the implementation of...

Adaptive Media Images Not Displaying for Users in Product Catalog Search Results

legacy Troubleshooting

Issue When using Adaptive Media with images in Product Catalog search results, the images are displayed correctly for some users, but not others. For example, Adaptive Media is not working for unauthenticated (guest) users but is rendering correctly for authenticated users. Environment...

Web Content "Modified by" User Appears to be Incorrect After Translation

legacy Troubleshooting

Issue After translating existing web content, the last modified user displayed is the original author, not the translator. Environment Liferay DXP 7.4+ Resolution The "Modified by" user and timestamp for web content reflects modifications to the default language content. Translations do...

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:...

Changing the Displayed Time Zone for Audit Logs

legacy Troubleshooting

Issue Even after changing the time zone for the instance within the Instance Settings, the time zone for the Create Date for the logs in Audit are still displayed in UTC. Environment Liferay DXP 7.4 Quarterly Release 2024.Q2 Resolution The Audit table, along with most other tables in...

Localizing Object Definitions.

legacy Troubleshooting

Issue We do not find where is the feature to get objects localization. Based on following documentation https://learn.liferay.com/w/dxp/liferay-development/objects/creating-and-managing-objects/localizing-object-definitions-and-entries, this feature should be available since 2023.Q3...

How to configure X-Pack secured search service liveness/readiness probes with authentication in Paas

legacy Troubleshooting

Issue We tried to configure in our PAAS environnement the Elasticsearch X-Pack feature. When we follow this article and enable X-Pack feature in dev server (with environment variable), the ElasticSearch endpoint used for readiness and liveness are not accessible anymore and return 401...

"http://localhost:8080/o/oauth2/authorize" URL redirect to the Login Page

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue When accessing the OAuth2 authorization URL (http://localhost:8080/o/oauth2/authorize) from the "view-source" page, the browser...

Getting BadPaddingException errors in the logs after an upgrade

legacy Troubleshooting

Issue After upgrading Liferay DXP, javax.crypto.BadPaddingException errors appear in the logs when using 'Auto Login' feature ('Remember me'). Example error message: ERROR [AutoLoginFilter:247] Current URL /home generates exception: com.liferay.portal.kernel.exception.SystemException:...

java.sql.BatchUpdateException: data exception: string data, right truncation from long client extension service names

legacy Troubleshooting

Issue When deploying a client extension, you may encounter an error, that can be traced to a BatchUpdateException, such as the following: Caused by: java.sql.BatchUpdateException: data exception: string data, right truncation at...

SAML Logout Issues: Multiple Login Entries and Optimistic Locking Exceptions

legacy Troubleshooting

Issue When a user logs out after authenticating via SAML, multiple login entries might be recorded in the audit logs. This can lead to HibernateOptimisticLockingException errors, particularly during concurrent user sessions or frequent login/logout attempts. Environment Liferay DXP 7.4...

Data Migration Center: Unable to Import CSV file

legacy Troubleshooting

Issue The issue only occurs when the field is being translated, using objects alone does not cause it. Steps to reproduce 1. Navigate to the Applications Menu and click on Data Migration Center. 2. In that, click New and then export file option [create one object first with 2 fields:...

Unable to Import Site Template LAR

legacy Troubleshooting

Issue Import of a LAR file exported from a Site Template through Publishing -> Export fails when being imported to another environment with an error stating: The LAR file could not be imported because it requires page templates or site templates that could not be found. Please import the...

In SAML setup user is not getting login in the SP and receiving warning on the UI

legacy Troubleshooting

Issue After setting up the SAML process, the user tries to log in receiving the warning below and not being logged in. Environment Liferay 2023.Q4.0 Resolution If users are setting up an identity provider as Liferay and a service provider as Liferay In IDP and SP, users set the below...

SAML Authentication Error: "This message decoder only supports the HTTP POST method

legacy Troubleshooting

Issue The following SAML errors appear in the Liferay logs: ERROR [http-nio-8080-exec-5][BaseSamlStrutsAction:53] org.opensaml.messaging.decoder.MessageDecodingException: This message decoder only supports the HTTP POST method com.liferay.saml.runtime.SamlException:...

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 system), the formerly configured assignments are lost. Environment Liferay DXP...

Duplicate files in Liferay theme WAR file

legacy Troubleshooting

Issue When building a Liferay theme using Liferay Developer Studio, multiple versions of CSS and JS files are created in the WAR file. Environment Liferay DXP 7.4 Resolution To prevent duplicate files in the theme's WAR file, add the following to the theme's build.gradle file:...

Why cannot see Publications after upgrade?

legacy Troubleshooting

Issue After making the upgrade from Liferay 7.4 update-46 to Liferay 7.4 Quarterly Release Q2 2024 user cannot see the Publications. Environment Liferay DXP 7.3 Liferay DXP 7.4 Resolution Consider to verify below points: Add "/o/change-tracking-rest*" in Control Panel --> Configuration...

Unexpected SAML calls: com.liferay.saml.internal.servlet.filter.SpSessionTerminationSamlPortalFilter.doProcessFilter

legacy Troubleshooting

Issue When navigating through the portal with SAML disabled, there are a few SAML-related filters that are still being processed, leading to database calls and causing slower performance. at...

Impersonated user is unable to add items to the cart

legacy Troubleshooting

Issue When impersonating a user with permissions to add items to a cart, a message is seen in the UI, which says: “Danger: [object Object]” and the items do not get added to the cart. This behavior can be seen by following these steps: Create two users, one as User One...

After Enabling Publications, Some Notifications are Listed as "Deleted" in the UI

legacy Troubleshooting

Issue When Publication is enabled, some notifications are unexpectedly displayed as "deleted" in the Notifications UI, even though the related workflow tasks and assets are still present and accessible. After publishing a publication, the related Notifications read "Notification no...

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:...

Some result searches for the same document can show text with replacement characters (�)

legacy Troubleshooting

Issue A text document (such as a PDF) has been added to the document library. Searching by a piece of text in the file, the result includes an excerpt with regular text including the search string. Searching by a piece of text only in the title, the result includes an excerpt with many...

JSP file [/monitor/app_check.jsp] not found errors are flooding the logs

legacy Troubleshooting

Issue After upgrading from 2023.q3.8 to 2024.q3.10, customer is seeing a lot of these errors in their logs: 2024-12-19 11:43:51.749 WARN [https-jsse-nio2-11251-exec-3][code_jsp:163] {code="404", msg="JSP file [/monitor/app_check.jsp] not found", uri=/monitor/app_check.jsp} 2024-12-19...

CORS request is failing

legacy Troubleshooting

Issue If the user allows any origin (Access-Control-Allow-Origin: *) to access the resource, the CORS request fails. Steps to reproduce: 1. Start Liferay DXP 7.4 U90 2. Navigate to Control Panel > Instance Settings > Security Tools > CORS > Edit. 3. Access-Control-Allow-Origin as * 4....

Upgrading the theme: Can't find stylesheet to import errors

legacy Troubleshooting

Issue How many ways to build and upgrade the theme? Environment Liferay DXP [all version] Resolution There are three ways of upgrading the theme: 1. Client Extension 2. Gulp 3. Gradle If the user is updating to a version that supports the themeCSS client extension, Liferay recommends...

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...

LIFERAY.HEADLESS.DELIVERY scope missing or delayed in OAuth 2 applications

legacy Troubleshooting

Issue The LIFERAY.HEADLESS.DELIVERY scope is missing or delayed in appearing when creating or managing OAuth 2 applications. The issue can occur intermittently, with the scope sometimes appearing after a delay of several hours. Reindexing, restarting the application server, or creating...

Regular users with specific roles cannot access the configuration of the widget Search Insights

Troubleshooting

Issue Given a user with a custom role with permissions to access the configuration of Search Insights, she cannot access this configuration. Environment Quarterly Releases: 2024.Q3, 2024.Q2, 2024.Q1, 2023.Q4, 2023.Q3 Resolution Only Virtual Instance administrators can access the...

Sitemap does not show the complete page tree

legacy Troubleshooting

Issue Using following URL http://my-domain/sitemap.xml does not show the complete page tree. What should we take into account for all pages are included in sitemap? Environment 2024.Q1.10 Resolution When you navigate to http://my-domain/sitemap.xml, Liferay checks if the domain matches...

S3 Requests Causing Timeouts in Environments Without Internet Access

legacy Troubleshooting

Issue We observe very long loading times (over 60 seconds) when accessing certain content management pages in the admin area, particularly: Editing a page in the page editor for the first time after login Displaying or editing user information in the control panel for the first time...

Audit Events filtered by date/time are not being exported accurately

legacy Troubleshooting

Issue When using using the Audit Export Feature, filters for date and time are not applied accurately in the resulting CSV file. The exported file may not include entries explicitly requested by the filter. For example: When filtering the audit events over several days, only the current...

Rest API filter by custom expando field: A property used in the filter criteria is not supported

legacy Troubleshooting

Issue How do I filter accounts by custom field with Rest APi? I'm on 2024.q3.9, fp3, and I have added a custom field to account (From Control Panel --> Custom Fields --> Account Entry) Name: Foo Key: foo Data type: text Localized field name Searchable: as keyword Yet when I try to filter...

I want to skip OpenID Connect provider selector at sign in if there is only one provider

legacy Troubleshooting

Issue We want to bypass the client selection screen because there is only one OpenID Client to choose. Environment Quarterly Releases Resolution There is a Feature Request opened for this which is currently under development. Please refer to: LPD-19197 Please note that the new...

Liferay Learn Resources Taglib

legacy Troubleshooting

Issue In recent versions of Liferay, the liferay-learn taglib has been introduced to automatically include links to the official Liferay Learn documentation. This functionality is controlled by the property: Prior to 2024.Q2: learn.resources.enabled=false|true After 2024.Q2...

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...

Getting invalid checksum error when building the Liferay Workspace

legacy Troubleshooting

Issue Facing an error when attempting to initialize a Liferay DXP bundle in the user's Liferay workspace. Steps to reproduce: 1. Create a Liferay workspace project. 2. Set the following in gradle.properties: liferay.workspace.bundle.dist.include.metadata = true...

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...

"assetURL" not redirecting to the desired 'Product Detail' page

legacy Troubleshooting

Issue The issue regarding the POST /v1.0/suggestions API. Specifically, when using the API, the page does not redirect to the desired 'Product Detail' page, whereas the same functionality works correctly via the UI. Steps to reproduce: From the UI: Navigate to the commerce site. Search...

Unable to Run Developer Studio 3.9.8 with JDK 17

legacy Troubleshooting

Issue When attempting to run Liferay Developer Studio 3.9.8 on JDK 17, there's no option available to configure JDK 17 when navigating to Window -> Preferences -> Java -> Compiler -> Compiler compliance level. Environment Liferay Developer Studio 3.9.8 Quarterly Release Resolution...

Certain values are lost or altered upon submitting a large form

legacy Troubleshooting

Issue For very long forms, some input values may be unexpectedly lost or modified after submission. Some fields are submitted correctly, but from a certain point onwards, they start persisting with incorrect values (usually the default value, unless it's a calculated field). Environment...

Spring Boot Client Extension cannot be deployed successfully

legacy Troubleshooting

Issue After deploying a Spring Boot client extension, it is loading indefinitely with the following message: CustomSpringBootService is gearing up. The service should be ready to receive requests soon. The following messages are displayed in the service's logs: [INFO tini (1)] Spawned...

After upgrading to Quarterly we can see a "could not resolve property: DDMStructureKey" error in the log

Troubleshooting

Issue After upgrading to Quarterly we can see the following error in the server log: ERROR [BasePersistenceImpl:629] Caught unexpected exception org.hibernate.QueryException: could not resolve property: DDMStructureKey of: com.liferay.journal.model.impl.JournalArticleImpl Environment...

Alternative management of web content pending in a workflow blocked by another user

legacy Troubleshooting

Issue This article addresses the need to manage a workflow for web content that is in a pending state and is also in an intermediate task of the workflow, associated with a person or left undetermined. An alternative is provided for administrators to manage the workflow. Environment...

Unable to get product info error showing in console

legacy Troubleshooting

Issue When building projects, users are getting the below error in the console: FAILURE: Build failed with an exception. * Where: Settings file 'C:\Users\ABC\Downloads\Dev\liferay\example\settings.gradle' line: 16 * What went wrong: A problem occurred evaluating settings 'example'. >...

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...

Resolving 401 Errors When Using Authorization Bearer Tokens in RestBuilder APIs

legacy Troubleshooting

Issue When making calls to a REST API service created with RestBuilder that includes the Authorization Bearer token header, the responses often return a 401 Unauthorized status. However, when the same service is tested using Swagger within a Liferay session, it responds with a 200 OK....

How to overcome BOMs pointing to wrong JARs?

legacy Troubleshooting

Issue When compiling our custom code, we encounter issues where our OSGi modules fail to start due to unresolved references to the Liferay packages. For instance, the following error is thrown: org.osgi.framework.BundleException: Could not resolve module: my.custom.portlet [1111]_...

Unknown system variable 'tx_isolation'

legacy Troubleshooting

Issue After update database service to MySQL 8 in PaaS Liferay can not connect to database due to unknown system variable 'tx_isolation' error. [dxp] WARN [main][PoolBase:452] HikariPool-1 - Default transaction isolation level detection failed (Unknown system variable 'tx_isolation')....

Back Button is Unresponsive After Opening a Notification

legacy Troubleshooting

Issue After opening a notification, I'm unable to return to the previous page by using the back button. The back button is unresponsive if I'm viewing a notification. Return button does not work when viewing a workflow task. Environment 2024.q1 2024.q2 2024.q3 Resolution To resolve this...

Google Drive authentication randomly fails in a multi-node cloud environment

legacy Troubleshooting

Issue Google Drive authentication usually works correctly, but sometimes it randomly fails with java.lang.IllegalStateException: Authorization oAuth2State not initialized errors in the logs. Google Drive was linked to the environment correctly following the official documentation. My...

Slow Content Search with SearchUtil API

legacy Troubleshooting

Issue In 7.4 q2.12, searching using SearchUtil API is taking upwards of 3-4 minutes when the expected response is in milliseconds. Environment 7.4 2024.q2.12 Resolution Do one of the following: Upgrade to 2024.q3.3+ Request a hotfix to add LPD-32852. AddgroupIdsto SearchContext...