Upgrading PGD clusters with TPA
===============================

..  Note No Postgres major version upgrades::
   TPAは現在Postgresのメジャーバージョンのアップグレードをサポートしていません。ここで概要を説明する技術は、 PGDソフトウェアのマイナーバージョンのアップグレードとPostgresのマイナーバージョンのアップグレードを実行できます。 Postgresのメジャーバージョンのアップグレードを実行するには、 :ref:`In-place Postgres major version upgrades <In-place Postgres major version upgrades>` を参照してください。

.. ::
   TPAを使用してクラスターをインストールした場合、TPAを使用してクラスターをアップグレードすることもできます。 TPAドキュメントの :ref:`Upgrading your cluster <Deploying EDB Postgres Distributed using Trusted Postgres Architect>` で、TPAアップグレードの機能の詳細を読むことができます。

..  Warning Always test first::
   可能であれば、最初にQA環境でアップグレードプロセスをテストして、考慮すべき予期しない要素がないことを確認してください。 PGD構成を再現可能に展開するTPAの機能により、作業するテスト環境の構築が非常に簡単になります。 !!!

マイナーおよびメジャーPGDのアップグレード
-----------------------------------------

PGDのマイナーバージョンのアップグレードは自動的に管理されます

PGDのメジャーバージョンのアップグレードには、展開構成が含まれるTPA
``config.yml`` ファイルを変更する必要があります。

以前のPGDメジャーバージョンからPGD 5にアップグレードする場合は、
 :ref:`tpaexec reconfigure <Deploying EDB Postgres Distributed using Trusted Postgres Architect>` を使用して、展開構成に適切な変更を加えることができます。

``reconfigure``
コマンドでは、アーキテクチャの設定が必要です実行するには、\ ``PGD_Always_ON``
およびPGDプロキシルーティングのみ。実行前に展開構成をバックアップすることを忘れず、
``--describe`` および\ ``--output``
オプションを使用して再構成をプレビューします。

前提条件
--------

-  TPAがPGDクラスターを展開したときに作成されたクラスター構成ディレクトリ。

-  PGDのメジャーバージョンのアップグレードを実行する場合は、
   ``tpaexec reconfigure``
   が実行され、 :ref:`appropriate configuration changes <#minor-and-major-pgd-upgrades>` が作成されていることを確認します。

アップグレード
--------------

走る

::

   tpaexec upgrade clustername

ここで、 **clustername**
は、クラスターの名前とクラスター構成ディレクトリへのパスです。デフォルトでは、TPAはクラスターの各ノードを、ノードが構成されたソフトウェアの最新のマイナーバージョンにアップグレードします。

..  Note TPA's automated rolling upgrade procedure::
   TPAは、最初にクラスターをテストし、次にノードをテストします。各ノードはクラスターから分離され、アップグレードされて、クラスター内のオペレーションに戻ります。

-  クラスターをアップグレードするためのすべての前提条件が満たされていることを確認します。

*クラスター内の各インスタンスについて、正しいリポジトリが構成されていること、および必要なpostgresパッケージがそれらの中で利用可能なことを確認します。*
クラスター内のBDRノードごとに、一度に1つずつ
*ノードをフェンスして、pgd-proxyがそれに接続を送信しないようにします。*
postgresを停止、更新、および再起動します。
*ノードのフェンスを解除して、再び接続を受信できるようにします。*
このノードに該当する場合、pgbouncer、pgd-proxy、およびpgd-cliを更新します。

!!!
