TPA installation¶

TPAを使用するには、tpaexecをインストールしてtpaexec setup コマンドを実行する必要があります。このドキュメントでは、TPAパッケージをインストールする方法について説明します。

TPAパッケージは、プロスペクト（60日間の試用版）、有効なExtreme HAサブスクリプションをお持ちのEDBのお客様、または事前の手配によりご利用いただけます。アクセスをリクエストするには、アカウントマネージャーにお問い合わせください。

Debian 10（buster）、Ubuntu 22.04（jammy）、Ubuntu 20.04（focal）、Ubuntu 18.04（bionic）、RHEL / CentOS 7.xおよび8.x、Rocky 8.x、およびAlmaLinux 8.xのTPAパッケージを公開しています。これらのディストリビューションは、TPAが必要とするすぐに使用可能なPython 3.6+環境を提供します。ただし、TPAはより広い範囲の distributions on target instances をサポートしています。

クイックスタート¶

Configuring EDB Repos 2.0 repositories にログイン

あなたのトークンを取得します。次に、 <your-token> を自分のトークンに置き換えて、次のコマンドを実行します。

#  Add repository (Debian, Ubuntu)

$ curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.deb.sh | sudo -E bash

#  Add repository (RedHat, Rocky or AlmaLinux)

$ curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.rpm.sh | sudo -E bash

次に、次のコマンドを実行します。

#  Install packages (Debian, Ubuntu)

$ sudo apt-get install tpaexec

#  Install packages (RedHat, Rocky or AlmaLinux)

$ sudo yum install tpaexec

#  Install additional dependencies

$ sudo /opt/EDB/TPA/bin/tpaexec setup

#  Verify installation (run as a normal user)

$ /opt/EDB/TPA/bin/tpaexec selftest

より詳細な説明を以下に示します。

今何時？¶

さまざまなことが失敗するため、システムに正しい日付と時刻が設定されていることを絶対に確認してください。例：

$ sudo ntpdate pool.ntp.org

パッケージ¶

TPAをインストールするには、最初にそれを提供するEDBリポジトリにサブスクライブする必要があります。リポジトリの推奨ソースはEDB Repos 2.0です。

Configuring EDB Repos 2.0 repositories にログイン

あなたのトークンを取得します。次に、 <your-token> を自分のトークンに置き換えて、次のコマンドを実行します。

#  Debian or Ubuntu

$ curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.deb.sh | sudo -E bash

#  RedHat, Rocky or AlmaLinux

$ curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.rpm.sh | sudo -E bash

または、従来の2ndQuadrantリポジトリからTPAを取得することもできます。これを行うには、EDBカスタマーサポートポータルにログインし、: products/tpa/release

Support/Software/Subscriptionsでサブスクリプションを追加し、指示に従ってシステムでリポジトリを有効にします。

これらのリポジトリのいずれかを有効にしたら、次のようにTPAをインストールできます。

#  Debian or Ubuntu

$ sudo apt-get install tpaexec

#  RedHat, Rocky or AlmaLinux

$ sudo yum install tpaexec

これにより、TPAが/opt/EDB/TPA にインストールされます。また、他の必要なパッケージ（Python 3.6以降など）がインストールされていることを確認します。

ここでは、ルート権限が必要なコマンドを示すためにのみ sudo について説明します。他の方法を使用して、ルートとしてコマンドを実行できます。

Python環境¶

次に、 tpaexec setup を実行して分離されたPython環境を作成し、必要なすべてのモジュールの正しいバージョンをインストールします。

注釈

20.04より前のUbuntuバージョンでは、 sudo -H tpaexec setup を使用してください（tpaexec configure 中の後続のパーミッションエラーを回避するため）

$ sudo /opt/EDB/TPA/bin/tpaexec setup

これは/opt/EDB/TPA に書き込むため、rootとして実行する必要がありますが、このプロセスはインストールしたシステム全体のPythonモジュール（Ansibleを含む）には影響しません。

通常tpaexec コマンドを実行するユーザーのPATH に/opt/EDB/TPA/bin を追加します。たとえば、これを .bashrc または同等のシェル構成ファイルに追加できます。

$ export PATH=$PATH:/opt/EDB/TPA/bin

ネットワークアクセスなしでインストール¶

tpaexec setup を実行すると、通常はネットワークからPythonパッケージがダウンロードされます。 tpaexec-deps パッケージ（tpaexecと同じリポジトリから入手可能）には、ダウンロードされるすべてがバンドルされているため、ネットワークにアクセスせずにインストールできます。 tpaexec setup を実行する前にパッケージをインストールするだけで、バンドルされたコピーが自動的に使用されます。

検証¶

上記の手順をすべて完了したら、次のコマンドを実行してローカルインストールを確認します。

$ tpaexec selftest

そのコマンドがエラーなしで完了したら、TPAインストールを使用する準備が整います。

アップグレード¶

TPAの新しいリリースにアップグレードするには、次のことを行う必要があります。

1.最新のtpaexec パッケージをインストールします

2.最新のtpaexec-deps パッケージをインストールします（必要な場合。上記を参照）

tpaexec setup を再度実行します

上記のようにTPAパッケージリポジトリをサブスクライブしている場合、 apt-get update && apt-get upgrade またはyum update を実行すると、これらのパッケージの利用可能な最新バージョンがインストールされます。そうでない場合は、利用可能な任意の方法でパッケージをインストールできます。

tpaexec の新しいバージョンをインストールするたびに、 tpaexec setup を再度実行することをお勧めします。新しいリリースの中には、これを厳密に必要としないものもありますが、それなしでは動作しません。

Ansibleコミュニティのサポート¶

TPAはansibleコミュニティをサポートするようになりました。 tpaexec setup 中に--use-community-ansible オプションを使用して使用することを選択できます。デフォルトでは、従来の2ndQuadrant/ansibleフォークが使用されます。これは将来のリリースで変更され、 2ndQuadrant/ansible のサポートが終了し、コミュニティansibleが新しいデフォルトになります。

顕著な違い:

--skip-flags オプションをコミュニティの動作に変更します。リストの一部が--skip-tags オプションに指定されている場合、特別なタグalways でタグ付けされている場合でもタスクがスキップされます。 TPAは、完全な展開を保証するためにalways タグ付けされたすべてのタスクが実行されることを想定しています。そのため、コミュニティansibleを使用する場合は--skip-tags を使用しないでください。