...

• Patches are offered from from .jar Java archive files or 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_agent.<release>-PATCH.<issue-key>.[jar|tar.gz]
  • The following placeholders are used:
    • release: The JS7 release number, see Releases.
    • issue-key: The issue key in the SOS Change Management System, for example: JS-1984.
  • Example:
    
    • Unix, Windows: js7_agent.2.2.3-PATCH.JS-1984.jar, js7_agent.2.2.3-PATCH.JS-1984.tar.gz
• Patch .tar.gz archive files
  • include one or more .jar files that hold patches.
  • include a directory hierarchy for .jar files:
    • agent/lib/patches

...

The Agent expects Java .jar files holding patches in the following locations:

• Unix
  • /opt/sos-berlin.com/js7/agent/lib/patches
• Windows
  • C:\Program Files\sos-berlin.com\js7\agent\lib\patches

The paths noted above are specified during installation and can point to a different location. The lib/patches part of the path will be the same for all installations.

Download Patch

Find the following examples for a patch:

The patch examples will not impact an Agent installation and are used for instructional purposes only. For details see JS-1984.

...

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

Anchor
on_premises on_premises

Patches for Agent On Premises

The Agent expects Java .jar files holding patches in the following locations:

• Unix
  • /opt/sos-berlin.com/js7/agent/lib/patches
• Windows
  • C:\Program Files\sos-berlin.com\js7\agent\lib\patches

The paths noted above are specified during installation and can point to a different location. The lib/patches part of the path will be the same for all installations.

Apply Patch

Apply the following steps to an Agent instance. If an Agent cluster is operated then the steps have to be performed for all Agent cluster members.

...

# navigate to the target directory for patches
cd /opt/sos-berlin.com/js7/agent/lib/patches

# download the patch archive
curl https://download.sos-berlin.com/patches/2.2.3-patch/js7_agent.2.2.3-PATCH.JS-1984.tar.gz -O

# extract the patch archive that includes .jar files
tar -xvzf js7_agent.2.2.3-PATCH.JS-1984.tar.gz

# remove the patch archive
rm js7_agent.2.2.3-PATCH.JS-1984.tar.gz

Apply Patch on Windows

@rem navigate to the target directory for patches
cd %ProgramFiles%\sos-berlin.com\js7\agent\lib\patches

@rem download from URL https://download.sos-berlin.com/patches/2.2.3-patch/js7_agent.2.2.3-PATCH.JS-1984.jar
@rem copy from download location (could be different from this example)
copy %USERPROFILE%\Downloads\js7_agent.2.2.3-PATCH.JS-1984.jar .

...

Note: The Agent has to be stopped before patches are removed.

Anchor
docker_containers docker_containers

...

Patches for Agent Container

The Agent container expects Java .jar files for patches in the following location:

...