次の手順は、合成プライベートエージェントを取得してインストールする方法を示しています。 

合成プライベートエージェントのインストールでは、システムに次の変更を加えます。

  • 合成プライベートエージェントをインストールします。
  • ブラウザをインストールします。
  • 複数の Windows レジストリ設定の変更など、Windows のさまざまな側面を構成して、ブラウザからパフォーマンスデータを収集できるようにします。
  • Windows ファイアウォールを有効にして、サーバへのインバウンドネットワーク接続を防止します。

前提条件

インストールを開始する前に、次のことを完了していることを確認します。

インストールの手順

合成プライベートエージェントをインストールするには、以下の手順を実行します。

合成プライベートエージェントの取得

AppDynamics ダウンロードに移動し、合成プライベートエージェントをダウンロードします。

管理者としてログインします。

合成プライベート エージェント インストーラをコピーして実行するには、その前に、合成プライベートエージェント用の専用 Windows マシンに管理者としてログインする必要があります。

合成プライベートエージェントを専用マシンにコピー/移動

  1. 合成プライベートエージェントを含む圧縮アーカイブファイル SyntheticAgentInstaller.zip  をこのマシンに移動またはコピーします。 

  2. アーカイブファイルを解凍します。
  3. ディレクトリ SyntheticAgentInstaller にインストーラスクリプト install.ps1 が含まれていることを確認します。 

アカウントと場所情報の準備

合成プライベートエージェントをインストールする前に、次の情報が必要になります。

  • EUM Account Name / EUM License Key：
    1. SaaS コントローラに移動します。
    2. [License > Peak Usage] に移動します。
    3. [User Experience] セクションまで下にスクロールします。
    4. [Account Name] と [License Key] のフィールドの値をコピーします。
  • Location name：場所のユーザフレンドリな文字列。複数のコンピュータで同じ場所情報を使用すると、その場所にキャパシティを追加できます。たとえば、プライベートの場所が SF の会社オフィスから実行されている複数のマシンの場所である場合は、「SF Office」を使用できます。
  • Location ID：1 つ以上のエージェントが実行されている可能性がある場所を識別する 4 ～ 10 文字の一意の英数字文字列。この ID は、場所の名前に基づいて作成する必要があります。 

  • Latitude and longitude of the location：GPS Coordinates with Google Mapsツール（
    https://www.gps-coordinates.net/）に移動して、場所の緯度と経度を取得します。

インストーラの実行

アーカイブファイルを解凍した後、次の手順を実行します。

  1. PowerShell コンソールを開きます。

  2. ディレクトリ SyntheticAgentInstaller に移動します。

  3. PowerShell 実行ポリシーを Unrestricted に設定します。

    > Set-ExecutionPolicy Unrestricted
    POWERSHELL

  4. PowerShell スクリプト install.ps1 を実行して、合成プライベートエージェント、インターネットブラウザをインストールし、Windows の設定を変更します。

    > .\install.ps1
    POWERSHELL
  5. コマンドプロンプトで、最後の手順で準備した情報を入力します。

エージェントと合成サーバの接続（オプション）

デフォルトでは、合成プライベートエージェントは、アメリカのビジネス地域にある SaaS 合成サーバに測定結果を報告します。したがって、合成プライベートエージェントがアメリカのビジネス地域にあり、SaaS 合成サーバに報告している場合は、合成プライベートエージェントの起動を続行します。

合成プライベートエージェントがオンプレミスの合成サーバに測定結果を報告している場合、設定手順については合成エージェントと合成サーバの接続を参照してください。

EMAC または APAC のビジネス地域で SaaS 合成サーバに報告するように合成プライベートエージェントを構成するには、次の手順を実行します。

  1. 次の表の [EMAC] または [APAC] タブを選択し、地域内の SaaS 合成サーバへの URL を見つけます。

    Cisco AppDynamics SaaS Domains and IP Ranges

    This page has not yet been translated to Japanese.

  2. ディレクトリ C:\appdynamics\synthetic-agent\synthetic-driver\conf に移動します。
  3. ファイル synthetic-driver.yml を編集します。

  4. 次に示すように、地域の SaaS 合成シェパードへの URL を shepherdUrl に設定します。

    ## Use the SaaS Synthetic Server URL from the table above for EMAC or APAC.
shepherdUrl: http://<saas_synthetic-server_url>
    POWERSHELL

  5. 変更内容を保存して、synthetic-driver.yml ファイルを閉じます。

合成プライベートエージェントの起動

インストールが完了した後（インストーラによってコンピュータが再起動される場合があります）、デスクトップショートカット [Start Agent] をダブルクリックして、合成プライベートエージェントを起動します。

インストールが成功したことの確認

  1. SaaS コントローラに移動し、次に移動します。Synthetic Job List.
  2. [Create a Job] をクリックします。
  3. [Choose Locations] で、ドロップダウンから Private を選択して、アカウントに関連付けられているすべての合成プライベートエージェントを表示します。
  4. 使用可能な場所の 1 つとしてプライベートの場所が表示されていることを確認します。 

自動ログオンの構成

起動後のマシンが自動的に管理者アカウントにログオンするように、自動ログオンを設定する必要があります。自動ログオンを設定するには、無料の Microsoft Sysinternals ユーティリティAutologon.exe  を使用することをお勧めします。Autologon.exe は使いやすく、さらに重要なこととして、Windows レジストリに保存されているアカウントログイン情報を暗号化します。

自動ログオンを構成するには、次の手順を実行します。

  1. https://docs.microsoft.com/en-us/sysinternals/downloads/autologon から Autologon.exe をダウンロードします。
  2. 実行可能ファイル Autologon.exe をダブルクリックします。
  3. 要求された情報（ユーザ名、ドメイン、パスワードなど）を入力します。
  4. [Enable] をクリックします。

コマンドラインから Autologon.exe を実行することもできますが、パスワード内の特殊文字は必ずエスケープするようにします。

レジストリを編集して手動で自動ログオンを構成するには、「How to turn on automatic logon in Windows」を参照してください。使用している Windows のバージョンによっては、記載された手順が若干変わることがあるので注意してください。 

ログオン時に合成プライベートエージェントが起動するスケジュール設定

自動ログオンを設定したら、マシンが管理者アカウントにログインした後に合成プライベートエージェントを自動的に起動するようにスケジュールする必要があります。

  1. PowerShell コンソールを開きます。

  2. ファイル startagent.xml をダウンロードし、$HOME ディレクトリに保存します。

  3. $HOME ディレクトリに移動します。
  4. 「管理者」以外のユーザとしてログオンしている場合は、startagent.xml ファイルを編集して、次の XML 要素の値 "Administrator" をユーザ名に置き換えます（ユーザアカウントには引き続き管理者権限が必要です）。
    • <Author>
    • <UserId>

  5. 合成プライベートエージェントを起動するタスクをスケジュールします。

    &gt; schtasks /create /f /tn "Start the Synthetic Private Agent"/xml .\startagent.xml
    POWERSHELL

  6. マシンを再起動します。

  7. マシンが起動すると、「Administrator: Windows PowerShell」というタイトルの Windows コンソールが開いて、ログメッセージ「Synthetic-agent is running」が表示されます。

詳細オプション

複数のエージェントのインストール

1 つの合成プライベートエージェントをインストールした後、さらに合成プライベートエージェントをインストールする必要があるかどうかを検討する必要があります。

次の使用例では、複数のエージェントをインストールすることをお勧めします。

  • 複数の場所をテストする。test multiple locations 複数のマシンに合成プライベートエージェントをインストールし、インストール中にさまざまな場所情報を指定する必要があります。それぞれの場所は、Job Editor で個別に表示されます。
  • さらにテストを実行するためにさらにスループットが必要である。more throughput to run more tests 1 つの場所から多数の合成ジョブを実行すると、「Location is overloaded」のようなエラーが表示されることがあります。これは、マシンがキャパシティに達していて、別のマシンを追加する必要があることを意味します。別のマシンにエージェントをインストールすることにより、同じ場所情報を指定することができます。 
  • Internet Explorer の複数のバージョンをサポートする。support for multiple versions of Internet Explore 詳細については、ソフトウェア要件を参照してください。