If you’re running an agent with a lower version than 2020.08.04.01, please refer to the August 2020 Update documentation for information on updating to the latest version of the Loome Agent.
Updating the Loome Agent varies depending on the platform you’re hosting it on, below is a summary of the required action for each platform in order to update the agent.
|Hosting Method||How to Update||Update Details|
|Windows Service||Rerun the install script from Loome Integrate.||Updating Hosted Agent Services|
|Linux Service||Rerun the install script from Loome Integrate.||Updating Hosted Agent Services|
|Azure Container Instances||Restart your container instance, the latest version is pulled as part of the restart.||Updating Azure Container Instances Agent|
||Pull the latest image, remove your current container and the recreate the container with the latest image.||Updating Docker Agents (Using Docker Run)|
|Docker (Portainer, Fargate, etc)||Refer to your provider’s documentation.||Updating Docker Agents (Non-Azure Container Service)|
To update Loome Agents running as a Windows service or Linux systemd daemon, simply run the same script you used to install in the agent in the first place. The script will automatically detect if the agent is already installed and update it, restarting the existing service in the process.
You do not have to use the exact same script that was used to install the agent in the first place. Whilst it’s convenient to save the script in an easy to remember location, you can easily redownload the script from your tenant if you lose it.
Azure Container Instances are stateless when restarted. Unlike containers ran locally using Docker, restarting an Azure Container instance will drop the previous filesystem and start from new.
The benefit to this is that in the process of restarting the container, the latest version of the container’s image is pulled and used. This means to update an Azure Container Instance, simply find the container in the Azure Portal and click “Restart”.
To update a locally hosted Docker container agent, you will need to have the
docker run command handy from the installation of the
agent in the first place.
With this command you need to do the following:
This means that the general series of commands for updating the agent would look like:
docker pull loomesoftware/agent docker rm example-agent docker run example-agent ... # The rest of the command
With tools like Portainer and Amazon Fargate, the process for updating the container is a case of restarting the container and as is the case with Azure Container Instances; the latest version is downloaded in the process.
If you require any help with your container hosting service of choice, please contact us at email@example.com