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

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

引数
----

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

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

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

- ``--architecture <architecture>`` 必須
  クラスターの新しいアーキテクチャ。現在、サポートされているアーキテクチャは\ ``PGD-Always-ON``
  のみです

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

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

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

クラスターを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
