14.4.3. Rollback the Application of a Patch in Zip Form Using the patch Command
This task describes how to use the
patch command to rollback the application of a previously applied zip patch in JBoss EAP 6.
patchcommand is not intended as a general uninstall functionality. It is only intended to be used immediately after the application of a patch which had undesirable consequences.
patchcommand is a feature that was added in JBoss EAP 6.2. For versions of JBoss EAP prior to 6.2, the process to rollback patches in zip form is different, and you should instead refer to the relevant version's documentation available at https://access.redhat.com/site/documentation/.
- A patch that was previously applied using the
- Access to the Management CLI for the server instance. Refer to Launch the Management CLI in the Administration and Configuration Guide.
Procedure 14.3. Rollback a patch from a JBoss EAP 6 server instance using the
- From the Management CLI, use the
patch infocommand to find the ID of the patch that is to be rolled back.
- For cumulative patches, the patch ID is the value of the first
cumulative-patch-idshown in the
- One-off security or bug fix patch IDs are listed as the value of the first
patchesshown in the
patch infooutput, with the most recently applied one-off patch listed first.
- From the Management CLI, rollback the patch with the appropriate patch ID from the previous step.
WarningUse caution when specifying the value of the
--reset-configurationswitch.If set to
TRUE, the patch rollback process will also rollback the JBoss EAP 6 server configuration files to their pre-patch state. Any changes that were made to the JBoss EAP 6 server configuration files after the patch was applied will be lost.If set to
FALSE, the server configuration files will not be rolled back. In this situation, it is possible that the server will not start after the rollback, as the patch may have altered configurations, such as namespaces, which may no longer be valid and have to be fixed manually.
patch rollback PATCH_ID --reset-configuration=TRUEThe
patchtool will warn if there are any conflicts in attempting the rollback the patch. Refer to Section 14.4.1, “The
patchCommand” for available switches to re-run the command to resolve any conflicts.
- Restart the JBoss EAP 6 server instance for the patch rollback to take effect:
The patch, and optionally also the server configuration files, are rolled back on the JBoss EAP 6 server instance.