Versions Compared

Key

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

...

The following information applies to patches of the JOC Cockpit GUI. For patches of the JS7 - REST Web Service API (API Server) see JS7 - Patches for JOC Cockpit API Server.

  • Patch file names follow the schema: js7-<release>-PATCH-GUI-<sequence>-<issue-key>.tar.gz
    • 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: js7-2.5.3-PATCH-GUI-1-JOC-1550.tar.gz

Anchor
on_premises
on_premises
Apply Patch to JOC Cockpit On Premises

...

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/patch-20230612-JOC-1550.js7-2.5.3-gui-PATCH-GUI-1-JOC-1550.tar.gz -O

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

# remove the patch archive
rm patch-20230612-JOC-1550.js7-2.5.3-gui-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/patch-20230612-JOC-1550.js7-2.5.3-gui-PATCH-GUI-1-JOC-1550.zip
@rem copy from download location (could be different from this example)
copy %USERPROFILE%\Downloads\patch-20230612-JOC-1550.js7-2.5.3-gui-PATCH-GUI-1-JOC-1550.zip .

@rem extract the patch archive
tar.exe -xf patch-20230612-JOC-1550.js7-2.5.3-gui-PATCH-GUI-1-JOC-1550.zip
 
@rem remove the patch archive
del patch-20230612-JOC-1550.js7-2.5.3-gui-PATCH-GUI-1-JOC-1550.zip


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

...