Site Search - Liferay Learn

Liferay fails to manage unique session and displays the mismatched data of the users

Issue Liferay fails to manage unique sessions and displays the mismatched data of the users when using the below code ThemeDisplay td = (ThemeDisplay) renderRequest.getAttribute(WebKeys.THEME_DISPLAY); User user = td.getUser(); String clientId = user.getScreenName().toUpperCase();...

Service "com.liferay.portal.kernel.messaging.DestinationFactory" is unavailable

legacy Troubleshooting

Issue What does this error mean? When it will occur? 2021-07-21 00: 02: 06.207 ERROR [ServerService Thread Pool - 111] [ServiceProxyFactory: 109] Service "com.liferay.portal.kernel.messaging.DestinationFactory" is unavailable in 60000 milliseconds while setting field "...

Errors when executing upgrade process for com.liferay.exportimport.service

legacy Troubleshooting

Issue The ExportImport Service failed during the upgrade from Liferay 6.2 to DXP 7.2: ERROR - Failed upgrade process for module com.liferay.exportimport.service com.liferay.portal.kernel.upgrade.UpgradeException: com.liferay.portal.kernel.exception.SystemException:...

The jgroupsping entries not getting deleted from table in Kubernetes environment

legacy Troubleshooting

Issue In case of using Kubernetes, you might encounter a problem in your cluster using JDBC_PING, as the entries from the jgroupsping table related to the shutdown pods are not getting deleted. Environment DXP 7.3+ Kubernetes Resolution Set the following property:...

Upgrading from Fix Pack 1 to Fix Pack 2 in Liferay DXP 7.3, a NoSuchGroupException occurs

legacy Troubleshooting

Issue When upgrading from Fix Pack 1 to Fix Pack 2, issues with the control panel options arise, such as being unable to use the page building option and having no portlets visible on the home page. The console errors seen during server startup are listed below. ERROR...

com.microsoft.sqlserver.jdbc.SQLServerException: The driver could not establish a secure connection to SQL Server by using Secure Sockets Layer (SSL) encryption

legacy Troubleshooting

Issue The server is down with the below exception. What does this error mean? ERROR [https-jsse-nio-8443-exec-144] [JDBCExceptionReporter: 234] The driver could not establish a secure connection to SQL Server by using Secure Sockets Layer (SSL) encryption. Error: "Connection reset...

Create custom notification module

legacy Troubleshooting

Issue Unable to get notification over UI even after adding entry in usernotificationevent table through UserNotificationEvent API. Environment Liferay DXP 7.2 Resolution Even after adding entry in usernotificationentry, in order to interpret the notification event and determine whether...

Using JSONFactoryUtil.looseDeserialize method deserilizes to HashMap instead of my class.

legacy Troubleshooting

Issue We have a WAR portlet that uses JSONFactoryUtil.looseDeserialize method. Also, our class is defined as whitelisted. See following: json.deserialization.whitelist.class.names=\ com.liferay.portal.kernel.cal.DayAndPosition,\ com.liferay.portal.kernel.cal.Duration,\...

Getting com.mysql.cj.jdbc.exceptions.CommunicationsException on server startup

legacy Troubleshooting

Issue User gets below error on server startup/restart: ERROR [main][DialectDetector:147] com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure__The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from...

NullPointerException in service builder methods after upgrade to DXP 7.3

legacy Troubleshooting

Issue After upgrading the portal to DXP 7.3, the following stack trace in some custom modules is reported: Caused by: java.lang.NullPointerException at com.liferay.portal.cache.internal.dao.orm.FinderCacheImpl._getArguments(FinderCacheImpl.java:466) at...

"Your request failed to complete" error is displayed on the user interface but there is no more information about it

legacy Troubleshooting

Issue If there is an unexpected error, sometimes a "Your request failed to complete" error is displayed on the user interface, but no additional information is given. How can I get more information on this error? Environment Any Liferay DXP version Resolution In order to get more...

Multiple Spring MVC Portlets names are not displayed in Add Widget menu when added in the same WAR file

legacy Troubleshooting

Issue When creating custom widgets, if multiple widgets are deployed within the same war file, the individual names of the widgets are not seen in the Add Widget menu within Liferay Instead, each widget shares the same name Environment Liferay DXP 7.3 Resolution This occurs if a widget...

Known Issue [Resolved]: Staging publications in the Global site fail due to duplicate categories after upgrade to 7.3 or 7.4

legacy Troubleshooting

Issue After upgrading our 7.0 bundle (where we had some categories in the Global site used for various assets) to 7.3, the vocabularies look to be duplicated in the post-upgrade environment (one list that cannot be edited/deleted), and new staging publishing events in the Global site are...

Known Issue: "PermissionChecker not initialized" errors are observed and no pages are rendered following upgrade to 7.3

legacy Troubleshooting

Issue After upgrading from 7.0 to 7.3, when we start up our bundle for the first time the site does not render any pages (other than to show "powered by" on the home page) and the following error can be observed in the logs: Caused by: java.lang.RuntimeException:...

How to connect to API Rest using Digest Auth in 7.1

legacy Troubleshooting

Issue It's not possible to accces to an endpoint in 7.1 when using Digest Auth using the same configuration as used in higher versions (for our example we'll use 7.3). For the reproduction steps we'll use: the same endpoint used in How To Invoke A Service, namely...

After upgrading from 7.2 to 7.3, Style Books throws IllegalArgumentException

legacy Troubleshooting

Issue After upgrading from 7.2 to 7.3, Style Books is inaccessible Steps to Reproduce: Launch a clean 7.2 DXP bundle Shut down the bundle once the portal appears in the browser Upgrade to 7.3 and launch the 7.3 bundle Navigate to [Site_Administration] > Design > Style Books Actual...

SQLRecoverableException

legacy Troubleshooting

Issue The server is down with the below exception java.sql.SQLRecoverableException. What will be the possible root cause which triggers this exception? 2021-10-12 10:25:54,807 SEVERE [Common.CommonUtils] (default task-48) null: java.sql.SQLRecoverableException: IO Error: The Network...

7.2 to 7.3 upgrade fails with "Failed upgrade process for module com.liferay.asset.display.page.service"

legacy Troubleshooting

Issue The upgrade fails with an error message that includes the following line: ERROR [main][UpgradeStepRegistratorTracker:144] Failed upgrade process for module com.liferay.asset.display.page.service Environment DXP 7.2 DXP 7.3 Resolution Important: make sure to test the following steps...

Bulk deployment state loop

legacy Troubleshooting

Issue When trying to deploy the modules in bulk, the modules got stuck in a start-stop loop. Environment Liferay DXP 7.2, 7.3 Resolution It's an already known issue LPS-139889 and will be fixed in the upcoming fix pack. Please create a support ticket to request a hotfix. Additional...

How to resolve a Jenkins "Failed to rotate logs" error when executing the Project Build Discarder

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue In our -infra service's CI logging, we are seeing frequent errors such as the following: build-10 [ci-0] WARNING ...

After updating to DXP 7.2 FP dxp-13 the Spring portlets show an Unsatisfied dependency error

legacy Troubleshooting

Issue After updating to DXP 7.2 FP dxp-13 the Spring portlets show an Unsatisfied dependency error. The trace is: ERROR [fileinstall-directory-watcher][ContextLoader:350] Context initialization failed org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean...

Unresolved requirements using a class from util-java in custom development

legacy Troubleshooting

Issue Trying to use a class from /util-java, such as com.liferay.util.Normalizer, in a custom development by adding to build.gradle the dependency compileOnly group: "com.liferay.portal", name: "com.liferay.util.java" will lead to unresolved requirements such as: 2021-08-19 09:56:31.228...

How can I resolve "Unable to get portal cache manager MULTI_VM_PORTAL_CACHE_MANAGER" errors?

legacy Troubleshooting

Issue I am seeing the following error in my clustered environment: com.liferay.portal.kernel.messaging.MessageListenerException: java.lang.IllegalStateException: Unable to get portal cache manager MULTI_VM_PORTAL_CACHE_MANAGER Environment DXP 7.2 DXP 7.3 Resolution LPS-123495 prevents...

Are directories "document_preview" and "document_thumbnail" strictly necessary to upgrade to DXP?

legacy Troubleshooting

Issue During the upgrade, there are usually many thumbnails and previews, which could significantly increase the duration of the upgrade. Environment Liferay DXP 7.0, 7.1, 7.2, 7.3 Resolution It's not necessary to copy these directories to new installation. In order to avoid high CPU...

Fetch forms through API in Liferay DXP 7.1 and above

legacy Troubleshooting

Issue I would like to fetch forms with the DDLRecordSetLocalServiceUtil.getRecordSets(groupId) API call, but it only returns DDL records and not any forms. Environment DXP 7.1 - DXP 7.3 Resolution Since DXP 7.1, forms have been separated into other tables from the DDLRecordSet table,...

Session timeout problems in Azure related environments

legacy Troubleshooting

Issue OIDC and SAML2 connections with Azure-related services can experience session timeout related problems where the session expires before its intended lifetime. Environment Liferay DXP 7.2 Liferay DXP 7.3 Resolution To resolve issues like this there are a few things that need to be...

How do I disable the Trial license within a Liferay DXP image?

legacy Troubleshooting

Issue My Liferay Docker Image is giving a warning message that the Activation Key needs to be updated: ERROR [fileinstall-directory-watcher][LicenseManager:?] DXP Development license is expired We have noticed that the Liferay DXP Trial key is still being processed despite us deploying...

Liferay 6.2 upgrade stops at UpgradeDynamicDataMapping#upgradeXMLStorageAdapter step

legacy Troubleshooting

Issue The Liferay upgrade process hangs at one specific part for a longer period of time (several hours) com.liferay.dynamic.data.mapping.internal.upgrade.v1_0_0.UpgradeDynamicDataMapping#upgradeXMLStorageAdapter Environment Portal 6.2 while upgrading to DXP 7.0 and above Resolution...

SSL protocol errors are observed in the browser while attempting to access Liferay at http://localhost:8080

legacy Troubleshooting

Issue This document will discuss some cases where SSL protocol errors are observed in the browser after opening the default address to the Liferay DXP instance (i.e., http://localhost:8080). This is especially true when SSL is not enabled on the application server). The browser will...

Ext module is not deployed with the cloud deployment process

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue The modules_ext style projects in workspace will correctly deploy to /build/dist/osgi/marketplace/override. However, for dockerDeploy...

Layout module upgrade fails with NoSuchGroupException when moving up to dxp-14 fix pack

legacy Troubleshooting

Issue After installing dxp-14 fix pack, start up fails due to the layout module upgrade failure. ERROR [main][UpgradeStepRegistratorTracker:184] Failed upgrade process for module com.liferay.layout.impl com.liferay.portal.kernel.upgrade.UpgradeException:...

Empty string is considered as null in the parameter map

legacy Troubleshooting

Issue Is there any specific reason why the empty String in the parameter map is considered Null? Steps to Reproduce: Deploy the com.mycompany.my.icefaces.portlet. The portlet has a example <ace:datatable> with filters. Add the com.mycompany.my.icefaces.portlet to a Liferay page. Type...

Special Characters are Escaped in Salesforce Chat

legacy Troubleshooting

Issue Special characters are escaped when using the Salesforce Snap-In Chat in Liferay. Environment Liferay DXP Resolution Since Salesforce Snap-In Chat is a third-party add on, and no core Liferay issue has been identified which leads to this issue, there is currently no official...

Accessing a Service Builder module from a Spring MVC portlet in Liferay DXP

legacy Troubleshooting

Issue When a Spring MVC portlet is trying to call a Service Builder service, there are java.lang.ClassCastExceptions in the logs. For example: ERROR [http-nio-8080-exec-5][DispatcherPortlet:428] Could not complete request java.lang.ClassCastException: com.sun.proxy.$Proxy1205 cannot be...

Known Issue: Adjusting Calendar Notification Template fields to be greater than 75 characters results in “Portlet is temporarily unavailable" and JDBCExceptionReporter errors

legacy Troubleshooting

Issue When attempting to edit the fields for a calendar email notification template (such as the "From Name" and "From Address" in the "Invite Email" template), if the combined values of the two fields are too long (>75 characters, including the database metadata), when attempting to...

"Service "com.liferay.portal.kernel.cache.MultiVMPool" is unavailable" errors in the logs during startup

legacy Troubleshooting

Issue The following error can be seen in the logs multiple times during server startup ERROR [Start Level: Equinox Container: 30e307ea-2db2-001b-1b24-8fe7a9e210b3][ServiceProxyFactory:265] Service "com.liferay.portal.kernel.cache.MultiVMPool" is unavailable in 60000 milliseconds while...

Startup errors after installing DXP 7.3 Fix Pack 2

legacy Troubleshooting

Issue After installing Fix pack 2, errors like the following are shown in the server boot log: 2021-07-02 08:21:57.763 ERROR [com.liferay.portal.spring.extender.internal.LiferayServiceExtender-BundleTrackerOpener][BasicLazyInitializer:165] Javassist Enhancement failed:...

A servlet matching the filter (servlet.init.private=false)(servlet.type=friendly-url) is unavailable

legacy Troubleshooting

Issue The following WARN message is obtained during the portal startup: 2020-02-07 09:02:43.401 WARN [http-nio-9090-exec-7][PortalImpl:6752] javax.servlet.ServletException: A servlet matching the filter (servlet.init.private=false)(servlet.type=friendly-url) is unavailable...

Schedulers are not initialized as intended in a clustered environment

legacy Troubleshooting

Issue In a clustered environment if we restart the nodes at the same time for a deployment, schedulers and information can be lost. Environment Liferay DXP 7.3 Resolution The issue described above is caused by not starting clustered nodes sequentially which is considered to be a bad...

NoClassDefFoundError when starting the nodes simultaneously

legacy Troubleshooting

Issue The following error is thrown when the nodes of the cluster are started simultaneously: 2021-08-04 18:43:34,772 ERROR [Framework Event Dispatcher: Equinox Container: 94ea1e3b-3db5-4b49-9cf5-398239563c13][osgi.logging.org_eclipse_osgi:97] FrameworkEvent ERROR...

Requires 3.0 opt-in when customizing Control Panel

legacy Troubleshooting

Issue When deploying a module that customizes Control Panel, the changes don't take effect and I get: java.lang.UnsupportedOperationException: Requires 3.0 opt-in. Environment Liferay DXP 7.2 Resolution The solution is to rebuild the module with the latest Liferay IDE version as well as...

Error during Liferay startup after updating a config or cfg configuration file in the osgi/configs folder

legacy Troubleshooting

Issue After editing a config or configuration file in the osgi/configs folder, there are unexpected errors during the startup process, that can prevent Liferay from starting correctly The errors detected in 7.2 Fixpack 11 and 12 are: After editing the Elasticsearch configuration...

Exported Page Template SAVES Custom Fragment Configurations / Imported Page Template IGNORES Custom Fragment Configurations

legacy Troubleshooting

Issue Steps to Reproduce: Create a custom fragment with any type of configuration. (I've tested with "dataType": "int" and "type": "text"). Alternatively you can import the attached zip that includes a custom fragment. Create a page template and add the custom fragment to the page....

Performance of the JSLoaderModulesServlet

legacy Troubleshooting

Issue Steps to Reproduce: Start a server With a navigator, open the dev-tools and look at the network tab, and load the home. Refresh the home. Actual Results: js_loader_modules file is never cached. Size: X KB Expected Results: Second requirement to js_loader_modules should be served as...

How to fix "Store is not available" exception when using Amazon S3 for Liferay DXP 7.2 Fix Pack 13?

legacy Troubleshooting

Issue When setting up or upgrading to Liferay DXP 7.2 Fix Pack 13, files in Documents and Media are not available and/or new files cannot be added and the below error occurs in the log: WARN [http-nio-8080-exec-31][PortalImpl:6884] java.lang.IllegalStateException: Store is not available...

Changes made to LDAP connection settings do not go into effect

legacy Troubleshooting

Issue Despite making changes to LDAP connection settings through Control Panel > Instance Settings > LDAP > Connection, those changes don't go into effect, and the default settings are used when connecting to the LDAP server. For example, despite setting...

Failed upgrade process com.liferay.asset.display.page.internal.upgrade.v2_3_2.UpgradeAssetDisplayPageEntry

legacy Troubleshooting

Issue The following error is thrown while upgrading a DXP 7.3 instance: 2021-08-09 11:25:50.668 INFO [main][UpgradeProcess:115] Failed upgrade process com.liferay.asset.display.page.internal.upgrade.v2_3_2.UpgradeAssetDisplayPageEntry in 49 ms...

Obsolete CBC Ciphers (AES, ARIA, etc)

legacy Troubleshooting

Issue "Obsolete CBC Ciphers" warning message can appear during a security revision or in certain browsers. Environment Liferay DXP. Resolution The message points to a vulnerability related to the available cipher protocols for HTTP transport. This communication is always ciphered by...

${processor.processMax()} error message with a blank page

legacy Troubleshooting

Issue Opening different pages and menus on DXP 7.2 and above could result in an empty page showing the ${processor.processMax()} error message The solution only applies if you use the module.framework.properties.org.osgi.framework.bootdelegation property in your portal-ext.properties,...

FileImpl "Unable to extract text from" and other errors during document indexation related to TIKA library

legacy Troubleshooting

Issue If we execute a reindex of documents (DLFileEntry) we have several warnings and errors in the log file with the message "Unable to extract text from" and related to FileImpl and TikaException: Tried to allocate an array of length 1133957, but 1000000 is the maximum for this record...

Internal Server Error thrown due to orphan portlet

legacy Troubleshooting

Issue Steps to Reproduce 1) Create a theme with an embedded DM portlet (portletId = 20) in Liferay 6.2. 2) Deploy this theme. 3) Visit the page configured with that theme and check that the embedded DM portlet is available. 4) Add a few documents in it. 5) Add Most viewed assets Portlet....

Web Content Search shows all versions

legacy Troubleshooting

Issue Steps to reproduce: Create a web content Edit it a few times Search for it in the Web content search field Current behaviour: Every version of the web content is shown in the results Expected behaviour: Only the web content should be shown in the results Environment Liferay DXP 7.2...

Performance issue: Liferay service getting restarted frequently

legacy Troubleshooting

Issue Liferay service gets restarted frequently [every day or so], and status logs show readiness and liveness probes failing and causing the service to restart. Environment liferay-dxp:7.2-4.0.3 Resolution There can be multiple issues, one of them can be the use of...

Upgrading to 7.3+ fails due to a table not complying with the requirements of an external plugin

legacy Troubleshooting

Issue The upgrade process to Liferay DXP 7.3+ failed with the following Caused by: Caused by: java.sql.SQLException: The table does not comply with the requirements by an external plugin. Environment Liferay DXP 7.3+ Resolution This error will occur when group replication is enable on...

How can a URL be replaced or hidden on every site visit?

legacy Troubleshooting

Issue As a reverse proxy on the web server, whenever a user accesses a URL, the user is sent to the application server's IP address, which is visible on the site URL. Now, how can this URL be replaced by IP or hidden on every visit to the site. Environment Liferay DXP 7.2 Apache Web...

Failed upgrade process for Analytics when upgrading to DXP 7.3

legacy Troubleshooting

Issue When upgrading to DXP 7.3, I'm encountering the following error in the upgrade process: 2021-05-12 04:16:12.918 ERROR [main][UpgradeStepRegistratorTracker:144] Failed upgrade process for module com.liferay.analytics.settings.web com.liferay.portal.kernel.upgrade.UpgradeException:...

Session timeout auto extend fails with Google Chrome

legacy Troubleshooting

Issue The user session expires in about 10-15 minutes inactivity, even if session.timeout.auto.extend is set to true, and session.timeout and session.timeout.auto.extend.offset are all configured. The issue only occurs when using Google Chrome. Environment DXP 7.3 Resolution The issue...

"javax.crypto.BadPaddingException" warning in server console.

legacy Troubleshooting

Issue While startup below warnings can be observed in the server console: ERROR [tomcat-http--1][AutoLoginFilter:259] Current URL / generates exception: com.liferay.portal.kernel.exception.SystemException: com.liferay.petra.encryptor.EncryptorException:...

Table 'OA2Auths_OA2ScopeGrants' already exists

legacy Troubleshooting

Issue The following error occurs while upgrading a database to DXP 7.1 or higher Table 'OA2Auths_OA2ScopeGrants' already exists Environment Upgrading Portal 6.2 or DXP 7.0 -> DXP 7.1 or higher Resolution This error says that the table already exists, but OA2Auths_OA2ScopeGrants table...

Unable to configure instances using portal-{WebID}.properties

legacy Troubleshooting

Issue Steps to Reproduce Add -Dcompany-id-properties=true to the JAVA_OPTS on $LIFERAY_HOME/tomcat/x.y.z-bin/setenv.sh; Add a file $LIFERAY_HOME/portal-test1.properties with the content company.security.auth.type=screenName; Go to Configuration > Virtual Instances; Create a new virtual...

Search Results