Upgrade or Uninstall Bindplane Server

NOTE

We recommend backing up your environment prior to an upgrade. See our Backup and Disaster Recovery Guide.

Upgrading Bindplane Server

Upgrading the Bindplane Server is as simple as re-running the install script without the --init flag. A convenient piped one liner is below.

curl -fsSlL https://storage.googleapis.com/bindplane-op-releases/bindplane/latest/install-linux.sh | bash -s --

Additionally, if you want to upgrade to a specific version, you can do it using the below command. Replace 1.72.1 with the specific version you want.

curl -fsSlL https://storage.googleapis.com/bindplane-op-releases/bindplane/latest/install-linux.sh | bash -s -- --version 1.72.1

After upgrading you will need to restart the Bindplane Server.

sudo systemctl restart bindplane

Older Transform Agent binaries

Each Bindplane release ships a versioned Transform Agent binary into /var/lib/bindplane/transform-agents/. Older bta-v* binaries are left in place during upgrades, and on service start the Bindplane Server launches every binary in this directory as a subprocess to support Live Preview for collectors on different versions.

If you'd prefer not to keep older bta-v* binaries around, you're free to remove all but the latest. The server runs fine with every version present; trimming simply reduces startup time and idle subprocesses. The change takes effect at the next service start.

Downgrading Bindplane Server

WARNING

Downgrading is generally not recommended.

If you need to downgrade, please contact the Bindplane support team.

Uninstall Bindplane Server

1. Stop the process:

sudo systemctl disable bindplane && sudo systemctl stop bindplane

1. Remove the package

• Debian and Ubuntu:

sudo apt-get remove bindplane-ee -y && sudo apt-get purge bindplane-ee -y

• CentOS and RHEL 8 and newer (use yum for anything older)

sudo dnf remove bindplane-ee -y

1. Optionally remove leftover data

sudo rm -rf /etc/bindplane /var/lib/bindplane /var/log/bindplane