Perform a major upgrade of a Podman image

This document explains how to perform a major upgrade for an existing remote agent using the Podman image. The procedure assumes you're viewing the Major Upgrade dialog in the Google Security Operations SOAR platform.

1. On the Major Upgrade dialog, copy the provided Podman run command:

    PODMAN_COMMAND 
   

2. List the current running Podman containers:

   podman  
   ps

3. Enter your agent's container ID:

    CONTAINER_ID 
   

4. Enter your agent's container name:

    AGENT_NAME 
   

   .
5. Pull the latest Podman image to your machine using the following command. You can replace the :latest tag with a specific version, such as 1.4.8.3 .

   podman  
   pull  
   us-podman.pkg.dev/siem-ar-public/images/agent:latest

6. Copy the original environment variables ( .bash_profile ) to a local temporary file.

   podman  
    exec 
     
    CONTAINER_ID 
     
   cat  
   /home/siemplify_agent/.bash_profile  
   >  
   temp_bash_profile.txt

7. Stop the agent's Podman container.

   podman  
   stop  
    CONTAINER_ID 
   

8. Rename the container for backup.

   podman  
   rename  
    AGENT_NAME 
     
    AGENT_NAME 
   _backup

9. Run the new agent image. If you changed the latest tag, make sure the image tag matches the one pulled in.

    PODMAN 
   

10. List the running Podman containers.

    podmabn  
    ps

11. Enter your agent's new container ID:

     NEW_CONTAINER_ID 
    

12. Copy the environment variables .bash_profile from the temporary file to the new container.

    cat  
    temp_bash_profile.txt  
     | 
      
    podman  
     exec 
      
    -i  
      
     NEW_CONTAINER_ID 
      
    sh  
    -c  
     'cat > /home/siemplify_agent/.bash_profile' 
    

13. Restart the agent service to apply the modified environment variables.

    podman  
     exec 
      
     NEW_CONTAINER_ID 
      
    supervisorctl  
    restart  
    all