TPA installation#

TPAを使用するには、パッケージまたはソースからインストールし、tpaexec setup コマンドを実行する必要があります。このドキュメントでは、TPAパッケージをインストールする方法について説明します。 EDBサブスクリプションプランを契約しており、EDBリポジトリにアクセスできる場合、これらの手順に従う必要があります。ソースからTPAをインストールするには、

Installing TPA from source を参照してください。

サポートされているプラットフォームについては、

Distribution support を参照してください。

注釈

Please make absolutely sure that your system has the correct date and time set, because various things will fail otherwise. We recommend you use a network time, for example sudo ntpdate pool.ntp.org

クイックスタート#

EDB Repos 2.0 にログイン

トークンを取得します。次に、次のコマンドを実行します。

DebianまたはUbuntuにリポジトリを追加し、TPAをインストールします#

curl -1sLf https://downloads.enterprisedb.com/<your-token>/<your-plan>/setup.deb.sh | sudo -E bash
sudo apt-get install tpaexec

RHEL、Rocky、AlmaLinux、またはOracle Linuxにリポジトリを追加し、TPAをインストールします#

curl -1sLf https://downloads.enterprisedb.com/<your-token>/<your-plan>/setup.rpm.sh | sudo -E bash
sudo yum install tpaexec

追加の依存関係をインストールする#

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

インストールの検証一般のユーザーとして実行#

/opt/EDB/TPA/bin/tpaexec selftest

各ステップのより詳細な説明を以下に示します。

TPAをインストールする場所#

サポートされているプラットフォームを使用している限り、TPAはワークステーションからインストールして実行できます。これは、学習、ローカルテスト、またはデモンストレーションの目的に適しています。 TPAは deploying to Docker containers をサポート

独自のワークステーションで完全な展開を実行したい場合。

運用環境で使用する場合、専用の永続的な仮想マシンでTPAを実行することをお勧めします。これにより、クラスターディレクトリが保持され、将来のクラスター管理または更新にチームが利用できるためです。また、TPAのコピーを1つだけ更新する必要があり、単一のTPAホストからターゲットインスタンスへのネットワークアクセスを提供するだけであることも意味します。

TPAパッケージのインストール#

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

EDB Repos 2.0 にログイン

トークンを取得します。次に、次のコマンドを実行します。

DebianまたはUbuntuにリポジトリを追加する#

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

RHEL、Rocky、AlmaLinux、またはOracle Linuxにリポジトリを追加します#

curl -1sLf https://downloads.enterprisedb.com/<your-token>/<your-plan>/setup.rpm.sh | sudo -E bash
または、古い2ndQuadrantリポジトリからTPAを取得することもできます。これを行うには、EDBカスタマーサポートポータルにログインし、

products/tpa/release を購読します。

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

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

DebianまたはUbuntuにインストールする#

sudo apt-get install tpaexec

RHEL、Rocky、AlmaLinux、またはOracle Linuxにインストールする#

sudo yum install tpaexec

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

ここでsudo について言及しているのは、どのコマンドがroot権限を必要とするかを示すためです。他の手段を使用して、rootとしてコマンドを実行できます。

TPA Python環境のセットアップ#

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

注釈

On Ubuntu versions prior to 20.04, please use sudo -H tpaexec setup to avoid subsequent permission errors during 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 を実行する前にパッケージをインストールするだけで、バンドルされたコピーが自動的に使用されます。

TPAインストールの検証#

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

tpaexec selftest

そのコマンドがエラーなしで完了した場合、TPAインストールは使用できる状態です。

TPAのアップグレード#

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

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

  2. 最新のtpaexec-deps パッケージ必要な場合、上記を参照してください。

  3. tpaexec setup を再度実行します

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

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

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

TPAは、デフォルトでansibleのコミュニティディストリビューションを使用するようになりました。 --use-2q-ansible オプションをtpaexec setup に渡すことにより、2ndQuadrant / ansibleフォークを継続して使用できます。将来のTPAリリースでは、2ndQuadrantアンシブルフォークのサポートが削除されます。