TPA installation¶
TPAを使用するには、tpaexecをインストールしてtpaexec setup
コマンドを実行する必要があります。このドキュメントでは、TPAパッケージをインストールする方法について説明します。サポートされているプラットフォームについては、
配布サポート を参照してください。
TPAパッケージは、見込み客（60日間の試用版）、有効なExtreme HAサブスクリプションをお持ちのEDB顧客、または事前の手配により利用できます。アカウントマネージャーに連絡して、アクセスをリクエストしてください。
注釈
さまざまなことが失敗するため、システムに正しい日付と時刻が設定されていることを絶対に確認してください。 sudo ntpdate pool.ntp.org などのネットワーク時間を使用することをお勧めします
クイックスタート¶
EDB Repos 2.0 にログイン
あなたのトークンを取得します。次に、 <your-token>
をトークンに置き換えて、次のコマンドを実行します。
DebianまたはUbuntuにリポジトリを追加し、TPAをインストールする¶
curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/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>/postgres_distributed/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 にログイン
あなたのトークンを取得します。次に、 <your-token>
をトークンに置き換えて、次のコマンドを実行します。
DebianまたはUbuntuにリポジトリを追加する¶
curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.deb.sh | sudo -E bash
RHEL、Rocky、AlmaLinux、またはOracle Linuxにリポジトリを追加します¶
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またはUbuntuにインストールする¶
sudo apt-get install tpaexec
RHEL、Rocky、AlmaLinuxまたはOracle Linuxにインストール¶
sudo yum install tpaexec
これにより、TPAが/opt/EDB/TPA
にインストールされます。また、他の必要なパッケージ（Python
3.6以降など）がインストールされていることも確認します。
ここでは、どのコマンドにroot権限が必要かを示すためにのみ、 sudo
について言及します。他の方法を使用して、ルートとしてコマンドを実行できます。
TPA 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
を実行する前にパッケージをインストールするだけで、バンドルされたコピーが自動的に使用されます。
TPAのインストールの確認¶
上記の手順をすべて完了したら、次のコマンドを実行してローカルインストールを確認します。
tpaexec selftest
そのコマンドがエラーなしで完了した場合、TPAインストールを使用する準備が整います。
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オプションをコミュニティの動作に変更します。ここでは、特別なタグalwaysでもタグ付けされている場合でも、--skip-tagsオプションに指定されたリストの一部であればタスクがスキップされます。 TPAは、alwaysタグ付けされたすべてのタスクが実行されて完全なデプロイメントが保証されることを想定しています。そのため、コミュニティansibleを使用する場合は--skip-tagsを使用しないでください。
