If you installed Liferay DXP manually as a WAR file on a supported application server, you must apply patches to the WAR file and supporting files and re-deploy them. This tutorial shows you how to do that.
Download the necessary artifacts from the Customer Portal:
- Liferay DXP WAR file (
- Dependencies ZIP file (
- OSGi JARs ZIP file (
- Latest Patching Tool
Create an arbitrary folder. Unzip the dependency artifacts and the Patching Tool into it. The folder contents should look like this:
liferay-dxp-dependencies-[version]/← Unzipped Dependencies
osgi/← Unzipped OSGi JARs
patching-tool/← Unzipped Patching Tool
liferay-dxp-[version].war/← Liferay DXP WAR File
Create the default profile configuration file in the Patching Tool folder:
patching-home/patching-tool/default.properties. The contents should look like this:
patching.mode=binary war.path=../../patching-home/liferay-dxp-[version].war global.lib.path=../../patching-home/liferay-dxp-dependencies-[version] liferay.home=../../patching-home
If you’re using a different OSGi folder structure, you can specify it as the Patching Tool Advanced Configuration documentation describes:
module.framework.core.path=/osgi-home/osgi/core module.framework.marketplace.path=/osgi-home/osgi/marketplace module.framework.modules.path=/osgi-home/osgi/modules module.framework.portal.path=/osgi-home/osgi/portal module.framework.static.path=/osgi-home/osgi/static
Download the patch (fix pack or hotfix) to install and put it in a folder called
patchesin your Patching Tool folder:
Execute the Patching Tool’s
/patching-home/patching-tool> patching-tool info Loading product and patch information... Product information: * installation type: binary * build number: 7110 * service pack version: - available SP version: Not available - installable SP version: Not available * patching-tool version: 2.0.8 * time: 2018-09-12 18:30Z * host: 91WRQ72 (8 cores) * plugins: no plugins detected Currently installed patches: - Available patches: dxp-2-7110 Detailed patch list: [ I] dxp-2-7110 :: Currently not installed; Will be installed. :: Built for LIFERAY
Install the patch.
/patching-home/patching-tool> patching-tool.sh install One patch is ready to be installed. Applying dxp-2... Cleaning up: [1%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100%] Installing patches: [1%..10%..20%..30%..40%..50%..60%..70%..80%..90%...100%] The installation was successful. One patch is installed on the system.
Great! You have successfully patched the artifacts, and they are ready to be deployed on any supported Application Server.