Configuring the agent

Configuring the agent#

TPAは、config.yml のロールbeacon-agent を持つノードにビーコンエージェントをインストールおよび構成します。 --enable-beacon-agent がtpaexec configure に渡される場合、クラスター内のすべてのpostgresノードがこのロールになります。

Beaconエージェントパッケージバージョン#

デフォルトでは、TPAはbeacon-agent の利用可能な最新バージョンをインストールします。

config.yml ファイルのcluster_vars セクションの下にbeacon_agent_package_version: xxx を含めることにより、インストールされるbeacon-agent パッケージのバージョンを指定できます。

cluster_vars:
    …
    beacon_agent_package_version: 1.56.2-1
    …

aptまたはyumが受け入れるバージョン指定子を使用できます。

バージョンが一致しない場合は、 * ワイルドカードを追加してみてください。これは、パッケージバージョンに2:... のようなエポック修飾子がある場合に必要になることがよくあります。

ビーコンエージェントの構成#

ビーコンエージェント構成には、クラスターごとに設定する必要がある2つのパラメーター、アクセスキーとプロジェクトIDが含まれています。

アクセスキーはクラスターディレクトリで暗号化されたままで、 tpaのstore-password およびshow-password コマンドを使用して設定または読み取ることができます。

$ tpaexec store-password . beacon_agent_access_key
Password:

$ tpaexec show-password . beacon_agent_access_key

tpaexec provision の実行時に環境変数BEACON_AGENT_ACCESS_KEYが設定されている場合、アクセスキーはその値から設定されます。

プロジェクトIDは、cluster_vars のbeacon_agent_project_id キーの下のconfig.yml に保存されます。 --beacon_agent_project_id 引数がtpaexec configure に渡される場合、その値はconfig.yml に適切に書き込まれます。

ビーコンエージェントのインストール#

TPAはEDBのリポジトリからビーコンエージェントをインストールし、beacon というオペレーティングシステムユーザーとbeacon というデータベースユーザーを作成します。エージェントの構成ファイルは、ビーコンユーザーのホームディレクトリの.beacon/beacon_agent.yaml に書き込まれます。

ビーコンエージェントの実行#

TPAは、 systemdサービスユニットファイルをインストールして、ブート時にエージェントを起動し、ビーコンユーザーとして実行します。

目次