JS7 JobScheduler

Space shortcuts

Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Introduction

SOS provides JS7 - Patch Management in a situation of severe bugs or Vulnerabilities.

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.

Apply Patch to JOC Cockpit On Premises

The JOC Cockpit GUI expects patches to be extracted to its data directory in following location:

  • Unix
    • /var/sos-berlin.com/js7/joc/jetty_base/webapps/joc
    • /var/sos-berlin.com/js7/joc/jetty_base/webapps/joc/assets
    • /var/sos-berlin.com/js7/joc/jetty_base/webapps/joc/styles
  • Windows
    • C:\ProgramData\sos-berlin.com\js7\joc\jetty_base\webapps\joc
    • C:\ProgramData\sos-berlin.com\js7\joc\jetty_base\webapps\joc\assets
    • C:\ProgramData\sos-berlin.com\js7\joc\jetty_base\webapps\joc\styles

The first part of the path including the jetty_base is specified during installation and can point to a different location. The remaining webapps/joc part of the path will remain the same for all installations.

Download Patch

The following example makes use of a patch available for

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

Effective download links for JOC Cockpit patches are indicated with the respective Change Management issue.

Before applying patches users might want to verify the integrity and authenticity of downloaded files, see JS7 - Verifying releases.

Apply Patch

Apply the following steps to a JOC Cockpit instance. If a JOC Cockpit cluster is operated then the steps are to be performed for all JOC Cockpit instances.

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


Example how to apply a patch to JOC Cockpit for Unix
# 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.2.5.3-gui.tar.gz -O

# extract the patch archive
tar -xvzf patch-20230612-JOC-1550.2.5.3-gui.tar.gz

# remove the patch archive
rm patch-20230612-JOC-1550.2.5.3-gui.tar.gz



Example how to apply a patch to JOC Cockpit for Windows
@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.2.5.3-gui.zip
@rem copy from download location (could be different from this example)
copy %USERPROFILE%\Downloads\patch-20230612-JOC-1550.2.5.3-gui.zip .

@rem extract the patch archive
tar.exe -xf patch-20230612-JOC-1550.2.5.3-gui.zip
 
@rem remove the patch archive
del patch-20230612-JOC-1550.2.5.3-gui.zip


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

Note: As an alternative for Windows you can download the patch file to the target directory and use tools such as 7-Zip to extract the archive. Do not create a sub-folder from the archive name but extract directly to the directory hierarchy as indicated above.

Remove Patch

Patches are automatically removed when a JOC Cockpit release is installed.

Patches can be manually removed

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

Apply Patch to JOC Cockpit Images

It is not recommended to patch the GUI in JOC Cockpit containers. As a larger number of files are included in a GUI patch this will create unwanted overlays in your container architecture.

You can apply patches to JOC Cockpit images. Use the same sequence of OS commands as indicated with chapter Apply Patch to JOC Cockpit On Premises in your Dockerfile when creating the image. For details how to build the image see JS7 - JOC Cockpit Build of Container Image.



  • No labels