HCL Commerce Version 9.1.15.0 or later

Applying a patch to the Query service

Complete the following steps to apply a custom processor patch to the Query service.

Procedure

  1. Open a web browser and log in to the My HCLSoftware portal website to download the code patch JAR.
  2. Use one of the following procedures to apply the patch JAR, depending on your target runtime environment:
    1. Docker container - place the code patch JAR into /patches directory, and run /SETUP/bin/patch.sh to apply all the patch JARs under the /patches directory. Restart the Query container to apply the patch during the next server start-up.
    2. Kubernetes - create a custom image using dockerfile which contains instruction to place the code patch JAR into /patches directory and run /SETUP/bin/patch.sh as the root user.
    3. Auto patching - the Query service comes with an automatic patching function that gets triggered during each server startup. Any patch JAR placed under the/patches directory will be applied automatically through patch.sh script file before the application starts up. This approach can be considered as a slight variation as mentioned in above step 2b (Kubernetes), and is more flexible as it does not require creating a custom image with the binary patches applied ahead of time. Patches can also be added or removed as needed, and all that is needed is to restart the application. To disable this auto-patching capability, explicitly set an environment variable called AUTO_PATCHING to false.