Perform a major upgrade of a Podman image

Supported in:

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

Need more help? Get answers from Community members and Google SecOps professionals.