Site Search - Liferay Learn

OHS IP Appended to Image URLs on One Application Server Node

Issue Inconsistent behavior is observed between two application server nodes with identical configurations. One node appends the OHS (Oracle HTTP Server) IP address to image URLs, causing 404 errors, while...

Receiving ClassNotFoundException:JspTagHandlerPool in traces

legacy Troubleshooting

Issue When starting the server, receiving the ClassNotFoundException:JspTagHandlerPool in the gowroot traces: Steps to reproduce: 1. Start the server by giving this command: ./catalina.sh glowroot run. 2. Now...

Exceptions in the log when the Glowroot page times out

legacy Troubleshooting

Issue I see a lot of exceptions in the Glowroot logfile. It is caused by administrators accessing the glowroot page and leaving it open in a tab. Then the session times out and since the frontend tries to update the...

NullPointerException on assetRendererFactory after Upgrade

legacy Troubleshooting

Issue After upgrading to Liferay DXP 2025.q1, the upgrade process completes successfully. However, upon restarting the server, the following error is shown in the log: ERROR [render_portlet_jsp:122] Cannot invoke...

How to Optimize Language Selection for SEO

legacy Troubleshooting

Issue The language selector in Liferay DXP uses the /c/portal/update_language URL, which calls the UpdateLanguageAction.java action. This action sets the selected language and redirects the user to the...

Incorrect Pagination Behavior in the SearchResultsPortlet

legacy Troubleshooting

Issue I have an issue with the search results portlet pagination. When searching for an item by selecting a page after page 20, the first page results are shown instead of the selected page. Steps to reproduce: Set up...

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

Page Audit is not displaying errors properly

legacy Troubleshooting

Issue I have an issue with Page Audit. The feature has stopped working. When initiating an audit on a page, the progress bar reaches 99% and then stops, resulting in a null pointer exception error being thrown in the...

Proxy paths are not honored after upgrading to 2025.Q1.9

legacy Troubleshooting

Issue After upgrading to 2025.Q1.9 we've found that our page are largely inoperable. There are a large amount of console errors related to missing functions, missing MIME types, missing AUI, etc. Environment...

The drop-down is not working when clicking anywhere apart from the arrow

legacy Troubleshooting

Issue The category filter fragment only expands or collapses the category list when clicking the dropdown arrow. Clicking the category name itself does not trigger this action. Steps to reproduce: 1. Navigate to...

Filtering Analytics Cloud Individual User Activity by Date Range via API

legacy Troubleshooting

Issue There is a requirement to filter Analytics Cloud individual user activity data by date range using the API. individual user activity can be extracted withcurl -i -L -H "Authorization: Bearer {token}" -L...

Why is the Back Button not working?

legacy Troubleshooting

Issue Users have reported that the back button does not function as expected in certain areas of Liferay. Environment Liferay 7.4 Resolution Kindly navigate to Control Panel → Instance Settings → Content...

Web Content Not Visible in Related Asset Window

legacy Troubleshooting

Issue The user is unable to tag web content to another web content as a related asset with a DB2 database. Steps to reproduce: 1. Navigate to the web content section. 2. Select a basic web content item and create...

Workflow "Metrics" Data Not Visible After Upgrading Liferay

legacy Troubleshooting

Issue After upgrading Liferay from 2024.Q2.7 to 2025.Q1.4-lts, navigated to Applications Menu > Applications > Workflow > Metrics, and noticed that the data is not being displayed. Steps to reproduce: Start Liferay...

One cluster node doesn't start up completely after OS patching

legacy Troubleshooting

Issue I am currently running a Liferay cluster. I patched my OS then rebooted each server separately. One more more nodes came back online correctly, but at least one node isn't starting up completely, and I see...

Feature Flags are not enabled by Default

legacy Troubleshooting

Issue I have an issue with the feature flags: feature.flag.LPD-11131=true and feature.flag.LPD-35013=true I set both features in the portal-ext.properties file in 2025.q1.6-lts. However, after started the instance the...

Error Code 403 Forbidden: Timeout Issues when uploading/downloading Large Files to S3

legacy Troubleshooting

Issue Experiencing timeout and permission issues when uploading/downloading large files (in GBs) using Liferay's simple file system. ERROR [http-nio-0.0.0.0-8080-exec-41][PortletServlet:109] Unable to process...

Error in Logs When Accessing "OAuth 2 Administration" in Control Panel

legacy Troubleshooting

Issue When clicking on the "OAuth 2 Administration" option in the Control Panel, the following error is logged, and the UI displays an unresolved Velocity variable (${processor.processMax()}): Unable to execute...

Workflows are missing from Applications → Process Builder

legacy Troubleshooting

Issue Some workflows are missing from Applications → Process Builder. I have publications enabled in my environment, and I have edited workflows from withing the publications. Environment Quarterly Releases...

SCIM Token Generation Fails with JavaScript Error in French Language

legacy Troubleshooting

Issue When Liferay’s interface language is set to French, clicking the Generate button to create a SCIM access token results in a JavaScript error, preventing the token generation popup from opening. The following...

During portlet WAR deployment getting unresolved requirement errors

legacy Troubleshooting

Issue When deploying a spring portlet WAR using JDK 17 or JDK 21, the following deployment error appears in the Liferay logs: Unresolved requirement: Import-Package:...

Property "redirect.url.security.mode" has invalid value: domain,domain

legacy Troubleshooting

Issue After setting the property redirect.url.security.mode=domain we are now seeing WARN messages such as Property "redirect.url.security.mode" has invalid value: domain,domain Environment Liferay DXP Resolution Please...

Upgrading Liferay fails with "Data too long for column 'smallAttributeValue'"

legacy Troubleshooting

Issue I am trying to upgrade Liferay to 2024.Q3 or 2024.Q4 The upgrade fails with the following error: 2024-12-17 14:45:21.409 ERROR [main][UpgradeExecutor:333] Failed upgrade process for module...

Unwanted spaces appearing after HTML tags in translated text

legacy Troubleshooting

Issue When using HTML tags like <strong>, <b>, <h1>, <span>, and <i> within internationalized text in the Language Override functionality, an unnecessary space is generated after the closing tag when the text is rendered...

Null Values for PortalInetSocketAddress and PortalProtocol for Cluster Nodes

legacy Troubleshooting

Issue When running a Groovy script to check cluster formation, the output shows "null" for PortalInetSocketAddress and PortalProtocol for some nodes. Environment DXP 7.4 Quarterly Releases Resolution...

Liferay REST Module Failing After Adding JJWT Dependencies

legacy Troubleshooting

NOTE: The following resolution requires customization and should only be implemented at the discretion of your team. Liferay Support will not be able to assist with designing or implementing customizations. Issue...

Database Upgrade from Liferay 6.2 to DXP 2024.Q4 Fails on Oracle 19

legacy Troubleshooting

Issue When upgrading from Liferay 6.2 to DXP 2024.Q4 quarterly release using the `db_upgrade_client.sh` script, the process fails with the following error: Type change is not allowed when altering column name. Column...

REST Builder fails after upgrading to DXP 2024.Q1.5

legacy Troubleshooting

Issue: We have observed that the REST Builder is failing after upgrading from DXP 2023.Q4.4 to DXP 2024.Q1.5, and the following error occurs: The liferay.workspace.docker.image.liferay property is...

When a virtual instance is created via a headless API, the admin user's email address changes

legacy Troubleshooting

Issue When a virtual instance is created via a headless API, the admin user's email address changes. Environment 2024.q2.2 Resolution Update to 2024.q3+ or implement a portal property as a workaround: Set...

Error when projecting a clob field in a DSL query with an Oracle database

legacy Troubleshooting

Issue Given the following DSL query: DSLQuery testQuery = DSLQueryFactoryUtil.select(ddmfaTable.largeAttributeValue) .from(ddmfTable) .innerJoinON(ddmfaTable,...

WAR Deployment Issue with Java 17

legacy Troubleshooting

Issue I'm seeing the following error when deploying a war portlet that was compiled using Java 17: ERROR [fileinstall-directory-watcher][DirectoryWatcher:988] Unable to start bundle:...

Null captcha text in a custom development using liferay-captcha taglib

legacy Troubleshooting

Issue After adding the captcha taglib in a custom JSP, for example: <liferay-captcha:captcha url="${captchaURL}" /> CaptchaUtil.check(actionRequest) is returning an error since CAPTCHA_TEXT is null....

"Single Node (Memory Clustered)" type of jobs are not scheduled

legacy Troubleshooting

Issue When restarting the Liferay portal, the job schedulers are not auto-scheduled in a Single Node (Memory Clustered) environment. Expected result: Next Run Date will show an actual date Actual result: Next Run...

Using the "ehcache.multi.vm.config.location" property, the "java.lang.NullPointerException: Configuration Path is Null" error occured

legacy Troubleshooting

Issue After configuring the "ehcache.multi.vm.config.location" property in portal-ext.properties, the following errors occurred. ERROR [SCR Component Actor][ROOT:47] bundle...

Error: HikariPool-1 - Failed to validate connection org.postgresql.jdbc.PgConnection@xxxxxx (This connection has been closed.). Possibly consider using a shorter maxLifetime value

legacy Troubleshooting

Issue Facing the following error in the logs and the Liferay node became unresponsive: HikariPool-1 - Failed to validate connection org.postgresql.jdbc.PgConnection@6c009ca1 (This connection has been...

HotDeployException thrown at startup sometimes for some of our custom portlets

legacy Troubleshooting

Issue we have a problem with our portlets. Sometimes when we restart Liferay, some portlets are failing to deploy. We do not have exact scenario. It can happen for any of our portlet during restart. Here is exception that...

Unable to start Liferay Portal with error: Current URL / generates exception: java.lang.NullPointerException

legacy Troubleshooting

Issue I am unable to start my Liferay Portal. The following errors are present in the log. 2024-11-19 05:16:09.815 ERROR [main][BundleStartStopLogger:62] file:/opt/liferay/osgi/modules/activation.jar has a null...

In Liferay DXP 2023.q4.4, clustered environment fails to load additional nodes

legacy Troubleshooting

Issue When using Liferay DXP 2023.q4.4 deployed in an environment, the initial node loads up without any issues, but any additional nodes result with the following traces: In JBoss EAP 7.4 Update 17: 2024-10-05...

Filtering objects by their NestedFields.

legacy Troubleshooting

Issue Having a relationship between two objects A and B. It is possible to make queries to the /o/c/as api filtering by a field of object B as nestedField. curl -X 'GET' \...

com.liferay.expando.kernel.model.ExpandoBridge cannot be found after upgrading to Quarterly Release

legacy Troubleshooting

Issue After upgrading to Liferay Quarterly Release 2024.Q1.1, the portal logs are displaying an error related to Commerce: ERROR [SystemExecutorServiceUtil-1][ROOT:47] bundle...

Search Results