Site Search - Liferay Learn

Issue You might get an error when trying to deserialize a session, which looks similar to this: java.lang.IllegalStateException: Error deserializing Session [2522563CC05A5789E25189BD49FFB38C]...

Fail to upgrade to fixpack dxp-8 or higher due to duplicate key error

legacy Troubleshooting

Issue When trying to upgrade Liferay DXP 7.2 to fixpack dxp-8 or higher, the process fails due to the following error: ERROR [Portal Dependency Manager Component Executor--1][UpgradeStepRegistratorTracker:184] Failed upgrade process for module com.liferay.asset.display.page.service...

Password Policies is inaccessible after upgrading from 6.2 to DXP 7.2 - workaround without rolling back to 6.2

legacy Troubleshooting

Issue After upgrading from 6.2 to 7.2, navigating to Control Panel > Users > Password Policies shows a UI error "Password Policies is temporarily unavailable", and an error is thrown in the logs: ERROR [https-jsse-nio-8441-exec-4][PortletRequestDispatcherImpl:304] Unable to dispatch...

Auto Upgrade in DXP 7.3 and Above

legacy How To

Issue Starting from Liferay 7.3, new upgrades for modules won't run automatically on startup by default. Resolution The following options are available to run the upgrades we may include in fix/service packs: Recover the old behavior with the property upgrade.database.auto.run set to...

Violation of PRIMARY KEY constraint on startup after DB upgrade

legacy Troubleshooting

Issue After successfully upgrading your DB with the db-upgrade tool you might face a similar error to the following one on fresh startup:...

Warnings get thrown while attempting to upgrade Lock_ table

legacy Troubleshooting

Issue Several warnings get thrown, while the migration tool is trying to upgrade Lock_ table. WARN [main][UpgradeProcess:446] Attempting to upgrade table Lock_ by recreating the table due to: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server...

Upgrade from Liferay DXP 7.2 FP5 to Liferay DXP 7.3 GA1 fails

legacy Troubleshooting

Issue When running the DB upgrade process from Liferay DXP 7.2 FP5 to Liferay DXP 7.3 GA1, it fails due to Duplicate column name 'defaultVirtualHost':...

Groovy Script for deleting users from the database

legacy How To

Directly modifying the database is not advised because we are unable to provide assistance regarding the damage it might do. The suggested approach in these cases is a groovy script that uses Liferay's API. Environment Liferay DXP 7.0 Liferay DXP 7.1 Liferay DXP 7.2 Resolution Here is a...

How-To Generate a HAR file for Liferay Support

HTTP Archive (HAR) files are a format used to track information between a user's browser and site. It can be used to identify performance issues such as slow load times, page renders, or other bottlenecks. This is due in part, because the file tracks the load of resources and how long...

ETAG response header is missing

legacy

Issue ETAG response header is missing on a page. Environment DXP 7.1 Resolution If a page contains at least one non-cacheable portlet, - such as Asset Publisher -, the ETAG response header is not added by design. The condition whether a portlet is cacheable or not is determined by...

Staging Publishing Takes a Long Time

legacy Troubleshooting

Issue Publishing from Staging takes a very long time Staging performance issues when publishing content Environment Liferay Staging Resolution The most common cause of this is trying to publish large amounts of data at a time. Best Practice is to "publish small, publish often". Don't...

Title/Description truncated during upgrading to Liferay 7.1+

legacy

Issue Receiving warnings in the log during the upgrade process about truncated titles/descriptions for certain articles. Example: WARN [ForkJoinPool-5-worker-2][UpgradeJournalArticleLocalizedValues:192] Truncated the description value for article 12345 because it is too long WARN...

ORA-01408 exception when upgrading custom Service Builder module

legacy Troubleshooting

Issue Running g! upgrade:check it turns out that a component was not migrated successfully, the output is for example: There is an upgrade process available for ServiceBuilder.service from 0.0.0 to 1.0.0 Upon executing the upgrade, a similar error appears:...

Upgrade from 6.2 to DXP fails with IBM-specific AESSecretKey error

legacy Troubleshooting

Issue Upgrade from 6.2 to DXP fails with IBM-specific AESSecretKey error, when a user was using IBM JDK for the 6.2 environment. 2020-01-08 13:00:49.267 ERROR [main][Base64:343] java.lang.ClassNotFoundException: com.ibm.crypto.provider.AESSecretKey...

How to identify the filename for a System Settings configuration file

legacy How To

Issue This article documents how to determine the filename that should be used for a Systems Settings configuration file (.config) that can be inserted into $LIFERAY.HOME/osgi/configs. Why? The creation of System Settings .config files permits you to transfer configurations between one...

Important Changes in Fix Pack Release Notes

legacy

Issue Some fix packs cannot be reverted or may have hard limits on which versions that the patch level can be reverted to. The reason why a rollback option is unavailable is due to database schema updates, plugin updates, or other changes that are incompatible with an earlier fix pack...

Different Browser Cache Behaviour on HTTPs Protocol in Google Chrome

legacy Troubleshooting

Issue Not all of the static requests are cached in Google Chrome, when you follow this documentation to set up HTTPs: Setting Up HTTPs on Tomcat Reproduction steps: Set up the portal as per attached documentation Access the home page over 8443 port and observe the network tab in chrome...

Upgrading from Liferay DXP 7.1 to 7.2

legacy How To

This paper is a high-level overview of the effort involved in moving from Liferay DXP 7.1 to 7.2. It contains an upgrade checklist, the upgrade steps, and what to do after a successful upgrade. The paper is available for download here., content:...

Liferay DXP Feature Comparison

legacy

Each version of Liferay improves on the features and functionality of previous versions. Since the release of Liferay Portal 6.2 EE, the Liferay platform has continued to evolve to cover new use cases that digital businesses face everyday. This whitepaper gives a comparison of the...

Benchmark Study of Liferay DXP 7.2

legacy

This whitepaper is a benchmark study of Liferay Digital Enterprise 7.2 and describes optimal configuration, settings, and the methodology used for this study. The whitepaper also contains the results based on the scenarios used. The paper is available for download here., content:...

Blogs Image Properties Moved to OSGi Config

legacy How To

Issue After installing 7.2 fix pack 1 the blogs.image.max size and blogs.image.extentions settings do not persist. Resolution The blogs.image. portal properties have been modularized and need to be set in the Control Panel or with a .config file. The portal properties will no longer...

Portal has upgraded successfully and NullPointerException is thrown with the server startup

legacy Troubleshooting

Issue Successfully upgraded the Liferay portal from 6.2EE to DXP 7.1 GA but the server is not started and thrown the NPE Null pointer Exception: 2019-09-13 01:11:59.750 ERROR [http-nio-8080-exec-1][MainServlet:1225] com.liferay.portal.kernel.events.ActionException:...

After upgrading to Liferay 7.1+, guest users cannot see some web contents

legacy Troubleshooting

Issue After upgrading to Liferay DXP 7.1+, guests users cannot see some web contents. This is also reproduced for users that aren't members of one site. They cannot see web contents that belong to that site. Environment Liferay DXP 7.1+ upgraded from Liferay 7.0 or 6.x Resolution The...

How to resolve deployment issues following the installation of Fix Pack DXP-12 for Liferay DXP 7.1

legacy Troubleshooting

Issue Please bear in mind that special considerations should be taken after applying the Fix Pack 12 (DXP-12). After the installation of DXP-12, it has been reported that deployment errors related to several core components will throw the following errors:...

Work folder under Liferay Home

legacy

Issue After upgrading to Liferay DXP we noticed that a work folder is created in {Liferay_Home}, in addition to {Tomcat_Home}/work directory. Is this the normal behaviour? Environment Liferay DXP 7.0 Liferay DXP 7.1 Liferay DXP 7.2 Resolution {Liferay_Home/work} got introduced in Liferay...

Failed upgrade process for module com.liferay.dynamic.data.mapping.service - Nested exception: Content is not allowed in prolog.

legacy Troubleshooting

Issue After a seemingly successful upgrade to Liferay DXP 7.1 the following error is showing up in the logs while starting the DXP bundle: Failed upgrade process for module com.liferay.dynamic.data.mapping.service com.liferay.portal.kernel.upgrade.UpgradeException:...

APR library not found

legacy Troubleshooting

Issue The Apache Tomcat works without the native libraries but degrading the performance. You can see the following message on the log: INFO: The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: ...

Deleting users using UserLocalServiceUtil.deleteUser(user) gets slow

legacy Troubleshooting

Issue UserLocalServiceUtil.deleteUser(user) API's performance decreases, when we try to use it to delete large number of users At first this job started deleting 1100-1200 users in 1 hour per day, but after 3-4 days it is only deleting 200-300 users per hour. Why is it so slow?...

How to resolve when basic configuration portal properties are not read during startup

legacy Troubleshooting

Issue When starting a pre-built Liferay DXP bundle for the first time, some of the properties set in a portal-ext.properties file (such as the default.admin.* and company.default.* properties) do not take effect and the Liferay defaults remain. Environment DXP 7.0 DXP 7.1 DXP 7.2...

How to know if your UDP Multicast communication is working

legacy Troubleshooting

Issue Communication is not working properly in the cluster even after setting all the configurations up in the portal instances. Changes have not been replicated from one node to another. Environment Liferay 6.2 Clustered Liferay DXP 7.0-7.2 Clustered Liferay DXP 7.3 Clustered...

Metadata for Journal Articles Not Indexing Appropriately during Upgrade Process

legacy Troubleshooting

Issue During the upgrade process, UpgradeImageTypeContent#copyJournalArticleImagesToJournalRepository copies all journal article images into the Document Library repository. In order to achieve this, DLFileEntry API is called, which creates a DLFileEntry record and also creates...

6.2 to 7.1 Oracle 12 Database Upgrade Results in Web Content with Custom Structures and Templates to have Missing Content

legacy Troubleshooting

Issue Upgrading from 6.2 to 7.1 with Oracle 12 can result in structureId and templateId reverting to the Basic Web Content structure and template which can be observed in the JournalArticle Table. Another symptom will be that after the upgrade, there will be no content in the Content...

Setting Site Member Role Permissions

legacy How To

Issue How can I change/edit permissions for a Site Member Role? Environment Liferay 7.0 Liferay 7.1 Resolution Permissions for the Site Member Role can be found at: Control Panel > Users > Roles > Site Roles Tab > Site Roles > Site Member > Ellipses > Define Permissions Additional...

Slow Performance or OutOfMemory errors due to StripFilter

legacy Troubleshooting

Issue The StripFilter in Liferay DXP removes blank lines from Javascript, CSS, and other files. While this can result in slightly faster load times for dial-up users, it can also result in a big performance hit for Liferay depending on the amount and type of content being cached...

Users Not Appearing in Control Panel After Upgrading Liferay Version

legacy Troubleshooting

Issue Users are not appearing in the Control Panel > Users > Users and Organizations section after upgrading to a newer Liferay version. Environment Liferay DXP 7.0, 7.1 Resolution 1. Remove com.liferay.portal.search.configuration.IndexStatusManagerConfiguration.cfg from osgi/configs...

Migrating to Liferay DXP: Best Practices, High Level Approach, and Strategy

legacy How To

This paper is to help organizations assess their own resources at-hand and come up with a plan for their migration project. It contains a questionnaire to guide customers in developing their migration plans, such as migrating environments, content, and themes. The paper is available for...

Duplicate Logging in Upgrade to DXP 7.1

legacy Troubleshooting

Issue Upgrade to DXP 7.1 shows duplicate logging during the VerifyProcess steps. For example: 2019-02-26 00:13:25.995 INFO [main][VerifyProcess:65] Verifying com.liferay.portal.scheduler.internal.verify.SchedulerHelperPropertiesVerifyProcess INFO - Verifying...

"Incorrect string value: '\xC2\x80\xC2\x99s ...' for column 'description' at row 1"?

legacy Troubleshooting

Issue During the upgrade process, you may encounter an error like the following: Incorrect string value: '\xC2\x80\xC2\x99s ...' for column 'description' at row 1 Environment Liferay DXP 7.0+ Resolution The database connected to the Liferay DXP bundle must be configured to UTF-8. It may...

Benchmark Study of Liferay Digital Enterprise 7.0

legacy

This whitepaper is a benchmark study of Liferay Digital Enterprise 7.0 and describes optimal configuration, settings, and the methodology used for this study. The whitepaper also contains the results based on the scenarios used. The paper is available for download here., content:...

Upgrading from Liferay DXP 7.0 to 7.1

legacy How To

This paper is a high-level overview of the effort involved in moving from Liferay DXP 7.0 to 7.1. It contains an upgrade checklist, the upgrade steps, and what to do after a successful upgrade. The paper is available for download here., content:...

How to Upgrade to Liferay DXP from Liferay 6.X

legacy

This whitepaper aims to set a framework for Liferay’s recommended upgrade path for your organization. A major technology upgrade is an endeavor requiring a deep analysis of your business requirements, careful planning, testing and execution in order to be successful. The paper is...

Liferay DXP 7.1 Upgrade Performance Benchmark

legacy

The Liferay Support and Liferay Engineering tuned Liferay 6.2 EE databases for upgrade and tested upgrading them to Liferay DXP 7.1. Databases from several vendors were tested. This whitepaper describes the test scenarios, tuning for database upgrade and upgrade performance results. The...

Removing Product Information Displayed in the HTTP Headers

legacy How To

Issue Customers might want to remove the product information found in the HTTP Headers and in the console logs for security reasons. The information displays: Liferay-Portal: Liferay Digital Experience Platform 7.0.10 GA1 (Wilberforce / Build 7010 / June 15, 2016) Environment Liferay DXP...

I would like to upgrade my portlets to Liferay DXP but can not find where XML Descriptors have been moved to

legacy

Issue Upgrading from Liferay 6.2 to Liferay 7.0+ is a significant process. One of the changes implemented is the use of OSGi components. Several XML Descriptors have been converted to OSGi services. Environment Liferay DXP 7.0 and higher Resolution Our Liferay DXP 7.1 Portlet Descriptor...

Updating to Liferay DXP 7.2 SP1 / Fix Pack 2 (or Above) from Liferay DXP 7.2 GA1 or Fix Pack 1

legacy How To

Issue When migrating from 7.2 GA1 or Fix Pack 1 to Liferay DXP 7.2 Fix Pack 2 (ie: SP1) or above, you will be required to run the upgrade tool after installing the patch. The reason for this is, SP1 and FP2 have modifications to data within the database that must be completed before...

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

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

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

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

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

User's group membership not updating with LDAP after upgrading to Liferay Portal 6.0 EE SP2

legacy Troubleshooting

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. Beginning in Liferay 6.0 EE SP2, the "addedbyLDAPImport" column was added to the usergroup table. The purpose of...

High Priority Issue Checklist

legacy Troubleshooting

This article provides a brief checklist of items to run through when your server is frozen, or goes down entirely. Collecting this information before opening a support ticket is a significant step towards helping us to provide you with a quick resolution. Resolution To help our Support...

Error when going to Portal Settings After Upgrading to Liferay Portal 6.1

legacy Troubleshooting

After an upgrade to Portal 6.1 EE GA1 when clicking on Control Panel > Portal settings, an error pops up: 11:53:46,699 ERROR [BeanPropertiesImpl:480] jodd.bean.BeanException: Simple property not found: hostname Invalid property: 'AccountImpl#hostname' (actual:'AccountImpl#hostname',...

Issues Encountered with Upgrades to Liferay Portal EE Versions

legacy Troubleshooting

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. The following comprises a list of issues that administrators have experienced in running an upgrade, along with...

[Upgrade] Handling Quartz Data during Liferay Portal Upgrades

legacy How To

Quartz data is a unique type of data. If quartz data is part of the database upgrade, then there are some potential additional steps to take during the upgrade process. Resolution If there are not any publishing jobs, simply dump the data in the old scheduler and the upgrade process will...

Backslashes in Screen Name Are No Longer Valid After Upgrading to Liferay Portal 6.2

legacy

After upgrading from Liferay Portal version 5.2 EE SP4 to 6.2 EE, backslashes in the screen name are not allowed when using the liberal screen name validator. In Portal 5.2, backslashes were allowed in the screen name. Resolution The ability to add backslashes in the screen name was...

Liferay Upgrades: Updating Custom Plugins

legacy How To

The following article describes how to update plugins to be compatible with a new version of the Liferay platform. Resolution The Liferay API may change from release to release, causing issues when trying to port code to a new version of Liferay. Please follow these steps in order to...

Internal Server Error after Upgrade

legacy Troubleshooting

A common error is that sometimes when certain pages display an internal server error and there is no stacktrace. If there was a custom theme before the upgrade the page layouts will still reference them and if one has not installed or recompiled the layouts in a new sdk it will create a...

Search Results