Installation

重要

Barmanをインストールする推奨方法は、 GNU/ Linuxディストリビューションションで利用可能なパッケージソフトを使用することです。

RPMパッケージソフトを使用したRedHat / CentOSへのインストール

Barmanは、RPMパッケージソフトを使用してRHEL7およびRHEL6 Linuxシステムにインストールできます。 Extra Packages Enterprise Linux(EPEL)リポジトリと PostgreSQL Global Development Group RPM repository を事前にインストールする必要があります。

Barmanの公式RPMパッケージソフトは、 EnterpriseDBがYumを介して public RPM repository 経由で配布します。そのウェブサイトに記載されている指示に従ってください。

次に、 root として次のように入力します。

yum install barman

注: > Barman関連のパッケージソフトは、PGDGリポジトリを介して更新されないようにすることをお勧めします。これは、以下の行を追加することで実行できます>内のBarmanサーバーに含まれるPGDGリポジトリ定義> /etc/yum.repos.d/pgdg-*.repo ファイル:edb_notranlate_2>これを行うことで、 Barmanソフトウェアのパッケージ管理にのみEnterpriseDBリポジトリを使用します。

注釈

PGDGリポジトリを介したBarman関連パッケージソフトの更新を除外することをお勧めします。これは、 /etc/yum.repos.d/pgdg-*.repo ファイル内のBarmanサーバーに含まれるPGDGリポジトリ定義に次の行を追加することで実行できます。edb_notranlate_2これを行うことで、 Barmanソフトウェアのパッケージ管理のみをEnterpriseDBリポジトリに依存します。

歴史的な理由により、 EnterpriseDBは Sourceforge.net を通じてBarmanのパッケージディストリビューションを維持し続けます。

パッケージソフトを使用したDebian / Ubuntuへのインストール

Barmanは、パッケージソフトを使用してDebianおよびUbuntu Linuxシステムにインストールできます。

DebianおよびUbuntuの公式リポジトリで直接利用できますが、これらのリポジトリには利用可能な最新バージョンが含まれていない場合があります。 Barmanの最新バージョンが必要な場合、これらの両方のリポジトリをインストールするメソッドをお勧めします。

注釈

PostgreSQL Community APTリポジトリプロジェクトにBarman開発者が直接関与したおかげで、 Barmanの最新バージョンに常にアクセスできます。

Barmanのインストールは簡単です。 root ユーザとして単純に入力します:

apt-get install barman

パッケージソフトを使用したSLESへのインストール

PGDG SLES repositories で利用可能なパッケージソフトを使用して、

BarmanをSLESシステムにインストールできます。

PGDG site で利用可能な指示に従って、必要なリポジトリをインストールします。

サポートされているSLESバージョンは、SLES 12 SP5およびSLES 15 SP3です。

  • SLES 12のみ*:OpenSUSE pythonバックポートも有効にする必要があります リポジトリは次のとおりです(この手順はSLES 15では不要です)。

zypper addrepo https://download.opensuse.org/repositories/devel:languages:python:backports/SLE_12_SP5/devel:languages:python:backports.repo
zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/python:/backports/SLE_12_SP4 devel_languages_python_backports_sp4
zypper refresh

必要なリポジトリがインストールされたら、 Barmanを root ユーザとしてインストールできます。

zypper install barman

ソースからのインストール

警告

ソースからのBarmanの手動インストールは、 GNU / Linuxのエキスパートユーザーのみが実行する必要があります。この方法でBarmanをインストールするには、依存関係管理、 barman ユーザの作成、 barman.conf ファイルの構成、 barman cron コマンドのcronセットアップ、ログ管理などのシステム管理アクティビティが必要です。

backup サーバーで barman というシステムユーザを作成します。 barman ユーザとして、ソースをダウンロードして解凍します。

システム全体のインストールの場合、次を入力します。

barman@backup$ ./setup.py build
# run this command with root privileges or through sudo
barman@backup# ./setup.py install

ローカルインストールの場合、次のように入力します。

barman@backup$ ./setup.py install --user

barman アプリケーションは、ユーザディレクトリ make sure that your `PATH environment variable is set properly <https://docs.python.org/3/install/index.html#alternate-installation-the-user-scheme>`__ にインストールされます)。

Barman is also available on the Python Package Index (PyPI)。 pip からインストールできます。

PostgreSQLクライアントバイナリ

以下のBarman機能は、 PostgreSQLクライアントバイナリに依存しています。

これらのバイナリはPostgreSQLクライアントパッケージソフトとともにインストールされ、次の場所にあります。

  • RedHat / CentOSの場合: /usr/pgsql-${PG_MAJOR_VERSION}/bin

  • Debian / Ubuntuの場合: /usr/lib/postgresql/${PG_MAJOR_VERSION}/bin

次のいずれかを保証する必要があります。

  1. Barmanユーザは、そのパスに適切な PG_MAJOR_VERSION の bin ディレクトリを持っています。または、2.各サーバーのBarman構成で path_prefix オプションが設定され、適切な PG_MAJOR_VERSION の bin ディレクトリを指します。

Upgrading Barman

Barmanはトランクベースの開発パラダイムに従っています。そのため、最新の安定(stable)バージョンは1つだけです。コミットのたびに、 Barmanは、サポートされている各PostgreSQLバージョンおよびサポートされている各Linuxディストリビューションに対して数千の自動テストを実施します。

また、 すべてのバージョンは以前のものと互換性があります 。したがって、 Barmanのアップグレード処理には通常、 yum update または apt update を使用したパッケージソフトのシンプル更新が必要です。

ただし、開発履歴には次の例外があり、構成に若干の変更が必要でした。

Barman 2.10からのアップグレード

barman-cloud-wal-archive または barman-cloud-backup を使用している場合、バージョン2.11からすべてのクラウドユーティリティが新しい barman-cli-cloud パッケージに移動されていることに注意する必要があります。したがって、 barman-cli-cloud パッケージが最新バージョンへのアップグレードのパートとして適切にインストールされていることを保証必要があります。上記のツールを使用していない場合は、通常どおり最新バージョンにアップグレードできます。

Barman 2.Xからのアップグレード(2.8より前)

Barman 2.7のバージョンからアップグレード処理前に、プライマリーサーバの rsync バックアップメソッドの古いユーザーは、 ワーニングを明示的に concurrent_backup ( PostgreSQL 9.6以降に推奨)またはBarman (現在のデフォルト)に設定する必要があります。 。

Barman 1.Xからのアップグレード

Barmanインストールが1.Xの場合、アーカイビング戦略を明示的に構成する必要があります。以前は、 archiver によって制御されるファイルベースのアーカイバはデフォルトで有効になっていました。

Barmanインストールを最新バージョンにアップグレードmake前に、次の行をグローバルに、またはそれを必要とするサーバーに追加してください。

archiver = on

さらに、いくつかのリリースでは、 Barmanはアーカイビング戦略を明示的に設定していないサーバーで archiver = on を透過的に設定し、ワーニングを発します。