Apply Patch for Existing CHAI™ Setup¶

To ensure the latest updates and improvements are applied to your CHAI™ setup, follow these steps for applying a new patch.

Patch Application Process¶

Step 1: Download Patch¶

Download the patch file from the provided link and save it to a designated folder on the appliance server:

wget '<link for the new patch>' -O new_patch.tar.gz

Step 2: Extract Patch¶

Once downloaded, extract the contents of the new_patch.tar.gz file:

tar -xzvf new_patch.tar.gz

Step 3: Apply Patch¶

Now, proceed to apply the patch to your CHAI™ setup. You have the option to either patch all services or specific ones based on your requirements.

Patching Options¶

Option A: Patch All Services¶

To apply the patch to all services, execute the following command:

sudo chctl patch appliance --all

This command will: - Load docker images - Stop the appliance - Take a backup of the existing /opt/appliance/chctl-compose.yaml file - Replace docker image tags in chctl-compose.yaml file - Start the appliance

Option B: Patch Specific Services¶

Alternatively, if you prefer to patch specific services, use the following command:

sudo chctl patch appliance --<service_name1> <tag1> --<service_name2> <tag2>

Example:

sudo chctl patch appliance --activity-service ch-rel-2.0.0-1 --webapp ch-rel-2.0.0-4

This command will: - Stop the appliance - Take a backup of the existing /opt/appliance/chctl-compose.yaml file - Replace docker image tags in chctl-compose.yaml file - Start the appliance

Verification¶

Once done, log in to CHAI™ and verify the data and version to ensure the patch has been applied successfully.