Page History
...
- Patches are offered from .tar.gz tarball archive files.
- The same patch files are applied to Unix and Windows.
- Patch file names follow the scheme:
- Unix, Windows:
js7_joc.<release>-PATCH.GUI-<sequence>.<issue-key>.tar.gz - The following placeholders are used:
release: The JS7 release number, for example 2.5.3, 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 key in the SOS Change Management System, for example: JOC-1550.
- Example:
- Unix, Windows:
js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz
- Unix, Windows:
- Unix, Windows:
- Patch .tar.gz archive files do not include a directory hierarchy.
...
Caution: Do not apply the patch from the example to any JOC Cockpit release different from 2.5.3, for details see JOC-1550.
Note: The JOC Cockpit has to be stopped before applying patches.
The examples "Automated Patching" make use of scripts
- Unix: js7_install_joc.sh
- Windows: Install-JS7CJoc.ps1
For download these scripts see https://kb.sos-berlin.com/display/JS7/JS7+-+Download
Applying Patch on Unix
Manual Patching
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
# invoke shell and switch to the user account that owns the JOC Cockpit's data directory
# download from patch URL
curl 'https://download.sos-berlin.com/patches/2.5.3-patch/js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz' -O
# apply patch
./js7_install_joc.sh \
--tarball=js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz \
--patch=JSJOC-1550 \
--patch-key=GUI-1 \
--home=/opt/sos-berlin.com/js7/joc \
--data=/var/sos-berlin.com/js7/joc \
--backup-dir=/tmp |
...
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
@rem invoke shell and switch to the user account that owns the JOC Cockpit's data directory @rem navigate to the data directory for patches cd %ProgramData%\sos-berlin.com\js7\joc\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.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz @rem copy from download location (could be different from this example) copy %USERPROFILE%\Downloads\js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz . @rem extract the .tar.gz patch archive tar.exe -xfxzf js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz @rem remove the .tar.gz patch archive del js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz |
...
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
# invoke PowerShell and switch to the user account that owns the JOC Cockpit's data directory
# download from patch URL
Invoke-WebRequest `
-Uri 'https://download.sos-berlin.com/patches/2.5.3-patch/js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz' `
-Outfile js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz
# apply patch
./Install-JS7CJocJS7Joc.ps1 `
-Tarball js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz `
-Patch JSJOC-1550 `
-PatchKey GUI-1 `
-HomeDir $env:ProgamFiles\sos-berlin.com\js7\joc `
-Data $env:ProgramData\sos-berlin.com\js7\joc `
-BackupDir $env:TEMP |
Note: The JOC Cockpit has to be restarted to apply patches.
Note: As an alternative for Windows users can download the patch file to the target directory and use Users are discouraged from using tools such as 7-Zip to extract the patch archive in case of manual patching. Instead, use the tools available from the OS as indicated by the examples. Do not create a sub-folder from the archive name but extract directly to the directory hierarchy as indicated above.
...
Overview
Content Tools