Scope

This documents document shows how to apply patches to the JOC Cockpit.

...

Applying one or more patches to

...

JOC Cockpit

...

(until 1.13.3)

Applying patches automatically

To apply one or more patches to the JOC Cockpit you have to:

1. copy all patches you want to apply to the patches folder of the JOC Cockpit installation. 
2. do not remove already installed patches to avoid overwriting an already applied patch with an older version
    
   
   
3. Double click the patch-executor-VERSION.jar in the patches\bin folder of your JOC Cockpit installation.
    

Apply Patches from the Command Line

The usage page shows the general usage information.

You can see the usage page when you type 

• java -jar patch-executor-<VERSION>.jar --help

Image Removed

Parameters to see the usage page are

• -?, -h, --help

Rollback An Already Patched Version

Rollback automatically

Applying one patch to JOC Cockpit (starting with 1.13.4)

Starting with release 1.13.4 of JOC Cockpit only one patch can be apllied at a time.

The patches have the filename format joc.[VERSION]-patch[PATCHNUMBER].war. The patch-executor will reject other files.

This is the completely patched web application of JOC Cockpit. The latest patch will always include all available patches since the release.

Applying patches automatically

1. To apply the patch remove all previous patches from the patches folder.
2. Copy the patch you want to apply into the patches folder.
3. As above double click the patch-executor-VERSION.jar in the patches\bin

...

1. folder of your JOC Cockpit installation.

...

Applying patches from the Command Line

To rollback already applied patches from the command line typeapply the patch

• java -jar patch-executor-<VERSION>.jar

...

To see the patch usage page with the general usage information.

• java -jar patch-executor-<VERSION>.jar

...

Difference In processing Rollbacks automatically and from the Command Line

If you want to rollback automatically you have to remove the existing patch files from the patches folder.

When the patch executor recognizes that there are no patch files in the patches folder an automatically rollback is performed.

...

• --help

Image Added

Parameters to see the usage page are:

• -?, -h, --help

Rolling back an already patched version 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 was 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 and that . 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 exisitng existing JOC Cockpit Installation the Setup will clean up the patches- and the archive folder of the previous installation.