Site Search - Liferay Learn

Managing LDAP Settings Using .config Files

This document has been updated and ported to Liferay Learn and is no longer maintained here. This article documents how to configure LDAP settings using .config files instead of the Control Panel. There are a great number of changes in Liferay Digital Experience Platform (DXP), and one...

Managing Distributed Cache in Liferay DXP

legacy How To

This document has been updated and ported to Liferay Learn and is no longer maintained here. This article documents the configuration options for managing distributed cache within Liferay Digital Experience Platform (DXP). Table of Contents Distributed Cache Basics How Liferay Does...

Application Server Times Out While Downloading/Uploading Documents

legacy Troubleshooting

When uploading documents larger than 3Mb via web call, an error may be thrown: 13:45:27,141 INFO [PortalImpl:4366] Current URL /documents/10162/179749/Certification+Tracking+Database+CSC+v2.0+Production.zip generates exception: null 13:47:20,403 WARN [StreamUtil:85] ClientAbortException:...

LDAP settings and upgrading from 5.2.x to 6.x

legacy Troubleshooting

This article pertains to portals in which LDAP is configured in Liferay Portal 5.2.x and an upgrade is performed. When a user attempts to login, an error is thrown, and the user is not authenticated. 18:44:06,854 ERROR [LDAPAuth:321] Problem accessing LDAP server...

Rolling Restart - Breaking Changes

legacy

Introduction When applying fix packs or hotfixes, rolling restarts are possible if there are no changes to a specific set of clustering classes or no module schema version changes. The following document is a list of the known fix packs which contain either of these exceptions. If a...

Changes in Liferay DXP Clustering

legacy

This article documents several changes with the clustering feature that will take effect in Liferay Portal CE 7.0 and Digital Experience Platform 7.0. In addition, this article details changes that may affect Community Edition users. Resolution General The default search indexing...

Managing Distributed Cache in Liferay Portal EE

legacy How To

Liferay Support does not recommend or endorse specific third-party products over others. Liferay is not responsible for any instructions herein or referenced regarding these products. Any implementation of these principles is the responsibility of the subscriber. Depending on the needs...

Changing the name of an existing environment

legacy

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。問題環境管理者としては、既存の環境の名前をもっと便利な方法で変更したい - ゼロから作り直す必要はありません。環境への配慮 DXPクラウド決議新しい環境を作成する場合、基本的にはどのような名前でも設定できます - 環境管理者の要求に基づいて。...

To be able to access Liferay PaaS portal Database through DB client

legacy

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。問題ローカルクライアントを介して Liferay Experience Cloud Self-Managed (SM) データベースに接続する方法 Environment ライフレイエクスペリエンスクラウド SM 解決策ここに回避策があります。...

Troubleshooting Missing OpenID Connect Login Option and OIDC "not requested or was removed" Errors

Issue The OpenID Connect option doesn’t appear in the Sign In (login) portlet; or, starting OIDC returns an “OpenID Connect was not requested or was removed” error. Environment Liferay DXP Quarterly Release: 2024.Q1+ Resolution If the Open ID connect button is not displayed in the login...

Integrate Azure AD with Liferay DXP Using SAML

Integrating Liferay DXP with other Identity Providers (IdPs) is a recommended security best practice. By leveraging external authentication mechanisms, you can strengthen your system's security and simplify user management processes. This how to guides you through the basic steps needed...

How to Resolve JNDI Mail Session java.lang.NoClassDefFoundError: javax/mail/Authenticator Tomcat errors

Issue How can I resolve this exception observed during initialization of global JNDI resources during Liferay startup on Tomcat? org.apache.catalina.mbeans.GlobalResourcesLifecycleListener.createMBeans Exception processing global JNDI Resources javax.naming.NamingException: Could not...

How can I add hyperlinks to an email template?

Issue I would like to replace a link, like [$PASSWORD_RESET_URL$], in an email template with hyperlink text, like ‘Click Here’. Environment Quarterly Releases Resolution You can configure a hyperlink through the HTML editing option. Navigate to Instance Settings > Email > Email Template...

Troubleshooting Unresponsiveness Caused by Batch Import Deadlocks

Issue After a period of activity, such as heavy content and object creation, the Liferay DXP instance becomes unresponsive. Symptoms include: Inability to accessible Liferay via browser or cURL requests, which eventually time out. Unresponsiveness after 2-3 hours of uptime, even if the...

How to View Previous Publication Dates for Web Content

Issue When editing a web content article that has a publication date set in the past, the Schedule Publication dialog appears with an empty date field. This behavior occurs for both newly created content scheduled for the past and for content that was created and published in a previous...

How to Access Nested Freemarker FieldSets in DXP 7.4+

Issue After upgrading to Liferay DXP 7.4+, FreeMarker templates appear to access fields within existing web content structures using different syntax than newly created web content structures. For example, older structures allow direct access to nested fields, while new structures...

ORA-01439, ORA-01440, ORA-22858, and ORA-22859 errors in the upgrade report after upgrading an Oracle database

Issue During a Liferay DXP upgrade when using an Oracle database, the upgrade completes with a success result, but the upgrade_report_diagnostics.txt file lists failed SQL statements such as these: Error: ORA-01439: column to be modified must be empty to change datatype Error: ORA-01440:...

How to Completely Delete a Portlet and Its Associated Data

Issue When a custom portlet is deprecated,it often remains in hundreds of pages across Liferay instances. Manually removing each instance and cleaning up the associated database entries is impractical. A method is needed to automate the complete removal of the portlet from all layouts...

How to delete site-scoped object entries on 2025.Q1.20 or 2025.Q1.21

Issue After creating site-scoped object entries, they cannot be deleted. Though company-scoped entries are unaffected, site-scoped entries are remaining even after: A success message being displayed in the Object Overview UI. A 204 response in the control panel. How can I delete these...

How to Resolve Jenkins Build "Content is not allowed in prolog" Errors

Issue When creating Liferay PaaS Jenkins builds, you may experience CI/CD pipeline build failures with errors relating to unresolved Gradle dependencies. For example: > Task :modules:your-module-name:compileJava FAILED [Fatal Error] dependency.pom:1:44: Content is not allowed in prolog....

How to add a certificate in Cacerts file in PaaS

How To

Issue What is the best way to add a new certificate for the Cacerts file to trust the response of a consumed API in Liferay Cloud (PaaS)? Environment Liferay DXP 7.4+ Resolution To ensure your security settings survive a reboot, the best approach is to move the certificates out of...

Troubleshooting 'Portlet is temporarily unavailable' Errors Caused by JSESSIONID in URLs

Issue When navigating our site, a ;jsessionid parameter is intermittently appended to the page URL. When this happens, portlets on the page fail to render, displaying a Portlet is temporarily unavailable error. This issue occurs when the session handling mechanism falls back to URL-based...

Getting Bad Request When Using API Filter Parameter on User Object Field

Issue When extending a system object, such as the User object, with a custom object field (e.g., customID), attempting to filter user accounts by this custom field using the headless API results in an error. The API call looks like this:...

Production Backups Not Visible in Disaster Recovery Environment After Configuration

Issue After following the documentation to set up Cross-Region Disaster Recovery in Liferay PaaS, the backups from the primary (production) environment are not visible in the secondary (disaster recovery) environment. The UI in the DR environment's Backup service does not show the tab or...

CKEditor Inserts Blank Paragraphs When Editing Articles Containing Audio or Video

Issue When a web content article containing an embedded audio or video file is created and then re-opened for editing, or when switching between WYSIWYG and source view, extra empty paragraph tags are inserted adjacent to the audio and video players. Environment Liferay DXP 2025.Q1+...

How To Upgrade JRXML Liferay Commerce Order Templates

Issue Liferay Commerce upgraded its internal reporting engine to JasperReports 7, utilizing a new XML schema with a Jackson-based parser that renders older Jasper 6 JRXML files incompatible. How can I upgrade custom Commerce order templates to the JasperReports 7 standard to make my...

Headless Object Relationship API Endpoint Returns 404 NOT_FOUND for Non-Admin Users

Issue When using a headless REST API endpoint to access an Organization related to a custom object, a 404 NOT_FOUND error returns for non-administrator users. This behavior occurs even if the user account's assigned role has explicit View permissions configured for both the custom object...

How to Migrate a Liferay PaaS Database from MySQL to PostgreSQL

Issue We are planning to migrate our Liferay PaaS database from MySQL to PostgreSQL and need to understand the process, the required steps, and the scope of Liferay Support's involvement. Environment Liferay PaaS Resolution Migrating a Liferay PaaS database from MySQL to PostgreSQL is a...

Unable to Map an Object's Multiselect Picklist Field in a Form

Issue When creating a Liferay Form that stores data in a custom Object, you cannot map an Object's "Multiselect Picklist" field to a "Multiple Selection" field on the form canvas. The multiselect object field does not appear in the Object Field dropdown under the Advanced tab of the...

How to Disable the Draggable Marker in a Geolocation Map Display

Issue When using a Geolocation field in a Web Content Structure and displaying it from the template on a page using the map-display tag, the location marker is draggable by end-users. You must make the marker static and prevent visitors from moving it. Environment Liferay DXP 2025.Q1...

How to Replicate Custom MultiVM Cache Entries Across Clustered Nodes

How To

Issue When using a custom MultiVM cache in a clustered Liferay DXP environment, entries are not replicating across all nodes. Updates made to the cache on one node are not visible on other nodes, as the cache entries are only being stored locally. Environment Liferay DXP 2023.Q1+...

CKEditor 5 Icons Not Loading When CDN is Enabled

Issue When a Content Delivery Network (CDN) is configured using the cdn.host.http and cdn.host.https properties in the portal-ext.properties file, the icons in the CKEditor 5 toolbar fail to load in Web Content articles. The browser's developer console may show errors related to...

Startup errors after installing DXP 7.2 Fix Pack 20

legacy

Issue After upgrading to Fix Pack 20, several errors related to Data Engine are thrown: ERROR [Framework Event Dispatcher: Equinox Container: 0e2749fb-bcdd-4fbb-a731-5b616e580bfb][Framework:93] FrameworkEvent ERROR java.lang.IllegalStateException: DEFAULT is already registered at...

Unable to sync callable error during upgrade

legacy Troubleshooting

Issue You might encounter the following error during your upgrade attempt: ERROR [main][DependencyManagerSyncImpl:54] Unable to sync callable java.lang.NullPointerException: null at...

Installing hotfix on weblogic server

legacy How To

Issue How to install the hotfix on weblogic server Environment Liferay DXP 7.0 - 7.4 Resolution Although this documentation explains Setting Up the Patching Tool in Weblogic, here are the easy steps Check theliferay.homefromportal-setup-wizard.propertiesand unzip the latest patching tool...

P_AUTH is ignored when using JSONWS API

legacy Troubleshooting

Issue When using JSONWS API with the P_AUTH parameter instead of credentials (email/password), the response is HTTP code 403: Forbidden. Environment Liferay DXP (any version) Resolution According to our documentation, "This authentication token is associated with your browser session and...

Illegal mix of collations during upgrade process

legacy Troubleshooting

Issue You might encounter the following error or similar during the upgrade process if your database's collation differs from the collation of the tables: com.liferay.portal.kernel.upgrade.UpgradeException: java.sql.SQLException: Illegal mix of collations (utf8mb4_general_ci,IMPLICIT)...

Is there an official docker image I can use with Alpine OS?

legacy

Issue I noted that Alpine OS is no longer available in the newer Liferay DXP docker images, they use Ubuntu instead I would like to know if Liferay plans to include Alpine OS again Environment Liferay DXP 7.0+ Resolution Liferay does not plan to have the official docker images recompiled...

After creating a new instance, we cannot log in to it.

legacy Troubleshooting

Issue We have created a new instance using the example.com domain. After creating it, we cannot log in to the new instance using the user: test / password: test credentials. What can we do to solve our problem? Environment Any Liferay version Resolution To solve this problem, you have to...

Headless API is unable to get global vocabularies on virtual instance

legacy Troubleshooting

Issue Unable to fetch the global vocabularies on virtual instance using Liferay headless API Steps to Reproduce: Create a virtual instance (Control Panel > Virtual Instances) Get the virtual instance "Global" Site ID Sign in to Virtual Instance Go to the "Global" site Configuration...

Search Results