Search Results

All Results 8315
Sort By
Resource Type
Applicable Versions
Deployment Approach
Capability
Feature
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...
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...
Boot Delegation List Did Not Upgrade Correctly
legacy Troubleshooting
Issue We are seeing the following errors in the console log after upgrading: ERROR - NoClassDefFound ERROR - Unable to Execute Method ProcessMax  ERROR - Expando Bridge Cannot be Found Environment DXP 7.1 DXP 7.2 DXP 7.3 DXP 7.4 Resolution Sometimes certain packages are not transferred...
Can Not Create a Virtual Instance
legacy Troubleshooting
Issue When trying to create a virtual instance, an error "Please enter a valid virtual host" shows up. Actually the virtual host is verified to be working. After enabling the DEBUG log for com.liferay.portal.service.impl.CompanyLocalServiceImpl, the following message is thrown in the...
Generating an encrypted certificate for SAML assertions in Liferay DXP 7.0
legacy Troubleshooting
Issue We use Liferay as SAML Service Provider and we want to generate an encrypted certificate in order to encrypt SAML assertions. Environment Liferay DXP 7.0. Resolution Unfortunately, this functionality is not available for DXP 7.0. However, it is available as of DXP 7.1, so it would...
In a clustered environment, log level changes may not be reflected
legacy Troubleshooting
Please be aware that the page you are viewing has been machine translated from Japanese into English and may contain some translation errors. If you observe any issues with the translation, please contact us. event cluster environment. When the log level was changed from Control Panel >...
The user is redirected back to the Calendar page
legacy Troubleshooting
Issue Pagination does not work in the manage calendars section (Liferay DXP Calendars). When the user attempts to change the quantity table number, he is redirected to the calendar page, and the pagination buttons (other than 1) are not displayed  Steps to Reproduce: 1) Navigate to Open...
Cluster instability
legacy Troubleshooting
Issue Liferay clustering with jGroups has been bound to HTTP thread and can cause severe cluster instability "ajp-nio-10.141.26.102-8009-exec-189" #12374 daemon prio=5 osprio=0 tid=0x00007f1d18097ac0 nid=0x2203c waiting on condition [0x00007f19ee037000] java.lang.Thread.State:...
Not possible to add Custom Entry on page
legacy Troubleshooting
Issue Mapping with Custom Objects is not working on Pages Steps to Reproduce: 1) Menu > Control Panel > Objects 2) Create a Custom Object 3) Navigate to Custom Object and click on the Fields tab 4) Add a Custom Field (text) 5) On details, publish 6) Go home 7) Navigate to Site Builder >...
How to get all sites or friendly URLs where the article is displayed?
legacy How To
Issue We are searching for a way to obtain where one article is displayed; based on the articleId. I did not find any clear way to achieve our goal in Documentation. The list should contain a list of friendly URLs or a list of siteIDs. journalArticle.getFriendlyURLMap() returns basic...
Newly created Virtual instance becoming the main instance
legacy Troubleshooting
Issue After creating the new virtual instance the newly created instance becomes the main instance and the System Setting has been shifted to the new instance. Environment Liferay DXP 7.0 Resolution This issue is due to the company.default.web.id properties. Make sure it's...
Is Windows Server 2022 supported?
legacy
Issue We would like to use Windows Server 2022 as our Operating System but we see that it is not listed in the Compatibility Matrix Environment Liferay DXP 7.0+ Resolution Windows Server 2022 is not supported as of yet. However, it is already being considered The same goes for anything...

Showing 3,161 to 3,200 of 10,320 entries.