# 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:

```bash
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:

```bash
bindplane get agents
```

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

```bash
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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/configuration/bindplane-otel-collector/updating-the-bindplane-distro-for-opentelemetry-collector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.