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

Gabriele Bartolini
Gabriele Bartolini


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



yum install barman-cli-cloud

On Debian/Ubuntu:

apt-get install barman-cli-cloud

Diagnostic Steps

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

On RHEL/CentOS you can type:

# rpm -qa | grep barman-cli

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

Root Cause

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.

Was this article helpful?

0 out of 0 found this helpful