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 collector versions before a Bindplane update is generally recommended.

Update through the UI

By far the easiest method, you can either select individual collectors and select the 'Upgrade to' blue link next to the version, or you can go into the 'COLLECTORS' tab and select multiple collectors and click the 'Upgrade x Outdated Collectors' button. Nothing special will need to be done and the collector 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 'COLLECTORS' page and selecting the blue '+ Install Collector' 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 collectors as well. If you are using the CLI and have it configured, you can run:

bindplane get collectors

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

bindplane update collector {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.