TPA installation#

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

ソースからTPAをインストールするには、 ソースからのビルドとインストール を参照してください。

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

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

注釈

システムの日付と時刻が正しいことを確認してください。そうしないと、さまざまな操作が失敗します。ネットワーク時間たとえば、sudo ntpdate pool.ntp.org を使用することをお勧めします。

クイックスタート#

トークンを取得するには、 EDB Repos 2.0 にログインします。次に、次のコマンドを実行して、<your-token> のトークンを置き換えます。購読しているEDBプランに応じて、 <your-plan> を次のいずれかに置き換えます。enterprise 、standard 、community360 、またはpostgres_distributed 。

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 にログインします。次に、次のコマンドを実行して、<your-token> のトークンを置き換えます。購読しているEDBプランに応じて、 <your-plan> を次のいずれかに置き換えます。enterprise 、standard 、community360 、またはpostgres_distributed 。

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 repository を購読します。

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以降などがインストールされていることも確認します。

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

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パッケージをダウンロードします。環境が別のインデックスを提供しない限り、デフォルトは公式の

PyPI です。使用可能なパッケージインデックスがない場合は、

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

TPAインストールの検証#

インストールが完了したら、ローカルインストールを確認します。

tpaexec selftest

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

TPAのアップグレード#

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

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

  2. 最新のtpaexec-deps パッケージをインストールします必要な場合。 Pythonパッケージインデックスへのアクセスを使用しないインストール を参照してください。

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

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

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

Ansibleバージョン#

TPAは、デフォルトでAnsibleバージョン8 ansible-core 2.15を使用します。 --use-2q-ansible オプションをtpaexec setup に渡すことにより、2ndQuadrant Ansibleバージョン2.9を使用でき、またはバージョン番号引数とともに--ansible-version オプションを渡すことによりコミュニティAnsibleの別のバージョンを使用できます。使用可能なバージョンは2.9 、8 、および9 です。

Ansible 2.9はTPAで非推奨になり、そのサポートは将来のバージョンで削除されます。 --skip-tags を使用している場合、コミュニティAnsibleでのこのオプションの動作が変更されたため、2ndQuadrant Ansible 2.9を使用し続ける必要があります。タスクをスキップする代替手段は、2ndQuadrantアンシブルのサポートが削除される前に、将来のTPAバージョンで提供される予定です。

Ansible 9のサポートは実験的です。 Python 3.10以降が必要であるため、edb-python 3.9がインストールされている場合は、tpaexec setup の実行時にPythonバージョンを明示的に設定する必要があります。

PYTHON=/usr/bin/python3.10 tpaexec setup --ansible-version 9