Capability

DXP Self-Hosted Installation, Maintenance, and Administration

In addition to SaaS and PaaS deployment approaches for Liferay DXP, you can also opt to self-host Liferay DXP. Self-hosting gives you flexibility to deploy Liferay DXP on-premises or to a cloud computing provider of your choice, giving you complete control over deployment, infrastructure, and maintenance.

Feature
Deployment Approach
How to override Liferay logs configuration
Issue How to override Liferay logs default configuration. Environment Liferay DXP 7.4 Resolution Liferay logs default configuration is defined in WEB-INF/shielded-container-lib/portal-impl.jar inside the file...
OutOfMemoryError on startup when there are a lot of very large FragmentEntryLinks
Issue Liferay takes a very long time to startup, and throws the following Heap Space error: ERROR [Framework Event Dispatcher: Equinox Container: d97119a4-f960-4e1c-839b-88c78fbc6cc6][Framework:93] FrameworkEvent...
"Portlet must not be null" error during upgrade
Issue You might encounter an issue where you face an error during upgrade such as follows: 2023-03-29 08:09:14.891 ERROR [Framework Event Dispatcher: Equinox Container:...
The Chat Provider I want to use is not in the list of available Chat Providers
Issue I would like to enable Click To Chat in our Liferay instance. I have checked the documentation: Enabling Automated Live Chat Systems The Chat Provider I want is not in the supported list: Getting The Chat...
I want to be able to publish redirects through Remote Publishing or bulk export/import redirects.
Issue There are a large number of redirects that needs to be setup between environments, and I would like to be able to remote publish or bulk export/import redirects. Environment DXP 7.4 Resolution Currently, redirects...
Deploying a Portlet to Liferay 6.2 on Tomcat 8, causes listerner tags in Web.xml of portlet to change to Context-param tags
Issue Deploying a portlet developed for Liferay 6.2 on Tomcat 7, on a Liferay 6.2 instance running on Tomcat 8 causes the portlet's web.xml file to reflect the following changes:  The web.xml before it is deployed had...
Unable to find products with ID via Headless API
Issue Noticed that products have two ID fields, when you fetch them via headless API id productId id is visible on the UI and productId is not. When you try to get products via headless API using id, it does...
I want to disable Basic Auth for JSONWS
Issue I want to disable Basic Auth for JSONWS (JSON web services) in Liferay so that only OAuth is used for a specific jsonws method (i.e. expandovalue) Environment DXP 7.4 Resolution Basic Auth can be entirely disabled,...
Firewall blocks URI for reserved characters
Issue URI contains reserved characters such as "$" and certain firewall rules block these URI's. Environment DXP 7.4 Resolution Many URL schemes reserve certain characters for a special meaning. However, this is not...
Cache is not replicating properly across the nodes in the cluster environment
Issue From one of the nodes, when uploading a document or creating web content, it's available under the content section in the other node. But when creating a page, adding the uploaded docs and existing web content...
After soy modification, the components under Control Panel are not visible
Issue Post portal upgrades from DXP 7.0 to Liferay 7.2, under the control panel, pages like the site, user organization, etc are not visible and getting UI error as "XXXX is temporarily unavailable" Environment...
How can I disable the Document Library File Rank Service in DXP 7.1 and 7.2?
Issue I would like to disable the Document Library File Rank Service In Liferay Portal 6.2 and DXP 7.0, there used to be a property which is now removed: dl.file.rank.enabled=false Environment Liferay DXP 7.1 Liferay...
Not able to download the logs of more than 10000 lines
Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue How to download more logs as the default "Download...
Unable to configure the portal-{WebID}.properties for each instances
Issue In Liferay, we have a feature of configuring different portal-{WebID}.properties (portal-ext.properties) for each instances. This configuration is not working in DXP 7.2 with fixpack dxp-2 and above....
Upgrade the CKeditor version
Issue Is there any option to update the Liferay's default CKeditor version? Environment Liferay DXP 7.0    Resolution For example, the default CKeditor version for the fix pack 90 is "4.11.3", and the version for the...
I cannot reinstall Marketplace applications in the App Manager
Issue I have issues with a Marketplace app, so I try to reinstall it I uninstall the App through the UI (from Control Panel > Apps > App Manager) I purchase the App again from the Marketplace (Apps > Store) Once it...
On 6.2 fix packs before portal-167-6210, Liferay shows a blank home page on MS IE11 and MS Edge
Issue When working in a Portal 6.2 EE environment with JBoss EAP 7.0, a web server and a patching level lower than portal-167-6210, the Liferay home page, when displayed on MS IE11 and MS Edge, will be blank ...
Fragment is not resolved after a clean server restart
Issue If I deploy a fragment, it works fine for the first time. But when I stop the server, delete osgi/state folder, and restart it, the fragment fails to resolve. It needs to be restarted in gogo shell to go to...
How can I change the email template of the Password Changed Notification?
Issue When the password is changed, users get a notification email. I would like to change the template of that email. Environment Liferay DXP 7.0+ Resolution Navigate to Control Panel > Configuration > Instance...
Deploying Liferay 6.2 SP 15 on Jboss EAP 6.2
Issue This article will outline a basic walkthrough on how-to deploy Liferay 6.2 SP 15 on Jboss EAP 6.2 specific to EAP version.          Environment Liferay 6.2 JBoss EAP 6.2  Resolution Prerequisite Download...
Mails are not getting triggered when configured with smtp.office365.com
Issue The email notifications are not sent successfully when configured with smtp.office365.com. The below errors are observed while mail is being sent. 1) 530 5.7.57 SMTP; Client was not authenticated to...
Groovy script to clear the stale data in the lock_ and backgroundtask tables
Issue Groovy script to clear the stale data in the lock_ and backgroundtask tables Environment Liferay DXP 7.2+ Resolution In the log, similar to the below info may be thrown which shows that there may be some stale...
I cannot configure the "Look and Feel" of widgets on the Content Page
Issue A new Content Page is created and a widget is added to it. There is no kebab menu on it (3 dots) and there is no Look and Feel Configuration button either. Environment Liferay DXP 7.2 Resolution The menu is no...
The document preview is not generated due to "[SocketOpenOfficeConnection:114] trying to (re)connect" warn message.
Issue The preview is not generated for the documents in the Document and Media portlet. The following warn messages are thrown in the logs, INFO...
Missing translations are shown in English (US) rather than in the default language
Issue A Liferay instance is configured to work with a default language A and other languages B, C, etc. None of the configured languages (A, B, C, ...) are English (US). A non-default language (B, C, ...) lacks...
Read the data of portal-ext.properties from custom portlet
Issue How to read the configured properties in the portal-ext.properties file from the custom module or custom portlet? Environment Liferay DXP 7.1 Resolution Please Note: The following procedures involve...
Upgrade the Log4j version in the existing Liferay DXP instance
Issue Is there any option to configure or upgrade the Log4j version in the existing Liferay DXP instance? Environment Liferay DXP 7.0 Resolution By default, Liferay DXP 7.0 is pre-bundled with the log4j 1.2.17...
Configuring multiple virtual hosts so that both www and non-www can be used
Issue To configure multiple virtual hosts on one site(for example, both www.aaa.com and aaa.com). The Virtual Host can not be configured by using both of the different hosts. Environment Liferay DXP 7.2 Resolution...
Can not start Liferay after upgrading to jdk 11 with "java.lang.ClassNotFoundException: jdk.internal.reflect.MethodAccessorImpl cannot be found" reported
Issue After upgrading to JDK 11, the server can not be started due to the following error: 2020-03-16 16:47:50.470 ERROR [Start Level: Equinox Container:...
Browser's console prints: “Error: Namespace "ClayTooltip.incrementaldom" already declared”
Issue While navigating through DXP pages, the browser's console will occasionally print the below error: Error: Namespace "ClayTooltip.incrementaldom" already declared So far the issue was observed in the...
java.sql.SQLException: Error on rename of mysql.frm due to permission denied
Issue After deploying the jar, it gets deployed and started successfully with the following error on Liferay logs. Also, the table gets created but there is no entry in Release_ and ServiceComponent table....
How to resolve failed deployments when quota limit errors indicate exceeded maximum builds
Issue Deployments are currently timing out for some of our services, causing the deployments of those builds to fail. When looking at the console for the CI, I see the following error:...
The work folder is no longer appearing since DXP 7.2 SP1
Issue After updating to SP1 (fix pack dxp-2) on DXP 7.2 the $[Liferay-home]/work folder is no longer there or no longer generates new content Environment DXP 7.2 SP1 or above. Resolution The $[Liferay-home]/work...
On RHEL7.7, the authentication code (captcha) on the password reissue screen may not be displayed
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. Issue...
Why the "Error executing FreeMarker template" is thrown in the logs?
Issue What is the reason behind the following error which is thrown in the logs? [runtime:60] Error executing FreeMarker template FreeMarker template error: The following has evaluated to null or missing: ==>...
Xerces Errors with Customizations
Issue After deploying a customization on Liferay 6.2 there are xerces related error on server restart Apache xerces error in the logs after module deployment Environment Liferay 6.2 and JBoss EAP 7.0 Resolution...
How is the number of cores reported to Liferay DXP?
Issue Liferay DXP is not reporting the correct number of cores.  For example: A machine has 4 physical cores in the CPU. However Liferay DXP is reporting 8 cores on the <domain>/c/portal/license page....
"Primordial" ReferenceError is thrown when upgrading or importing the theme
Issue Error as "ReferenceError: primordials is not defined" is thrown either while upgrading a theme or when importing a theme home/xxxx/yyyyy/theme$ yo liferay-theme:import 00h00m00s 0/0: : fs.js:27 const { Math,...
What configuration needs to be done to bypass the proxy in Liferay?
Issue What are the proxy configurations to be done at Liferay to bypass the proxy available in the network? Environment Liferay Portal 6.2 Liferay DXP 7.0, 7.1, 7.2, 7.3, 7.4 Resolution The configurations...
Why the error "Unable to get ranges java.io.IOException: Range start XXXX is greater than end YYYY" is thrown in the logs?
Issue What is the reason behind the following error which is thrown in the logs? ERROR [default task-4064][ServletResponseUtil:227] Unable to get ranges java.io.IOException: Range start 2851129 is greater...