barman-cloud-wal-archive command not found" after upgrading the barman-cli package

After an update of the Barman 2.10 package to a more recent version of Barman using yum update or apt upgrade, the archive_command of PostgreSQL that sends WALs to an object store fails with the following error:

barman-cloud-wal-archive: command not found

An equivalent error is thrown by Barman in case barman-cloud-wal-archive is used as a WAL archive hook script.

Similarly, also barman-cloud-backup fails:

barman-cloud-backup: command not found

On RHEL/CentOS:

yum install barman-cli-cloud

On Debian/Ubuntu:

apt-get install barman-cli-cloud

Please verify that you have got barman-cli installed via package.

On RHEL/CentOS you can type:

# rpm -qa | grep barman-cli
barman-cli-2.11-1.el7.noarch

The above command must return one line, stating that you are using version 2.11 or higher.

Alternatively, verify that the yum info barman-cli command returns something similar:

Name : barman-cli
Arch : noarch
Version : 2.11
Release : 1.el7
Size : 43 k
Repo : installed
From repo : 2ndquadrant-dl-default-release-pg12
Summary : Client Utilities for Barman, Backup and Recovery Manager for
: PostgreSQL
URL : https://www.pgbarman.org/
License : GPLv3
Description : Client utilities for the integration of Barman in
: PostgreSQL clusters.
:
: Barman (Backup and Recovery Manager) is an open-source
: administration tool for disaster recovery of PostgreSQL servers
: written in Python. It allows your organization to perform remote
: backups of multiple servers in business critical environments to
: reduce risk and help DBAs during the recovery phase.
:
: Barman is distributed under GNU GPL 3 and maintained by
: 2ndQuadrant.

On Debian/Ubuntu, you can verify the package is installed with:

# dpkg -s barman-cli | grep Version

If you require more information:

# apt-cache policy barman-cli

Due to issues with dependencies for the boto3 library on Linux systems, starting with Barman 2.11 the cloud client utilities are part of a separate package called barman-cli-cloud. These include:

• barman-cloud-backup
• barman-cloud-backup-list
• barman-cloud-restore
• barman-cloud-wal-archive
• barman-cloud-wal-restore

Two of them, barman-cloud-backup and barman-cloud-wal-archive, had been released in version 2.10 as part of the barman-cli package. Therefore, upgrading from 2.10 to a newer version of Barman removes these two utilities. If you were using them, your system will be affected.

Installing the barman-cloud-cli package will fix the issue.