Here are some things you might need to do with patches:
- Report Patch Levels to Liferay Support
- Uninstall Patches
- Show collisions between patches and deployed plugins
- Separate Patches from your Installation
Start with reporting patch levels to Liferay Support.
Including support-info in Support Tickets
Providing your environment’s information (e.g., hardware architecture) and patch level to Liferay Support is critical for reproducing your issues. Write your support information (including your patch level) to a file by executing this command:
The support information is written to file
patching-tool-support-info-actual-timestamp.txt in your
folder. Please upload this file to the
Have you noticed that the Patching Tool only seems to have an
This is because patches are managed not by the command, but by what appears in
patches folder. You manage the patches you have installed by adding or
removing patches from this folder.
Here’s how to uninstall (remove) a patch:
Remove the patch from your
To revert ALL patches, run this command:
Now you know how to remove and revert patches. You can also compare patch levels. See the reference guide for a list of the available commands.
Showing collisions between patches and deployed plugins
Some patches update files you might have customized via a plugin. The
patching-tool list-collisions command lists differences (collisions) between
installed patch files and your plugin’s version of them. Here’s the command:
It is an alias for the following diff command:
patching-tool diff collisions files _base
_base is the literal patch level name. Collisions are only listed for
installed patches that contain source code files.
Separating Patches from the Installation
The Patching Tool’s
separate command helps reduce the patched Liferay DXP
installation size. If the installation has been patched, you can make it smaller
by moving the restore files out of it.
Patched installations are large because the restore files are stored inside the
WEB-INF folder by default. These files are required for
patching the installation again.
If these files are removed, subsequent patching processes fail. Because of this, Liferay added an option to separate the patching files from the installation while still preserving and restoring them safely when new patches arrive. To do this, use this command:
patching-tool separate [separation_name]
This command produces a
liferay-patching-files-[separation-name].zip file in
the Patching Tool’s
patches folder. It contains the necessary files and
metadata for patching, verification, and validation. Once you create this file,
the patch files are removed from their default location and are now only
available in this file. You can store this file elsewhere to reduce your
WARNING: If the product is separated from its patches in this way, you cannot run most of the Patching Tool commands until the patches are restored.
After the separation process only the following commands can be used:
Any other command returns this:
This installation does not include data for patching. Please copy the liferay-patching-files-[separation-name].zip file into the 'patches' directory and run patching-tool setup.
This is how you restore the patch files to your system. Details below.
Restoring the Separated Patch Files
When you need to patch Liferay DXP again, you must restore the separated patch
artifact. To do this, copy the
back to the Patching Tool’s
patches folder and run
The command finds the necessary patching artifact and restores the patch files to the installation. After that, the Patching Tool works like it did prior to separating the patches.