Site Search - Liferay Learn

Issue Are there any specific configurations needed when setting up a Sybase database to connect to a Liferay bundle? Environment Sybase 15.7, 16 Liferay Portal 6.1, 6.2 DXP 7.0, 7.1 Resolution Unlike other database vendors, there are a couple of commands that must be executed on Sybase...

Upgrade Tool Uses Wrong Version of Tomcat

legacy Troubleshooting

Issue When upgrading to Liferay DXP 7.0 or DXP 7.1 and using the SP1 + Tomcat bundle, the wrong version of Tomcat is suggested by the Upgrade Tool For 7.1 the bundle includes Tomcat 9.0.6, but the Upgrade Tool is configured to recommend version 9.0.10 For 7.0 the bundle includes Tomcat...

JDK Certification, Java TCK Compliance, and Liferay

legacy

With the release of JDK11, Oracle's new Java SE Support Policy (also see here) brings changes to the Java Enterprise community. The following article outlines Liferay's approach concerning the certification of JDK releases for existing versions of Liferay Digital Experience Platform and...

Virtual Host Login/Logout Properties

legacy

This article documents four portal properties that are often used to configure redirection URLs for users. The four descriptions below include the properties, their descriptions, and examples for: Configuring the default home URL of the portal Redirecting a user after logging in...

DXP 7.3 Upgrade Reference Guide

legacy How To

An upgrade to Liferay DXP 7.3 gives you access to the latest Liferay technology, complete with all of the newest features, and the assurance of continued support for your Liferay environment. Our Subscription Services Team recognizes that an upgrade often requires a significant...

How to Install and Set up a Local Liferay DXP Instance on Windows or Mac (Video)

legacy How To

Learn how to install and set up a local Liferay DXP instance for the first time. Windows Mac Additional Information Official Documentation: Installing Liferay Liferay Learning Youtube Channel, content:...

Installing Fix Packs and Hotfixes on Liferay DXP

legacy How To

This document has been updated and ported to Liferay Learn and is no longer maintained here. To install Fix Packs and hotfixes on Liferay DXP, customers must first download the latest Patching Tool. For more information on how to configure the Patching Tool, see: Using the Patching Tool....

If a Staging publication is on progress and the server is shut down, publication stays on queue and no further publications are possible

legacy Troubleshooting

Issue If a publication on staging is made and the server is shut down, the publication will stay on queue on start-up and, even if cancelled, no more staging publications can be made. The following java class stays queued: BackgroundTaskResult backgroundTaskResult = ...

JDK7 Concerns

legacy

This article is a legacy article. It applies to previous versions of the Liferay product. While the article is no longer maintained, the information may still be applicable. JDK7 is supported in 6.1 EE GA2 edition of Liferay - however please note that patches are only shipped with JDK5...

Testing if Liferay Clustering is Working Properly

How To

Issue How can I confirm that my Liferay cluster is working correctly and all nodes displays the same information accurately? Environment DXP 7.x Portal 6.x Resolution There are two ways that to accomplish this: 1. Manually Test the Cache Replication Functionality To manually test this,...

Installing Archived Modules From Liferay's Public Repository

legacy How To

This article is a how-to guide for locating, downloading and installing modules from Liferay’s public repository. Installing modules directly from Liferay’s public repository should be done if the module or application has been deprecated, archived or otherwise not distributed with the...

SQL Scripts Causing Duplicate Keys

legacy Troubleshooting

While using a new instance of the Liferay Portal, some environments may encounter the following error: ORA-01452: cannot CREATE UNIQUE INDEX; duplicate keys found Resolution This error occurs do to an error in the creation of sample data by the create-*.sql scripts. This results in...

Deploying Activation Keys

How To

This article documents the basic instructions for how to deploy your Activation Key using an .xml file. The steps will vary slightly depending on the version of the Liferay platform you are using. If you encounter any issues along the way, see this separate Troubleshooting Activation Key...

DXP 7.0 Database Portal Properties

legacy How To

This article is intended to provide a list of all the Liferay DXP 7.0 Database properties that can be used to connect your DXP 7.0 installation to various databases. To use any of them, uncomment the block of code you need, and paste it into your portal-ext.properties file. For example,...

Setting up Session Replication in Tomcat With Liferay DXP

legacy How To

The purpose of this article is to provide an example of how to set up a basic Tomcat cluster that has session replication, using built-in Tomcat features. Please note: This example is provided as a courtesy. This configuration is not supported by Liferay Support as it deals with Tomcat,...

Liferay Web Proxy Module for Digital Experience Platform 7.1

legacy How To

The Web Proxy Portlet allows web applications to be embedded within a portlet while keeping the user interaction within the portal context. The portlet is deprecated and was removed from Digital Experience Platform (DXP) 7.1 due to low adoption. The portlet will not be released as an app...

Taking Thread Dumps From a JVM

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. A thread dump is a...

Taking Heap Dumps From a JVM

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. When a system runs into...

Permissions Are Not Working Post-Upgrade

legacy Troubleshooting

After upgrading from Liferay Portal 5.2, permissions settings may act in an undesirable manner. This could include not being able to change permissions, as well as not being able to access the control panel or any other areas of the portal that require something other than guest...

Load Balancing Can Return Null

legacy Troubleshooting

When running Liferay with more than one node on a load balancer, sometimes, when generating urls for buttons, they can receive a incorrect url or sometimes a null value. Resolution Using the: redirect.url.security.mode=domain property in portal-ext.properties will fix this...

Managing LDAP Settings Using .config Files

legacy How To

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

Avoiding Empty File Uploads in Documents and Media

Issue When uploading a file in Documents and Media, a form refresh (e.g., by changing the Document Type or triggering a metadata validation error) causes the selected file to be cleared from the input field. Despite the file no longer being attached, the form can be submitted. This...

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

Search Results