Empty patch example for instruction purposes about automated updates

Issue for Instruction Purposes

• This issue does not fix a problem but is intended for instruction purposes.
• Consider the articles linked below that include instructions how to apply patches to Controllers and Agents.

Patch

• The patches will not impact an existing JS7 JOC Cockpit,, Controller or Agent.
• The patches include a Java class that is not used by JS7 components.
• To apply a patch it is stored
  • for a Controller to the JS7_CONTROLLER_HOME/lib/patches directory,
  • for an Agent to the JS7_AGENT_HOME/lib/patches directory.
  • for JOC Cockpit API to the JETTY_BASE/webapps/joc/WEB-INF/classes directory,
  • for JOC Cockpit GUI to the JETTY_BASE/webapps/joc directory,

Applying a Patch to the JS7 Controller

• Download
  • https://download.sos-berlin.com/patches/2.2.3-patch/js7_controller.2.2.3-PATCH.JS-1984.jar [sha256] [sig] [tsr]
  • Consider to verify integrity and authenticity of downloaded files, see JS7 - Verifying Releases
• Manual installation of the Patch
  • Follow instructions from JS7 - Patches for Controller
• Automated installation of the Patch
  • Run Controller Installer Script available from: JS7 - Automated Update of Controller

    ./js7_install_controller.sh --home=/home/sos/controller --patch=JS-1984 --patch-jar=js7_controller.2.2.3-PATCH.JS-1984.jar
    

Applying a Patch to the JS7 Agent

• Download
  • https://download.sos-berlin.com/patches/2.2.3-patch/js7_agent.2.2.3-PATCH.JS-1984.jar [sha256] [sig] [tsr]
  • Consider to verify integrity and authenticity of downloaded files, see JS7 - Verifying Releases
• Manual installation of the Patch
  • Follow instructions from JS7 - Patches for Agent
• Automated installation of the Patch
  • Run Agent Installer Script available from: JS7 - Automated Update of Agent

    ./js7_install_agent.sh --home=/home/sos/agent --patch=JS-1984 --patch-jar=js7_agent.2.2.3-PATCH.JS-1984.jar
    

Applying a Patch to the JOC Cockpit API

• Download
  • https://download.sos-berlin.com/patches/2.2.3-patch/js7_joc.2.2.3-PATCH.API-1.JS-1984.jar [sha256] [sig] [tsr]
  • Consider to verify integrity and authenticity of downloaded files, see JS7 - Verifying Releases
• Manual installation of the Patch
  • Follow instructions from JS7 - Patches for JOC Cockpit API
• Automated installation of the Patch
  • Run JOC Cockpit Installer Script available from: JS7 - Unix Shell Installation Script - js7_install_joc.sh
  • Run Installer Script for the same home and data directory:

    ./js7_install_joc.sh --home=/home/sos/joc --patch=JS-1984 --patch-key=API-1 --patch-jar=js7_joc.2.2.3-PATCH.API-1.JS-1984.jar
    

  • Run Installer Script for different home and data directories:

    ./js7_install_joc.sh --home=/opt/sos-berlin.com/js7/joc --data=/var/sos-berlin.com/js7/joc --patch=JS-1984 --patch-key=API-1 --patch-jar=js7_joc.2.2.3-PATCH.API-1.JS-1984.jar
    

Applying a Patch to the JOC Cockpit GUI

• Caution: The patch will impact your JOC Cockpit GUI and is applicable to release 2.5.3 only.
• Download
  • https://download.sos-berlin.com/patches/2.5.3-patch/js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz [sha256] [sig] [tsr]
  • Consider to verify integrity and authenticity of downloaded files, see JS7 - Verifying Releases
• Manual installation of the Patch
  • Follow instructions from JS7 - Patches for JOC Cockpit GUI
• Automated installation of the Patch
  • Run JOC Cockpit Installer Script available from: JS7 - Unix Shell Installation Script - js7_install_joc.sh
  • Run Installer Script for the same home and data directory:

    ./js7_install_joc.sh --home=/home/sos/joc --tarball=js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz --patch-key=GUI-1 --patch=JOC-1550
    

  • Run Installer Script for different home and data directories:

    ./js7_install_joc.sh --home=/opt/sos-berlin.com/js7/joc --data=/var/sos-berlin.com/js7/joc --tarball=js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz --patch-key=GUI-1 --patch=JOC-1550