Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Patch file names follow the schema:
    • Unix, Windows: js7_joc_linux.<release>-PATCH.GUI-<sequence>.<issue-key>.tar.gzWindows: js7_joc_windows.<release>-PATCH.GUI-<sequence>.<issue-key>.zip
    • The same patch files are applied for Unix and Windows.
  • The following placeholders are used:
    • release: The JS7 release number, see Releases.
    • sequence:  Patches for a given release are assigned ascending numbers starting from 1. Patches with a higher number include any patches with lower numbers.
    • issue-key: The issue in the SOS Change Management System, for example: JOC-1550.
  • Example:
    • Unix, Windows:js7_joc_linux.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz
    • Windows:js7_joc_windows.2.5.3-PATCH.GUI-1.JOC-1550.zip

Anchor
on_premises
on_premises
Patches for JOC Cockpit On Premises

...

Find the following example for a patch:

Platform
ProductTypeMediaDownload URL ExampleHashSigTSR
Installation, Update, Upgrade, Patches
JOC CockpitLinuxtarball archive.tar.gz

https://download.sos-berlin.com/patches/2.5.3-patch/js7_joc_linux.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz

sha256sigtsr

Windows.ziphttps://download.sos-berlin.com/patches/2.5.3-patch/js7_joc_windows.2.5.3-PATCH.GUI-1.JOC-1550.zipsha256sigtsr

Do not apply the patch from the above examples for any JOC Cockpit release different from 2.5.3, for details see JOC-1550.

...

Code Block
languagebash
titleExample how to apply a patch to JOC Cockpit for Unix
linenumberstrue
# navigate to the target directory for patches
cd /var/sos-berlin.com/js7/joc/jetty_base/webapps/joc

# verify the directory by checking if this file is available
ls version.json

# take a backup
tar --exclude=./WEB-INF -cvzf /tmp/backup-joc-cockpit-$(date +"%Y%m%d-%H%M%S").tar.gz .

# remove existing files and directories
find . -maxdepth 1 -type f -delete && rm -d -r ./assets ./styles

# download the patch archive
curl https://download.sos-berlin.com/patches/2.5.3-patch/js7_joc_linux.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz -O

# extract the patch archive
tar -xvzf js7_joc_linux.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz

# remove the patch archive
rm js7_joc_linux.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz

...

Code Block
languagebash
titleExample how to apply a patch to JOC Cockpit for Windows
linenumberstrue
@rem navigate to the target directory for patches
cd %ProgramData%\sos-berlin.com\js7\joc\jetty_base\webapps\joc

@rem verify the directory by checking if this file is available
dir version.json

@rem take a backup
set month=%date:~3,2%
set day=%date:~0,2%
set year=%date:~6,4%
set hour=%time:~0,2%
set minute=%time:~3,2%
set second=%time:~6,2%
tar.exe --exclude .\WEB-INF -cf %TEMP%\backup-joc-cockpit-%year%%month%%day%-%hour%%minute%%second%.zip .

@rem remove existing files and directories
del /Q *.*
rmdir /Q /S .\assets
rmdir /Q /S .\styles

@rem download from URL https://download.sos-berlin.com/patches/2.5.3-patch/js7_joc_windows.2.5.3-PATCH.GUI-1.JOC-1550.tar.zipgz
@rem copy from download location (could be different from this example)
copy %USERPROFILE%\Downloads\js7_joc_windows.2.5.3-PATCH.GUI-1.JOC-1550.ziptar.gz .

@rem extract the patch archive
tar.exe -xf js7_joc_windows.2.5.3-PATCH.GUI-1.JOC-1550.ziptar.gz

@rem remove the patch archive
del js7_joc_windows.2.5.3-PATCH.GUI-1.JOC-1550.ziptar.gz


Note: The JOC Cockpit has to be restarted to apply patches.

...