Search in docs

Results ..

No results for ''
Search by Algolia

Upgrade

Upgrade Agent

We recommend to keep your Agent up-to-date to benefit for improved security, reliability and performance.

We recommend that you make sure at least once a month that your agent is up to date.

Standard Method

If you installed Bleemeo agent with the standard method, it's using your system packaging tools. Therefore upgrade is done by those tools (apt, yum, dnf...).

For detailed instruction per distribution:

Using Docker

When using Docker, you will need to pull new images before re-creating containers.

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 and on Docker Store.

Bleemeo Agent is a Docker Certified Container. The Docker Certification program is a framework for partners to integrate and certify their technology to the Docker Enterprise Edition (EE) commercial platform.

Bleemeo Agent is a Docker Certified Container

To upgrade your agent, you may use 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 containers. It the same steps as 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" \
-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 CAP_SYS_PTRACE bleemeo/bleemeo-agent

Using Docker Compose

Update the :download:Docker compose file </resources/bleemeo-agent/docker-compose.yml>. Or copy/paste the following content:

Update the Docker compose file.

Edit the docker-compose file, and set value for GLOUTON_BLEEMEO_ACCOUNT_ID and GLOUTON_BLEEMEO_REGISTRATION_KEY, e.g. something like

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

Then pull new images:

$ docker-compose pull

Run Docker compose:

$ docker-compose up -d

Upgrade Agent on Windows

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

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

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

Running Installer

Download the installer on Bleemeo.

Run the installer, it will upgrade your Agent.

Unattended Upgrade

Installer can be run with option to hide wizard (useful if you are deploying on several servers):

bleemeo-agent_latest.exe /S

Upgrade Agent on CentOS with Packages

This page details step to upgrade 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
This will upgrade all installed software, not only Bleemeo agent. While it's a best practice to keep you 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 step to upgrade Bleemeo agent and its dependencies on a Debian or Ubuntu systems.

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
This will upgrade all installed software, not only Bleemeo agent. While it's a best practice to keep you 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 Bleemeo repository being disable. This may happen after upgrading your distribution (for example upgrade from Ubuntu 16.04 to Ubuntu 18.04).

If that happen, 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 and /etc/apt/sources.list.d/bleemeo-jmxtrans.list: uncomment the line and update the distribution codename (for example change "xenial" in "bionic").

Upgrade Agent on Fedora with Packages

This page details step to upgrade 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
This will upgrade all installed software, not only Bleemeo agent. While it's a best practice to keep you 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 step to upgrade 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
This will upgrade all installed software, not only Bleemeo agent. While it's a best practice to keep you 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