Capability

Integration

Liferay is designed to be standards-compliant and highly interoperable. Connect Liferay DXP with external systems using SOAP, REST, GraphQL, and more to unite third-party software, legacy systems, and data.

Headless APIs, Remote Apps (Client Extensions), API Builder, and integrations with SSO platforms are some of the examples of the features in this area.

Feature
Deployment Approach
Accessing a Service Builder module from a Spring MVC portlet in Liferay DXP
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...
Known Issue: Adjusting Calendar Notification Template fields to be greater than 75 characters results in “Portlet is temporarily unavailable" and JDBCExceptionReporter errors
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...
"Service "com.liferay.portal.kernel.cache.MultiVMPool" is unavailable" errors in the logs during startup
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...
Adding custom preferences to Spring MVC Portlet
Issue We've create a new Spring MVC Portlet and we'd like to configure it with some custom portlet preference. How can we do it? Environment Liferay DXP Resolution Once you've created your Spring MVC Portlet you...
Empty string is considered as null in the parameter map
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...
Special Characters are Escaped in Salesforce Chat
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...
How to enable Hibernate query parameters logging
Issue Sometimes it can be useful to check which query is executed against the database as well as its parameters. Resolution To show the information in the logs the following has to be done: From Control Panel...
Error during Liferay startup after updating a config or cfg configuration file in the osgi/configs folder
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...
When adding long values to a JSON object using the Liferay API a String with double quotes is being returned
Issue When generating a new JSON object using the Liferay API (JSONObjectImpl.java) and a new long value is added to it the returned value is a String with double quotes. In this case the user is calling...
A servlet matching the filter (servlet.init.private=false)(servlet.type=friendly-url) is unavailable
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...
Exported Page Template SAVES Custom Fragment Configurations / Imported Page Template IGNORES Custom Fragment Configurations
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....
Requires 3.0 opt-in when customizing Control Panel
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...
Schedulers are not initialized as intended in a clustered environment
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...
NoClassDefFoundError when starting the nodes simultaneously
Issue The following error is thrown when the nodes of the cluster are started simultaneously:...
Configure default database if the one defined in jndi is not available
Issue When the database is configured through the portal property: jdbc.default.jndi.name (and its properties defined in ROOT.xml) and it is, for some reason, not available when the portal starts, the...
How to fix "Store is not available" exception when using Amazon S3 for Liferay DXP 7.2 Fix Pack 13?
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...
Changes made to LDAP connection settings do not go into effect
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...
Performance of the JSLoaderModulesServlet
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...
How to disable simultaneous login from multiple sessions
Issue How to disable users to simultaneously login to Liferay DXP using multiple different sessions. Environment Liferay DXP 7.0 Liferay DXP 7.1 Liferay DXP 7.2 Liferay DXP 7.3  Resolution Please add the following...
User is required to change their password when they first log in
Issue  User is required to change their password when they first log in Environment DXP 7.2+ Resolution Add the below properties in portal-ext. properties files: users.reminder.queries.custom.question.enabled=false...
How to generate multiple Java Thread Dumps in Linux and Windows
Issue In case of a throughput issue, the Liferay support service usually asks to take some java thread dumps from the Liferay server, in an interval of 1-2 seconds. Taking several thread dumps, allows you to detect if a...
${processor.processMax()} error message with a blank page
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...
Failed upgrade process com.liferay.asset.display.page.internal.upgrade.v2_3_2.UpgradeAssetDisplayPageEntry
Issue The following error is thrown while upgrading a DXP 7.3 instance:...
Obsolete CBC Ciphers (AES, ARIA, etc)
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...
FileImpl "Unable to extract text from" and other errors during document indexation related to TIKA library
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...
Internal Server Error thrown due to orphan portlet
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...
Logs rotation based on size
Issue How to implement the log rotation for Liferay logs based on the size Environment Liferay Portal 6.2 Liferay DXP 7.0 Resolution The logs can be rotated based on the size and it can be achieved through...
Upgrading to 7.3+ fails due to a table not complying with the requirements of an external plugin
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...
Response Status Code Inconsistency for Deactivated Site
Issue My site is deactivated. Different status code responses are returned within the site when accessing: 1.) Pages (404) 2.) Documents (302) http responses are inconsistent for a deactivated site. Environment DXP...
Performance issue: Liferay service getting restarted frequently
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...
Web Content Search shows all versions
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...
How to execute verify.frequency in Liferay DXP 7.3
Issue The property verify.frequency was deprecated in Liferay DXP 7.3. Environment Liferay DXP 7.3. Resolution To check for available verify processes, go to Control Panel > System > Gogo shell and enter the...
"javax.crypto.BadPaddingException" warning in server console.
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:...
How can a URL be replaced or hidden on every site visit?
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...
Session timeout auto extend fails with Google Chrome
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...
Table 'OA2Auths_OA2ScopeGrants' already exists
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...
Failed upgrade process for Analytics when upgrading to DXP 7.3
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...
Although I access DXP using https, CDN urls use http
Issue If there is a load balancer in front of the DXP nodes responsible of the SSL offloading and the use of a CDN has been configured, when DXP is accessed using the https protocol, the content is downloaded from...
Why does my Liferay instance rejoin a cluster that it was previously a part of?
Issue My Liferay instance was once a part of a cluster. Now I've separated it from the cluster, but the cluster keeps detecting the instance and re-adding it. I use TCPPING for both of my environments, but I've...
In a thread dump there are many blocked threads inside InitFilter class
Issue When I analyze a thread dump there are multiple threads in BLOCKED status with stacktraces such as this: "http-nio-8080-exec-129" Id=325 BLOCKED on...