tpaexec reconfigure
===================

``tpaexec reconfigure``
コマンドは、config.ymlを読み取り、引数に応じてさまざまな方法でクラスターを変更する変更バージョンを生成します。

引数
----

他のtpaexecコマンドと同様に、クラスターディレクトリは常に指定する必要があります。

クラスターのアーキテクチャの変更
--------------------------------

次の引数により、クラスターのアーキテクチャを変更できます。

- ``--architecture <architecture>`` (必須)
  クラスターの新しいアーキテクチャ。 ``PGD-Always-ON`` および\ ``PGD-X``
  を有効な引数として受け入れます

- ``--pgd-proxy-routing <global|local>`` ``PGD-Always-ON`` に必要
  PGD-Proxyが接続をルーティングする方法。この引数の意味の詳細については、
  :ref:`PGD-Always-ON <PGD-Always-ON>` を参照してください。

- ``--edb-repositories <repositories>`` オプショナル
  EDBパッケージリポジトリのスペース区切りリスト。通常、これを指定する必要はありません。
  ``tpaexec configure``
  は、クラスターで使用されているpostgresフレーバーに基づいて、適切なリポジトリを選択します。

アーキテクチャを変更した後、
:ref:`Upgrading your cluster <Upgrading your cluster>` を実行して、クラスターに必要な変更を加えます。

クラスターをPGD-プロキシからPGD-Always-ONの接続マネージャーに変更する
---------------------------------------------------------------------

- ``--enable-connection-manager(required)`` PGD
  5.9+クラスター上のPGD-プロキシから新しいビルトイン接続マネージャーへの移行を許可するオプション。

クラスターを2qからEDBリポジトリへの変更
---------------------------------------

``--replace-2q-repositories``
引数は、クラスターが使用する2ndQuadrantリポジトリを削除し、必要に応じてEDBリポジトリを追加して、それらを置き換えます。

この引数で再構成した後、 [tpaexec
promote)(tpaexec-deploy.md)を実行して、クラスターに必要な変更を加えます。

出力フォーマット
----------------

次のオプションは、出力の形式を制御します。

- ``--describe`` 何も変更せずに、変更される内容の説明を表示します。

- ``--check``
  加えられる変更を検証し、エラーがあれば何も変更せずに、検証の結果発生したエラーまたは警告を表示します。

- ``--output <filename>`` config.yml以外のファイルに出力を書き込みます。

サンプル呼び出し
----------------

::

   $ tpaexec reconfigure ~/clusters/speedy\
     --architecture PGD-Always-ON\
     --pgd-proxy-routing local
