When using patching-tool version 20 and below, corruptions of portal files can occur if a patch is installed when the portal is not completely shutdown, or if it is still running.
Because of this, it is important to always shut down the portal completely prior to installing a patch.
Note: Patching-tool version 21 will resolve this issue.
In the event that this issue does occur, the following workaround can be used for general cases.
- Download a clean bundle.
- Apply the same patch that was installed in the affected environment.
- Shut down the application server
- Copy the following files from the clean bundle (which is now patched) to the affected environment:
./patching-tool.sh revertin the affected environment to recover the original files.
patching-tool revertif the environment is on a Windows machine.
patching-tool installfor Windows
- Start the server and verify that the issue is resolved.
To see a specific example of this occurring, along with a more specific resolution, please reference the following article: Dockbar Display Error After Patch Installation With Patching Tool.