Site Search - Liferay Learn

"Unable to lookup mail/MailSession" error when sending emails

Issue We have configured email delivery using the application server JNDI mail resource: Configuring in the context.xml of the application server: <Resource name="mail/MailSession" auth="Container"...

Intermittent portal startup failures due to BundleException

legacy Troubleshooting

Issue Intermittent portal start up failures occur when the following BundleException error is observed: Caused by: org.osgi.framework.BundleException: Cannot transiently start a module whose start level is not met. at...

Can I use per-instance portal-[companyId].properties files in my enviroment?

legacy Troubleshooting

Issue You would like to have a per-instance properties file after adding -Dcompany-id-properties=true in setenv or system-ext properties. While infrequent, a StackOverflowError can be reproduced and...

Upgrade to 2024.Q4.5/6 fails with "Unable to upgrade com.liferay.object.service to 10.2.0 from 10.0.0"

legacy Troubleshooting

Issue I am trying to upgrade to 2024.Q4.5 or 2024.Q4.6. The upgrade fails with the following error: 2025-02-03 15:56:10.160 ERROR [main][UpgradeExecutor:333] Failed upgrade process for module...

Resolving ClassNotFound Exceptions in JSPs and TLDs

legacy Troubleshooting

Issue A ClassNotFound exception occurs when referencing classes from JSPs or TLDs, even when using a wildcard (*) in the import-package header of liferay-plugin-package.properties. Example error message: Unable...

Seeing "A JSON web service action is already registered at" WARN messages after upgrading Liferay

legacy Troubleshooting

Issue After upgrading Liferay, I'm seeing the following WARN message repeatedly in the logs: WARN [main][JSONWebServiceActionsManagerImpl:590] A JSON web service action is already registered at ... Environment...

Database Upgrade Fails with "Invalid object name 'Configuration_'"

legacy Troubleshooting

Issue When running the upgrade, we see the following error: 2025-03-05 07:05:33.290 ERROR [Apache Felix Configurator Worker Thread][LogService:47] Error processing taskInvalid object name 'Configuration_'....

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

Is there an out-of-the-box way to set up gzip compression for only specific endpoints?

legacy

Issue The gzip filter is disabled by default, but I enabled it using: com.liferay.portal.servlet.filters.gzip.GZipFilter=true After enabling it, I tried accessing an image guest URL via Postman, but I noticed that the...

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

[PortletServlet:109] Unable to process portlet com_liferay_dispatch_web_internal_portlet_DispatchPortlet: java.lang.reflect.UndeclaredThrowableException

legacy Troubleshooting

Issue Navigate to Control Panel > Configuration > Job Scheduler > Scheduled Jobs, and after clicking the "Run Now" button, it redirects back to the "Job Scheduler Triggers" page instead of executing the job. The...

Not able to get results for internal categories when fetching via APIs

legacy Troubleshooting

Issue Not getting similar results from Headless APIs when filtering content by internal categories. However, everything works fine with Public categories. The following are the steps: 1. Create an Asset...

'Unresolved Requirement' error for a custom module post upgrading DXP 7.4 from U24 to U92

legacy Troubleshooting

Issue Receiving the 'Unresolved Requirement' error below for a custom module post upgrading DXP 7.4 from u24 to u92: ERROR [Framework Event Dispatcher: Equinox Container:...

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

Configuring Site Locales Using Site Initializer site-settings.json File

legacy

Issue How can I configure site locales using the site-settings.json file within the Site Initializer framework? Environment Liferay DXP 7.4+ Resolution Currently, the Site Initializer framework doesn't support...

How to Remove Product Attachments via Commerce API?

legacy How To

Issue I need to remove a product attachment by running a script and I am looking for the appropriate Commerce Headless API endpoint to accomplish this. Environment Liferay DXP 2023.Q4.0+ Resolution As of Liferay...

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

Liferay DXP + JBoss EAP 8 Compatibility FAQ

legacy

When will Liferay Support JBoss EAP 8.0? Our team is actively working on making Liferay compatible with JBoss EAP 8. Upgrading to JBoss EAP 8 will require migrating to a newer version of Liferay DXP that supports...

URL scheme must be "http" or "https" for CORS request

legacy Troubleshooting

Issue CORS errors "Failed to fetch" when accessing headless APIs through the API Explorer. Environment Liferay DXP 7.4 Resolution CORS issues arise from mismatches between the origin of the API request and the...

Customize Liferay Startup Logo

legacy How To

Issue How to customize Liferay Startup Logo Customization Environment Liferay 7.3 Liferay 7.4 Resolution NOTE: The following resolution requires customization and should only be implemented at the discretion of...

Groovy Scripts not working on Partner Portal

legacy Troubleshooting

Issue While filling out the upgrade request form on Partner Portal, the groovy scripts 'ee_6_2-all.groovy' and 'PrintDatabaseInfo_DXP_Modified.groovy' are not working. Environment Liferay Portal 6.2...

URL redirection between sites in Liferay DXP 7.4

legacy Troubleshooting

Issue After migrating from Liferay DXP 7.3 to DXP 7.4, URL redirection rules defined in rewriteurl.xml (no longer supported in 7.4) and through .config files stopped working. Liferay’s built-in redirection...

What 'type' parameter should I provide to the addUser() function when creating a User through API?

legacy

Issue I would like to create a user via UserLocalServiceUtil.addUser() One of the parameters required is 'int type'. What value should I provide to this type parameter? Environment DXP 7.4 Quarterly Releases...

JournalContentSearchLocalServiceUtil.getLayoutIds returns an empty list

legacy Troubleshooting

Issue When trying to retrieve the pages where a web content article is displayed using its articleId, an empty list is returned. After instantiating a web content in a Content Viewer, the following...

How to set up Search Blueprints to be used with Search headless API

legacy How To

Issue You do not find a suitable headless API or is not still developed by Liferay so you would like to create your own search blueprint and invoke it easily from Search API. For example, retrieve draft...

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

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

ERR_CONTENT_DECODING_FAILED

legacy Troubleshooting

Issue When the user is accessing their DMS application, sometimes they encounter the below error in the browser console: Error : Failed to load resource: net::ERR_CONTENT_DECODING_FAILED....

Receiving resource not found error when creating commerce product through headless API

legacy Troubleshooting

Issue When creating a product using headless API. After creating it, the product status shows 'Approved'; however, when searching for the product or clicking the product to open it, that shows the resource not...

String ¿¿¿¿¿¿ is displayed in several Web Contents after upgrading

legacy Troubleshooting

Issue After upgrading, some Web Contents are displayed with the string ¿¿¿¿¿¿¿. Environment Quarterly Releases: 2023.Q3, 2023.Q4, 2024.Q1, 2024.Q2, 2024.Q3 Resolution The string ¿¿¿¿¿¿ is codification of the...

Where can I see image details in the Headless API response for Vocabularies?

legacy

Issue I cannot see image details for Categories in the Headless API response upon calling /o/headless-admin-taxonomy/v1.0/taxonomy-categories/{{categoryId}} Environment Liferay 7.4 Quarterly Releases...

How to get the portlet ID in the Asset Publisher template

legacy How To

Issue How can I obtain the portlet ID, which is used for advanced styling, within the Freemarker template of the Asset Publisher? Environment Liferay DXP 7.4+ Resolution The portlet ID used for advanced styling is a...

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

Client Extension Batch Not Inserting Object Entries

legacy Troubleshooting

Issue We have a batch client extension to deploy List Definitions and Object Definitions, and we tried to use the same batch CX to insert object entries for an object definition. However, the batch seems to ignore the...

Video loads multiple times on page refresh/ page navigation

legacy Troubleshooting

Issue When a video is added to the page and the page is refreshed, the video gets loaded multiple times which is ultimately impacting the performance of the page. Steps to reproduce: 1. Go to Documents and...

ERROR [SystemExecutorServiceUtil-5][BundleBlacklist:198] Unable to uninstall org.eclipse.osgi

legacy Troubleshooting

Issue After restarting the server, the system shuts down and displays a 503 error. The following error appears in the logs: 2024-11-29 22:12:03.912 ERROR [SystemExecutorServiceUtil-5][BundleBlacklist:198]...

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

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

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

'OutOfMemoryError' during PDF preview generation

legacy Troubleshooting

Issue Application nodes frequently crash. The following error appears in the logs: ERROR [liferay/document_library_pdf_processor-1][PDFProcessorImpl:795] java.util.concurrent.ExecutionException:...

Glowroot Access for Non-Admin Users

legacy

Issue The user encountering an issue with accessing Glowroot using roles other than administrator. Here are the steps performed: 1. Started the server using the command: ./catalina.sh glowroot run 2. Navigated to...

What is the use of XML files in logs folder?

legacy

Issue Users can find two sorts of files in the liferay-dxp/logs folder .log and .xml. What is the purpose of XML log files? Environment Liferay DXP 7.2 Liferay DXP 7.3 Liferay DXP 7.4 Resolution XML log file...

Can we enable a prompt for asset removal?

legacy How To

Issue Currently, there is no confirmation message before we remove assets (web contents, documents etc) asking us if we really want to do it This could lead to accidental deletions which of course can be...

Spring Framework 6 and JDK 21 Compatibility with Liferay DXP

legacy

Issue There is a need to upgrade the application to Spring Framework 6 due to security vulnerabilities in Spring 5.x. Is Spring 6 compatible with Liferay DXP 7.4 or later patches? What is the exact version...

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

Unable to disable Email Verification in the Control Panel Instance Settings

legacy Troubleshooting

Issue When attempting to uncheck the "Require strangers to verify their email address?" option under Instance Settings → User Authentication and clicking Save, the setting reverts to being checked. Environment Quarterly...

The per-virtual instance portal properties file feature has been removed

legacy Troubleshooting

Issue The per-virtual instance portal properties file feature is deprecated. Files such as portal-[companyId].properties will no longer be considered The JVM property -Dcompany-id-properties=true is also no longer...

Why is Javascript utilized more than HTML in Liferay, given that it has an influence on site performance?

legacy

Issue Why is the Javascript percentage high as compared to the HTML percentage in Liferay, which should be vice versa in any application if someone wants their sites to be crawled by Google? As per the GSC (Google...

Configure Rate Limiting in Apache for Liferay Forms

legacy How To

Issue How to prevent users from submitting a form too frequently (e.g., more than 10 times in 10 seconds) in a custom MVC portlet. Environment Liferay DXP 7.4 Resolution Configure rate limiting directly in the...

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

When will Liferay support JBoss EAP 8?

legacy

Issue Do you have plans to support JBoss EAP 8 for the Liferay Quarterly Release? Environment Liferay Quarterly Release Resolution We still have not indicated or planned the exact Quarterly Release where the JBoss EAP...

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

Can Liferay integrate logs with SIEM?

legacy

Issue Is it possible to integrate Liferay's application log entries with a centralized logging system like SIEM(Security Information and Event Management)? Environment DXP 7.4 Resolution SIEM integration may be possible...

Marketplace License Does Not Appear On Our Account and Purchased Apps Not Visible

legacy How To

Issue We purchased a perpetual license to the RTG Survey Portlet, but it seems that it's no longer attributed to our account. As the marketplace has changed significantly since we last had to re-issue a license key,...

Framework Event Dispatcher error is seen reporting missing packages when trying to connect an upgraded database to a new environment

legacy Troubleshooting

Issue After upgrading to a Liferay Quarterly Release version and trying to connect the upgraded database to the production environment, a Framework Event Dispatcher error is seen reporting missing...

JS file caching

legacy

Issue How to enable the cache for the JS file? On each page refresh, all default JS is getting called, impacting site performance. Environment Liferay Paas Liferay Quarterly Release Resolution While refreshing the...

How to perform some actions when an OSGi module is started/stopped

legacy How To

Issue I would like to perform some actions when my OSGi module is started/stopped. How can I achieve that? Environment Liferay DXP 7.0+ Resolution NOTE: The following resolution requires customization and should only...

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

Search Results