Upgrade

Upgrade Agent

We recommend keeping your agent up-to-date to benefit from improved security, reliability and performance.

We recommend checking at least once a month that your agent is up to date.

Bleemeo agent auto-upgrade

If you installed Bleemeo agent with the standard method, it will auto-upgrade itself by default.

If Bleemeo agent is installed using standard method or using packages for your Linux distribution, you can enable auto-upgrade by running:

sudo systemctl enable --now glouton-auto-upgrade.timer

The auto-upgrade will check and install newer version of Bleemeo agent every week day (Monday to Friday) between 7h to 19h.

If you prefer to upgrade the Bleemeo agent manually, you can disable auto-upgrade with:

sudo systemctl disable --now glouton-auto-upgrade.timer

Then follow instructions below to apply upgrade.

Standard Method on Linux

If you installed the Bleemeo agent with the standard method, it uses your system packaging tools. The upgrade is therefore done by those tools (apt, yum, dnf…).

Note

This section does not apply to Bleemeo agent installed using Docker. See Docker section for steps to upgrade if Bleemeo agent is installed using Docker.

For detailed instructions per distribution:

• Upgrade Agent on Debian/Ubuntu with Packages for Debian & Ubuntu
• or Upgrade Agent on CentOS with Packages for CentOS
• or Upgrade Agent on Red Hat Enterprise Linux with Packages for Red Hat Enterprise Linux
• or Upgrade Agent on Fedora with Packages for Fedora.
• or Upgrade Agent on Windows for Windows

Standard Method on TrueNAS CORE

On TrueNAS CORE you can check and install the new Bleemeo agent version by running the following in a shell:

service glouton upgrade

This command does not work for TrueNAS SCALE. Use upgrade on TrueNAS SCALE instead.

Upgrade Agent Using Docker

If you followed Install Agent Using Docker, here are the steps to follow to upgrade your agent.

Before upgrading Bleemeo agent, please check that you meet the system requirements.

Bleemeo provides official images on Docker Hub.

To upgrade your agent, you can use either the docker run command or docker compose.

Using Docker Run Command

If you run Bleemeo agent using Docker image, you will need to pull again the images to get their latest versions before restarting Docker container. Containers do not hold any state data; the agent state is stored on your host, thanks to -v /var/lib/glouton:/var/lib/glouton.

Pulling new images:

docker pull bleemeo/bleemeo-agent

Remove old containers:

docker stop bleemeo-agent
docker rm bleemeo-agent

Re-create the containers. The steps are the same as the installation with Install Agent Using Docker:

export GLOUTON_BLEEMEO_ACCOUNT_ID=<YOUR-ACCOUNT-ID>
export GLOUTON_BLEEMEO_REGISTRATION_KEY=<YOUR-REGISTRATION-KEY>

docker run -d --name="bleemeo-agent" --restart unless-stopped \
    -v /var/lib/glouton:/var/lib/glouton -v /var/run/docker.sock:/var/run/docker.sock -v /:/hostroot:ro \
    -e GLOUTON_BLEEMEO_ACCOUNT_ID -e GLOUTON_BLEEMEO_REGISTRATION_KEY \
    --pid=host --net=host --cap-add SYS_PTRACE --cap-add SYS_ADMIN bleemeo/bleemeo-agent

Using Docker Compose

Download or copy-paste the latest version of the docker compose file from github.

Edit the docker-compose file and set the values for GLOUTON_BLEEMEO_ACCOUNT_ID and GLOUTON_BLEEMEO_REGISTRATION_KEY, for example:

[...]
    environment:
    - GLOUTON_BLEEMEO_ACCOUNT_ID=91bd2bba-ad84-40eb-9eff-07e5a961285a
    - GLOUTON_BLEEMEO_REGISTRATION_KEY=199390d7-8fc7-4a06-b3eb-53e574f5c7a0
[...]

Then pull the new images:

docker compose pull

Run Docker Compose:

docker compose up -d

Upgrade Agent on TrueNAS SCALE

When the Bleemeo agent was installed, the option pull_policy: always was set. To upgrade, you only need to stop and then start the bleemeo-agent application:

• On TrueNAS UI, go to Apps
• Click stop the bleemeo-agent application
• Then click start the bleemeo-agent application

Upgrade Agent on Windows

This page details the steps to upgrade the Bleemeo agent on a Windows system.

Before upgrading Bleemeo agent, please check that you meet the system requirements.

The Bleemeo agent can be upgraded on Windows with a classic installer. An unattended upgrade is also available.

Running Installer

Download the installer on Bleemeo.

Run the installer. It will upgrade your agent.

Unattended Upgrade

The installer can be run with an option to hide the wizard (this is useful if you are deploying on several servers). Run the following command as administrator on your server:

msiexec /i bleemeo-agent_latest.msi /qr

Upgrade Agent on CentOS with Packages

This page details the steps to upgrade the Bleemeo agent on a CentOS system.

Before upgrading Bleemeo agent, please check that you meet the system requirements.

The agent works with your native packaging tools. For CentOS the agent uses rpm packages.

Upgrade Your System

The agent could be upgraded with the rest of your system with:

sudo yum update

Note

This will upgrade all installed software, not only Bleemeo agent. While it’s a best practice to keep your system up-to-date, be aware that some service may be restarted during the upgrade and may cause disruption.

Upgrade only the Agent

If you want to only upgrade Bleemeo agent you may use:

sudo yum update bleemeo-agent glouton

Upgrade Agent on Debian/Ubuntu with Packages

This page details the steps to upgrade the Bleemeo agent and its dependencies on a Debian or Ubuntu system.

Before upgrading Bleemeo agent, please check that you meet the system requirements.

The agent works with your native packaging tools. For Debian/Ubuntu the agent uses APT and deb package.

Upgrade Your System

The agent could be upgraded with the rest of your system with:

sudo apt-get update
sudo apt-get upgrade

Note

This will upgrade all installed software, not only Bleemeo agent. While it’s a best practice to keep your system up-to-date, be aware that some service may be restarted during the upgrade and may cause disruption.

Upgrade only the Agent

If you want to only upgrade Bleemeo agent you may use:

sudo apt-get update
sudo apt-get install bleemeo-agent glouton

Troubleshoot

If the above command does not upgrade your agent, it may be due to the Bleemeo repository being disabled. This may happen after upgrading your distribution (for example, upgrading from Ubuntu 16.04 to Ubuntu 18.04).

If that happens, re-enable the repository by either:

• Re-running the wget -qO- "https://get.bleemeo.com?accountId=<YOUR ACCOUNT_ID>&registrationKey=<YOUR_REGISTRATION_KEY>" | sh
• Edit /etc/apt/sources.list.d/bleemeo-agent.list: uncomment the line and update the distribution codename (for example change “xenial” to “bionic”).

Upgrade Agent on Fedora with Packages

This page details the steps to upgrade the Bleemeo agent and its dependencies on a Fedora system.

Before upgrading Bleemeo agent, please check that you meet the system requirements.

The agent works with your native packaging tools. For Fedora the agent uses rpm packages.

Upgrade Your System

The agent could be upgraded with the rest of your system with:

sudo dnf update

Note

This will upgrade all installed software, not only Bleemeo agent. While it’s a best practice to keep your system up-to-date, be aware that some service may be restarted during the upgrade and may cause disruption.

Upgrade only the Agent

If you want to only upgrade Bleemeo agent you may use:

sudo dnf update bleemeo-agent glouton

Upgrade Agent on Red Hat Enterprise Linux with Packages

This page details the steps to upgrade the Bleemeo agent and its dependencies on a Red Hat Enterprise Linux system.

Before upgrading Bleemeo agent, please check that you meet the system requirements.

The agent works with your native packaging tools. For RHEL the agent uses rpm packages.

Upgrade Your System

The agent could be upgraded with the rest of your system with:

sudo yum update

Note

This will upgrade all installed software, not only Bleemeo agent. While it’s a best practice to keep your system up-to-date, be aware that some service may be restarted during the upgrade and may cause disruption.

Upgrade only the Agent

If you want to only upgrade Bleemeo agent you may use:

sudo yum update bleemeo-agent glouton

Manual Method

To upgrade the Bleemeo agent, you only need to upgrade the binary. If you did a manual installation by following our steps, Bleemeo agent is installed in “/usr/local/sbin/glouton”. Therefore to upgrade:

• Stop the Bleemeo agent:

  sudo -u glouton pkill glouton

• Re-download the latest agent:

  wget https://packages.bleemeo.com/bleemeo-agent/glouton-$(uname -m).bin
  sudo mv glouton-$(uname -m).bin /usr/local/sbin/glouton

• Start the agent as you did during installation. For example to run it on foreground:

  sudo -u glouton /usr/local/sbin/glouton