Capability

Development and Tooling

Liferay offers a comprehensive toolkit to extend or customize your digital experience. Build applications quickly with low-code/no-code features like Objects, or leverage developer tools like Liferay Workspace and Blade CLI for further customizations.

For users on PaaS or running Self-Hosted, Liferay also offers tools deploying customizations.

Feature
Deployment Approach
Starting Servers in the Correct Sequence
Issue What is the correct sequence to start up all servers during a restart? Environment DXP 7.0, 7.1 Resolution Sometimes it is necessary to restart some if not all of the servers that Liferay DXP runs on or is...
What HTTP METHODS/VERBS does Liferay DXP use?
Issue Which HTTP Methods does Liferay DXP use? We would like to restrict HTTP traffic using a firewall and do not want to impact Liferay DXP functionalities. Environment Liferay DXP 7.0+ Resolution Liferay DXP...
Installing Fix Packs and Hotfixes on Liferay DXP
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...
DXP 7.3 Upgrade Reference Guide
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...
Virtual Host Login/Logout Properties
This article documents four portal properties that are often used to configure redirection URLs for users. The four descriptions below include the properties, their descriptions, and examples for: Configuring the...
Installing Archived Modules From Liferay's Public Repository
This article is a how-to guide for locating, downloading and installing modules from Liferay’s public repository. Installing modules directly from Liferay’s public repository should be done if the module or application...
Testing if Cluster Link is Working
Issue How can I test if the cluster link is connected and working? Environment DXP 7.x Portal 6.x Resolution There are two ways that this can be accomplished: 1. Manually test that the cache replication is working...
If a Staging publication is on progress and the server is shut down, publication stays on queue and no further publications are possible
Issue If a publication on staging is made and the server is shut down, the publication will stay on queue on start-up and, even if cancelled, no more staging publications can be made. The following java class stays...
JDK Certification, Java TCK Compliance, and Liferay
With the release of JDK11, Oracle's new Java SE Support Policy (also see here) brings changes to the Java Enterprise community. The following article outlines Liferay's approach concerning the certification of JDK...
JDK7 Concerns
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.  JDK7 is...
How to Install and Set up a Local Liferay DXP Instance on Windows or Mac (Video)
Learn how to install and set up a local Liferay DXP instance for the first time. Windows Mac Additional Information Official Documentation: Installing Liferay Liferay Learning Youtube...
Setting up Session Replication in Tomcat With Liferay DXP
The purpose of this article is to provide an example of how to set up a basic Tomcat cluster that has session replication, using built-in Tomcat features. Please note: This example is provided as a courtesy. This...
Taking Heap 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....
Deploying Activation Keys
This document has been updated and ported to Liferay Learn and is no longer maintained here. This article documents the basic instructions for how to deploy your Activation Key via the...
Using a Web Server With the Liferay Platform
This article documents which properties should be configured if a web server sits in front of Liferay. If you do not set the following properties, you may encounter one of these issues. There could be UI issues such as...
DXP 7.0 Database Portal Properties
This article is intended to provide a list of all the Liferay DXP 7.0 Database properties that can be used to connect your DXP 7.0 installation to various databases. To use any of them, uncomment the...
Liferay Web Proxy Module for Digital Experience Platform 7.1
The Web Proxy Portlet allows web applications to be embedded within a portlet while keeping the user interaction within the portal context. The portlet is deprecated and was removed from Digital Experience Platform...
SQL Scripts Causing Duplicate Keys
 While using a new instance of the Liferay Portal, some environments may encounter the following error: ORA-01452: cannot CREATE UNIQUE INDEX; duplicate keys found Resolution This...
Managing Distributed Cache in Liferay DXP
This document has been updated and ported to Liferay Learn and is no longer maintained here. This article documents the configuration options for managing distributed cache within Liferay Digital Experience...
Rolling Restart - Breaking Changes
Introduction When applying fix packs or hotfixes, rolling restarts are possible if there are no changes to a specific set of clustering classes or no module schema version changes. The following document is a list of...
Managing LDAP Settings Using .config Files
This document has been updated and ported to Liferay Learn and is no longer maintained here. This article documents how to configure LDAP settings using .config files instead of the Control Panel. There are a great...
Before Opening a Liferay Performance Ticket
The following article outlines a short checklist of questions to ask and steps to take before opening a performance ticket. By taking a moment to go through this checklist before...
LDAP settings and upgrading from 5.2.x to 6.x
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...
Changes in Liferay DXP Clustering
This article documents several changes with the clustering feature that will take effect in Liferay Portal CE 7.0 and Digital Experience Platform 7.0. In addition, this article details changes that may affect...
Permissions Are Not Working Post-Upgrade
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...
Application Server Times Out While Downloading/Uploading Documents
When uploading documents larger than 3Mb via web call, an error may be thrown: 13:45:27,141 INFO [PortalImpl:4366] Current URL /documents/10162/179749/Certification+Tracking+Database+CSC+v2.0+Production.zip...
Managing Distributed Cache in Liferay Portal EE
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...
Installing Liferay Portal in a Clustered Environment
Many enterprise environments utilize clustering for both scalability and availability. This article provides specific instructions for installing a basic configuration of Liferay Portal in a pre-existing clustered...
Resolving 'BadPaddingExceptions' in the Console Logs
This article addresses a situation where customers might encounter a BadPaddingException in the logs. This occurs if customers have two instances on the same domain; when a user tries to access another instance on the...
Including portal-ext.properties in Help Center Tickets
One of the most important pieces of information when resolving a customer issue is the portal-ext.properties file for your environment. It is now possible to upload the portal-ext.properties file before opening a...
PropsUtil causing NullPointerException at startup
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. 
 When starting up the application server,...
Performance Issue for Thread Counts While Processing JSP files
This article is designed to help administrators tune performance in Liferay DXP 7.0 when the active thread count approaches the maximum allowed thread count. The reason for this performance issue is because the values...
Carousel Portlet Prevents Ehcache Plugin From Loading With a 'ClassNotFoundException'
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. This...
Transactional Cache or Blocking Portal Cache Causes the Portal to Hang
This article serves as a troubleshooting guide. During a thread dump, your server may hang indefinitely due to the blocking portal cache. Blocking portal cache is one of the caches...
Load Balancing Can Return Null
When running Liferay with more than one node on a load balancer, sometimes, when generating urls for buttons, they can receive a incorrect url or sometimes a null value. Resolution...
Quick Start Guide to SAML on Liferay Portal 6.1 EE GA3
  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.  If you are working with a Liferay Portal...
Setting Up Liferay WAR on Tomcat 7
This article describes how to set up Liferay Portal 6.1 EE or Liferay Portal 6.2 EE using Windows and MySQL 5.x on Apache Tomcat 7.x. Resolution 1. Gather the Necessary Files Download...
High Priority Issue Checklist
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...
Common Upgrade Errors for Liferay DXP
This article documents the common configuration errors you may encounter while upgrading to Liferay Digital Experience Platform (DXP), versions 7.0 or 7.1. Read below to discover the steps you can take to resolve these...
Testing JSON Web Services in Liferay
This article documents the new implementation of JavaScript Object Notation (JSON) web services in Liferay Portal 6.1.x to test API methods. The only limitation is that to test any methods they must go through JSON. A...
Cannot Obtain Lock During Startup on DXP 7.0
In some cases, JGroups may not get a response when trying to bind to an address. In this case, an exception like the following can be thrown: 05:50:53,559 ERROR [Framework Event Dispatcher: Equinox Container:...
User's group membership not updating with LDAP after upgrading to Liferay Portal 6.0 EE SP2
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...
Cluster Nodes Are Not Connected When Using Jdbc_Ping on an Oracle Database
This article documents a solution if subscribers are using an Oracle database and using JDBC_ping as the discovery protocol in a clustered environment. The issue is that the JGroup's default initialize_sql value is...
Setting Up Liferay Portal on JBoss 6 EAP
This article will outline how to set up JBoss 6 EAP and deploy Liferay 6.1 EE and 6.2 EE to this application server. Resolution Before You Begin, download JBoss EAP 6.0.1 or 6.1, and...
Issues Encountered with Upgrades to Liferay Portal EE Versions
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...
Clustering With TCP Unicast
Clustering with the Liferay platform can be achieved by using UDP Multicast, UDP Unicast and TCP Unicast. While Multicast is being used by default, there are cases where UDP Multicast...
Liferay-JBoss Integration
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...
Before Opening an Upgrade Ticket
The following article outlines a short checklist of questions to ask and steps to take before opening an upgrade ticket. By taking a moment to go through this checklist before opening a request, you are ensuring the...
Errors and Redirect Issues While Using the Control Panel
This article describes navigational/redirect issues while using the Control Panel when accessing the Liferay platform through a domain (web server or not). The symptoms of this behavior are somewhat random, but...
PDFBox Causing JVM Crashes
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. This article describes an issue inherent...
Error when going to Portal Settings After Upgrading to Liferay Portal 6.1
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...
Trouble Starting Portal If 'Java_Home/bin' Is Not Defined in Path Variable
This article describes a known issue where the platform may not start if JAVA_HOME/bin is not defined in the PATH variable. DXP 7.0 and 7.1 requires JAVA_HOME and PATH variables to be set. However, the...
Before Opening a Clustering Ticket
This article provides a short checklist of questions to ask and steps to take before opening a clustering ticket in Help Center. By taking a moment to go through this checklist before opening a Help Center request, you...
Avoiding SAXParser Exceptions
By default, the Liferay platform does not define a SAXParser. But please note that a SAXParser contains the logic that can parse XML files. Liferay does not define a SAXParser because certain setups (e.g....
Possible Performance Issue Caused by LPS-48693
Before the portal-84-6210 fixpack, the DDMTemplate editor UI was missing the cacheable checkbox. This issue caused each DDMTemplate that was saved into the DB to not be cached. This article provides a solution to a...
NamingException Error on WebSphere 6.x
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. When Liferay Portal is running on a...
Common Errors with Database Sharding in DXP 7.0
This article documents the issues with setting up a sharded database and lists steps to resolve the issue or avoid it altogether. Resolution Error: Users are unable to create content specifically on a sharded database...
Image Editor Does Not Load on Websphere
This article documents an issue where the image editor does not load on WebSphere, as well as steps to resolve the issue or avoid it altogether. This issue is caused by one of the JS files served within the JS editor...
Upgrade halts with "ALTER TABLE" exception
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. Liferay Support does not recommend or...
Ehcache Configuration for Different Versions of the Liferay Platform
This article outlines Liferay configurations for distributed caching along with how to deploy custom tuning configurations. For cache tuning and finding optimal settings for a particular environment, please see the...