Paragon Automationのインストール

ノードを準備するには、VM を作成して構成する必要があります。

1. Juniper Paragon Automationソフトウェアのダウンロードサイトから、Paragon AutomationインストールOVAファイルをダウンロードします。OVA は、ノード VM の作成とクラスタのデプロイに使用されます。

   実際のファイル名には、 paragon-2.0.0-0515.ovaのようにリリース日が含まれることに注意してください。

   ファイルのサイズが大きいため、ダウンロードしてからコンピューターから VM を作成するのにかなりの時間がかかる場合があります。そのため、Paragon Automationをインストールするのと同じサーバーまたは別のサーバー上に、基本的なUbuntuデスクトップVMであるローカルインストーラーVMを作成することをお勧めします。このローカル インストーラ仮想マシンに OVA ファイルをダウンロードでき、仮想マシンにファイルを格納するのに十分な領域がある必要があります。 図 2 に示すように、サーバーの管理 IP アドレスへの接続を構成します。

   図 2: OVA/OVF ファイルをダウンロードするためのローカル インストーラー VM

2. (オプション)OVA ファイルの整合性を検証します。Ubuntuデスクトップを使用している場合は、次のコマンドを使用します。

   画面に表示される数字が、Juniper Paragon Automation ソフトウェアのダウンロードサイトで入手できるSHA512チェックサム番号と同じであることを確認します。[ チェックサム] をクリックして、有効な SHA512 チェックサムを表示します。

3. 整合性を確認したら、ノード仮想マシンを作成します。OVA 全体を使用して VM を作成できます。

   または、OVA から OVF ファイルと .vmdk ファイルを抽出して使用し、VM を作成します。ファイルを抽出するには、次のコマンドを使用します。

   インストール デスクトップで Windows が実行されている場合は、 https://gnuwin32.sourceforge.net/packages/gtar.htm から tar ユーティリティをダウンロードして使用し、ファイルを抽出できます。

   手記：

   vCenter を使用しないスタンドアロンの ESXi 8.0 サーバを使用している場合、VMware ホスト クライアントの制限により、大きな OVA ファイルをクライアントにアップロードできません。このような場合は、OVF、.vmdk、および .nvram ファイルを抽出して使用し、VM を作成する必要があります。

4. Webブラウザから、Paragon AutomationをインストールするVMware ESXi 8.0サーバーに接続してログインします。

   ローカル インストーラー VM を使用している場合は、VM のブラウザーを使用して VMware ESXi サーバーに接続します。

5. ノード VM を作成します。

   VM を作成するには、次の手順を実行します。

   1. [ ホスト ] アイコンを右クリックし、[ VM の作成/登録] を選択します。

      [新しい仮想マシン] ウィザードが表示されます。

   2. [作成の種類の選択] ページで、 [ OVF または OVA ファイルから仮想マシンをデプロイする] を選択します。

      「 次へ」をクリックします。

   3. [OVF および VMDK ファイルの選択] ページで、ノード VM の名前を入力します。

      クリックしてアップロードするか、OVA ファイルまたは OVF ファイルを .vmdk ファイルと一緒にドラッグ アンド ドロップします。

      アップロードするファイルのリストを確認し、「 次へ」をクリックします。

   4. [ストレージの選択] ページで、ノード VM に 300 GB の SSD を収容できる適切なデータストアを選択します。SSDは必須であることに注意してください。

      「 次へ」をクリックします。ファイルの抽出には数分かかります。

   5. [デプロイ オプション] ページで、次の操作を行います。

      • ノード VM の接続先となる仮想ネットワークを選択します。

      • [ シック ディスク プロビジョニング] オプションを選択します。

      • VM の電源が自動的にオンになるようにします。

      「 次へ」をクリックします。

   6. [完了する準備ができました] ページで、VM の設定を確認します。

      [ 完了] をクリックしてノード仮想マシンを作成します。

      手記：

      OVF ファイルと .vmdk ファイルを使用して VM を作成し、VM の作成に失敗した場合は、.nvram ファイルを使用して仮想マシンの作成を再試行してください。手順 5.c で、OVF ファイルおよび .vmdk ファイルと共に .nvram ファイルをアップロードします。vCenter を使用しないスタンドアロンの ESXi 8.0 サーバの場合は、.nvram ファイルもアップロードする必要があります。

   7. 他の 3 つのノード VM について、手順 5.a から 5.f を繰り返します。 プロンプトが表示されたら、適切な VM 名を入力します。

   8. (オプション)ページ下部の [最近のタスク] セクションで、VM の作成の進行状況を確認します。VM が作成されると、VMware Host Client インベントリの [仮想マシン] の下に表示されます。

   9. すべての VM が作成されたら、仕様が正しく、パワーオンされていることを確認します。

6. ノード VM を構成する

   すべてのノード VM が作成されたら、次の手順を実行して構成します。

   1. 最初の VM のノード VM Web コンソールに接続します。自動的にrootとしてログインします。

   2. すぐにパスワードを変更するように求められます。新しいパスワードを入力し、再度入力します。VM から自動的にログアウトされます。

      手記：

      すべての VM に同じパスワードを入力することをお勧めします。VM に異なるパスワードを構成する場合は、次の要求に応じて異なるパスワードを正しく入力します。

      • Paragon Shellを使用してクラスターを導入する際に、クラスターノードの SSHキーを生成します 。

      • デプロイ ウィザードを使用してクラスターをデプロイするときに、VM の パスワードを入力します 。

   3. プロンプトが表示されたら、新しく設定したパスワードでrootユーザーとして再度ログインします。

   4. プロンプトが表示されたら、次の情報を構成します。

      表 1: VM 構成ウィザード

      プロンプト	アクション
      ホスト名を設定しますか?(y/n)	y と入力してホスト名を構成します。
      ホスト名を指定してください	VM の識別ホスト名を入力します。たとえば、Primary1 です。ホスト名は64文字未満で、英数字と一部の特殊文字を使用できます。 ホスト名を入力しない場合、controller-<VM-IP-address-4th-octet> is assigned.形式のデフォルトのホスト名 手記： 1 つのノードからクラスターを展開し、クラスター構成プロセス中に他のノードの IP アドレスを入力するため、ロールは自動的に割り当てられます。構成する最初の 3 つのノードはプライマリ ノードとワーカー ノードで、最後のノードはワーカー専用ノードです。 ホスト名(およびホスト名がノードの役割と一致するかどうか)は、クラスタの操作に影響を与えません。ただし、管理上の理由から、ノードに名前を付ける方法と、クラスターの作成手順でアドレスを入力する順序に注意を払うことをお勧めします。 クラスタのインストール後にホスト名を変更することはサポートしていません。
      静的 IP (推奨) を設定しますか?(y/n)	「y」と入力して、VM の IP アドレスを構成します。
      IPアドレスはCIDR表記で指定してください	IP アドレスを CIDR 表記で入力します。たとえば、10.1.2.3/24 です。 手記： 10.1.2.3/24 ではなく 10.1.2.3 を入力すると、「無効な IP アドレス」というエラー メッセージが表示されます。
      ゲートウェイIPを指定してください	ゲートウェイの IP アドレスを入力します。
      プライマリDNS IPを指定してください	プライマリ DNS IP アドレスを入力します。
      セカンダリDNS IPを指定してください	セカンダリ DNS の IP アドレスを入力します。

   5. 続行するかどうかを確認するプロンプトが表示されたら、表示された情報を確認し、 y と入力して Enter キーを押します。

   6. Paragon Shellにログインしています。

   7. 他の 3 つの VM について、手順 6.a から 6.f を繰り返します。

7. (オプション)クラスタの展開に進む前に、NTPサーバが到達可能であることを確認します。いずれかのクラスタ ノードで、「 start shell」と入力します。 # プロンプトで、 ping ntp-servers-name-or-address コマンドを使用してサーバーに ping を実行します。ping が失敗した場合は、別の NTP サーバを使用します。

ノードの準備手順が完了し、Paragon Shellまたはデプロイメントウィザードを使用してクラスターを導入する準備が整いました。

Paragon Shell CLIを使用してParagon Automationクラスターを展開するには、以下のステップを実行します。

1. 最初のノード VM (Primary1) に戻ります。ログアウトしている場合は、SSHを使用して、以前に設定した パスワードでrootとして再度ログインします。Paragon Shell運用モードになります。

2. クラスターを設定するには、Paragon Shellで設定モードに入ります。

3. 次のクラスタパラメータを設定します。

   どこ：

   インデックスが 1 から 4 の kubernetes ノードの IP アドレスは、ノード VM で構成されている 静的 IP アドレス と一致する必要があります。インデックス 1、2、3 の Kubernetes ノードはプライマリ ノードとワーカー ノードであり、インデックス 4 のノードはワーカー専用ノードです。

   ntp-serversは、同期先のNTPサーバです。

   web-admin-user および web-admin-password は、最初のユーザーが Web GUI にログインするために使用できる E メール・アドレスとパスワードです。

   ingress-vip は、汎用イングレス IP アドレスの VIP アドレスです。

   test-agent-gateway-vip は、Paragon Active Assurance テスト エージェント ゲートウェイの VIP アドレスです。

   VIPアドレスは、デバイスがParagon Automationとの接続を確立するために必要なアウトバウンドSSH設定に追加されます。

4. (オプション)汎用イングレスおよびParagon Active Assuranceテストエージェントゲートウェイのホスト名を設定する場合は、次のように設定します。

   どこ：

   system-hostname は、汎用イングレス仮想 IP アドレスのホスト名です。

   test-agent-gateway-hostnameは、Paragon Active Assuranceテストエージェントゲートウェイの仮想IPアドレスのホスト名です。

   ホスト名を設定すると、VIP アドレスの代わりにホスト名がアウトバウンド SSH 設定に追加されます。

5. (オプション)SMTP ベースのユーザー管理については、次の設定を構成します。

   どこ：

   sender-domains は、Paragon Automation がユーザーに電子メールを送信する電子メール ドメインです。

   relayhost-hostname は、メッセージを中継する SMTP サーバーの名前です。

   relayhost-username(オプション)は、SMTP(リレー)サーバーにアクセスするためのユーザー名です。

   relayhost-password(オプション)は、SMTP(リレー)サーバーのパスワードです。

   sender-e-mail-address は、e-電子メールの受信者に送信者の電子メール アドレスとして表示される電子メール アドレスです。

   sender-nameは、Paragon Automationからユーザーに送信される電子メールの送信者名として表示される名前です。

   papi-local-user-management False ローカルユーザー管理を無効にします。

   手記：

   この時点では、SMTPの設定はオプションです。SMTP設定は、クラスターがデプロイされた後にも構成できます。クラスタ導入後にSMTPを設定する方法については、次を参照してください: Paragon ShellでSMTP設定を構成する。

6. (オプション)カスタムユーザー証明書をインストールします。ユーザー証明書をインストールする前に、カスタム証明書ファイルと証明書キーファイルを、クラスタのデプロイ元のノードの Linux ルートシェルの /root/epic/config フォルダにコピーしておく必要があります。

   どこ：

   certificate.cert.pem は、ユーザー証明書のファイル名です。

   certificate.key.pem は、ユーザー証明書キーのファイル名です。

   手記：

   この時点では、証明書のインストールは省略可能です。クラスターのデプロイ後にも、カスタムユーザー証明書を使用するようにParagon Automationを設定できます。クラスタのデプロイ後にユーザー証明書をインストールする方法については、「 ユーザー証明書のインストール」を参照してください。

7. 設定をコミットし、設定モードを終了します。

8. 構成ファイルを生成します。

   インベントリ ファイルには、VM の IP アドレスが含まれています。

   config.yml ファイルには、クラスター Paragon Automationデプロイに必要な最小限のクラスター パラメーターが含まれています。

   request paragon config コマンドは、config ディレクトリに config.cmgd ファイルも生成します。config.cmgd ファイルには、3 で実行したすべての set コマンドが含まれています。 config.yml ファイルが誤って編集または破損した場合は、設定モードで load set config/config.cmgd コマンドを使用してクラスターを再デプロイできます。

9. クラスタノードでsshキーを生成します。

   プロンプトが表示されたら、VM の SSH パスワードを入力します。 VM にログインするように構成したものと同じ パスワード を入力します。

   手記：

   VM に異なるパスワードを構成している場合は、プロンプトが表示されたら、対応するパスワードを入力してください。

10. クラスターをデプロイします。

    クラスターのデプロイが開始され、完了するまでに 1 時間以上かかります。

11. (オプション)画面上で展開の進行状況を監視します。

    展開の進行状況が表示されます。次のような出力が画面に表示されると、デプロイは完了です。

    または、 monitor コマンドを使用してデプロイメントの進行状況を画面上で監視することを選択しなかった場合は、 file show /epic/config/log コマンドを使用してログファイルの内容を表示できます。ログ ファイルの最後の数行は、 サンプル出力のようになります。ログ ファイルを定期的にチェックして、デプロイの進行状況を監視することをお勧めします。

12. デプロイが完了したら、VMからログアウトし、Paragon Shellに再度ログインします。

    デプロイが正常に完了すると、アプリケーション クラスターが作成されます。

    コンソール出力には、Paragon Shellのウェルカムメッセージと4つのノード(コントローラ-1からコントローラ-4と呼ばれる)のIPアドレス、Paragon Active AssuranceテストエージェントのゲートウェイVIPアドレス、Web管理者ユーザの電子メールアドレス、およびWeb GUI IPアドレスが表示されます。

    CLI コマンド プロンプトに、以前に設定したログイン ユーザー名とノード ホスト名が表示されます。たとえば、プライマリノードのホスト名として「Primary1」と入力した場合、コマンドプロンプトは root@Primary1 >になります。

図3は、インストール後のParagon Automationクラスターを示しています。

図 3: Paragon Automation クラスター

これで、クラスタのデプロイメントを検証し、Web GUI にログインできます。 Web GUI へのログインを参照してください。

Paragon Shellを使用してクラスターを展開していない場合は、次の手順を実行して、Linuxルートシェルから対話型デプロイウィザードを使用してParagon Automatonクラスターを展開します。

1. 最初のノードVM(Primary1)に戻り、以前に設定した パスワードでrootとしてログインします。Paragon Shell操作モードである。

2. Paragon Shellを終了します。 exit と入力して、Linuxルートシェルに戻ります。

3. クラスターを作成するかどうかを尋ねられたら、「 y 」と入力して Enter キーを押します。

   手記：

   デプロイウィザードは、 setup コマンドを使用していつでも起動してクラスターを作成できます。

4. プロンプトが表示されたら、次の情報を構成します。

   表 2: VM デプロイ ウィザード

   プロンプト	アクション
   利用可能なIPのリストを指定してください	VIP アドレスを、形式 10.1.2.3, 10.1.2.4 のリスト、または 10.1.2.3-10.1.2.4 形式の範囲で入力します。
   コントローラ 2 の IP を指定してください コントローラ 3 の IP を指定してください コントローラ-4 IPを指定してください	2 番目、3 番目、4 番目の VM の IP アドレスを、コントローラ 2、コントローラ 3、およびコントローラ 4 の VM に対応するように入力します。 これらの IP アドレスは、ノードに設定された 静的 IP アドレス と一致する必要があります。
   Web管理者のメールアドレスを指定してください	Paragon Automation Web GUIに最初にログインするユーザーのメールアドレスを入力します。このユーザーは、システム管理者またはその他の指定されたユーザーです。このユーザーにはスーパーユーザー権限があり、追加のユーザーを作成できます。
   Web 管理者のパスワードを指定してください Web管理者のパスワードを指定してください(再度)	最初のユーザーが Web GUI へのログインに使用できるパスワードを入力します。 パスワードを確認するために再入力します。
   NTPサーバーを指定してください	NTP サーバの IP アドレスを入力します。NTP サーバーに到達可能であり、VM ネットワークからサーバーへのアクセスをブロックしているファイアウォールがないことを確認します。

5. 続行するかどうかを尋ねられたら、「 y 」と入力して Enter キーを押します。

6. プロンプトが表示されたら、VM の SSH パスワードを入力します。 VM にログインするように構成したものと同じ パスワード を入力します。

   手記：

   VM に異なるパスワードを構成している場合は、プロンプトが表示されたら、対応する正しいパスワードを入力してください。

   クラスタのデプロイが開始されます。デプロイが完了するまでに 1 時間以上かかります。

7. 導入が正常に完了すると、アプリケーションクラスタが作成され、Paragon Shellにログインします。

   コンソール出力には、4 つのコントローラ IP アドレス、Paragon Active Assurance テスト エージェント ゲートウェイ VIP アドレス、Web GUI VIP アドレス、および Web 管理者ユーザの電子メール アドレスが表示されます。クラスターの構成時に入力した VIP アドレスのリストの最初の VIP アドレスが Web GUI に割り当てられ、2 番目の VIP アドレスがテスト・エージェント・ゲートウェイに割り当てられます。

8. ノードVMからログアウトし、Paragon Shellに再度ログインして、更新されたコマンドプロンプトを表示します。CLIコマンドプロンプトに、ログインユーザー名と、以前に設定したノードホスト名が表示されます。たとえば、プライマリノードのホスト名として「Primary1」と入力した場合、コマンドプロンプトは root@Primary1 >になります。

9. (オプション)SMTP ベースのユーザー管理を構成します。SMTPを設定するには、「 Paragon ShellでSMTP設定を構成する」で説明されている手順を実行します。

10. (オプション)カスタムユーザー証明書をアップロードします。カスタムユーザー証明書を使用するようにParagon Automationを設定するには、「 ユーザー証明書のインストール」で説明されている手順を実行します。

11. (オプション)Paragon Shellを使用して、一般的なイングレスおよびParagon Active Assuranceテストエージェントゲートウェイのホスト名を設定し、以下のステップを実行します。

    どこ：

    system-hostname は、汎用イングレス IP アドレスのホスト名です。

    test-agent-gateway-hostnameは、Paragon Active AssuranceテストエージェントゲートウェイIPアドレスのホスト名です。

これで、クラスタのデプロイメントを検証し、Web GUI にログインできます。

図3は、インストール後のParagon Automationクラスターを示しています。

クラスターがデプロイされたら、デプロイメントを検証し (オプション)、デプロイメント中に入力した情報を使用して Web GUI にログインできます。

1. (オプション)デプロイを確認します。

   1. クラスターの詳細を確認します。

   2. クラスタノードの詳細を確認します。

2. Web GUI にログインします。

   1. Web ブラウザに「https://web-ui-ip-address」と入力して、Paragon Automation ログイン ページにアクセスします。 web-ui-ip-address は、クラスターのデプロイが完了した後にコンソールに表示される URL です。

   2. Paragon Automationにログインするために以前に 設定 したWeb管理ユーザーのメールアドレスとパスワードを入力します。Web 管理者ユーザーの電子メールは、クラスターのデプロイの完了後にコンソールにも表示されます

      Paragon Automation GUIにログインすると、[新規アカウント]ページが表示され、そこから新しい組織を作成できます。詳細については、「 ユーザーのアクティブ化とログイン」を参照してください。