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.
- do not remove already installed patches to avoid overwriting an already applied patch with an older version
- Double click the
patch-executor-VERSION.jarin thepatches\binfolder of your JOC Cockpit installation.
Applying patches from the Command Line
To apply the patches
java -jar patch-executor-<VERSION>.jar
To see the patch usage page with the general usage information.
java -jar patch-executor-<VERSION>.jar --help
Parameters to see the usage page are:
- -
?, -h, --help
Rolling back an already patched version
Rollback from the command line
To roll back already applied patches from the command line type:
java -jar patch-executor-<VERSION>.jar --rollback
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. This also makes sure, that you can choose which patches to apply at any moment in time, e.g. you have already applied the patches "x", "y" and "z". If you choose to apply only patches "x" and "z" going further you can do so by deleting the patch "y" from the patches folder and simply run the patch executor again.
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.