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

The ``tpaexec reconfigure`` command reads config.yml and generates a
revised version of it that changes the cluster in various ways according
to its arguments.

Arguments
---------

As with other tpaexec commands, the cluster directory must always be
given.

Changing a cluster’s architecture
---------------------------------

The following arguments enable the cluster’s architecture to be changed:

- ``--architecture <architecture>`` (required) The new architecture for
  the cluster. Accepts ``PGD-Always-ON`` and ``PGD-X`` as valid
  arguments

- ``--pgd-proxy-routing <global|local>`` (required for ``PGD-Always-ON``
  ) How PGD-Proxy is to route connections. See :ref:`PGD-Always-ON <PGD-Always-ON>`  for more
  information about the meaning of this argument.

- ``--edb-repositories <repositories>`` (optional) A space-separated
  list of EDB package repositories. It is usually unnecessary to specify
  this; ``tpaexec configure`` will choose a suitable repository based on
  the postgres flavour in use in the cluster.

After changing the architecture, run :ref:`Upgrading your cluster <Upgrading your cluster>`  to make the required
changes to the cluster.

Changing a cluster from PGD-Proxy to Connection Manager in PGD-Always-ON
------------------------------------------------------------------------

- ``--enable-connection-manager(required)`` The option to allow
  migration from PGD-Proxy on a PGD 5.9+ cluster to the new builtin
  Connection Manager.

Changing a cluster from 2q to EDB repositories
----------------------------------------------

The ``--replace-2q-repositories`` argument removes any 2ndQuadrant
repositories the cluster uses and adds EDB repositories as required to
replace them.

After reconfiguring with this argument, run [tpaexec
deploy)(tpaexec-deploy.md) to make the required changes to the cluster.

Output format
-------------

The following options control the form of the output:

- ``--describe`` Shows a description of what would be changed, without
  changing anything.

- ``--check`` Validates the changes that would be made and shows any
  errors any errors or warnings that result from validation, without
  changing anything.

- ``--output <filename>`` Writes the output to a file other than
  config.yml.

Sample invocation
-----------------

::

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