The Liferay Support Team creates and releases fixes to address issues discovered with the product. These are shipped in zipped packages, which are referred to as patches.
Patches can be installed by utilizing the Patching Tool which is included in every Liferay bundle. More information on installing patches may be found here:
- Installing Fix Packs and Hotfixes on Liferay DXP
- Installing Fix Packs and Hotfixes on Liferay Portal 6.x EE
Liferay delivers fixes through these three types of patches:
A Fix Pack is a collection of the latest fixes bundled together. Fix packs include fixes for both the core and the application suites that ship with the product. Fix Packs are cumulative and contain all the fixes from previous Fix Packs.
Fix Packs can be downloaded from our Downloads page. With each Fix Pack, release notes are provided outlining important information, such as Important Changes, security fixes, and a changelog with more detailed information for each fix.
Note: For customers on DXP, there is also a Release Notes Tool that makes it easy to compare all of the changes between different DXP Fix Pack and version levels, including module version changes. This is helpful in planning upgrades and identifying any potential impact to your customizations.
In cases when you encounter an issue which is not yet addressed in a Fix Pack, you can create a Help Center ticket to request a Hotfix. Liferay Support will work together with you to determine if the issue is with the product, and provide a fix for any unintended behavior.
There are two types of hotfixes, standard and cumulative (see below). The Liferay version you are on determines the type of hotfix you will receive (Standard for DXP, Cumulative for Portal EE). These hotfixes are not publicly available for download, you need to contact our Liferay Support Team to obtain them. Hotfixes are installed with the Patching Tool and are specific to the individual customer. Applying hotfixes from other customers may lead to conflicts and create further issues. Hotfixes are available for gold and platinum customers.
(For versions DXP 7.0+)
Standard hotfixes are built assuming a specific Fix Pack level, and must be installed with the corresponding Fix Pack present in the Patches folder. At any given moment one hotfix and one fixpack may be installed together. A standard hotfix may contain more than one fix and even a complete Fix Pack if necessary.
(For version Portal 6.2 EE)
For Portal 6.2 EE, when a hotfix is created, all your currently installed Fix Packs are included in the hotfix. These hotfixes cannot be installed together with Fix Packs. The Patching Tool will automatically recognize and install the newer fix.
Note: Our engineers will need to know which patches are installed on your system. When you contact Liferay Support requesting a hotfix please share this information as it is essential to build a Hotfix. With the Patching Tool you can easily create a text file which contains all the necessary details using the
A security issue may be fixed with a hotifx, a security fix, or a fix pack. For DXP, security issues please see: DXP Security Fix Packs
For Portal 6.2 EE, security issues may be temporarily fixed with a hotfix. Security fixes are then released and delivered to all Portal 6.2 EE customers in the next Fix Pack release. This Fix Pack will include the latest security fixes along with other fixes, as well.
If you are not planning to install all of the latest Fix Packs (or Security Fix Packs) but still need the security fix, please create a Help Center ticket to request a hotfix.
Periodically, the latest fixes and Fix Packs are merged together into a Service Pack. Service Packs are built on top of the original Liferay GA major release, and bundled together with the most up-to-date:
- Patching Tool
- Fix Pack
- Bundled Marketplace Apps
Service Packs can be downloaded from our Downloads page. If starting a new project, always start with the latest Service Pack. The Service Pack will contain all the fixes released (at the time of release) since the previous Service Pack. For existing installations, please follow the instructions on updating to the latest Service Pack level, here:
Note: In previous versions of Liferay Portal (6.0.12, 6.1.10, 6.1.20) the Fix Packs were not compatible with different Service Packs, they can only be installed by rebuilding the portal environment from the new bundles. Fix Packs were only compatible with one Service Pack (or GA as they were called in 6.1 EE) so they couldn't be installed on other versions.
Liferay extensively tests all three types of Fix Packs to ensure high quality. Fix Packs go through both automated regression testing and manual testing. Hotfixes receive similar automated testing, and the fix for the reported issue is tested by the support engineer who built the fix and the support engineer assigned to the Help Center ticket.
Before releasing a Service Pack, additional test suites run on the packaged releases to ensure the quality of the packaging.
A conflict happens when a fix modifies the same file which has already been modified by a Fix Pack. The Patching Tool is not able to decide how to handle these so the case has to be verified and resolved by an engineer (sometimes the logic has to be adjusted as well). This is called a merge because the new fix has to include the previous one as well. The Patching Tool looks for information in the patches so it knows how to install the various patches correctly.
Previously with standard hotfixes, many combinations of conflicts emerged and needed to be handled which lead to slower and more error prone resolutions. Also, every customer could have a completely different environment.
By releasing fix packs more often the need to handle these conflicts occurs only once in the newer fix pack. This way we can reduce the number of different environments our customers may have. From versions 6.1.30 and 6.2.10 ideally only the fix packs are used in a Liferay installation. In case there is an urgent need to handle a malfunction a cumulative hotfix can be requested. After releasing and installing a cumulative hotfix there is still a possibility to go back to use fix packs if the fix is included in a fix pack later on.
Important: Make sure to backup your Liferay DXP installation and database regularly, especially before patching. The patching tool installs code changes and some of these make data changes (if necessary) automatically on startup.
Certain fix packs (service packs) can include data/schema micro changes—they’re optional and revertible. Module upgrades and any micro changes they include are applied at server startup by default, or can be applied manually by disabling the
autoUpgradeproperty. Server startup skips all Core micro changes. Instead, you can apply them using the upgrade tool before server startup.
- Patch Management Best Practices
- Fix Pack and Security Release Schedules
- DXP Security Fix Packs
- Naming Conventions for Fix Packs and Service Packs
Please subscribe to our Liferay Support Updates to stay informed on the latest releases.