Site Search - Liferay Learn

Groovy scripts in Objects actions do not work in JBoss. System.out.println traces do not appear in the server logs.

Issue Objects actions using Groovy scripts to update web content after an entry is added or deleted in the object do not work as expected. This functionality works in Tomcat environments, but not in JBoss environments. System.out.println traces do not appear in the server logs....

The Product Menu Becomes Unresponsive after Upgrading to 2024.Q3 when module.framework.properties.org.osgi.framework.bootdelegation is configured

legacy Troubleshooting

Issue After upgrading to version 7.4 2024 Q3.6. the product menu becomes inaccessible and resulting in an exception at the backend. This happened after copying the module.framework.properties.org.osgi.framework.bootdelegation from Liferay version 7.1. Environment Quarterly Release DXP...

Adaptive Media Warnings from AMRuntimeException and Errors from GhostscriptImpl in the Logs

legacy Troubleshooting

Issue There are warnings related to Adaptive Media and Errors related to Ghostscript in the logs when trying to configure ImageMagick and generating media previews. First warning: 2025-04-24 00:02:15.885 WARN [liferay/adaptive_media_processor-685][AMMessageListener:79] null...

Adding proxy properties in the JVM causes images to no longer be visible on the site

legacy Troubleshooting

Issue After adding the following properties to the environment variables LIFERAY_JVM_OPTS, images on the site are no longer visible. https.proxyHost= httpx.proxyPort Environment Liferay DXP QR 2024.Q1.10 Resolution In order to get the images to appear, the following property must...

The XML Sitemap does not include Web Content URLs from the Asset Library or the Global Site

legacy Troubleshooting

Issue The sitemap does not include any web content created in Asset Libraries or the Global site. Web contents having a Display Page template within the site are correctly included in the XML sitemap. Environment Liferay DXP 7.3, 7.4 Quarterly Releases Resolution This behavior is not...

File Upload Fails in Forms on Remote Live Site

legacy Troubleshooting

Issue When uploading files using a form upload field on Remote Live site, files do not upload, and the following error message appears: "An unexpected error occurred while uploading your file." This only occurs in Remote Live site and not on the Staging site. Environment Liferay DXP 7.4...

External Document Management Tool Integration Fails When a Vocabulary is Required

legacy Troubleshooting

Issue I'm unable to create a new document in Google Drive or Office 365. After editing documents in Google Drive and navigating back to Liferay, the Liferay UI breaks. I currently have at least one Vocabulary that is required for documents. Environment DXP with Google Drive or Office 365...

Tomcat download error encountered when leveraging Liferay Developer Studio / IDE

legacy Troubleshooting

Issue When leveraging Liferay Developer Studio / IDE to build Liferay 2025.Q1.3, my build fails with indications that Tomcat is not able to download Example error: Execution failed for task ':modules:demo-local-service-wrapper-test:setUpTestableTomcat'. > Can't get...

Custom CK Editor toolbar is registered but not displayed

legacy Troubleshooting

Issue We followed this blog post to create a custom CKEditor 4 module in workspace. We can see that CKEDITOR.plugins.registered but, we are not able to see it on the CK Editor toolbar UI in Liferay 7.4 portal. Environment Quarterly Releases Resolution The blog post was written 4 year...

Brave log-correlation issue

legacy Troubleshooting

Issue I am using brave (https://github.com/openzipkin/brave) to create a correlation across all logs events from Liferay, portlets and backends. After upgrading from Liferay 7.2 to 2024.Q3.12, which now internally uses log4j2 v2.17.1, I am missing the information taceId and spanId in...

Slow Performance When Searching for Non-Admin Users

legacy Troubleshooting

Issue Searching for non-admin users causes performance issues that did not exist prior to upgrading to 2024.q1. When non-admin users attempt to search, they receive a timeout error. Performance issues in SearchPermissionChecker due to too many GroupLocalService calls. Thread dumps show...

"Lambda expressions are allowed only at source level 1.8 or above" warning occurs in the logs

legacy Troubleshooting

Issue The following warning occurs in the logs while configuring the WebSphere application server with Liferay. WARN [WebContainer : 4][code_jsp:162] {code="500", msg="JSPG0049E: /html/common/themes/top_head.jsp failed to compile : __JSPG0225E: An error occurred at line: 21 in the...

javax.mail.Provider: com.sun.mail.imap.IMAPProvider not a subtype

legacy Troubleshooting

Issue I am encountering the following error when attempting to send emails using Jakarta Mail (version 2.0.1) within my Liferay environment. javax.mail.Provider:com.sun.mail.imap.IMAPProvider not a subtype Environment Liferay DXP 7.4 Resolution Liferay versions prior to the Jakarta...

Hardcoded Text in Commerce Order Importer Not Translatable

legacy Troubleshooting

Issue Allow hiding the non-required options from CSV template message. We have this csv_template.csv file and sometimes we need to edit its content to remove non-used fields, like requestedDeliveryDate that is optional. The issue is that we cannot hide the field from the message, as it...

I cannot add a parent page in Menu Display using the Pages Hierarchy

legacy Troubleshooting

Issue I have an issue with the Menu Display Widget. When I try to select a parent menu in the configuration tab, the preview doesn’t change and after saving the configuration the Pages hierarchy is reset. Reproduction Steps: Add a widget page "1" Add a widget page "2" child from "1" Add...

Radio Buttons in Forms cannot be navigated by keyboard

legacy Troubleshooting

Issue I have set up a form with non-inlined radio button groups. Using tabulator and arrow keys, I cannot select the appropriate option within groups. This is an accessibility issue, since the form cannot be navigated with keyboard only. Environment 2024.Q1 2025.Q1 Resolution This is a...

Special characters like apostrophe (') is displayed as its ASCII value in the account address field

legacy Troubleshooting

Issue Special characters like apostrophe (') are displayed as their ASCII value in the account address field. Steps to Reproduce: Start Liferay DXP 2024.Q1.12 Go to Control Panel -> Accounts Create an account and add a "Billing/Shipping" address. Enter special characters in any field...

Pagination Numbers Displayed in Hindi Numerals When Language is Switched to Hindi

legacy Troubleshooting

Issue When switching the language from English to Hindi, the numeric values in the pagination control change to Hindi numerals. Environment Liferay DXP 7.4 Quarterly Release 2023.Q3 Resolution This issue is due to the default behavior of Java's NumberFormat class when using JDK versions...

ClassCastException When Adding Web Content in Batch via Headless API

legacy Troubleshooting

Issue When attempting to add web content in batch using the headless API endpoint /o/headless-delivery/v1.0/sites/{siteId}/structured-contents/batch, a ClassCastException occurs. The error resembles the following: ERROR [default-2][BatchEngineImportTaskExecutorImpl:155] Unable to update...

Are Document Previews in Liferay Compatible with '.potx' File Extensions?

legacy Troubleshooting

Issue We are facing an issue with the preview of files having '.potx' extension. We added the extension in System Settings > Documents and Media > Service and System Settings > Documents and Media > Item Selector View. After which we are able to upload the files to documents and media,...

After upgrading to DXP 7.4 u92 I receive an unable to locate transaction executor error on server startup

legacy Troubleshooting

Issue I have an issue with deploying our custom built Java modules. I upgraded from DXP 7.4 update 81 to u92. After the upgrade, on server startup the deployment of the custom built modules behavior is inconsistent and the following error is thrown ion the log:...

The restClient object throws error in Freemarker templates on JBOSS EAP

legacy Troubleshooting

Issue The "restClient" object throws an error in a Freemarker template within a Web Content Template, Application Display Template, a Fragment or any other kind. The error message displayed on the HTML page is something similar to: Java method...

Site-initializer using PATCH instead of PUT for object definition with API

legacy Troubleshooting

Issue I am having issues updating our object definitions via site initializer synchronization. The issue was first observed with new fields not getting added to objects. When I do a manual object definition export/add fields/import, it works, and I get the new fields; if I try it via...

How can I search for all instances where a specific theme has been applied?

legacy Troubleshooting

Issue I have applied a specific theme to certain pages and would like to update the theme to a new one. However, I am not sure which pages / layouts have my theme has been applied. When I remove my previous theme and update to my new theme, I am seeing this warning: WARN...

Upgrade to 2024.Q1.14 LTS on Oracle failed with "Invalid column name" error

legacy Troubleshooting

Issue When upgrading to Liferay DXP 2024.Q1.14 LTS, the database upgrade process fails with the following error: ERROR - Failed upgrade process for module com.liferay.layout.page.template.service com.liferay.portal.kernel.upgrade.UpgradeException: java.sql.SQLException: Invalid column...

When trying to develop an integration to import several product warehouse availability, the BatchEngineImportTask fails

legacy Troubleshooting

Issue Blocking bug evident when trying to use the warehouse item batch headless API. Steps to reproduce: Create a warehouse with external reference code CR41 Execute a POST to /o/headless-commerce-admin-inventory/v1.0/warehouses/warehouseItems/batch with the following json body [ { ...

Content Structure Headless getSiteContentStructuresPage search does not consider Structure name or description

legacy Troubleshooting

Issue The user is unable to search for a specific web content structure using either the structure name or description via the API endpoint: /o/headless-delivery/v1.0/sites/20117/content-structures?search=demo Steps to reproduce: 1. Navigate to Product Menu > Content & Data > Web Content...

"Fields", "nestedFields" and "Restrict Fields" do not filter out the data in the API response body

legacy Troubleshooting

Issue While using the Navigation Menu Headless API (`/o/headless-delivery/v1.0/navigation-menus/${navigation_menu_id}`), the response is too long, especially with multiple navigation levels. When "navigationMenuItems.customField" or "navigationMenuItems.link" or...

Thread deadlock during startup of liferay in cluster

legacy Troubleshooting

Issue I'm not 100% sure on how to reproduce/trigger it, but it seems that when there is active traffic to the cluster, there is a fair chance that one of the nodes will deadlock during startup of the portal. We see this happen almost every deployment on production, however on dev, test &...

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

legacy Troubleshooting

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" type="javax.mail.Session" mail.smtp.host="MY_HOST_VALUE" /> And adding the following...

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 org.eclipse.osgi.container.Module.start(Module.java:413) 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 potentially flooding the log file: ... at...

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 com.liferay.object.service java.lang.IllegalStateException: Unable to upgrade...

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 to dispatch request: The class com.example.package.Class specified in the...

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 Quarterly Release Resolution These WARN messages are often caused by...

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_'. com.microsoft.sqlserver.jdbc.SQLServerException: Invalid object name...

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 error message is displayed in the browser console: Uncaught SyntaxError:...

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: com.liferay.portal.osgi.web.servlet.jsp.compiler; resolution:="optional"_ 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 following errors appear in the logs. 2024-06-25 12:02:56.631 ERROR...

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 Library, Vocabulary (internal), Category, Folder, and Web Contents 2. Assign the...

'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: a66dab4b-cb78-460e-aa7f-8ea2748a79be][Framework:47] FrameworkEvent ERROR...

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 check all of your environment's PROPERTIES files to ensure that...

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 com.liferay.dynamic.data.mapping.service com.liferay.portal.kernel.upgrade.UpgradeException:...

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 allowed origins configured in Liferay. If the issue persists even after...

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 Resolution Try with the attached updated Groovy scripts. If the issue persists, please...

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 settings only handle site-level redirections and do not support redirection for...

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 method is used to obtain the layoutIds: List<Long> layoutIds =...

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 This behavior is expected when not all cluster nodes have been accessed through a web...

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 in a fragment This extra space is visible in both the displayed...

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 found error on the UI. Steps to reproduce: 1. Start Liferay DXP 7.4 U90. 2....

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 characters E2 80 8B related to the character ZERO WIDTH SPACE interpreted by 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 After adding the following dependencies to the build.gradle file of a...

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 object entry json, with no messages in the logs and no ImportTask ID...

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 Media and add a video. 2. Copy the path of the video. 3. Now create a fragment 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] Unable to uninstall org.eclipse.osgi_3.13.0.LIFERAY-PATCHED-19 [0]...

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 LayoutBranch.LayoutBranchId has different type than LONG not null Here...

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 company.security.strangers.verify to false Additional Information LPD-40015 ,...

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 currently overriding the default value managed by the liferay.workspace.product setting....

'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: com.liferay.petra.process.ProcessException: java.lang.OutOfMemoryError:Java heap space...

Search Results