Patch installation

If the upload from an ODBC data source has failed, you need to download and install the Dockerfile.odbcpatch file.

Prerequisites

  • If the target machine (HOST) is not connected to the internet, you will need an additional machine (BUILDER) that is connected to the internet and has Docker installed. You need to have the Dockerfile.odbcpatch on the respective machine (HOST or BUILDER) depending on the HOST internet connection. All actions in the instructions are marked on which machine to perform them.
  • Make sure you have root access on both machines.

Step 1 – Setup

  1. HOST: Install the Process Intelligence application.
  2. HOST: Stop the Process Intelligence service using the command systemctl stop timeline

Step 2 – Patch

Patch with internet connection on HOST.

HOST: Patch the timeline/backend image with the received dockerfile:

cd <path_to_dockerfile> && docker build -f Dockerfile.odbcpatch -t timeline/backend:latest

Patch without internet connection on HOST.

  1. HOST: Export the timeline/backend image:

    docker save -o timeline-backend-latest.tar timeline/backend:latest

  2. Move the exported timeline-backend-latest.tar to the BUILDER machine.

  3. BUILDER: Load the timeline/backend image:

    docker load --input <path_to_image_tar>/timeline-backend-latest.tar

  4. BUILDER: Patch the timeline/backend image with the received dockerfile:

    cd <path_to_dockerfile> && docker build -f Dockerfile.odbcpatch -t timeline/backend:latest

  5. BUILDER: Export the patched timeline/backend image:

    docker save -o timeline-backend-latest-patched.tar timeline/backend:latest

  6. Move the exported timeline-backend-latest-patched.tar to the HOST machine.

  7. HOST: Load the patched timeline/backend image:

    docker load --input <path_to_image_tar>/timeline-backend-latest-patched.tar

Step 3 – Clean up and start the Process Intelligence service

Perform these actions on the machine you have used for patch installation.

  1. (Optional) HOST/BUILDER: Find the old timeline/backend image (repository: timeline/backend, tag: <none>):

    docker image ls

  2. (Optional) HOST/BUILDER: Delete the old timeline/backend image by id::

    docker image rm <image_id_of_old_backend_image>

  3. HOST: Restart Process Intelligence service:

    systemctl start timeline