"Inconsistent patch level detected" error occured in the logs

Issue

• The following error occurs in the logs due to an inconsistency in patch levels:

Example 1:

ERROR [server.startup : 2][PatcherImpl:204] Inconsistent patch level detected
WARN [server.startup : 2][PatcherImpl:212] Patch level on portal-impl.jar: [dxp-28-7110, hotfix-xxxx-7110]
WARN [server.startup : 2][PatcherImpl:222] Patch level on portal-kernel.jar: [dxp-28-7110, hotfix-yyyy-7110]
ERROR [server.startup : 2][MainServlet:221] Stopping the server due to the inconsistent patch levels

Example 2:

ERROR [server.startup : 0][PatcherImpl:207] Inconsistent patch level detected
WARN  [server.startup : 0][PatcherImpl:214] Patch level on portal-impl.jar: [dxp-2-7310, hotfix-xxxx-7310]
WARN  [server.startup : 0][PatcherImpl:224] Patch level on portal-kernel.jar: [dxp-1-7310]

Environment

• Liferay DXP 7.1+
• Liferay DXP 7.2+
• Liferay DXP 7.3+
• Liferay DXP 7.4+

Resolution

The "Inconsistent patch level detected" error occurs when the patch levels in the following JAR files do not match:

• Example 1: "portal-impl.jar" contains [dxp-28-7110, hotfix-xxxx-7110], but "portal-kernel.jar" contains [dxp-28-7110, hotfix-yyyy-7110].
• Example 2: "portal-impl.jar" contains [dxp-2-7310, hotfix-xxxx-7310], but "portal-kernel.jar" contains [dxp-1-7310].

To resolve this issue, follow these steps:

1. Check the installed patches/hotfixes using the command:{$LIFERAY_HOME}\patching-tool: patching-tool info (Windows) ./patching-tool.sh info (Unix/Linux)

2. If a conflicting hotfix is installed, uninstall it by running:
   ./patching-tool.sh revert -hotfix

3. Locate the portal-kernel.jarfile and replace it:

   • For Liferay 7.3 and below:
     • Navigate to:Liferay_home > app server > lib > ext
     • Find the portal-kernel.jar file and replace the existing jar with the new jar file.
   • For Liferay 7.4 and above:
     • Navigate to:Liferay_home > app server > webapps > root > web-inf > shielded-container-lib
     • Here, you will find both portal-kernel.jar and portal-impl.jar. Replace the required file.

4. Backup the original file before replacing it.

5. Reinstall the required hotfix after replacing the file.

6. Perform a clean restart after clearing all temporary folders.