Versions Compared

Key

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

...

  • Patch file names follow the schema:
    • Unix: js7_joc_linux.<release>-PATCH.GUI-<sequence>.<issue-key>.tar.gz
    • Windows: js7_joc_windows.<release>-PATCH.GUI-<sequence>.<issue-key>.zip
  • 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: 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 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.zip
@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.zip .

@rem extract the patch archive
tar.exe -xf js7-_joc_windows.2.5.3-PATCH-.GUI-1-.JOC-1550.zip

@rem remove the patch archive
del js7-_joc_windows.2.5.3-PATCH-.GUI-1-.JOC-1550.zip


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

...