There are two ways to configure the Patching Tool:
Automatically by executing the
Manually by editing the configuration file (see Patching Tool Advanced Configuration)
Automatic configuration generates the configuration files by looking for
Liferay DXP files in the local file system. By default the Patching Tool looks for
them in its parent folder. To start the process, run this command in your
Patching Tool folder (
If Liferay DXP is not installed in the parent folder, specify its location:
patching-tool auto-discovery /opt/liferay-dxp
If you specified the wrong location of Liferay DXP or it is not in the parent folder, the Patching Tool can’t find the Liferay Home and reports an error like this:
The .liferay-home has not been detected in the given directory tree. Configuration: patching.mode=binary war.path=../tomcat-9.0.17/webapps/ROOT/ global.lib.path=../tomcat-9.0.17/lib/ext/ liferay.home=**[please enter manually]** The configuration hasn't been saved. Please save this to the default.properties file.
Here are ways to resolve the Liferay Home issue:
- Specify the Liferay Home path in the
- If the Liferay Home is in the Patching Tool’s tree, create a
.liferay-homefile in the Liferay Home folder and re-run the auto-discovery process.
When the Patching Tool is configured, running
patching-tool info reports
product version information.
That’s it! Now that you’ve installed and configured the Patching Tool, you’re ready to download and install patches.