To install fix packs and hotfixes, please download the latest patching tool.
- Stop the application server.
- Download the file mentioned to
- From the PATCHING_TOOL_HOME command prompt, execute
- Confirm the patch was installed by executing
./patching-tool info. You should see an
Inext to the installed patch
- Start the server.
If the hotfix is not installed OR if you receive an error that is not covered in the documentation below, please open a Help Center Support ticket and provide the full patching-tool output.
Note: If there are any issues with the installed fixes, verify that there are not any remaining files within the application server cache from the previous patch installation of a fix pack or hotfix.
For example, in Tomcat, clear out the
$CATALINA_HOME/temp directories. The reason why these folders should be cleared out after the patch has been installed is to ensure that any temporary or cached files from the last patch level is not being utilized. Clearing the temporary folders within the application server allows for the Liferay platform to have a fresh start based on the new patch level.
During the installation,
patching-backup.zip files will be created and stored in the
DO not delete the
patching-backup.zip file is necessary for installing future patches. This is because the patching-tool reverts the installed fix pack before installing a new one. In order to revert the installed fix pack, it examines the contents of the patching-backup.zip in order to determine what changes have been made that it needs to revert.
web.xml file inside the
/WEB-INF folder will always be overwritten by the one inside the patch. Any custom configurations made by system administrators will be lost. Administrators should remember to add back custom configurations before restarting the application server.
While removing the
patching-backup.zip file does not affect the patching-tool's report of what's installed in the bundle, we do not recommend removing the file from the
ROOT/WEB-INF because doing so will cause future installations to fail.