Updating the Bindplane Distro for OpenTelemetry Collector

Update requirements

The first thing to consider when updating your collectors is the method you would like to use going forward, and versioning rules and guidelines in your organization. Typically, collector updates are independent from Bindplane updates, but to use the newer features in Bindplane you will want to update the collectors as well. It is a preferred strategy to stay up-to-date on collectors for the most part.

That is not to imply you need an aggressive update schedule, but catching up on agent versions before a Bindplane update is generally recommended.

Update through the UI

By far the easiest method, you can either select individual agents and select the 'Upgrade to' blue link next to the version, or you can go into the 'AGENTS' tab and select multiple agents and click the 'Upgrade x Outdated Agents' button. Nothing special will need to be done and the agent will be upgraded.

Update through Terminal/Command Prompt and Detached Collectors

You can run a in-place upgrade through the command line or terminal. This is not recommended but could be used in some versioning strategies. To do that, you would simply run the collector install script again with the new version. You can obtain the collector install script by going to the 'AGENTS' page and selecting the blue '+ Install Agent' button on the top right, for managed collectors, or running the install script using the latest collector version for unmanaged/detached collectors. Example:

sudo sh -c "$(curl -fsSlL 'https://github.com/observIQ/bindplane-agent/releases/latest/download/install_unix.sh')" install_unix.sh

Update through CLI

There are CLI commands to update agents as well. If you are using the CLI and have it configured, you can run:

bindplane get agents

To show the connected agents and their ID which you will use in the following command. Then run:

bindplane update agent {ID}

Update to V2 Collector

At this time we do not recommend updating a v1 collector to a v2 collector. If you do wish to use the v2 collector, it is recommended to do a fresh install.