Perform a major upgrade of a Docker image

Supported in:

Google secops SOAR

This document explains how to perform a major upgrade for an existing Remote Agent using its Docker image. This procedure covers pulling the latest image, creating a backup of the existing container, preserving essential environment variables, and restarting the newly upgraded agent.

Before you begin

This procedure assumes you've already selected the Remote Agent upgrade option and are viewing the Major Upgrade dialog.

In the Major Upgrade dialog, copy the Docker command and paste it here for later use:

DOCKER_COMMAND

Upgrade existing Remote Agent

To upgrade an existing Remote Agent using it's Docker image, follow these steps:

Run the following command to list the current running Docker containers to identify your agent's container ID and name:
```
dockerps
```
Enter your agent's container ID and name:
```
CONTAINER_ID
```
```
AGENT_NAME
```
Run the following command to pull the latest Docker image to your machine: You can change the latest tag to a specific version, such as 1.4.8.3.
```
dockerpullus-docker.pkg.dev/siem-ar-public/images/agent:latest
```
Run the following command to copy the modified environment variables to a local temporary file:
```
dockerexecCONTAINER_IDcat/home/siemplify_agent/.bash_profile>temp_bash_profile.txt
```
Run the following command to stop the agent's Docker container:
```
dockerstopCONTAINER_ID
```
Run the following command to rename the container to create a backup:
```
dockerrenameAGENT_NAMEAGENT_NAME_backup
```
Run the new agent image. If you have used a specific version for the latest tag in the previous step, user the same tag here:
```
DOCKER_COMMAND
```
Run the following command to list the running Docker containers to find the new container ID:
```
dockerps
```
Enter your agent's new container ID:
```
NEW_CONTAINER_ID
```

Run the following command to copy the original contents of .bash_profile to the new container:

cattemp_bash_profile.txt|dockerexec-i
NEW_CONTAINER_IDsh-c'cat> /home/siemplify_agent/.bash_profile'

Run the following command to restart the agent service to apply the modified environment variables:
```
dockerexecNEW_CONTAINER_IDsupervisorctlrestartall
```

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