Scope
This document shows how to apply patches to the JOC Cockpit.
Applying one or more patches to the JOC Cockpit
Applying patches automatically
To apply one or more patches to the JOC Cockpit you have to:
- copy all patches you want to apply to the patches folder of the JOC Cockpit installation.
- Double click the
patch-executor-VERSION.jar
in thepatches\bin
folder of your JOC Cockpit installation.
Applying Patches from the Command Line
The patch usage page shows the general usage information.
You can see the usage page when you type:
java -jar patch-executor-<VERSION>.jar --help
Parameters to see the usage page are:
- -
?, -h, --help
Rolling back an already patched version
Automatic rollback
To rollback already applied patches you have to delete all the patch files from the patches folder of your JOC Cockpit installation.
Rollback from the command line
To roll back already applied patches from the command line type:
java -jar patch-executor-<VERSION>.jar --rollback
Delete all patch files from the patches folder and then type:
java -jar patch-executor-<VERSION>.jar
without any further parameters
Difference between processing rollbacks automatically and from the command line
If you want to rollback automatically then you will first have to remove all the existing patch files from the patches
folder.
When the patch executor then recognizes that there are no patch files in the patches folder an automatically rollback is performed.
In contrast, when you type java -jar patch-executor-<VERSION>.jar --rollback
in the command line, a rollback will be performed, no matter which patch files reside in the patches
folder.
General Information
When you run the patch executor it will check if a copy of the (original) joc.war
file has already archived in the archive folder of the JOC Cockpit installation. If not, a copy of the original joc.war
file will be copied to the archive folder.
If a copy of the joc.war
file already exists in the archive folder, it will not be overwritten. This ensures that only the original joc.war
file is archived and not an already patched one. It also ensures that the patch executor is able to perform a rollback to the original state.
When a new installation is performed on an existing JOC Cockpit Installation the Setup will clean up the patches- and the archive folder of the previous installation.