インストールする#

Barman公式パッケージは、 :term:`PGDG`によって提供されています。これらのパッケージは、オペレーティングシステムに付属するPython 3のデフォルトバージョンを使用します。

Barman機能スイートを構成する3つのパッケージ barman 、 barman-cli および barman-cli-cloud 。

  • barman はメインパッケージであり、インストールする必要があります。

  • barman-cli は、 barman-wal-restore および barman-wal-archive ユーティリティを保持するオプションパッケージです。このパッケージは、これらのユーティリティを archive_command または restore_command として使用する予定がある場合に必須です。 Barmanクラスターの一部である各Postgresサーバーにインストールする必要があります。

  • barman-cli-cloud は、クラウドプロバイダーでバックアップを管理するために使用できる barman-cloud-* クライアントスクリプトを保持するオプションパッケージです。 Barmanをバイパスして、クラウドプロバイダーに直接バックアップするPostgresサーバーにインストールする必要があります。

注釈

Barmanパッケージは、いくつかの異なるリポジトリで見つけることができます。互換性、安定性、最新の更新へのアクセスが保証されるため、 PGDGリポジトリの使用をお勧めします。

警告

別のリポジトリを使用してBarmanをアップグレードしないでください。そうすることで、各ソースリポジトリが異なる構成レイアウトを使用する異なるパッケージを提供するため、構成が失われるリスクがあります。

システム要件#

Barmanサーバーを実行するために必要な最小システム要件は次のとおりです。

  • LinuxオペレーティングシステムDebian、Ubuntu、RHEL、Rocky、FedoraなどまたはUNIX系オペレーティングシステムFreeBSD、OpenBSDなど

  • Python 3.8以降

  • Pythonモジュール

    • psycopg2 >= 2.4.2 Postgresサーバーに接続するために必要です

    • python-dateutil

    • setuptools

    • argcomplete オプショナル

  • PostgreSQLクライアントツール Postgresサーバーと対話するために必要です

  • PostgreSQLサーバー> = 13

  • rsync >= 3.1.0 リカバリーとRsyncバックアップに必要

  • boto3 >= 1.29.1 AWSのスナップショットロック機能と backup_method = snapshot を併用する場合に必要

  • file POSIXコマンド、通常は file パッケージで提供されます

バージョン 3.14 で非推奨: Pythonのバージョン3.6および3.7のサポートは非推奨になりました。 Barman 3.14はPython 3.6では動作しないことが知られています。 Python 3.7で動作する可能性がありますが、3.8より前のバージョンのPythonではテストされておらず、サポートされていません。

注釈

RedHat Enterprise Linux、RockyLinux、およびAlmaLinuxのユーザーは、`Extra Packages Enterprise Linux EPELリポジトリ<https://fedoraproject.org/wiki/EPEL>`をインストールする必要があります。

RHELベースのディストリビューション#

RHEL`システムおよびAlmaLinux、Oracle Linux、Rocky Linuxなどの同様のRHELベースのシステムに:term:`RPM`パッケージを使用して、 ``barman` 、 barman-cli および barman-cli-cloud をインストールできます。

インストールを始めるには、最初に PGDG RPM repository をインストールします。

重要

barman-cli-cloud スクリプトは、 PGDG`からのRHELベースのディストリビューションの ``barman-cli` パッケージの一部です。したがって、クラウドスクリプトを使用するには、 barman-cli をインストールするだけで済みます。

バーテンダー#

barman パッケージをインストールするには barman として実行します。

dnf install barman

barman-cli#

barman-cli パッケージをインストールするには、Postgresサーバーで barman-cli として実行します。

dnf install barman-cli

注釈

barman-cloudユーティリティを hook scripts として使用する場合、 Barmanサーバーに barman-cli パッケージをインストールする必要があります。

Debianベースのディストリビューション#

DebianシステムおよびUbuntuのようなDebianベースのシステムでは、 DEB`パッケージを使用して ``barman` 、 barman-cli 、および barman-cli-cloud をインストールできます。

インストールをはじめに、PGDG APTリポジトリをインストールします。これはシステムによって異なります。

重要

barman-cli-cloud パッケージは、 barman-cli のインストール時に推奨パッケージに含まれます。

インストールを開始する前に、ユースケースを評価することが重要です。 barman-cloud-backup などのbarman-cloudクライアントスクリプトを使用する予定がない場合は、 barman-cli のインストール時に推奨パッケージとして barman-cli-cloud のインストールをスキップできます。ただし、 barman-cloudクライアントスクリプトのみを使用する場合は、 barman-cli-cloud パッケージを自分自身でインストールできます。

バーテンダー#

barman パッケージをインストールするには barman として実行します。

apt install barman

barman-cli#

barman-cli パッケージをインストールするには、Postgresサーバーで barman-cli として実行します。

apt install barman-cli

barman-cli-cloud#

barman-cli-cloud パッケージをインストールするには、Postgresサーバーで barman-cli-cloud として実行します。

apt install barman-cli-cloud

注釈

barman-cloudユーティリティを hook scripts として使用する場合、このパッケージをBarmanサーバーにインストールする必要があります。

SLESベースのディストリビューション#

barman は、 :term: barman にインストールできます。

インストールを開始するには、 PGDG SLES Repository Configuration で入手可能な詳細な手順に従って、適切なリポジトリを追加する必要があります。

The current supported version for installation is SLES 15 SP6.

重要

barman-cli-cloud ユーティリティは、 PGDG`からのSLESベースのディストリビューションの ``barman-cli` パッケージの一部です。したがって、クラウドスクリプトを使用するには、 barman-cli をインストールするだけで済みます。

バーテンダー#

barman パッケージをインストールするには barman として実行します。

zypper install barman

barman-cli#

barman-cli パッケージをインストールするには、Postgresサーバーで barman-cli として実行します。

zypper install barman-cli

注釈

barman-cloudユーティリティを hook scripts として使用する場合、このパッケージをBarmanサーバーにインストールする必要があります。

追加要件#

クラウドストレージ統合やデータ圧縮などの一部のBarman機能は、オプションのPythonライブラリに依存しています。これらの依存関係は、システムのパッケージマネージャーを介してBarmanをインストールする場合、デフォルトでは含まれません。

barman-cloud 、スナップショットバックアップ、または特定の圧縮アルゴリズムなどの機能を有効にするには、以下の表にリストされている適切な追加依存関係をインストールする必要があります。これらの依存関係が、 Barmanが使用するのと同じPythonインタープリターにインストールされていることを確認します。

Optional Libraries

機能/プロバイダー

必要なライブラリ

AWS S3

boto3

AWS EC2スナップショット

boto3

Azure Blob Storage

azure-identity、azure-storage-blob

Azure VMのスナップショット

azure-identity、azure-storage-blob、azure-mgmt-compute

Google Cloud Storage

google-cloud-storage

GCPコンピューティングスナップショット

grpcio、google-cloud-storage、google-cloud-compute

スナッピー圧縮

python-snappy、cramjam >= 2.7.0

Zstandard圧縮

zstandard

LZ4圧縮

lz4

オートコンプリート

argcomplete

Tip

barman-cloud の使用時に ModuleNotFoundError が発生した場合は、次のことを確認します。

  1. Barmanが使用するのと同じPythonインタープリターを使用してライブラリをインストールしました。

  2. インストールは、許可やネットワークエラーなしで正常に完了しました。

On this page
ソースコードを表示