TPA installation ================ TPAを使用するには、パッケージまたはソースからインストールし、\ ``tpaexec setup`` コマンドを実行する必要があります。このドキュメントでは、TPAパッケージをインストールする方法について説明します。 EDBサブスクリプションプランを契約しており、EDBリポジトリにアクセスできる場合、これらの手順に従う必要があります。ソースからTPAをインストールするには、 :ref:`Installing TPA from source ` を参照してください。 サポートされているプラットフォームについては、 :ref:`Distribution support ` を参照してください。 .. Note:: システムの日付と時刻が正しいことを完全に確認してください。そうしないと、さまざまな機能が失敗します。ネットワーク時間、例 `sudo ntpdate pool.ntp.org` を使用することをお勧めします クイックスタート ---------------- まず、 `subscribe to an EDB repository `_ 。 TPAのインストール ^^^^^^^^^^^^^^^^^ .. code:: shell sudo install tpaexec 追加の依存関係をインストールする ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code:: shell sudo /opt/EDB/TPA/bin/tpaexec setup インストールの検証一般のユーザーとして実行 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code:: shell /opt/EDB/TPA/bin/tpaexec selftest 各ステップのより詳細な説明を以下に示します。 TPAをインストールする場所 ------------------------- サポートされているプラットフォームを使用している限り、TPAはワークステーションからインストールして実行できます。これは、学習、ローカルテスト、またはデモンストレーションの目的に適しています。 TPAは :ref:`Dockerのインストール ` をサポート 独自のワークステーションで完全な展開を実行したい場合。 運用環境で使用する場合、専用の永続的な仮想マシンでTPAを実行することをお勧めします。これにより、クラスターディレクトリが保持され、将来のクラスター管理または更新にチームが利用できるためです。また、TPAのコピーを1つだけ更新する必要があり、単一のTPAホストからターゲットインスタンスへのネットワークアクセスを提供するだけであることも意味します。 TPAパッケージのインストール --------------------------- TPAをインストールするには、最初に `subscribe to an EDB repository `_ を行う必要があります。 TPAは、すべてのEDBリポジトリで使用できます。 次のとおりにTPAをインストールします。 DebianまたはUbuntuにインストールする ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code:: shell sudo apt-get install tpaexec RHEL、Rocky、AlmaLinux、またはOracle Linuxにインストールする ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code:: shell sudo dnf install tpaexec SLES ^^^^ .. code:: shell sudo zypper install tpaexec これにより、TPAが\ ``/opt/EDB/TPA`` にインストールされます。また、他の必要なパッケージPython 3.12以降がインストールされていることも確認します。 ここで\ ``sudo`` について言及しているのは、どのコマンドがroot権限を必要とするかを示すためです。他の手段を使用して、rootとしてコマンドを実行できます。 TPA Python環境のセットアップ ---------------------------- 次に、 ``tpaexec setup`` を実行して、分離されたPython環境を作成し、必要なすべてのモジュールの正しいバージョンをインストールします。 .. Note:: 20.04より前のUbuntuバージョンでは、 `sudo -H tpaexec setup` を使用して、`tpaexec configure` 中の後続の権限エラーを回避してください .. code:: shell sudo /opt/EDB/TPA/bin/tpaexec setup ``tpaexec setup`` は、適切なバージョンのrequirements.txtファイルを自動的に使用して、システムに適切なモジュールをインストールします。 これは\ ``/opt/EDB/TPA`` に書き込むため、rootとして実行する必要がありますが、プロセスは、インストールしているシステム全体のPythonモジュールAnsibleを含むには影響しません。 通常\ ``tpaexec`` コマンドを実行するユーザーの\ ``PATH`` に\ ``/opt/EDB/TPA/bin`` を追加します。たとえば、これを.bashrcまたは同等のシェル構成ファイルに追加できます。 .. code:: shell export PATH=$PATH:/opt/EDB/TPA/bin インターネットまたはネットワークアクセスエアギャップなしでTPAをインストールする ------------------------------------------------------------------------------- このセクションでは、EDBリポジトリ、Pythonパッケージインデックス、またはその両方にアクセスできないサーバーにTPAをインストールする方法について説明します。このような環境でTPAを使用する方法については、 :ref:`Managing clusters in a disconnected or air-gapped environment ` を参照してください。 TPAパッケージのダウンロード ^^^^^^^^^^^^^^^^^^^^^^^^^^^ TPAをインストールする必要があるサーバーからEDBリポジトリに直接アクセスできない場合、インターネットに接続されたマシンからパッケージをダウンロードして転送できます。これを行うには、いくつかの方法があります。 インターネットに接続されたマシンがターゲットと同じオペレーティングシステムを使用している場合、 ``yumdownloader`` RHELライクまたは\ ``apt download`` Debianライクを使用してパッケージをダウンロードすることをお勧めします。 または、 `EDB Repos `_ にアクセスし、[ Download EDB software Packages from your Browser ]という見出しの下で[ Enterprise ]、[ Standard ]または[ Community 360 ]のいずれかを選択することにより、ブラウザーから任意のプラットフォームのパッケージをダウンロードできます。 TPAをインストールするには、次のパッケージが必要です。 - tpaexec - tpaexec-deps - edb-python312 ダウンロードしたパッケージをターゲットサーバーに転送したら、プラットフォームに適切なツールを使用してインストールする必要があります。 Pythonパッケージインデックスへのアクセスを使用しないインストール ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ``tpaexec setup`` を実行すると、通常はPythonパッケージインデックスからPythonパッケージをダウンロードします。環境が別のインデックスを提供しない限り、デフォルトは公式の `PyPI `_ です。使用可能なパッケージインデックスがない場合は、インストールした\ ``tpaexec`` と同じ方法で\ ``tpaexec-deps`` パッケージをインストールする必要があります。 ``tpaexec-deps`` パッケージ tpaexecと同じリポジトリから入手できますは、ダウンロードされるすべてをバンドルしているため、ネットワークアクセスなしでインストールできます。 ``tpaexec setup`` を実行する前にパッケージをインストールするだけで、バンドルされたコピーが自動的に使用されます。 TPAインストールの検証 --------------------- 上記の手順がすべて完了したら、次のコマンドを実行してローカルインストールを確認します。 .. code:: shell tpaexec selftest そのコマンドがエラーなしで完了した場合、TPAインストールは使用できる状態です。 TPAのアップグレード ------------------- TPAの新しいリリースにアップグレードするには、次のことを行う必要があります。 1. 最新の\ ``tpaexec`` パッケージをインストールする 2. 最新の\ ``tpaexec-deps`` パッケージ必要な場合、上記を参照してください。 3. ``tpaexec setup`` を再度実行します 上記のようにTPAパッケージリポジトリをサブスクライブしている場合、 ``apt-get update && apt-get upgrade`` または\ ``yum update`` を実行すると、これらのパッケージの利用可能な最新バージョンをインストールする必要があります。それ以外の場合は、利用可能な任意の手段でパッケージをインストールできます。 ``tpaexec`` の新しいバージョンがインストールされるときは、 ``tpaexec setup`` を再度実行することをお勧めします。一部の新しいリリースはこれを厳密に必要としない場合がありますが、他のリリースはそれなしでは動作しません。 Ansibleバージョン ----------------- TPAは、デフォルトでansible-core 2.16を使用します。