TPA installation

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

TPAパッケージは、見込み客（60日間の試用版）、有効なExtreme HAサブスクリプションをお持ちのEDB顧客、または事前の手配により利用できます。アカウントマネージャーに連絡して、アクセスをリクエストしてください。

配布サポート

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

クイックスタート

あなたのトークンを取得します。次に、 <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です。

あなたのトークンを取得します。次に、 <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以降など）がインストールされていることも確認します。

ここでは、どのコマンドにroot権限が必要かを示すためにのみ、 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

インターネットまたはネットワークアクセスなしでTPAをインストールする（エアギャップ）

このセクションでは、EDBリポジトリ、Pythonパッケージインデックス、またはその両方にアクセスできないサーバーにTPAをインストールする方法について説明します。このような環境でのTPAの使用方法については、 Managing clusters in a disconnected or air-gapped environmentをご覧ください

TPAパッケージのダウンロード

TPAをインストールする必要があるサーバーからEDBリポジトリに直接アクセスできない場合は、インターネットに接続されたマシンからパッケージをダウンロードして転送できます。これを達成するにはいくつかの方法があります。

インターネットに接続されたマシンがターゲットと同じオペレーティングシステムを使用している場合は、 yumdownloader （RHEL風）またはapt download （Debian風）を使用してパッケージをダウンロードすることをお勧めします。

これが不可能な場合は、EDBサポートに連絡してください。サブスクリプションに適したダウンロードリンクまたは手順を提供します。

Pythonパッケージインデックスにアクセスせずにインストールする

tpaexec setup を実行すると、通常、PythonパッケージインデックスからPythonパッケージがダウンロードされます。あなたの環境が別のインデックスを提供しない限り、デフォルトは公式の

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

検証

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

$ tpaexec selftest

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

アップグレード

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

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

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

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